Unicode と国際化のサポート

Android は ICU ライブラリと CLDR プロジェクトを活用して、Unicode や各種国際化をサポートしています。このページでは、Unicode と国際化のサポートについて、Android 6.0（API レベル 23）以前と Android 7.0（API レベル 24）以降の 2 つのセクションに分けて説明します。

Android 6.0（API レベル 23）以前の Unicode と国際化のサポート

Android プラットフォームは、ICU と CLDR を使用して、ラテン文字と非ラテン文字の両方を処理するためのさまざまなクラスを実装し、Locale クラスや Character クラス、ならびに java.text の各種サブクラスなどのクラスをエクスポーズします。Android 6.0（API レベル 23）以前のプラットフォームのバージョンをターゲットとするアプリが、エクスポーズしたクラスを超える国際化機能を実装する場合、ICU ライブラリを含める必要があります。

バージョニング

Android プラットフォームの各リリースは、それぞれその時点の ICU の最新バージョン、および対応する CLDR バージョンと Unicode バージョンに対応しています。Android 6.0（API レベル 23）以前の対応状況を表 1 に示します。

表 1. Android 6.0（API レベル 23）以前のリリースで使用される ICU と CLDR のバージョン

Android フレームワークは、Android 7.0（API レベル 24）以降をターゲットとするアプリに対する Unicode と国際化のサポートをより包括的に提供します。次のセクションでは、このサポートについて詳しく説明します。

Android 7.0（API レベル 24）以降の Unicode と国際化のサポート

Android 7.0（API レベル 24）以降の場合、Android プラットフォームは、アプリ デベロッパーが使用できる ICU4J API のサブセットを android.icu パッケージ内でエクスポーズします。 ICU4J は、ソフトウェア アプリで Unicode と国際化をサポートする際に広く利用されているオープンソースの Java ライブラリ セットです。

ICU4J API は、デバイス上に存在するローカライズ データを使用します。そのため、ICU4J ライブラリをアプリに組み込まないことで、アプリのフットプリントを削減することができます。その場合はフレームワーク内のライブラリを呼び出すことができます。これを行う場合は、複数バージョンの APK を提供して、Android 7.0（API レベル 24）よりも前のバージョンの Android を実行しているユーザーが、ICU4J ライブラリを含むバージョンのアプリをダウンロードできるようにすることをおすすめします。

このセクションでは、まず、ライブラリをサポートする際に必要となる最小 Android API レベルの基本情報について説明します。次に、Android 固有の ICU4J 実装について知っておくべき情報について説明します。最後に、Android フレームワーク内で ICU4J API を使用する方法について説明します。

Android 上の ICU4J

Android は、com.ibm.icu パッケージではなく android.icu パッケージを通じて、ICU4J API のサブセットをエクスポーズします。一部の ICU4J API は、API のサポート終了や安定版として宣言されていないなどの理由で、Android フレームワークからエクスポーズされません。ICU チームが API のサポートを終了した場合、Android もその API をサポート終了としてマーキングしますが、API 自体は引き続き組み込まれた状態を維持します。

以下の点に注意してください。

• ICU4J Android フレームワーク API には、必ずしもすべての ICU4J API が含まれているわけではありません。
• Android フレームワーク内の API は、リソースを使用したローカライズのサポートに代わるものではありません。
• 場合によっては、Android フレームワークの方が、ICU ライブラリよりも多くの文字をサポートしていることがあります。たとえば、android.text クラスの絵文字のサポートがこれに該当します。

com.ibm.icu パッケージから android.icu パッケージに移行する

すでにアプリ内で ICU4J API を使用していて、android.icu API が要件を満たしている場合、フレームワーク API に移行するには、Java インポートを com.ibm.icu から android.icu に変更する必要があります。移行後は、ICU4J ファイルのコピーをアプリから削除できます。

注: ICU4J フレームワーク API は、com.ibm.icu 名前空間ではなく、android.icu 名前空間を使用します。これは、アプリ内で独自の com.ibm.icu ライブラリを使用している場合に、名前空間の競合が発生しないようにするためです。

他の Android SDK API から android.icu API に移行する

java パッケージや android パッケージ内のクラスの中には、ICU4J 内のクラスと同等のものがあります。ただし、通常は ICU4J の方が規格や言語に関して幅広いサポートを提供しています。

同等のクラスの主な例を表 2 に示します。

表 2: Android と Java ICU4J のクラス

Android 上の ICU4C

Android は、libicuuc.so や libicui18n.so ではなく libicu.so ライブラリを通じて、ICU4C API のサブセットをエクスポーズします。API は Android 12（API レベル 31）以降で使用できます。NDK ヘッダーは NDK リリース r22b 以降で使用できます。C++ API は Android NDK を通じてエクスポーズされません。一部の C API はご利用いただけません。

バージョニング

Android プラットフォームの各リリースは、それぞれその時点の ICU の最新バージョン、および対応する CLDR バージョンと Unicode バージョンに対応しています。Android 7.0（API レベル 24）以降の対応状況を表 3 に示します。 VersionInfo.ICU_VERSION API（Android 7.0 以降で利用可能）を使用して、実行時に ICU のバージョン情報を取得します。

表 3: Android 7.0（API レベル 24）から Android 15（API レベル 35）までの Android バージョンで使用される ICU と CLDR のバージョン。

時刻形式の設定（24 時間形式 / 12 時間形式）

val skeleton: String = if (DateFormat.is24HourFormat(context)) "Hm" else "hm"
val formattedTime: String = android.icu.text.DateFormat.getInstanceForSkeleton(
        skeleton,
        Locale.getDefault()).format(Date()
)

String skeleton = DateFormat.is24HourFormat(context) ? "Hm" : "hm";
String formattedTime = android.icu.text.DateFormat.getInstanceForSkeleton(skeleton, Locale.getDefault()).format(new Date());

文字変換機能の安定性

ライセンス

ICU4J は、ICU ライセンスの下でリリースされています。詳細については、ICU ユーザーガイドをご覧ください。