Xamarin.Forms の文字列とイメージのローカライズ

[アーティクル]
11/01/2019

ローカライズは、ターゲット市場の特定の言語または文化の要件を満たすようにアプリケーションを適合させるプロセスです。ローカライズを実現するには、アプリケーションのテキストとイメージを複数の言語に翻訳する必要がある場合があります。ローカライズされたアプリケーションでは、モバイルデバイスのカルチャ設定に基づいて、翻訳されたテキストが自動的に表示されます。

iOS および Android のローカライズアプリケーションのスクリーンショット

.NET Framework には、Resx リソースファイルを使用してアプリケーションをローカライズするための組み込みメカニズムが用意されています。リソースファイルには、指定されたキーのコンテンツをアプリケーションで取得できるように、テキストやその他のコンテンツが名前と値のペアとして格納されます。リソースファイルを使用すると、ローカライズされたコンテンツをアプリケーションコードから分離できます。

リソースファイルを使用して Xamarin.Forms アプリケーションをローカライズするには、次の手順を実行する必要があります。

翻訳されたテキストを含む Resx ファイルを作成する。
共有プロジェクトで既定のカルチャを指定する。
Xamarin.Forms のテキストをローカライズします。
各プラットフォームのカルチャ設定に基づいてイメージをローカライズする。
各プラットフォームでアプリケーション名をローカライズする。
各プラットフォームでローカライズをテストする。

Resx ファイルを作成する

リソースファイルは、ビルド処理中にバイナリリソース (.resources) ファイルにコンパイルされた、.resx 拡張子を持つ XML ファイルです。 Visual Studio 2019 では、リソースの取得に使用される API を提供するクラスが生成されます。ローカライズされたアプリケーションには、通常、アプリケーションで使用されるすべての文字列を含む既定のリソースファイル、およびサポートされている各言語のリソースファイルが含まれています。このサンプルアプリケーションには、リソースファイルを含む共有プロジェクト内の Resx フォルダー、および AppResources.resx という名前の既定のリソースファイルがあります。

リソースファイルには、各項目に関する次の情報が含まれています。

[名前] では、コード内のテキストへのアクセスに使用されるキーが指定されます。
[値] では、翻訳済みテキストが指定されます。
[コメント] は、追加情報を含む省略可能なフィールドです。

Visual Studio 2019 では、[新しい項目の追加] ダイアログを使用してリソースファイルを追加します。

Visual Studio 2019 で新しいリソースを追加する

ファイルが追加されると、各テキストリソースに対して行を追加できるようになります。

.resx ファイルで既定のテキストリソースを指定する

[アクセス修飾子] ドロップダウン設定では、リソースへのアクセスに使用されるクラスが Visual Studio でどのように生成されるかが決定されます。 [アクセス修飾子] を [公開] または [内部] に設定すると、指定したアクセシビリティレベルを持つクラスが生成されます。 [アクセス修飾子] を [コード生成なし] に設定すると、クラスファイルは生成されません。既定のリソースファイルは、クラスファイルを生成するように構成する必要があります。これにより、.designer.cs 拡張子を持つファイルがプロジェクトに追加されます。

既定のリソースファイルが作成されたら、アプリケーションでサポートされるカルチャごとに追加のファイルを作成できます。追加の各リソースファイルでは、ファイル名に翻訳カルチャを含める必要があります。また、[アクセス修飾子] を [コード生成なし] に設定する必要があります。

実行時に、アプリケーションではリソース要求を特異性の順に解決することが試行されます。たとえば、デバイスのカルチャが en-US である場合、アプリケーションでは次の順序でリソースファイルが検索されます。

AppResources.en-US.resx
AppResources.en.resx
AppResources.resx (既定)

次のスクリーンショットは、AppResources.es.resx という名前のスペイン語の翻訳ファイルを示しています。

.resx ファイルで既定のスペイン語のテキストリソースを指定する

翻訳ファイルでは、既定のファイルに指定されているのと同じ [名前] 値が使用されますが、[値] 列にはスペイン語の文字列が含まれています。また、[アクセス修飾子] は [コード生成なし] に設定されています。

Visual Studio 2019 for Mac では、[新しい項目の追加] ダイアログを使用してリソースファイルを追加します。

Visual Studio 2019 for Mac で新しいリソースを追加する

既定のリソースファイルが作成されたら、リソースファイルの root 要素内に data 要素を作成することで、テキストを追加できます。

