このページとあなたの好きなAIアシスタントを使ってドキュメントを要約します
このページのコンテンツはAIを使用して翻訳されました。
英語の元のコンテンツの最新バージョンを見るIf you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.
GitHub link to the documentationCopy doc Markdown to clipboard
React Nativeアプリを翻訳するためのi18nソリューションの探求
世界がますますグローバル化する中で、複数の言語でReact Nativeアプリを提供することは、アクセシビリティとユーザー満足度を大幅に向上させることができます。国際化（i18n）は、翻訳を効果的に管理するための中心的な要素であり、言語特有のテキスト、日付や時間の形式、通貨などを、コードベースを複雑にすることなく表示することを可能にします。この記事では、専用ライブラリからより一般的なソリューションに至るまで、さまざまなi18nアプローチを掘り下げ、あなたのReact Nativeプロジェクトに最適なものを見つける手助けをします。
国際化（i18n）とは？
国際化、またはi18nは、アプリケーションを構造化して、さまざまな言語、地域の形式、文化的規範に簡単に適応できるようにすることを含みます。React Nativeにおけるi18nは、ボタンやラベルの文字列を扱うだけでなく、ユーザーのロケールに応じて日付、時間、通貨などをフォーマットすることも含まれます。適切に準備されたReact Nativeアプリは、後から追加の言語やロケール特有の動作をシームレスに統合できるため、大規模なリファクタリングなしに行うことができます。
国際化の概念についてさらに深く掘り下げるには、以下の記事をご覧ください：
国際化（i18n）とは？定義と課題。
React Nativeアプリケーションにおける翻訳の課題
React Nativeで翻訳を扱うことには、独自の考慮事項があります：
コンポーネントベースのアーキテクチャ
Web用のReactと同様に、React Nativeのモジュール設計ではテキストが多数のコンポーネントに散らばる可能性があります。これらの翻訳を堅牢な方法で中央集中的に管理することが重要です。オフラインおよびリモートデータ
一部の文字列はアプリ内に埋め込むことができますが、他のコンテンツ（例：ニュースフィード、製品データ）はリモートで取得される場合があります。非同期で到着するデータの翻訳を扱うことは、モバイルではより複雑になる可能性があります。プラットフォーム固有の動作
iOSとAndroidには、それぞれ独自のロケール設定とフォーマットの特異性があります。両プラットフォームでの日付、通貨、数字の一貫した表示を確保するには、徹底したテストが必要です。状態とナビゲーション管理
ユーザーが選択した言語を画面間で維持したり、ディープリンクやタブベースのナビゲーションで一貫させるには、i18nをRedux、Context API、またはその他の状態管理ソリューションに統合する必要があります。アプリの更新とオーバー・ザ・エア（OTA）
CodePushや別のOTA更新メカニズムを使用している場合、翻訳の更新や新しい言語がフルアプリストアリリースなしで提供される方法を計画する必要があります。
React Nativeのための主要なi18nソリューション
以下は、React Nativeでの多言語コンテンツ管理におけるいくつかの人気のあるアプローチです。それぞれが異なる方法で翻訳のワークフローを簡素化することを目指しています。
1. Intlayer
ウェブサイト: https://intlayer.org/
概要
Intlayerは、現代のJavaScriptアプリ（React Nativeを含む）における多言語サポートを簡素化することを目的とした革新的でオープンソースの国際化ライブラリです。翻訳に対する宣言的アプローチを提供し、コンポーネントと直接一緒に辞書を定義することを可能にします。
主な特徴
翻訳の宣言
単一のファイルやコンポーネントレベルで翻訳を保存し、テキストを見つけて修正するのを簡単にします。TypeScript & オートコンプリート
翻訳キーの型定義を自動的に生成し、開発者に優しいオートコンプリートと堅牢なエラーチェックを提供します。軽量 & 柔軟
不要なオーバーヘッドなしで、React Native環境で優れた動作をします。モバイルデバイスで効率的に統合するのが簡単です。プラットフォーム固有の考慮事項
必要に応じて、iOSとAndroidのプラットフォーム固有の文字列を適応または分離できます。非同期読み込み
翻訳辞書を動的に読み込むことができ、大規模なアプリや段階的な言語の展開に役立ちます。
考慮事項
- コミュニティ & エコシステム
まだ比較的新しいソリューションであるため、長年の実績があるライブラリに比べて、コミュニティ主導の例やすぐに使えるプラグインが少ないかもしれません。
2. React-i18next
ウェブサイト: https://react.i18next.com/
概要
React-i18nextは、人気のあるi18nextフレームワークを基に構築されており、柔軟なプラグインベースのアーキテクチャと堅牢な機能セットを提供します。設定プロセスがよく文書化されているため、React Nativeアプリでも広く使用されています。
主な特徴
スムーズなReact Native統合
i18nをシームレスにコンポーネントに統合するためのフック（useTranslation）、高階コンポーネント（HOC）、その他を提供します。非同期読み込み
大規模なアプリや新しい言語パックを追加する際に、必要に応じて翻訳を読み込むことができます。豊富な翻訳機能
ネストされた翻訳、補間、複数形、変数の置換をすぐに処理できます。TypeScript & オートコンプリート
React-i18nextは型付けされた翻訳キーをサポートしますが、初期設定は、型を自動生成するソリューションに比べて手動で行う必要があります。プラットフォーム非依存
i18nextは特にウェブやモバイルに結びついていないため、異なるプロジェクトタイプ間で同じライブラリを使用できます（例：ウェブとネイティブでコードを共有する場合）。
考慮事項
設定の複雑さ
高度な機能（複数形、フォールバックロケールなど）を使用したi18nの設定には、慎重な設定が必要です。パフォーマンス
React-i18nextは通常良好なパフォーマンスを発揮しますが、モバイルデバイス上でのオーバーヘッドを避けるために、翻訳リソースの組織と読み込み方法に注意しなければなりません。
3. React Intl (from FormatJS)
ウェブサイト: https://formatjs.io/docs/react-intl/
概要
React Intlは、FormatJSエコシステムの一部であり、さまざまなロケールに対するメッセージフォーマットの標準化を中心に構築されています。メッセージ抽出ワークフローを強調し、幅広いロケールに対して日付、数字、時間を正しくフォーマットするのに特に強力です。
主な特徴
フォーマットに特化したコンポーネント
<FormattedMessage>、<FormattedDate>、<FormattedTime>などが、iOSとAndroid間でのフォーマットタスクを簡素化します。軽量 & 拡張可能
必要なFormatJSの部分だけをインポートことができ、モバイルにとって重要です。サポートされていないロケール用のポリフィル
古いAndroidやiOSバージョンでの一貫した日付/数字フォーマットを保証します。TypeScript互換性
TypeScriptと統合されますが、完全に型付けされたメッセージIDを得るには追加のツールが必要です。
考慮事項
メッセージ抽出
抽出ワークフローが必要で、ビルドプロセスに複雑さを追加する可能性があります。ただし、多くの翻訳を管理する大規模なチームにとっては強力です。アプリサイズ & デプロイ
複数のポリフィルや大規模な翻訳ファイルに依存する場合、特にモバイル環境でアプリ全体のサイズに注意を払う必要があります。コミュニティの例
広く使用されていますが、Reactネイティブ特有の使用例は、Reactウェブよりも少ないかもしれません。既存の文書やパターンをネイティブ環境に適応させる必要があるでしょう。
4. LinguiJS
ウェブサイト: https://lingui.js.org/
概要
LinguiJSは、JavaScriptおよびReact（React Nativeを含む）向けのモダンで開発者フレンドリーなアプローチを提供します。CLIを使用したメッセージ抽出とコンパイルを通じて、ランタイムのオーバーヘッドを最小限に抑えることに重点を置いています。
主な特徴
自動メッセージ抽出
コード内の翻訳文字列をスキャンし、見逃しや未使用のメッセージのリスクを削減します。最小限のランタイムオーバーヘッド
コンパイルされた翻訳により、アプリのパフォーマンスを維持し、モバイルデバイス向けに最適化されています。TypeScript & オートコンプリート
適切に設定すれば、翻訳の型付けされたIDを取得でき、開発者のワークフローをより安全かつ直感的にします。React Nativeとの統合
React Native環境へのインストールとリンクが簡単で、必要に応じてプラットフォーム固有の翻訳を処理することもできます。
考慮事項
初期CLI設定
React Nativeプロジェクトのための抽出およびコンパイルパイプラインを設定するために、いくつかの追加の手順が必要です。コミュニティ & プラグイン
ライブラリのエコシステムはi18nextよりも小さいですが、急速に成長しており、コアCLIツールは堅実です。コードの整理
メッセージカタログをどのように分割するか（画面、機能、または言語ごと）を決定することは、大規模なアプリでの明確さを維持するために重要です。
最終的な考え
React Nativeアプリケーションのためにi18nソリューションを選択する際には：
要件を評価する
- 現在および将来、必要な言語は何ですか？
- 大規模なアプリに対してオンデマンド読み込みが必要ですか？
プラットフォームの違いに留意する
- すべてのライブラリがiOSとAndroidのロケールの違いをサポートしていることを確認してください。特に日付、数字、通貨の特異性に注意してください。
- オフライン使用を考慮してください。一部の翻訳はアプリにバンドルする必要があるかもしれませんが、他はリモートで取得できます。
スケーラビリティのための構造を選ぶ
- 大規模または長期にわたるアプリケーションを計画している場合、強力な抽出ワークフローや型付けされたキーが翻訳を整理された状態に保つのに役立ちます。
パフォーマンスとバンドルサイズ
- モバイルデータの制約により、翻訳ファイルやポリフィルのサイズに細心の注意を払う必要があります。
開発者体験（DX）
- チームのスキルセットに合ったライブラリを選択してください。一部のソリューションは冗長ですが簡単で、他のソリューションは設定の複雑さの代わりに自動化を提供します。
どのソリューション（Intlayer、React-i18next、React Intl、LinguiJS）もReact Native環境で効果的であることが証明されていますが、優先事項は少し異なります。 プロジェクトのロードマップ、開発者の好み、およびローカリゼーションのニーズを評価することで、真にグローバルなReact Nativeアプリを提供するための理想的な適合が見つかるでしょう。