Retour

compiler v1.0.0 + gt-next@6.7.0

Ernest McCarter avatarErnest McCarter
@general-translation/compilerv1.0.0compilertranslationi18n

Vue d’ensemble

Nous sommes très heureux d’annoncer la sortie de @general-translation/compiler v1.0.0.

Comme nous l’avons indiqué dans notre version gt-next@6.2.0, nous pensons que l’avenir des bibliothèques i18n réside dans le traitement au moment du build. Plus tôt cette année, nous avons publié un plugin SWC pour gt-next qui a permis des optimisations comme le hachage au moment de la compilation et une meilleure traduction des chaînes en environnement de développement. Bien que cela ait constitué une excellente (quoique intense) introduction aux plugins de compilateur pour notre équipe, sa portée était limitée aux projets Next.js uniquement.

Nous tenons notre engagement en faveur du traitement au moment du build en publiant ce plugin de compilateur React générique. Cela signifie que toutes les optimisations de build de gt-next sont désormais disponibles pour chaque utilisateur de gt-react !

Configuration

Configuration

OptionTypeDefaultDescription
compileTimeHashbooleantrueActive le hachage au moment de la compilation
disableBuildChecksbooleanfalseDésactive la levée d’erreurs lorsqu’une utilisation invalide de la bibliothèque est détectée
logLevelstring'warn'Contrôle le niveau de journalisation. Options : 'silent' | 'error' | 'warn' | 'info' | 'debug'

Remarque : Pour gt-next, afin de respecter une exigence de rétrocompatibilité, si vous définissez compileTimeHash sur false, l’ensemble du plugin sera désactivé.

gt-react

Vous devez d’abord installer le package :

npm install @generaltranslation/compiler

Vite

// vite.config.js
import { defineConfig } from 'vite'
import { vite as gtCompiler } from '@generaltranslation/compiler'

export default defineConfig({
  plugins: [gtCompiler()],
})

Webpack

// webpack.config.js
const { webpack: gtCompiler } = require('@generaltranslation/compiler')

module.exports = {
  plugins: [gtCompiler()],
}

Rollup

// rollup.config.js
import { rollup as gtCompiler } from '@generaltranslation/compiler'

export default {
  plugins: [gtCompiler()],
}

gt-next

Vous n'avez pas besoin d'installer de packages supplémentaires.

Pour gt-next, nous abandonnons progressivement experimentalSwcPluginOptions au profit du nouveau champ experimentalCompilerOptions. La principale différence est que vous devez désormais spécifier le type de compilateur à utiliser : 'swc' ou 'babel'. Le compilateur 'swc' est utilisé par défaut, mais vous pouvez activer le nouveau compilateur basé sur Babel en définissant le champ type sur 'babel'.

// next.config.js
import { withGTConfig } from 'gt-next'

export default withGTConfig(nextConfig, {
  experimentalCompilerOptions: {
    type: 'babel',
  },
})

Conclusion

Nous avons encore beaucoup d’améliorations prévues pour le compilateur, attendez-vous donc à des mises à jour fréquentes au cours des prochains mois.