# General Translation Changelog: gt-react 11.0.0: Reactフレームワーク共通のランタイム
URL: https://generaltranslation.com/ja/blog/gt-react_v11_0_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Ernest McCarter
Published: 2026-07-03

## 概要

`gt-react` 11 は、React ライブラリ群にまたがる General Translation の統合リリースの中核です。`gt-react`、`gt-next`、`@generaltranslation/react-core`、`gt-react-native`、`gt-tanstack-start` はすべてバージョン 11 に更新され、あわせて `gt-i18n` 1.0 と `generaltranslation` 9.0 もリリースされました。

このリリースの目標は 2 つありました。i18n ランタイムをより多くのフレームワークに拡張しやすくすることと、ユーザーに配布される General Translation のコード量を減らすことです。その結果、ブラウザ専用アプリとサーバーレンダリング対応アプリの両方で、より明確なセットアップフローを備えた共通基盤が実現しました。

## Pages Router のファーストクラスサポート

v11 におけるユーザー向けの最大の変更点は、`gt-next` で Next.js Pages Router が直接サポートされたことです。これまでは、Pages Router アプリでは `gt-react` を使用する必要がありました。現在では、[`withGTServerSideProps()`](/docs/react/nextjs-pages-router-quickstart) を使ってロケールと翻訳スナップショットを読み込み、その両方を `_app.tsx` の [`<GTProvider>`](/docs/react/reference/components/gt-provider) に渡せます。

また、v11 では静的生成向けの [`withGTStaticProps()`](/docs/react/nextjs/pages-router-static-site-generation) も追加されています。バージョン 11.1.3 では、推奨されるルーティングのセットアップが `gt-next` のミドルウェアから [Next.js の国際化ルーティング](/docs/react/nextjs/pages-router-middleware) に移行しました。

## 更新されたセットアップフロー

* **React SPAs** - アプリの読み込み前に、[`initializeGTSPA()`](/docs/react/reference/config#initialize-spa) で `gt-react` を初期化します。初期化時にロケールと翻訳があらかじめ解決されるため、SPA ではプロバイダーは不要になりました。[React SPA Quickstart](/docs/react/react-spa-quickstart) を参照してください。
* **サーバーレンダリング React** - ランタイム を一度初期化したうえで、サーバー側で request ロケールと翻訳スナップショットを解決します。同期 hydration のため、`locale` と `translations` の両方を [`<GTProvider>`](/docs/react/reference/components/gt-provider) に渡します。[サーバーレンダリング React Quickstart](/docs/react/react-quickstart) を参照してください。
* **TanStack Start** - root loader でロケールと翻訳スナップショットを解決し、その両方を [`<GTProvider>`](/docs/react/reference/components/gt-provider) に渡します。ロケールの選択は、設定されたロケール cookie を通じて保持されます。[TanStack Start Quickstart](/docs/react/tanstack-start-quickstart) を参照してください。

## より小さく、より拡張しやすい ランタイム

バージョン11では、クライアントアプリに不要なコードを削除し、パッケージをバンドラがよりツリーシェイクしやすくしています。開発専用の翻訳パスも、本番ビルドから除外できるようになりました。

本番環境の Next.js ベンチマークでは、GT によるクライアント JavaScript は約251 KBから108 KBへと減少しました。これは **57.1%の削減** です。この数値はクライアントバンドル全体ではなく、そのうち General Translation が占める部分を測定したものです。パッケージおよびエントリポイントのデータは、[Odysseus Bundle Size Tracker](https://odysseus-bundlesize.vercel.app/) で確認できます。

このリファクタリングにより、より多くのフレームワークをサポートするための共通基盤も整いました。

## 今後

今後も、クライアントバンドルの削減を進めていく予定です。次の段階では、dictionary 翻訳や開発時のホットリロードといった機能をモジュール化し、アプリが実際に使う機能だけを含めて配布できるようにしたいと考えています。

また、今後はコンパイラ主導のアーキテクチャにもさらに注力していく予定です。ランタイムではなくビルド時により多くの処理を移すことで、クライアント JavaScript とランタイムオーバーヘッドを削減しつつ、より多くのフレームワークをサポートしやすくなるはずです。

## リンク

* [Project Odysseus PR #1439](https://github.com/generaltranslation/gt/pull/1439)
* [Version 11 のリリース PR #1837](https://github.com/generaltranslation/gt/pull/1837)

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
