i18next에서 Intlayer로 마이그레이션

상세한 단계별 튜토리얼은 i18next 마이그레이션 가이드를 참고하세요.

Intlayer는 i18next의 핵심 런타임 특성을 완벽하게 복제합니다. compat package를 활용하면 Vanilla 애플리케이션이나 내부 모듈에서 익숙한 구문을 계속 사용할 수 있습니다.

수행할 작업

먼저 프로젝트에서 Intlayer를 초기화하세요:

npx intlayer init

Vite를 사용 중인 경우 Intlayer plugin을 포함하여 import를 @intlayer/i18next로 라우팅하세요:

import { defineConfig } from "vite";import { i18nextVitePlugin } from "@intlayer/i18next/plugin";export default defineConfig({  plugins: [i18nextVitePlugin()],});

내부 동작 원리

i18nextVitePlugin은 i18next import를 @intlayer/i18next로 별칭 지정하여 JSON 파일 포함으로 인한 bundle 팽창을 방지합니다.

내부적으로:

• Instance 구성: createInstance는 namespace fallback을 올바르게 파싱하고 적용하며 dictionary 검색을 위해 Intlayer의 컴파일 파이프라인을 활용합니다.
• Interpolation: {{name}} 대체 및 $t(key) nesting 재귀에 대한 기본 지원.
• Context & Plurals: key_male 및 key_one/key_other 같은 접미사 형식을 식별하고 해결하며 표준 Intl.PluralRules에 대해 평가합니다.
• Return objects: returnObjects: true 모드는 Intlayer dictionary에서 트리를 안전하게 추출합니다.