Androidアプリケーションサンプル
ローカライズ

非英語ネーティブによるローカライズ手法

• まず国際化に対応したアプリを英語で作ります。
• 次にこのアプリを開発者の母国語対応に現地化します。私の場合は日本語です。
• 同じ方法で他国語にも対応可能です。例えば、韓国語であれば、韓国語が話せる人に協力が得られれば、ローカライズは簡単です。

最初に英語をサポートすることでまず世界のそれなりの部分に対応できます。 英語圏の人のみならず、母国語は異なるが英語はある程度わかるという人が多いからです。 あとは必要と余力に応じ英語と自身の母国語以外の対応言語を増やしていけます。

以下、この手法を使ってAndroidアプリのローカライズを行ってみます。 Android OSが提供している国際化のしくみは非英語ネーティブ手法と相性がよいため、素直にローカライズを行うことができました。

[res/values/strings.xml]

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="app_name">Internationalization and Localization</string>
    <string name="hello">Hello World.</string>
    <string name="byebye">Bye bye World</string>
    <string name="button">Change Text</string>
</resources>

次が日本語のリソースファイルです。

[res/values-ja/strings.xml]

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <string name="app_name">国際化と現地化</string>
   <string name="hello">こんにちは、みなさん</string>
   <string name="byebye">さようなら、みなさん</string>
   <string name="button">テキストを変える</string>
</resources>

おわかりのように、helloやbyebyeなどをキーにして、英語、日本語それぞれの言語の挨拶文が取得できるというわけです。

この判断はAndroid側が自動的に行ってくれます。 しくみは簡単。 現在の言語設定がxxであれば、values-xxに収められているstrings.xmlを参照します。 日本語の場合はvalues-ja、英語の場合はvalues-enです。 xxにあたるvalues-xxが用意されていない場合は、xxの付かないただのvaluesの下のstrings.xmlが参照されます。 つまり、values-xxが用意されている言語についてはその中のstrings.xmlが参照され、それ以外の場合はデフォルトのvaluesの中のstrings.xmlが参照されるというしくみです。

非英語ネーティブ手法では、デフォルトが英語、私の母国語の日本語がひとつめのローカライズ対象であるので、英語文字列はvalues/strings.xmlに、日本語文字列はvalues-ja/strings.xmlに置きます。 言語設定が日本語の場合のみvalues-ja/strings.xmlが使われ、それ以外の場合はデフォルトのvalues/strings.xmlが使われます。 つまり、言語設定が英語（en）であれ、韓国語（ko）であれ、ドイツ語（de）であれ、表示は英語になります。

[src/sample.i18n/I18N.java]

public class I18N extends Activity ... {

    ...

    public void onClick(View v) {
        if (v.getId() == R.id.button1) {
            String greeing = getString(R.string.byebye);
            textView.setText(greeting);
        }
    }
}

上記のgetStringは、アクティビティクラス（android.app.Activity）の親クラスのひとつ、コンテキストクラス（android.content.Context）で定義されたメソッドです。 このようにアクティビティの中から一発呼び出しでローカライズ文字列が取得できます。

ここで「R.string」というのは何か、疑問がわくでしょう。
これはAndroidプラグインが、リソースファイルに文字列を追加すると自動的に生成してくれるIDです。 アプリケーションフォルダーのgenフォルダーの下のR.javaに収められています。

[gen/sample.i18n/R.java]

/* AUTO-GENERATED FILE.  DO NOT MODIFY.
 *
 * This class was automatically generated by the
 * aapt tool from the resource data it found.  It
 * should not be modified by hand.
 */

package sample.i18n;

public final class R {
    public static final class attr {
    }
    public static final class drawable {
        public static final int icon=0x7f020000;
    }
    public static final class id {
        public static final int button1=0x7f050001;
        public static final int textView1=0x7f050000;
    }
    public static final class layout {
        public static final int main=0x7f030000;
    }
    public static final class string {
        public static final int app_name=0x7f040000;
        public static final int button=0x7f040003;
        public static final int byebye=0x7f040002;
        public static final int hello=0x7f040001;
    }
}

文字列以外にも、アイコンなどの画像ファイル、レイアウト定義、UI部品も、同様にIDで参照されることがわかります。

[res/layout/main.xml]

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <TextView android:layout_weight="0.9" android:id="@+id/textView1"
        android:text="@string/hello" android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center" android:isScrollContainer="true"
        android:background="#AAAAAA" android:textColor="#333333">
    </TextView>
    <Button android:layout_width="match_parent"
        android:layout_height="wrap_content" android:id="@+id/button1"
        android:layout_weight="0.1" android:text="@string/button"
        android:gravity="center">
    </Button>
</LinearLayout>

レイアウトXMLファイルからの文字列リソース参照の書式は「@string/<id>」です。 画面の中央に表示されるテキストビュー（TextView）には「hello」が指定されています。 これは英語の場合は「Hello World」です。 画面の下部のボタン（Button）の名前は「button」が設定されているので、英語の場合は「Change Text」になります。

[AndroidManifest.xml]

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android= ...

    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".I18N"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

[src/sample.i18n/I18N.java]

package sample.i18n;

import java.util.Locale;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.TextView;

// Sample application for demonstrating non-English-speaker's
// localization strategy.
// 2011 Apr 17 Written for test by ARAI, Bunkichi, Kobu.Com,
// 2011 Jul 24 Updated for demonstration

public class I18N extends Activity implements OnClickListener {
    
    private String logtag = getClass().getSimpleName();
    
    private TextView textView;
    
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    
        textView = (TextView) findViewById(R.id.textView1);
        
        Button button = (Button) findViewById(R.id.button1);
        button.setOnClickListener(this);
        
        Locale locale = Locale.getDefault(); // current locale
         Locale locale = getResources().getConfiguration().locale;  or you can ...
        Log.d(logtag, "lang = " + locale.getLanguage());
    }

    @Override
    public void onClick(View v) {
        if (v.getId() == R.id.button1) {
            textView.setText(getString(R.string.byebye)); // set localized text
             textView.setText(R.string.byebye);  or you can do it faster
        }
    }
}

以上がAndroidアプリケーションのローカライズの簡単な実例でした。

上記ソースコードのほか、これまでに掲載した外部リソースファイルも、下記のEclipseプロジェクトに含まれています。

ダウンロード: Eclipse Androidアプリケーションプロジェクト - I18N.zip