Google은 흑인 공동체를 위한 인종 간 평등을 진전시키기 위해 노력하고 있습니다. Google에서 어떤 노력을 하고 있는지 확인하세요.

유니코드 및 국제화 지원

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

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

Android 플랫폼은 ICU 및 CLDR을 사용하여 라틴어와 라틴어가 아닌 언어의 표기를 처리하는 다양한 클래스를 구현하고 Locale, Characterjava.text의 많은 서브클래스를 노출합니다. 노출된 클래스를 벗어난 국제화 기능을 사용하고 Android 6.0(API 레벨 23)이하의 플랫폼 버전을 타겟팅하는 앱은 APK에 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 7.0(API 레벨 24) 이상을 타겟팅하는 앱은 Android 프레임워크에서 노출하는 유니코드 및 국제화에 관한 더 포괄적인 지원을 활용할 수 있습니다. 이 문서의 다음 섹션에서는 지원에 관한 세부정보를 제공합니다.

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

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

ICU4J API는 기기에 있는 현지화 데이터를 사용합니다. 따라서, APK에 ICU4J 라이브러리를 컴파일하지 않으므로 APK 크기를 줄일 수 있으며 프레임워크에서 쉽게 라이브러리를 호출할 수 있습니다. (이 경우 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가 지원 중단되거나 안정적으로 선언되지 않는 등의 다양한 이유로 Android 프레임워크는 ICU4J API를 노출하지 않을 수 있습니다. ICU 팀이 향후 API를 지원 중단하면 Android 역시 지원 중단으로 표시하지만 계속해서 API를 포함합니다.

다음은 몇 가지 중요한 사항입니다.

  • ICU4J Android 프레임워크 API에 모든 ICU4J API가 포함된 것은 아닙니다.
  • NDK는 Android ICU4C를 지원하지 않습니다.
  • Android 프레임워크 API는 리소스를 사용하여 현지화하는 Android의 지원을 대체하지 않습니다.
  • 경우에 따라 Android 프레임워크는 ICU 라이브러리보다 더 많은 문자를 지원합니다. 한 예로 android.text 클래스의 이모티콘 지원을 들 수 있습니다.

com.ibm.icu에서 android.icu 패키지로 이전

이미 앱에서 ICU4J API를 사용하고 있고 android.icu API가 요구사항을 충족한다면 프레임워크 API로 이전하기 위해 자바 import를 com.ibm.icu에서 android.icu로 변경해야 합니다. 그런 다음 APK에서 ICU4J 파일의 사본을 삭제할 수 있습니다.

참고: ICU4J 프레임워크 API는 com.ibm.icu 대신 android.icu 네임스페이스를 사용합니다. 이는 자체 com.ibm.icu 라이브러리를 포함하는 APK에서 네임스페이스 충돌을 방지하기 위한 것입니다.

다른 Android SDK API에서 android.icu API로 이전

javaandroid 패키지의 일부 클래스는 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 플랫폼의 후속 릴리스는 새 버전의 ICU(이에 대응하는 CLDR과 유니코드 버전 포함)에 대응됩니다. 표 3은 Android 7.0(API 레벨 24)에서 시작하여 이 대응 관계를 보여줍니다.

표 3. Android 7.0(API 레벨 24) 이상에서 사용되는 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

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

Android의 ICU는 사용자의 24시간/12시간 시간 형식 설정(DateFormat.is24HourFormat()에서 가져옴)을 준수하지 않습니다. 설정을 준수하려면 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 사용자 가이드를 참조하세요.