diff --git a/docs/html/_redirects.yaml b/docs/html/_redirects.yaml index 0dd1c89c27ded..1e6f2169f1224 100644 --- a/docs/html/_redirects.yaml +++ b/docs/html/_redirects.yaml @@ -1202,8 +1202,8 @@ redirects: - from: /r/studio-ui/menu-start.html to: /training/index.html?utm_medium=android-studio -# N Preview redirects - +- from: /preview/features/icu4j-framework.html + to: /guide/topics/resources/icu4j-framework.html - from: /preview/features/key-attestation.html to: /training/articles/security-key-attestation.html - from: /preview/features/security-config.html diff --git a/docs/html/guide/_book.yaml b/docs/html/guide/_book.yaml index 6d6686b3cf3f7..b788c3840633f 100644 --- a/docs/html/guide/_book.yaml +++ b/docs/html/guide/_book.yaml @@ -69,6 +69,9 @@ toc: path: /guide/topics/resources/runtime-changes.html - title: Localization path: /guide/topics/resources/localization.html + section: + - title: ICU4J Android Framework APIs + path: /guide/topics/resources/icu4j-framework.html - title: Resource Types path: /guide/topics/resources/available-resources.html section: diff --git a/docs/html/preview/features/icu4j-framework.jd b/docs/html/guide/topics/resources/icu4j-framework.jd similarity index 92% rename from docs/html/preview/features/icu4j-framework.jd rename to docs/html/guide/topics/resources/icu4j-framework.jd index 839c077d3f6ad..e7cbe72e9c6ba 100644 --- a/docs/html/preview/features/icu4j-framework.jd +++ b/docs/html/guide/topics/resources/icu4j-framework.jd @@ -30,14 +30,16 @@ page.image=images/cards/card-nyc_2x.jpg

ICU4J is an open-source, widely used set of Java libraries providing Unicode - and globalization support for software applications. Android N - exposes a subset of the ICU4J APIs in the Android framework for app developers + and globalization support for software applications. Starting in Android 7.0 + (API level 24), Android + exposes a subset of the ICU4J APIs for app developers to use under the {@code android.icu} package. These APIs use localization data present on the device. As a result, you can reduce your APK footprint by not compiling the ICU4J libraries into your APK; instead, you can simply call out to them in the framework. (In this case, you may want to provide multiple versions - of your APK, so users running versions of Android lower than Android N + of your APK, so users running versions of Android lower than + Android 7.0 (API level 24) can download a version of the app that contains the ICU4J libraries.)

@@ -51,17 +53,17 @@ page.image=images/cards/card-nyc_2x.jpg

Relationship to ICU4J

- Android N exposes a subset of the ICU4J APIs via the + Android exposes a subset of the ICU4J APIs via the android.icu package, rather than com.ibm.icu. The Android framework may choose not to - expose ICU4J APIs for various reasons; for example, Android N does not expose + expose ICU4J APIs for various reasons; for example, Android does not expose some deprecated APIs or those that the ICU team have not yet declared as stable. As the ICU team deprecates APIs in the future, Android will also mark them as deprecated but will continue to include them.

Table 1. ICU and CLDR versions used - in Android N.

+ in Android].

@@ -69,7 +71,7 @@ page.image=images/cards/card-nyc_2x.jpg - +
Android API levelCLDR version
Android NAndroid 7.0 (API level 24) 56 28