<?xml version="1.0" encoding="utf-8"?>
<root>
    ...
    <data name="AddButton" xml:space="preserve">
        <value>Add Note</value>
    </data>
    <data name="NotesLabel" xml:space="preserve">
        <value>Notes:</value>
    </data>
    <data name="NotesPlaceholder" xml:space="preserve">
        <value>e.g. Get Milk</value>
    </data>
</root>

.designer.cs クラスファイルを作成するには、リソースファイルのオプションで [カスタムツール] プロパティを設定します。

リソースファイルのプロパティで指定された [カスタムツール]

[カスタムツール] を [PublicResXFileCodeGenerator] に設定すると、public アクセスを持つクラスが生成されます。 [カスタムツール] を [InternalResXFileCodeGenerator] に設定すると、internal アクセスを持つクラスが生成されます。 [カスタムツール] 値が空の場合、クラスは生成されません。生成されたクラス名は、リソースファイル名と一致します。たとえば、AppResources.resx ファイルによって、AppResources.designer.cs という名前のファイルに AppResources クラスが作成されます。

サポートされているカルチャごとに、追加のリソースファイルを作成できます。各言語ファイルでは、ファイル名に翻訳カルチャを含める必要があるため、es-MX をターゲットとするファイルには AppResources.es-MX.resx という名前を付ける必要があります。

AppResources.en-US.resx
AppResources.en.resx
AppResources.resx (既定)

言語翻訳ファイルには、既定のファイルと同じ [名前] 値が指定されている必要があります。次の XML は、AppResources.es.resx という名前のスペイン語翻訳ファイルを示しています。

<?xml version="1.0" encoding="utf-8"?>
<root>
    ...
    <data name="NotesLabel" xml:space="preserve">
        <value>Notas:</value>
    </data>
    <data name="NotesPlaceholder" xml:space="preserve">
        <value>por ejemplo . comprar leche</value>
    </data>
    <data name="AddButton" xml:space="preserve">
        <value>Agregar nuevo elemento</value>
    </data>
</root>

既定のカルチャを指定する

リソースファイルが正常に機能するには、アプリケーションに NeutralResourcesLanguage 属性が指定されている必要があります。リソースファイルを含んでいるプロジェクトでは、AssemblyInfo.cs ファイルをカスタマイズして既定のカルチャを指定する必要があります。次のコードは、AssemblyInfo.cs ファイルで NeutralResourcesLanguage を en-US に設定する方法を示しています。

using System.Resources;

// The resources from the neutral language .resx file are stored directly
// within the library assembly. For that reason, changing en-US to a different
// language in this line will not by itself change the language shown in the
// app. See the discussion of UltimateResourceFallbackLocation in the
// documentation for additional information:
// https://learn.microsoft.com/dotnet/api/system.resources.neutralresourceslanguageattribute
[assembly: NeutralResourcesLanguage("en-US")]

警告

NeutralResourcesLanguage 属性を指定しない場合、ResourceManager クラスにより、特定のリソースファイルを持たないすべてのカルチャに対して null 値が返されます。既定のカルチャを指定した場合、ResourceManager により、サポートされていないカルチャに対して既定の Resx ファイルから結果が返されます。そのため、サポートされていないカルチャに対してテキストが表示されるように、常に NeutralResourcesLanguage を指定することをお勧めします。

既定のリソースファイルが作成され、AssemblyInfo.cs ファイルで既定のカルチャが指定されると、実行時にアプリケーションでは、ローカライズされた文字列を取得できます。

リソースファイルの詳細については、「Create resource files for .NET apps」(.NET アプリでのリソースファイルの作成) を参照してください。

iOS でサポートされる言語を指定する

iOS では、サポートされるすべての言語をプロジェクトの Info.plist ファイルで宣言する必要があります。 Info.plist ファイルで、[Source]\(ソース\) ビューを使用して CFBundleLocalizations キーの配列を設定し、Resx ファイルに対応する値を指定します。さらに、CFBundleDevelopmentRegion キーを使用して、予期される言語が設定されていることを確認します。

ローカライズのセクションを示す Info.plist エディターのスクリーンショット

または、XML エディターで Info.plist ファイルを開き、次を追加します。

