戻る

gt-next@6.14.0

Jackie Chen avatarJackie Chen
gt-nextgt-i18ngt-nodegt-tanstack-startversion-idhooki18n

概要

新しい useVersionId フックと getVersionId ヘルパー関数が、すべての GT JavaScript パッケージで利用できるようになりました。これにより、runtime に GT の設定から _versionId を読み取れます。デバッグ、キャッシュバスティング、ログ記録、現在有効になっている翻訳のバージョンの追跡に役立ちます。

PackageVersionExport
gt-next6.14.0useVersionId (クライアント + サーバー) 、getVersionId (関数)
gt-i18n0.7.0getVersionId (関数)
gt-node0.4.0getVersionId (関数)
gt-tanstack-start0.2.0getVersionId (関数)
gt-i18n (Python)0.3.0get_version_id() (関数)
gt-fastapi0.3.0get_version_id() (関数)
gt-flask0.3.0get_version_id() (関数)

使用方法

Next.js (クライアント)

import { useVersionId } from 'gt-next';

function DebugFooter() {
  const versionId = useVersionId();
  return <footer>Translation version: {versionId ?? 'unknown'}</footer>;
}

Next.js (サーバー)

import { useVersionId } from 'gt-next/server';

export default function Page() {
  const versionId = useVersionId();
  // サーバーコンポーネント、ログ、ヘッダーなどで使用
}

Node / 非React

import { getVersionId } from 'gt-i18n';
// または: import { getVersionId } from 'gt-node';

console.log('現在の翻訳バージョン:', getVersionId());

Python (gt-fastapi / gt-flask)

from gt_i18n import get_version_id
# または: from gt_fastapi import get_version_id
# または: from gt_flask import get_version_id

print("Current translation version:", get_version_id())

initialize_gt() に version_id を直接渡すこともできます：

initialize_gt(version_id="abc123", ...)

設定

gt.config.json で _versionId を設定します。この値は、translate コマンドを実行すると CLI によって自動的に設定されます。

{
  "defaultLocale": "en",
  "locales": ["en", "es", "fr"],
  "_versionId": "abc123"
}

次は

ロケールとバージョン ID に runtime でアクセスできるようになったので、次のステップは アナリティクスのトラッキング です。これにより、実際にどの翻訳がレンダリングされたのかを、対応するアナリティクスイベントとあわせて開発者が把握できるようになります。

導入を予定しているのは、ハッシュの集約です。<T>、gt()、m() のような翻訳コンポーネントが runtime で解決されるたびに、それらのハッシュを追跡可能な集合として収集します。新しい useAnalytics() フックにより、アナリティクスイベントが発火した時点で、現在解決済みのハッシュ集合を開発者が参照できるようになります。また、<AnalyticsScope> ラッパーを使えば、その収集対象を React ツリー内の特定の部分に限定できます。