이 페이지는 Cloud Translation API를 통해 번역되었습니다.

유니코드 및 국제화 지원

Android는 ICU 라이브러리와 CLDR 프로젝트를 활용하여 유니코드 및 기타 국제화 지원을 제공합니다. 이 페이지에서 유니코드와 국제화 지원에 관한 설명은 Android 6.0(API 수준 23) 이하 및 Android 7.0(API 수준 24) 이상의 두 섹션으로 구성되어 있습니다.

Android 6.0(API 수준 23) 이하에서 유니코드 및 국제화 지원

Android 플랫폼은 ICU 및 CLDR을 사용하여 라틴어와 라틴어가 아닌 언어의 표기를 처리하는 다양한 클래스를 구현하고 Locale, Character 및 java.text의 많은 서브클래스를 노출합니다. 노출된 클래스 이외의 국제화 기능이 필요하고 Android 6.0(API 수준 23)을 통해 플랫폼 버전을 타겟팅하는 앱에는 ICU 라이브러리가 포함되어야 합니다.

버전 관리

Android 플랫폼의 후속 출시는 새 버전의 ICU(이에 대응하는 CLDR과 유니코드 버전 포함)에 대응됩니다. 표 1은 Android 6.0(API 수준 23)까지 대응하는 버전을 보여줍니다.

표 1. Android 6.0(API 수준 23)까지 사용되는 ICU 및 CLDR 버전

플랫폼(API 수준)	ICU	CLDR	유니코드
Android 1.5~2.0(API 수준 3~7)	3.8	1.5	5.0
Android 2.2(API 수준 8)	4.2	1.7	5.1
Android 2.3~3.0(API 수준 9~13)	4.4	1.8	5.2
Android 4.0(API 수준 14~15)	4.6	1.9	6.0
Android 4.1(API 수준 16~17)	4.8	2.0	6.0
Android 4.3(API 수준 18)	50	22.1	6.2
Android 4.4(API 수준 19~20)	51	23	6.2
Android 5.0(API 수준 21~22)	53	25	6.3
Android 6.0(API 수준 23)	55.1	27.0.1	7.0

Android 프레임워크는 Android 7.0(API 수준 24) 이상을 타겟팅하는 앱의 유니코드 및 국제화를 더 포괄적으로 지원합니다. 이 페이지의 다음 섹션에서는 지원에 관한 세부정보를 제공합니다.

Android 7.0(API 수준 24) 이상에서 유니코드 및 국제화 지원

Android 7.0(API 수준 24) 이상의 경우 Android 플랫폼은 앱 개발자가 android.icu 패키지에서 사용할 수 있도록 ICU4J API의 하위 집합을 노출합니다. ICU4J는 소프트웨어 애플리케이션의 유니코드 및 국제화 지원을 제공하기 위해 널리 사용되는 오픈소스 Java 라이브러리 세트입니다.

ICU4J API는 기기에 있는 현지화 데이터를 사용합니다. 따라서 ICU4J 라이브러리를 앱으로 컴파일하지 않음으로써 앱의 공간을 줄일 수 있습니다. 대신 프레임워크에서 호출할 수 있습니다. 이 경우 Android 7.0(API 수준 24)보다 낮은 버전의 Android를 실행하는 사용자가 ICU4J 라이브러리가 포함된 앱 버전을 다운로드할 수 있도록 여러 버전의 APK를 제공하는 것이 좋습니다.

이 섹션은 먼저 이러한 라이브러리를 지원하는 데 필요한 최소 Android API 수준에 관한 몇 가지 기본 정보를 제공합니다. 그런 다음 ICU4J의 Android 관련 구현에서 알아야 할 사항을 설명합니다. 마지막으로 Android 프레임워크에서 ICU4J API를 사용하는 방법을 설명합니다.

Android의 ICU4J

Android는 com.ibm.icu 대신 android.icu 패키지를 통해 ICU4J API의 하위 집합을 노출합니다. 일부 ICU4J API는 지원 중단되거나 안정적인 것으로 선언되지 않는 등의 이유로 Android 프레임워크에 의해 노출되지 않습니다. ICU팀이 향후 API를 지원 중단하면 Android 역시 지원 중단으로 표시하지만 계속해서 API를 포함합니다.

다음은 몇 가지 알아야 할 사항입니다.

ICU4J Android 프레임워크 API에 모든 ICU4J API가 포함되어 있는 것은 아닙니다.
Android 프레임워크의 API는 Android의 리소스로 현지화 지원을 대체하지 않습니다.
경우에 따라 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 및 자바 ICU4J 클래스

클래스	대안
`java.lang.Character`	`android.icu.lang.UCharacter`
`java.text.BreakIterator`	`android.icu.text.BreakIterator`
`java.text.DecimalFormat`	`android.icu.text.DecimalFormat`
`java.util.Calendar`	`android.icu.util.Calendar`
`android.text.BidiFormatter`	`android.icu.text.Bidi`
`android.text.format.DateFormat`	`android.icu.text.DateFormat`
`android.text.format.DateUtils`	`android.icu.text.DateFormat` `android.icu.text.RelativeDateTimeFormatter`

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과 유니코드 버전 포함)에 대응됩니다. 표 3은 Android 7.0(API 수준 24)에서 시작하여 이 대응 관계를 보여줍니다. VersionInfo.ICU_VERSION API (Android 7.0부터 사용 가능)를 사용하여 런타임 시 ICU 버전 정보를 가져옵니다.

표 3. Android 7.0 (API 수준 24)부터 Android 15 (API 수준 35)까지의 Android 버전에서 사용되는 ICU 및 CLDR 버전

플랫폼(API 수준)	ICU	CLDR	유니코드
Android 7.0~7.1(API 수준 24~25)	56	28	8.0
Android 8.0~8.1(API 수준 26~27)	58.2	30.0.3	9.0
Android 9(API 수준 28)	60.2	32.0.1	10.0
Android 10(API 수준 29)	63.2	34	11.0
Android 11(API 수준 30)	66.1	36	13.0
Android 12 (API 수준 31~32)	68.2	38.1	13.0
Android 13(API 수준 33)	70.1	40	14.0
Android 14 (API 수준 34)	72.1	42	15.0
Android 15 (API 수준 35)	75.1	45	15.1

24시간/12시간 시간 형식 설정

Android의 ICU는 DateFormat.is24HourFormat()에서 가져온 사용자의 24시간/12시간 시간 형식 설정을 준수하지 않습니다. 이 설정을 준수하려면 DateFormat 또는 DateUtils 시간 형식 지정 메서드를 사용하거나 is24HourFormat() 반환 값에 따라 적절한 시간 패턴 기호(12시간은 'h', 24시간은 'H')를 붙여 ICU 시간 형식 지정 패턴을 사용합니다. 예를 들어, 이 코드는 사용자의 12시간/24시간 설정을 준수하는 현재 시간으로 문자열을 생성합니다.

Kotlin

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());

음역기의 안정성

Android 10(API 수준 29)부터 텍스트를 한 형식에서 다른 형식으로 음역하는 Transliterator가 제공됩니다. 사용 가능한 음역 ID의 집합은 Android 출시 버전 및 기기 간에 불안정합니다. 기기 제조업체는 추가 음역 ID를 추가할 수 있습니다. 개발자는 텍스트를 음역하기 전에 사용 가능한 ID(Transliterator.getAvailableIDs()에서 가져옴)를 확인해야 합니다.

라이선스

ICU4J는 ICU 라이선스하에 출시됩니다. 자세한 내용은 ICU 사용자 가이드를 참고하세요.

유사 언어(pseudolocale)로 앱 테스트

언어 및 국가 확인