<key>CFBundleLocalizations</key>
<array>
    <string>de</string>
    <string>es</string>
    <string>fr</string>
    <string>ja</string>
    <string>pt</string> <!-- Brazil -->
    <string>pt-PT</string> <!-- Portugal -->
    <string>ru</string>
    <string>zh-Hans</string>
    <string>zh-Hant</string>
</array>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>

Note

Apple では、ポルトガル語の扱いが予期したものとは若干異なる可能性があります。詳細については、developer.apple.com の「Adding Languages」(言語の追加) を参照してください。

詳細については、「Info.plst での既定の言語とサポートされる言語の指定」を参照してください。

UWP でサポートされる言語を指定する

これは、サイドローディングまたはストア用にアプリをパッケージ化するときにアプリバンドルを生成する場合にのみ必要です。 UWP アプリバンドルの生成時に、バンドルがインストールされている場合は、インストールデバイスの言語設定に関連するリソースのみが読み込まれます。そのため、デバイスの言語設定が英語のみの場合は、英語のリソースだけがアプリとともにインストールされます。詳細と手順については、「Windows 8.1 ストアアプリ: デバイスにリソースが必要かどうかにかかわらず、必ずリソースをデバイスにインストールする」を参照してください。

Xamarin.Forms のテキストをローカライズする

Xamarin.Forms では、テキストは、生成される AppResources クラスを使用してローカライズされます。このクラスには、既定のリソースファイル名に基づいた名前が付けられます。サンプルプロジェクトのリソースファイルは AppResources.resx という名前であるため、Visual Studio では、AppResources という名前の一致するクラスが生成されます。静的プロパティは、リソースファイル内の行ごとに AppResources クラスで生成されます。サンプルアプリケーションの AppResources クラスでは、次の静的プロパティが生成されます。

AddButton
NotesLabel
NotesPlaceholder

これらの値に x:Static プロパティとしてアクセスすると、ローカライズされたテキストを XAML で表示できます。

<ContentPage ...
             xmlns:resources="clr-namespace:LocalizationDemo.Resx">
    <Label Text="{x:Static resources:AppResources.NotesLabel}" />
    <Entry Placeholder="{x:Static resources:AppResources.NotesPlaceholder}" />
    <Button Text="{x:Static resources:AppResources.AddButton}" />
</ContentPage>

ローカライズされたテキストは、次のようにコードで取得することもできます。

public LocalizedCodePage()
{
    Label notesLabel = new Label
    {
        Text = AppResources.NotesLabel,
        // ...
    };

    Entry notesEntry = new Entry
    {
        Placeholder = AppResources.NotesPlaceholder,
        //...
    };

    Button addButton = new Button
    {
        Text = AppResources.AddButton,
        // ...
    };

    Content = new StackLayout
    {
        Children = {
            notesLabel,
            notesEntry,
            addButton
        }
    };
}

AppResources クラスのプロパティでは、System.Globalization.CultureInfo.CurrentUICulture の現在の値を使用して、値を取得するカルチャリソースファイルが決定されます。

イメージをローカライズする

Resx ファイルには、テキストを格納するだけでなく、テキスト以外のイメージやバイナリデータを格納することもできます。ただし、モバイルデバイスにはさまざまな画面サイズと密度があり、各モバイルプラットフォームには、密度に依存したイメージを表示する機能があります。そのため、リソースファイルにイメージを格納する代わりに、プラットフォームイメージのローカライズ機能を使用する必要があります。

Android でイメージをローカライズする

Android の場合、ローカライズされたドローアブル (イメージ) は、Resources ディレクトリ内のフォルダーの名前付け規則を使用して格納されます。フォルダーには、ターゲット言語のサフィックスの付いた drawable という名前が付けられます。たとえば、スペイン語の言語のフォルダーには drawable-es という名前が付けられます。

4 文字のロケールコードが必要な場合、Android では、ダッシュの後に r を追加する必要があります。たとえば、メキシコロケール (es-MX) フォルダーには、drawable-es-rMX という名前を付ける必要があります。各ロケールフォルダー内のイメージファイル名は同じである必要があります。

Android プロジェクト内のローカライズされたイメージ

詳細については、「Android Localization」(Android のローカライズ) を参照してください。

iOS でイメージをローカライズする

iOS の場合、ローカライズされたイメージは、Resources ディレクトリ内のフォルダーの名前付け規則を使用して格納されます。既定のフォルダーには、Base.lproj という名前が付けられます。言語固有のフォルダーの名前としては、言語またはロケールの名前の後に lproj が付けられます。たとえば、スペイン語のフォルダーには es.lproj という名前が付けられます。

