page.title=ICU4J Android Framework API
page.image=images/cards/card-nyc_2x.jpg

@jd:body

<div id="qv-wrapper">
<div id="qv">
<h2>Dalam dokumen ini:</h2>
<ol>
    <li><a href="#relation">Hubungan dengan ICU4J</a></li>
    <li><a href="#migration">Migrasi ke android.icu API dari ICU4J </a></li>
    <li><a href="#licence">Lisensi</a></li>
</ol>

<h2>Lihat Juga</h2>
<ol>
  <li>
    <a class="external-link" href="http://userguide.icu-project.org">Dokumentasi untuk ICU4J</a>
  </li>

  <li>
    <a class="external-link" href="http://site.icu-project.org/#TOC-What-is-ICU-">Standar terbaru yang didukung
    oleh ICU4J</a>
  </li>
</ol>
</div>
</div>

<p>
  ICU4J merupakan serangkaian pustaka Java sumber terbuka yang banyak digunakan dan menyediakan Unicode
  serta dukungan globalisasi untuk aplikasi perangkat lunak. Android N
  mengekspos subset ICU4J API dalam kerangka kerja Android bagi pengembang aplikasi
  untuk digunakan pada paket {@code android.icu}. API ini menggunakan
  data pelokalan yang ada pada perangkat. Hasilnya, Anda bisa mengurangi footprint
  APK dengan tidak mengompilasi pustaka ICU4J ke APK Anda; sebagai gantinya,
  cukup memanggilnya dalam kerangka kerja. (Dalam hal ini, Anda mungkin perlu menyediakan
  <a href="{@docRoot}google/play/publishing/multiple-apks.html">beberapa versi
  APK Anda</a>, sehingga pengguna yang menjalankan versi Android lebih rendah dari Android N
  bisa mengunduh versi aplikasi yang berisi pustaka ICU4J.)
</p>

<p>
  Dokumen ini diawali dengan menyediakan beberapa informasi dasar tentang level Android API
  minimum yang diperlukan untuk mendukung pustaka-pustaka ini. Kemudian dijelaskan tentang apa
  yang perlu Anda ketahui tentang implementasi ICU4J spesifik Android. Terakhir,
  Anda akan diberi tahu cara menggunakan ICU4J API dalam kerangka kerja Android.
</p>

<h2 id="relation">Hubungan dengan ICU4J</h2>

<p>
  Android N mengekspos subset ICU4J API lewat
  paket <code>android.icu</code>, bukannya <code>com.ibm.icu</code>. Kerangka kerja
  Android dapat memilih untuk tidak
  mengekspos ICU4J API karena berbagai alasan; misalnya, Android N tidak mengekspos
  beberapa API yang tidak digunakan lagi atau yang dinyatakan belum
  stabil oleh tim ICU. Karena tim ICU tidak lagi menggunakan API di masa mendatang, Android juga akan menandainya
  sebagai tidak digunakan lagi namun akan terus menyertakannya.
</p>

<p class="table-caption"><strong>Tabel 1.</strong> Versi ICU dan CLDR yang digunakan
  di Android N.</p>
<table>
<tr>
<th>Level Android API</th>
<th>Versi ICU</th>
<th>Versi CLDR</th>
</tr>
<tr>
<td>Android N</td>
<td>56</td>
<td>28</td>
</tr>
</table>

<p>Inilah beberapa hal penting yang harus diperhatikan:</p>

<ul>
<li>ICU4J Android Framework API tidak menyertakan semua ICU4J API.</li>
<li>Pengembang NDK harus mengetahui bahwa Android ICU4C tidak didukung.</li>
<li>API dalam kerangka kerja Android tidak menggantikan dukungan Android untuk
<a href="{@docRoot}guide/topics/resources/localization.html">melokalkan dengan
sumber daya</a>.</li>
</ul>

<h2 id="migration">Migrasi ke paket android.icu dari com.ibm.icu</h2>

<p>
  Jika Anda sudah menggunakan ICU4J API dalam aplikasi, dan
  <code>android.icu</code> API memenuhi persyaratan Anda, maka migrasi ke
  API kerangka kerja mengharuskan Anda untuk mengubah impor Java
  dari <code>com.ibm.icu</code> ke <code>android.icu</code>. Kemudian Anda bisa
  membuang salinan file ICU4J dari APK.
</p>

<p class="note">
  <b>Catatan</b>: API kerangka kerja ICU4J menggunakan ruang nama {@code android.icu}
  sebagai ganti {@code com.ibm.icu}. Hal ini untuk menghindari konflik
  ruang nama di APK yang berisi pustaka {@code com.ibm.icu} sendiri.
</p>

<h3 id="migrate-from-android">
  Migrasi ke API android.icu dari Android SDK API lainnya
</h3>

<p>
  Beberapa kelas dalam paket <code>java</code> dan <code>android</code> memiliki
  padanannya dengan yang ditemukan di ICU4J. Akan tetapi, ICU4J seringkali menyediakan dukungan
  yang lebih luas untuk standar dan bahasa.
</p>
<p>Inilah beberapa contoh untuk membantu Anda memulai:</p>
<table>
<tr>
<th>Kelas</th>
<th>Alternatif</th>
</tr>
<tr>
<td><code>java.lang.Character</code> </td>
<td><code>android.icu.lang.UCharacter</code> </td>
</tr>
<tr>
<td><code>java.text.BreakIterator</code> </td>
<td><code>android.icu.text.BreakIterator</code> </td>
</tr>
<tr>
<td><code>java.text.DecimalFormat</code> </td>
<td><code>android.icu.text.DecimalFormat</code> </td>
</tr>
<tr>
<td><code>java.util.Calendar</code></td>
<td>
<code>android.icu.util.Calendar</code></td>
</tr>
<tr>
<td><code>android.text.BidiFormatter</code>
 </td>
<td><code>android.icu.text.Bidi</code>
 </td>
</tr>
<tr>
<td><code>android.text.format.DateFormat</code>
 </td>
<td><code>android.icu.text.DateFormat</code>
 </td>
</tr>
<tr>
<td><code>android.text.format.DateUtils</code> </td>
<td><code>android.icu.text.DateFormat</code>
<code>android.icu.text.RelativeDateTimeFormatter</code>
</td>
</tr>
</table>

<h2 id="licence">Lisensi</h2>

<p>
  ICU4J dirilis dengan lisensi ICU. Untuk detailnya, lihat <a class="external-link" href="http://userguide.icu-project.org/icufaq#TOC-How-is-the-ICU-licensed-">Panduan Pengguna
  ICU.</a>
</p>