# General Translation Changelog: gt-react 11.0.0: Un runtime condiviso tra framework React URL: https://generaltranslation.com/it/blog/gt-react_v11_0_0.mdx Docs index: https://generaltranslation.com/llms.txt Description: Authors: Ernest McCarter Published: 2026-07-03 ## Panoramica `gt-react` 11 è al centro di un rilascio coordinato di General Translation che coinvolge le nostre librerie React. `gt-react`, `gt-next`, `@generaltranslation/react-core`, `gt-react-native` e `gt-tanstack-start` sono tutti passati alla versione 11, insieme a `gt-i18n` 1.0 e `generaltranslation` 9.0. Questo rilascio aveva due obiettivi: rendere il runtime i18n più facile da estendere ad altri framework e ridurre la quantità di codice di General Translation distribuita agli utenti. Il risultato è una base condivisa con procedure di setup più chiare per le app eseguite solo nel browser e per quelle con rendering lato server. ## Supporto nativo per Pages Router La modifica più importante visibile agli utenti nella v11 è il supporto diretto per il Pages Router di Next.js in `gt-next`. In precedenza, le app con Pages Router dovevano usare `gt-react`. Ora possono usare [`withGTServerSideProps()`](/docs/react/nextjs-pages-router-quickstart) per caricare l'impostazione regionale e lo snapshot delle traduzioni, quindi passarli entrambi a [``](/docs/react/reference/components/gt-provider) in `_app.tsx`. La v11 introduce anche [`withGTStaticProps()`](/docs/react/nextjs/pages-router-static-site-generation) per la generazione statica. La versione 11.1.3 ha spostato la configurazione di routing consigliata dal middleware di `gt-next` al [routing internazionalizzato di Next.js](/docs/react/nextjs/pages-router-middleware). ## Procedura di setup aggiornata * **SPA React** - Inizializza `gt-react` con [`initializeGTSPA()`](/docs/react/reference/config#initialize-spa) prima del caricamento dell'app. L'inizializzatore risolve in anticipo l'impostazione regionale e le traduzioni, quindi le SPA non hanno più bisogno di un provider. Vedi [React SPA Quickstart](/docs/react/react-spa-quickstart). * **React con rendering lato server** - Inizializza il runtime una sola volta, quindi risolvi sul server l'impostazione regionale della richiesta e lo snapshot delle traduzioni. Passa sia `locale` sia `translations` a [``](/docs/react/reference/components/gt-provider) per un'idratazione sincrona. Vedi [server-rendered React Quickstart](/docs/react/react-quickstart). * **TanStack Start** - Risolvi l'impostazione regionale e lo snapshot delle traduzioni nel loader root, quindi passali entrambi a [``](/docs/react/reference/components/gt-provider). La selezione dell'impostazione regionale viene mantenuta anche tramite il cookie dell'impostazione regionale configurato. Vedi [TanStack Start Quickstart](/docs/react/tanstack-start-quickstart). ## Un runtime più piccolo e più estensibile La versione 11 rimuove il codice di cui le app client non hanno bisogno e rende i pacchetti più facili da ottimizzare con il tree-shaking da parte dei bundler. Anche i percorsi di traduzione usati solo in sviluppo possono essere esclusi dalle build di produzione. Nel nostro benchmark di produzione per Next.js, il codice JavaScript client attribuito a GT è sceso da circa 251 KB a 108 KB: una **riduzione del 57,1%**. Questa misura riguarda la porzione di General Translation del bundle client, non l'intero bundle dell'applicazione. Esplora i dati su pacchetti ed entry point in [Odysseus Bundle Size Tracker](https://odysseus-bundlesize.vercel.app/). Lo stesso refactoring ci fornisce una base comune per supportare più framework. ## In futuro Prevediamo di continuare a ridurre il bundle lato client. Il prossimo passo sarà modularizzare funzionalità come la traduzione del dizionario e l'hot reload in sviluppo, in modo che le app includano solo le funzionalità che utilizzano. Prevediamo inoltre di affidarci maggiormente a un'architettura basata su compilatore. Spostare più lavoro al build time anziché al runtime dovrebbe ridurre il JavaScript lato client e il sovraccarico a runtime, semplificando al tempo stesso il supporto di un numero maggiore di framework. ## Link * [PR #1439 del progetto Odysseus](https://github.com/generaltranslation/gt/pull/1439) * [PR #1837 del rilascio della versione 11](https://github.com/generaltranslation/gt/pull/1837) ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.