Vue d’ensemble

Un nouveau hook useVersionId et une fonction utilitaire getVersionId sont désormais disponibles dans tous les packages JavaScript de GT. Ils vous permettent de consulter le _versionId de votre configuration GT à l’exécution — pratique pour le débogage, l’invalidation du cache, la journalisation et le suivi de la version de vos traductions actuellement utilisée.

Utilisation

Next.js (côté client)

import { useVersionId } from 'gt-next';

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

Next.js (serveur)

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

export default function Page() {
  const versionId = useVersionId();
  // utiliser dans les composants serveur, la journalisation, les en-têtes, etc.
}

Node / sans React

import { getVersionId } from 'gt-i18n';
// ou : import { getVersionId } from 'gt-node';

console.log('Version de traduction actuelle :', getVersionId());

Python (gt-fastapi / gt-flask)

from gt_i18n import get_version_id
# ou : from gt_fastapi import get_version_id
# ou : from gt_flask import get_version_id

print("Version de traduction actuelle :", get_version_id())

Vous pouvez aussi passer version_id directement à initialize_gt() :

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

Configuration

Définissez _versionId dans votre gt.config.json. Cette valeur est automatiquement renseignée par la CLI lorsque vous exécutez la commande translate :

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

Et ensuite

Avec la locale et l’identifiant de version désormais accessibles à l’exécution, la prochaine étape est le suivi analytique — pour offrir aux développeurs une visibilité sur les traductions réellement rendues en lien avec leurs événements analytics.

Le plan est d’introduire une agrégation de hash : à mesure que des composants de traduction comme <T>, gt() et m() sont résolus à l’exécution, leurs hash seraient regroupés dans un ensemble pouvant être suivi. Un nouveau hook useAnalytics() permettrait aux développeurs de consulter l’ensemble actuel des hash résolus au moment où un événement analytics est déclenché, et un wrapper <AnalyticsScope> permettrait de limiter cette collecte à des parties spécifiques de l’arborescence React.