4 文字のローカルコードは、2 文字の言語コードと同じように動作します。たとえば、メキシコロケール (es-MX) フォルダーには、es-MX.lproj という名前を付ける必要があります。各ロケールフォルダー内のイメージファイル名は同じである必要があります。

iOS プロジェクト内のローカライズされたイメージ

Note

iOS では、.lproj フォルダー構造を使用する代わりに、ローカライズされたアセットカタログの作成がサポートされています。ただし、これらは Xcode で作成および管理する必要があります。

詳細については、「iOS Localization」(iOS のローカライズ) を参照してください。

UWP でイメージをローカライズする

UWP の場合、ローカライズされたイメージは、Assets/Images ディレクトリ内のフォルダーの名前付け規則を使用して格納されます。フォルダーには、言語またはロケールの名前が付けられます。たとえば、スペイン語のフォルダーには es、メキシコロケールフォルダーには es-MX という名前を付ける必要があります。各ロケールフォルダー内のイメージファイル名は同じである必要があります。

UWP プロジェクト内のローカライズされたイメージ

詳細については、UWP のローカライズに関するページを参照してください。

ローカライズされたイメージを使用する

各プラットフォームでは一意のファイル構造を持つイメージが格納されるため、XAML では OnPlatform クラスを使用して、現在のプラットフォームに基づいて ImageSource プロパティが設定されます。

<Image>
    <Image.Source>
        <OnPlatform x:TypeArguments="ImageSource">
            <On Platform="iOS, Android" Value="flag.png" />
            <On Platform="UWP" Value="Assets/Images/flag.png" />
        </OnPlatform>
    </Image.Source>
</Image>

Note

OnPlatform マークアップ拡張機能では、プラットフォーム固有の値をより簡潔に指定する方法が提供されます。詳細については、「OnPlatform markup extension」(OnPlatform マークアップ拡張機能) を参照してください。

イメージソースは、コードの Device.RuntimePlatform プロパティに基づいて設定できます。

string imgSrc = Device.RuntimePlatform == Device.UWP ? "Assets/Images/flag.png" : "flag.png";
Image flag = new Image
{
    Source = ImageSource.FromFile(imgSrc),
    WidthRequest = 100
};

アプリケーション名をローカライズする

アプリケーション名はプラットフォームごとに指定され、Resx リソースファイルは使用されません。 Android でアプリケーション名をローカライズする方法については、Android でのアプリ名のローカライズに関するページを参照してください。 iOS でアプリケーション名をローカライズする方法については、iOS でのアプリ名のローカライズに関するページを参照してください。 UWP でアプリケーション名をローカライズする方法については、UWP パッケージマニフェストでの文字列のローカライズに関するページを参照してください。

ローカライズをテストする

ローカライズのテストは、デバイスの言語を変更して実行することをお勧めします。コードで System.Globalization.CultureInfo.CurrentUICulture の値を設定することはできますが、プラットフォーム間で動作が一貫しないため、テストにはお勧めできません。

iOS では、設定アプリで、デバイスの言語を変更せずに、アプリごとに特定の言語を設定できます。

Android では、アプリケーションの起動時に言語設定が検出され、キャッシュされます。言語を変更した場合は、アプリケーションを終了してから再起動し、変更が適用されていることを確認する必要があります。

次の方法で共有

Xamarin.Forms の文字列とイメージのローカライズ

Resx ファイルを作成する

既定のカルチャを指定する

iOS でサポートされる言語を指定する

UWP でサポートされる言語を指定する

Xamarin.Forms のテキストをローカライズする

イメージをローカライズする

Android でイメージをローカライズする

iOS でイメージをローカライズする

UWP でイメージをローカライズする

ローカライズされたイメージを使用する

アプリケーション名をローカライズする

ローカライズをテストする

その他のリソース

次の方法で共有

Xamarin.Forms の文字列とイメージのローカライズ

Resx ファイルを作成する

既定のカルチャを指定する

iOS でサポートされる言語を指定する

UWP でサポートされる言語を指定する

Xamarin.Forms のテキストをローカライズする

イメージをローカライズする

Android でイメージをローカライズする

iOS でイメージをローカライズする

UWP でイメージをローカライズする

ローカライズされたイメージを使用する

アプリケーション名をローカライズする

ローカライズをテストする

関連リンク

その他のリソース