1 page.title=ICU4J Android Framework APIs 2 page.image=images/cards/card-nyc_2x.jpg 3 4 @jd:body 5 6 <div id="qv-wrapper"> 7 <div id="qv"> 8 <h2>Neste documento:</h2> 9 <ol> 10 <li><a href="#relation">Relao com o ICU4J</a></li> 11 <li><a href="#migration">Migrar para APIs android.icu do ICU4J </a></li> 12 <li><a href="#licence">Licenciamento</a></li> 13 </ol> 14 15 <h2>Veja tambm</h2> 16 <ol> 17 <li> 18 <a class="external-link" href="http://userguide.icu-project.org">Documentao para ICU4J</a> 19 </li> 20 21 <li> 22 <a class="external-link" href="http://site.icu-project.org/#TOC-What-is-ICU-">ltimos padres com suporte 23 do ICU4J</a> 24 </li> 25 </ol> 26 </div> 27 </div> 28 29 <p> 30 O ICU4J um conjunto de bibliotecas Java de cdigo aberto e amplamente usadas que fornecem suporte para Unicode 31 e globalizao para aplicativos de software. O Android N 32 expe um subconjunto de APIs do ICU4J na estrutura do Android para uso dos desenvolvedores de aplicativos 33 no pacote {@code android.icu}. Essas APIs usam 34 dados de localizao presentes no dispositivo. Consequentemente, voc pode reduzir o uso de APK 35 ao no compilar as bibliotecas do ICU4J no seu APK. Em vez disso, pode 36 simplesmente cham-las na estrutura. (Neste caso, pode ser conveniente fornecer 37 <a href="{@docRoot}google/play/publishing/multiple-apks.html">vrias verses 38 do seu APK</a> para que os usurios que tenham verses inferiores ao Android N 39 possam fazer o download de uma verso do aplicativo que contenha as bibliotecas do ICU4J.) 40 </p> 41 42 <p> 43 Este documento comea fornecendo informaes bsicas sobre os nveis mnimos da 44 Android API necessrios para oferecer suporte a essas bibliotecas. Em seguida, ele explica o que 45 voc deve saber sobre a implementao do ICU4J especfica do Android. Por fim, 46 ele informa como usar as APIs do ICU4J na estrutura do Android. 47 </p> 48 49 <h2 id="relation">Relao com o ICU4J</h2> 50 51 <p> 52 O Android N expe um subconjunto de APIs do ICU4J por meio do pacote 53 <code>android.icu</code>, no do <code>com.ibm.icu</code>. A 54 estrutura do Android pode optar por no 55 expor as APIs do ICU4J por diversos motivos. Por exemplo, o Android N no expe 56 algumas APIs obsoletas ou que a equipe do ICU ainda no declarou como 57 estveis. Conforme a equipe do ICU torna APIs obsoletas, o Android tambm as marcar 58 como obsoletas, mas continuar incluindo-as. 59 </p> 60 61 <p class="table-caption"><strong>Tabela 1.</strong> Verses ICU e CLDR usadas 62 no Android N.</p> 63 <table> 64 <tr> 65 <th>Nvel da Android API</th> 66 <th>Verso ICU</th> 67 <th>Verso CLDR</th> 68 </tr> 69 <tr> 70 <td>Android N</td> 71 <td>56</td> 72 <td>28</td> 73 </tr> 74 </table> 75 76 <p>Algumas observaes importantes:</p> 77 78 <ul> 79 <li>As APIs de estrutura do Android para ICU4J no incluem todas as APIs do ICU4J.</li> 80 <li>Desenvolvedores de NDK devem saber que o Android ICU4C no compatvel.</li> 81 <li>As APIs da estrutura do Android no substituem o suporte do Android para a 82 <a href="{@docRoot}guide/topics/resources/localization.html">localizao com 83 recursos</a>.</li> 84 </ul> 85 86 <h2 id="migration">Migrar do pacote com.ibm.icu para o android.icu</h2> 87 88 <p> 89 Se voc j estiver usando as APIs do ICU4J no seu aplicativo e as APIs 90 <code>android.icu</code> atenderem aos seus requisitos, a migrao para 91 as APIs de estrutura exigiro que voc altere as importaes Java 92 de <code>com.ibm.icu</code> para <code>android.icu</code>. Voc, ento, poder 93 remover sua prpria cpia dos arquivos do ICU4J do APK. 94 </p> 95 96 <p class="note"> 97 <b>Observao</b>: As APIs de estrutura do ICU4J usam o namespace {@code android.icu} 98 em vez de {@code com.ibm.icu}. Isso ocorre para evitar conflitos 99 de namespace em APKs que contm as prprias bibliotecas {@code com.ibm.icu}. 100 </p> 101 102 <h3 id="migrate-from-android"> 103 Migrar para APIs android.icu de outras APIs do Android SDK 104 </h3> 105 106 <p> 107 Algumas classes dos pacotes <code>java</code> e <code>android</code> tm 108 equivalentes para as encontradas no ICU4J. No entanto, o ICU4J frequentemente fornece um suporte 109 mais amplo para padres e linguagens. 110 </p> 111 <p>Alguns exemplos para voc comear:</p> 112 <table> 113 <tr> 114 <th>Classe</th> 115 <th>Alternativas</th> 116 </tr> 117 <tr> 118 <td><code>java.lang.Character</code> </td> 119 <td><code>android.icu.lang.UCharacter</code> </td> 120 </tr> 121 <tr> 122 <td><code>java.text.BreakIterator</code> </td> 123 <td><code>android.icu.text.BreakIterator</code> </td> 124 </tr> 125 <tr> 126 <td><code>java.text.DecimalFormat</code> </td> 127 <td><code>android.icu.text.DecimalFormat</code> </td> 128 </tr> 129 <tr> 130 <td><code>java.util.Calendar</code></td> 131 <td> 132 <code>android.icu.util.Calendar</code></td> 133 </tr> 134 <tr> 135 <td><code>android.text.BidiFormatter</code> 136 </td> 137 <td><code>android.icu.text.Bidi</code> 138 </td> 139 </tr> 140 <tr> 141 <td><code>android.text.format.DateFormat</code> 142 </td> 143 <td><code>android.icu.text.DateFormat</code> 144 </td> 145 </tr> 146 <tr> 147 <td><code>android.text.format.DateUtils</code> </td> 148 <td><code>android.icu.text.DateFormat</code> 149 <code>android.icu.text.RelativeDateTimeFormatter</code> 150 </td> 151 </tr> 152 </table> 153 154 <h2 id="licence">Licenciamento</h2> 155 156 <p> 157 O ICU4J liberado sob a licena do ICU. Para saber mais, consulte o <a class="external-link" href="http://userguide.icu-project.org/icufaq#TOC-How-is-the-ICU-licensed-">Guia do usurio do 158 ICU.</a> 159 </p> 160
