1 /* 2 * Copyright (C) 2015 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 package com.android.icu4j.srcgen; 17 18 import static com.google.currysrc.api.process.Rules.createMandatoryRule; 19 import static com.google.currysrc.api.process.Rules.createOptionalRule; 20 21 import org.eclipse.jdt.core.JavaCore; 22 import org.eclipse.jdt.core.formatter.DefaultCodeFormatterConstants; 23 24 import com.google.common.collect.Lists; 25 import com.google.currysrc.Main; 26 import com.google.currysrc.aosp.Annotations; 27 import com.google.currysrc.api.RuleSet; 28 import com.google.currysrc.api.input.InputFileGenerator; 29 import com.google.currysrc.api.output.BasicOutputSourceFileGenerator; 30 import com.google.currysrc.api.output.OutputSourceFileGenerator; 31 import com.google.currysrc.api.process.Rule; 32 import com.google.currysrc.api.process.ast.BodyDeclarationLocator; 33 import com.google.currysrc.api.process.ast.BodyDeclarationLocators; 34 import com.google.currysrc.api.process.ast.TypeLocator; 35 import com.google.currysrc.processors.AddAnnotation; 36 import com.google.currysrc.processors.AddDefaultConstructor; 37 import com.google.currysrc.processors.HidePublicClasses; 38 import com.google.currysrc.processors.InsertHeader; 39 import com.google.currysrc.processors.ModifyQualifiedNames; 40 import com.google.currysrc.processors.ModifyStringLiterals; 41 import com.google.currysrc.processors.RemoveJavaDocTags; 42 import com.google.currysrc.processors.RenamePackage; 43 import com.google.currysrc.processors.ReplaceTextCommentScanner; 44 45 import java.io.File; 46 import java.nio.file.Path; 47 import java.nio.file.Paths; 48 import java.util.Arrays; 49 import java.util.List; 50 import java.util.Map; 51 import java.util.stream.Collectors; 52 53 /** 54 * Applies Android's ICU4J source code transformation rules. If you make any changes to this class 55 * then you should re-run the generate_android_icu4j.sh script. 56 */ 57 public class Icu4jTransform { 58 59 // The list of public ICU API classes exposed on Android. If you change this, you should change 60 // the INITIAL_DEPRECATED_SET below to include entries from the new classes. 61 static final String[] PUBLIC_API_CLASSES = new String[] { 62 /* ASCII order please. */ 63 "android.icu.lang.UCharacter", 64 "android.icu.lang.UCharacter$BidiPairedBracketType", 65 "android.icu.lang.UCharacter$DecompositionType", 66 "android.icu.lang.UCharacter$EastAsianWidth", 67 "android.icu.lang.UCharacter$GraphemeClusterBreak", 68 "android.icu.lang.UCharacter$HangulSyllableType", 69 "android.icu.lang.UCharacter$IndicPositionalCategory", 70 "android.icu.lang.UCharacter$IndicSyllabicCategory", 71 "android.icu.lang.UCharacter$JoiningGroup", 72 "android.icu.lang.UCharacter$JoiningType", 73 "android.icu.lang.UCharacter$LineBreak", 74 "android.icu.lang.UCharacter$NumericType", 75 "android.icu.lang.UCharacter$SentenceBreak", 76 "android.icu.lang.UCharacter$UnicodeBlock", 77 "android.icu.lang.UCharacter$VerticalOrientation", 78 "android.icu.lang.UCharacter$WordBreak", 79 "android.icu.lang.UCharacterCategory", 80 "android.icu.lang.UCharacterDirection", 81 "android.icu.lang.UCharacterEnums", 82 "android.icu.lang.UCharacterEnums$ECharacterCategory", 83 "android.icu.lang.UCharacterEnums$ECharacterDirection", 84 "android.icu.lang.UProperty", 85 "android.icu.lang.UProperty$NameChoice", 86 "android.icu.lang.UScript", 87 "android.icu.lang.UScript$ScriptUsage", 88 "android.icu.math.BigDecimal", 89 "android.icu.math.MathContext", 90 "android.icu.number.CompactNotation", 91 "android.icu.number.CurrencyPrecision", 92 "android.icu.number.FormattedNumber", 93 "android.icu.number.FormattedNumberRange", 94 "android.icu.number.FractionPrecision", 95 "android.icu.number.IntegerWidth", 96 "android.icu.number.LocalizedNumberFormatter", 97 "android.icu.number.LocalizedNumberRangeFormatter", 98 "android.icu.number.Notation", 99 "android.icu.number.NumberFormatter", 100 "android.icu.number.NumberFormatter$DecimalSeparatorDisplay", 101 "android.icu.number.NumberFormatter$GroupingStrategy", 102 "android.icu.number.NumberFormatter$SignDisplay", 103 "android.icu.number.NumberFormatter$UnitWidth", 104 "android.icu.number.NumberFormatterSettings", 105 "android.icu.number.NumberRangeFormatter", 106 "android.icu.number.NumberRangeFormatter$RangeCollapse", 107 "android.icu.number.NumberRangeFormatter$RangeIdentityFallback", 108 "android.icu.number.NumberRangeFormatter$RangeIdentityResult", 109 "android.icu.number.NumberRangeFormatterSettings", 110 "android.icu.number.Precision", 111 "android.icu.number.Scale", 112 "android.icu.number.ScientificNotation", 113 "android.icu.number.SimpleNotation", 114 "android.icu.number.UnlocalizedNumberFormatter", 115 "android.icu.number.UnlocalizedNumberRangeFormatter", 116 "android.icu.text.AlphabeticIndex", 117 "android.icu.text.AlphabeticIndex$Bucket", 118 "android.icu.text.AlphabeticIndex$Bucket$LabelType", 119 "android.icu.text.AlphabeticIndex$ImmutableIndex", 120 "android.icu.text.AlphabeticIndex$Record", 121 "android.icu.text.Bidi", 122 "android.icu.text.BidiClassifier", 123 "android.icu.text.BidiRun", 124 "android.icu.text.BreakIterator", 125 "android.icu.text.CaseMap", 126 "android.icu.text.CaseMap$Fold", 127 "android.icu.text.CaseMap$Lower", 128 "android.icu.text.CaseMap$Title", 129 "android.icu.text.CaseMap$Upper", 130 "android.icu.text.CollationElementIterator", 131 "android.icu.text.CollationKey", 132 "android.icu.text.CollationKey$BoundMode", 133 "android.icu.text.Collator", 134 "android.icu.text.Collator$CollatorFactory", 135 "android.icu.text.Collator$ReorderCodes", 136 "android.icu.text.CompactDecimalFormat", 137 "android.icu.text.CompactDecimalFormat$CompactStyle", 138 "android.icu.text.ConstrainedFieldPosition", 139 "android.icu.text.CurrencyPluralInfo", 140 "android.icu.text.DateFormat", 141 "android.icu.text.DateFormat$BooleanAttribute", 142 "android.icu.text.DateFormat$Field", 143 "android.icu.text.DateFormat$HourCycle", 144 "android.icu.text.DateFormatSymbols", 145 "android.icu.text.DateIntervalFormat", 146 "android.icu.text.DateIntervalFormat$FormattedDateInterval", 147 "android.icu.text.DateIntervalInfo", 148 "android.icu.text.DateIntervalInfo$PatternInfo", 149 "android.icu.text.DateTimePatternGenerator", 150 "android.icu.text.DateTimePatternGenerator$DisplayWidth", 151 "android.icu.text.DateTimePatternGenerator$PatternInfo", 152 "android.icu.text.DecimalFormat", 153 "android.icu.text.DecimalFormatSymbols", 154 "android.icu.text.DisplayContext", 155 "android.icu.text.DisplayContext$Type", 156 "android.icu.text.Edits", 157 "android.icu.text.Edits$Iterator", 158 "android.icu.text.FormattedValue", 159 "android.icu.text.IDNA", 160 "android.icu.text.IDNA$Error", 161 "android.icu.text.IDNA$Info", 162 "android.icu.text.ListFormatter", 163 "android.icu.text.ListFormatter$FormattedList", 164 "android.icu.text.ListFormatter$Type", 165 "android.icu.text.ListFormatter$Width", 166 "android.icu.text.LocaleDisplayNames", 167 "android.icu.text.LocaleDisplayNames$DialectHandling", 168 "android.icu.text.LocaleDisplayNames$UiListItem", 169 "android.icu.text.MeasureFormat", 170 "android.icu.text.MeasureFormat$FormatWidth", 171 "android.icu.text.MessageFormat", 172 "android.icu.text.MessageFormat$Field", 173 "android.icu.text.MessagePattern", 174 "android.icu.text.MessagePattern$ApostropheMode", 175 "android.icu.text.MessagePattern$ArgType", 176 "android.icu.text.MessagePattern$Part", 177 "android.icu.text.MessagePattern$Part$Type", 178 "android.icu.text.Normalizer", 179 "android.icu.text.Normalizer$QuickCheckResult", 180 "android.icu.text.Normalizer2", 181 "android.icu.text.Normalizer2$Mode", 182 "android.icu.text.NumberFormat", 183 "android.icu.text.NumberFormat$Field", 184 "android.icu.text.NumberingSystem", 185 "android.icu.text.PluralFormat", 186 "android.icu.text.PluralRules", 187 "android.icu.text.PluralRules$PluralType", 188 "android.icu.text.RelativeDateTimeFormatter", 189 "android.icu.text.RelativeDateTimeFormatter$AbsoluteUnit", 190 "android.icu.text.RelativeDateTimeFormatter$Direction", 191 "android.icu.text.RelativeDateTimeFormatter$FormattedRelativeDateTime", 192 "android.icu.text.RelativeDateTimeFormatter$RelativeDateTimeUnit", 193 "android.icu.text.RelativeDateTimeFormatter$RelativeUnit", 194 "android.icu.text.RelativeDateTimeFormatter$Style", 195 "android.icu.text.Replaceable", 196 "android.icu.text.RuleBasedCollator", 197 "android.icu.text.ScientificNumberFormatter", 198 "android.icu.text.SearchIterator", 199 "android.icu.text.SearchIterator$ElementComparisonType", 200 "android.icu.text.SelectFormat", 201 "android.icu.text.SimpleDateFormat", 202 "android.icu.text.StringPrepParseException", 203 "android.icu.text.StringSearch", 204 "android.icu.text.SymbolTable", 205 "android.icu.text.TimeZoneFormat", 206 "android.icu.text.TimeZoneFormat$GMTOffsetPatternType", 207 "android.icu.text.TimeZoneFormat$ParseOption", 208 "android.icu.text.TimeZoneFormat$Style", 209 "android.icu.text.TimeZoneFormat$TimeType", 210 "android.icu.text.TimeZoneNames", 211 "android.icu.text.TimeZoneNames$NameType", 212 "android.icu.text.Transliterator", 213 "android.icu.text.Transliterator$Position", 214 "android.icu.text.UCharacterIterator", 215 "android.icu.text.UFormat", 216 "android.icu.text.UnicodeFilter", 217 "android.icu.text.UnicodeMatcher", 218 "android.icu.text.UnicodeSet", 219 "android.icu.text.UnicodeSet$ComparisonStyle", 220 "android.icu.text.UnicodeSet$EntryRange", 221 "android.icu.text.UnicodeSet$SpanCondition", 222 "android.icu.text.UnicodeSetIterator", 223 "android.icu.text.UnicodeSetSpanner", 224 "android.icu.text.UnicodeSetSpanner$CountMethod", 225 "android.icu.text.UnicodeSetSpanner$TrimOption", 226 "android.icu.util.BuddhistCalendar", 227 "android.icu.util.CECalendar", 228 "android.icu.util.Calendar", 229 "android.icu.util.Calendar$WeekData", 230 "android.icu.util.ChineseCalendar", 231 "android.icu.util.CopticCalendar", 232 "android.icu.util.Currency", 233 "android.icu.util.Currency$CurrencyUsage", 234 "android.icu.util.CurrencyAmount", 235 "android.icu.util.DateInterval", 236 "android.icu.util.EthiopicCalendar", 237 "android.icu.util.Freezable", 238 "android.icu.util.GregorianCalendar", 239 "android.icu.util.HebrewCalendar", 240 "android.icu.util.ICUUncheckedIOException", 241 "android.icu.util.IllformedLocaleException", 242 "android.icu.util.IndianCalendar", 243 "android.icu.util.IslamicCalendar", 244 "android.icu.util.IslamicCalendar$CalculationType", 245 "android.icu.util.JapaneseCalendar", 246 "android.icu.util.LocaleData", 247 "android.icu.util.LocaleData$MeasurementSystem", 248 "android.icu.util.LocaleData$PaperSize", 249 "android.icu.util.Measure", 250 "android.icu.util.MeasureUnit", 251 "android.icu.util.MeasureUnit$Complexity", 252 "android.icu.util.Output", 253 "android.icu.util.RangeValueIterator", 254 "android.icu.util.RangeValueIterator$Element", 255 "android.icu.util.TaiwanCalendar", 256 "android.icu.util.TimeUnit", 257 "android.icu.util.TimeZone", 258 "android.icu.util.TimeZone$SystemTimeZoneType", 259 "android.icu.util.ULocale", 260 "android.icu.util.ULocale$AvailableType", 261 "android.icu.util.ULocale$Builder", 262 "android.icu.util.ULocale$Category", 263 "android.icu.util.UniversalTimeScale", 264 "android.icu.util.ValueIterator", 265 "android.icu.util.ValueIterator$Element", 266 "android.icu.util.VersionInfo", 267 268 }; 269 270 /** 271 * The set of deprecated ICU types/methods/fields that must not be part of the public API as they 272 * were deprecated when Android first exposed their classes as a public API. Methods deprecated by 273 * ICU after this will be visible and deprecated in Android. 274 */ 275 // This list was originally generated by the CaptureDeprecatedElements tool when run against 276 // ICU56 with the original PUBLIC_API_CLASSES. 277 private static final String[] INITIAL_DEPRECATED_SET = new String[] { 278 /* ASCII order please. */ 279 "field:android.icu.lang.UProperty#ISO_COMMENT", 280 "field:android.icu.lang.UProperty#UNDEFINED", 281 "field:android.icu.lang.UProperty#UNICODE_1_NAME", 282 "field:android.icu.lang.UScript#DUPLOYAN_SHORTAND", 283 "field:android.icu.text.Bidi#CLASS_DEFAULT", 284 "field:android.icu.text.CaseMap#internalOptions", 285 "field:android.icu.text.DateFormat#ABBR_STANDALONE_MONTH", 286 "field:android.icu.text.DateFormat#DATE_SKELETONS", 287 "field:android.icu.text.DateFormat#HOUR_GENERIC_TZ", 288 "field:android.icu.text.DateFormat#HOUR_MINUTE_GENERIC_TZ", 289 "field:android.icu.text.DateFormat#HOUR_MINUTE_TZ", 290 "field:android.icu.text.DateFormat#HOUR_TZ", 291 "field:android.icu.text.DateFormat#STANDALONE_MONTH", 292 "field:android.icu.text.DateFormat#TIME_SKELETONS", 293 "field:android.icu.text.DateFormat#ZONE_SKELETONS", 294 "field:android.icu.text.DateFormatSymbols#DT_CONTEXT_COUNT", 295 "field:android.icu.text.DateFormatSymbols#DT_WIDTH_COUNT", 296 "field:android.icu.text.DateFormatSymbols#NUMERIC", 297 "field:android.icu.text.DateTimePatternGenerator#MATCH_MINUTE_FIELD_LENGTH", 298 "field:android.icu.text.DateTimePatternGenerator#MATCH_SECOND_FIELD_LENGTH", 299 "field:android.icu.text.IDNA#ALLOW_UNASSIGNED", 300 "field:android.icu.text.Normalizer#COMPARE_NORM_OPTIONS_SHIFT", 301 "field:android.icu.text.Normalizer#COMPOSE", 302 "field:android.icu.text.Normalizer#COMPOSE_COMPAT", 303 "field:android.icu.text.Normalizer#DECOMP", 304 "field:android.icu.text.Normalizer#DECOMP_COMPAT", 305 "field:android.icu.text.Normalizer#DEFAULT", 306 "field:android.icu.text.Normalizer#DONE", 307 "field:android.icu.text.Normalizer#FCD", 308 "field:android.icu.text.Normalizer#IGNORE_HANGUL", 309 "field:android.icu.text.Normalizer#NFC", 310 "field:android.icu.text.Normalizer#NFD", 311 "field:android.icu.text.Normalizer#NFKC", 312 "field:android.icu.text.Normalizer#NFKD", 313 "field:android.icu.text.Normalizer#NONE", 314 "field:android.icu.text.Normalizer#NO_OP", 315 "field:android.icu.text.Normalizer#UNICODE_3_2", 316 "field:android.icu.text.PluralRules#CATEGORY_SEPARATOR", 317 "field:android.icu.text.PluralRules#KEYWORD_RULE_SEPARATOR", 318 "field:android.icu.text.PluralRules$FixedDecimal#decimalDigits", 319 "field:android.icu.text.PluralRules$FixedDecimal#decimalDigitsWithoutTrailingZeros", 320 "field:android.icu.text.PluralRules$FixedDecimal#hasIntegerValue", 321 "field:android.icu.text.PluralRules$FixedDecimal#integerValue", 322 "field:android.icu.text.PluralRules$FixedDecimal#isNegative", 323 "field:android.icu.text.PluralRules$FixedDecimal#source", 324 "field:android.icu.text.PluralRules$FixedDecimal#visibleDecimalDigitCount", 325 "field:android.icu.text.PluralRules$FixedDecimal#visibleDecimalDigitCountWithoutTrailingZeros", 326 "field:android.icu.text.PluralRules$FixedDecimalRange#end", 327 "field:android.icu.text.PluralRules$FixedDecimalRange#start", 328 "field:android.icu.text.PluralRules$FixedDecimalSamples#bounded", 329 "field:android.icu.text.PluralRules$FixedDecimalSamples#sampleType", 330 "field:android.icu.text.PluralRules$FixedDecimalSamples#samples", 331 "field:android.icu.text.PluralRules$StandardPluralCategories#COUNT", 332 "field:android.icu.text.PluralRules$StandardPluralCategories#VALUES", 333 "field:android.icu.text.UnicodeSetIterator#endElement", 334 "field:android.icu.text.UnicodeSetIterator#nextElement", 335 "field:android.icu.util.Calendar#WEEKDAY", 336 "field:android.icu.util.Calendar#WEEKEND", 337 "field:android.icu.util.Calendar#WEEKEND_CEASE", 338 "field:android.icu.util.Calendar#WEEKEND_ONSET", 339 "field:android.icu.util.LocaleData#DELIMITER_COUNT", 340 "field:android.icu.util.LocaleData#ES_COUNT", 341 "field:android.icu.util.LocaleData#ES_CURRENCY", 342 "field:android.icu.util.MeasureUnit#subType", 343 "field:android.icu.util.MeasureUnit#type", 344 "field:android.icu.util.VersionInfo#ICU_DATA_VERSION", 345 "field:android.icu.util.VersionInfo#ICU_DATA_VERSION_PATH", 346 "field:android.icu.util.VersionInfo#UCOL_TAILORINGS_VERSION", 347 "method:android.icu.lang.UCharacter#getCharFromName1_0(String)", 348 "method:android.icu.lang.UCharacter#getISOComment(int)", 349 "method:android.icu.lang.UCharacter#getName1_0(int)", 350 "method:android.icu.lang.UCharacter#getName1_0Iterator()", 351 "method:android.icu.lang.UCharacter#getPropertyValueEnumNoThrow(int,CharSequence)", 352 "method:android.icu.lang.UCharacter#getStringPropertyValue(int,int,int)", 353 "method:android.icu.lang.UCharacter#isJavaLetter(int)", 354 "method:android.icu.lang.UCharacter#isJavaLetterOrDigit(int)", 355 "method:android.icu.lang.UCharacter#isSpace(int)", 356 "method:android.icu.lang.UCharacter#toTitleFirst(ULocale,String)", 357 "method:android.icu.text.AlphabeticIndex#getFirstCharactersInScripts()", 358 "method:android.icu.text.BreakIterator#getBreakInstance(ULocale,int)", 359 "method:android.icu.text.CollationElementIterator#getRuleBasedCollator()", 360 "method:android.icu.text.CollationElementIterator#hashCode()", 361 "method:android.icu.text.Collator#doCompare(CharSequence,CharSequence)", 362 "method:android.icu.text.Collator#setStrength2(int)", 363 "method:android.icu.text.Collator#setVariableTop(String)", 364 "method:android.icu.text.Collator#setVariableTop(int)", 365 "method:android.icu.text.CompactDecimalFormat#CompactDecimalFormat(String,DecimalFormatSymbols,CompactStyle,PluralRules,long[],Map<String,String[][]>,Map<String,String[]>,Collection<String>)", 366 "method:android.icu.text.CurrencyPluralInfo#hashCode()", 367 "method:android.icu.text.DateFormatSymbols#getDateFormatBundle(Calendar,Locale)", 368 "method:android.icu.text.DateFormatSymbols#getDateFormatBundle(Calendar,ULocale)", 369 "method:android.icu.text.DateFormatSymbols#getDateFormatBundle(Class<? extends Calendar>,Locale)", 370 "method:android.icu.text.DateFormatSymbols#getDateFormatBundle(Class<? extends Calendar>,ULocale)", 371 "method:android.icu.text.DateFormatSymbols#getLeapMonthPattern(int,int)", 372 "method:android.icu.text.DateFormatSymbols#initializeData(ULocale,CalendarData)", 373 "method:android.icu.text.DateFormatSymbols#setLeapMonthPattern(String,int,int)", 374 "method:android.icu.text.DateIntervalFormat#DateIntervalFormat(String,DateIntervalInfo,SimpleDateFormat)", 375 "method:android.icu.text.DateIntervalFormat#getPatterns(Calendar,Calendar,Output<String>)", 376 "method:android.icu.text.DateIntervalFormat#getRawPatterns()", 377 "method:android.icu.text.DateIntervalFormat#parseObject(String,ParsePosition)", 378 "method:android.icu.text.DateIntervalInfo#DateIntervalInfo()", 379 "method:android.icu.text.DateIntervalInfo#genPatternInfo(String,boolean)", 380 "method:android.icu.text.DateIntervalInfo#getPatterns()", 381 "method:android.icu.text.DateIntervalInfo#getRawPatterns()", 382 "method:android.icu.text.DateTimePatternGenerator#addPatternWithSkeleton(String,String,boolean,PatternInfo)", 383 "method:android.icu.text.DateTimePatternGenerator#getAppendFormatNumber(String)", 384 "method:android.icu.text.DateTimePatternGenerator#getCanonicalSkeletonAllowingDuplicates(String)", 385 "method:android.icu.text.DateTimePatternGenerator#getDefaultHourFormatChar()", 386 "method:android.icu.text.DateTimePatternGenerator#getFields(String)", 387 "method:android.icu.text.DateTimePatternGenerator#getFrozenInstance(ULocale)", 388 "method:android.icu.text.DateTimePatternGenerator#getRedundants(Collection<String>)", 389 "method:android.icu.text.DateTimePatternGenerator#getSkeletonAllowingDuplicates(String)", 390 "method:android.icu.text.DateTimePatternGenerator#isSingleField(String)", 391 "method:android.icu.text.DateTimePatternGenerator#setDefaultHourFormatChar(char)", 392 "method:android.icu.text.DateTimePatternGenerator#skeletonsAreSimilar(String,String)", 393 "method:android.icu.text.DateTimePatternGenerator$FormatParser#FormatParser()", 394 "method:android.icu.text.DateTimePatternGenerator$FormatParser#getItems()", 395 "method:android.icu.text.DateTimePatternGenerator$FormatParser#hasDateAndTimeFields()", 396 "method:android.icu.text.DateTimePatternGenerator$FormatParser#quoteLiteral(String)", 397 "method:android.icu.text.DateTimePatternGenerator$FormatParser#set(String)", 398 "method:android.icu.text.DateTimePatternGenerator$FormatParser#set(String,boolean)", 399 "method:android.icu.text.DateTimePatternGenerator$FormatParser#toString()", 400 "method:android.icu.text.DateTimePatternGenerator$FormatParser#toString(int,int)", 401 "method:android.icu.text.DateTimePatternGenerator$VariableField#VariableField(String)", 402 "method:android.icu.text.DateTimePatternGenerator$VariableField#VariableField(String,boolean)", 403 "method:android.icu.text.DateTimePatternGenerator$VariableField#getCanonicalCode(int)", 404 "method:android.icu.text.DateTimePatternGenerator$VariableField#getType()", 405 "method:android.icu.text.DateTimePatternGenerator$VariableField#isNumeric()", 406 "method:android.icu.text.DateTimePatternGenerator$VariableField#toString()", 407 "method:android.icu.text.DecimalFormat#getEffectiveCurrency()", 408 "method:android.icu.text.DecimalFormatSymbols#getMinusString()", 409 "method:android.icu.text.DecimalFormatSymbols#getPlusString()", 410 "method:android.icu.text.IDNA#IDNA()", 411 "method:android.icu.text.IDNA#addError(Info,Error)", 412 "method:android.icu.text.IDNA#addLabelError(Info,Error)", 413 "method:android.icu.text.IDNA#compare(String,String,int)", 414 "method:android.icu.text.IDNA#compare(StringBuffer,StringBuffer,int)", 415 "method:android.icu.text.IDNA#compare(UCharacterIterator,UCharacterIterator,int)", 416 "method:android.icu.text.IDNA#convertIDNToASCII(String,int)", 417 "method:android.icu.text.IDNA#convertIDNToASCII(StringBuffer,int)", 418 "method:android.icu.text.IDNA#convertIDNToASCII(UCharacterIterator,int)", 419 "method:android.icu.text.IDNA#convertIDNToUnicode(String,int)", 420 "method:android.icu.text.IDNA#convertIDNToUnicode(StringBuffer,int)", 421 "method:android.icu.text.IDNA#convertIDNToUnicode(UCharacterIterator,int)", 422 "method:android.icu.text.IDNA#convertToASCII(String,int)", 423 "method:android.icu.text.IDNA#convertToASCII(StringBuffer,int)", 424 "method:android.icu.text.IDNA#convertToASCII(UCharacterIterator,int)", 425 "method:android.icu.text.IDNA#convertToUnicode(String,int)", 426 "method:android.icu.text.IDNA#convertToUnicode(StringBuffer,int)", 427 "method:android.icu.text.IDNA#convertToUnicode(UCharacterIterator,int)", 428 "method:android.icu.text.IDNA#hasCertainErrors(Info,EnumSet<Error>)", 429 "method:android.icu.text.IDNA#hasCertainLabelErrors(Info,EnumSet<Error>)", 430 "method:android.icu.text.IDNA#isBiDi(Info)", 431 "method:android.icu.text.IDNA#isOkBiDi(Info)", 432 "method:android.icu.text.IDNA#promoteAndResetLabelErrors(Info)", 433 "method:android.icu.text.IDNA#resetInfo(Info)", 434 "method:android.icu.text.IDNA#setBiDi(Info)", 435 "method:android.icu.text.IDNA#setNotOkBiDi(Info)", 436 "method:android.icu.text.IDNA#setTransitionalDifferent(Info)", 437 "method:android.icu.text.LocaleDisplayNames#LocaleDisplayNames()", 438 "method:android.icu.text.LocaleDisplayNames#scriptDisplayNameInContext(String)", 439 "method:android.icu.text.MeasureFormat#formatMeasureRange(Measure,Measure)", 440 "method:android.icu.text.MeasureFormat#getRangeFormat(ULocale,FormatWidth)", 441 "method:android.icu.text.MeasureFormat#getRangePattern(ULocale,FormatWidth)", 442 "method:android.icu.text.Normalizer#Normalizer(CharacterIterator,Mode,int)", 443 "method:android.icu.text.Normalizer#Normalizer(String,Mode,int)", 444 "method:android.icu.text.Normalizer#Normalizer(UCharacterIterator,Mode,int)", 445 "method:android.icu.text.Normalizer#clone()", 446 "method:android.icu.text.Normalizer#compose(String,boolean)", 447 "method:android.icu.text.Normalizer#compose(String,boolean,int)", 448 "method:android.icu.text.Normalizer#compose(char[],char[],boolean,int)", 449 "method:android.icu.text.Normalizer#compose(char[],int,int,char[],int,int,boolean,int)", 450 "method:android.icu.text.Normalizer#concatenate(String,String,Mode,int)", 451 "method:android.icu.text.Normalizer#concatenate(char[],char[],Mode,int)", 452 "method:android.icu.text.Normalizer#concatenate(char[],int,int,char[],int,int,char[],int,int,Normalizer.Mode,int)", 453 "method:android.icu.text.Normalizer#current()", 454 "method:android.icu.text.Normalizer#decompose(String,boolean)", 455 "method:android.icu.text.Normalizer#decompose(String,boolean,int)", 456 "method:android.icu.text.Normalizer#decompose(char[],char[],boolean,int)", 457 "method:android.icu.text.Normalizer#decompose(char[],int,int,char[],int,int,boolean,int)", 458 "method:android.icu.text.Normalizer#endIndex()", 459 "method:android.icu.text.Normalizer#first()", 460 "method:android.icu.text.Normalizer#getBeginIndex()", 461 "method:android.icu.text.Normalizer#getEndIndex()", 462 "method:android.icu.text.Normalizer#getFC_NFKC_Closure(int)", 463 "method:android.icu.text.Normalizer#getFC_NFKC_Closure(int,char[])", 464 "method:android.icu.text.Normalizer#getIndex()", 465 "method:android.icu.text.Normalizer#getLength()", 466 "method:android.icu.text.Normalizer#getMode()", 467 "method:android.icu.text.Normalizer#getOption(int)", 468 "method:android.icu.text.Normalizer#getText()", 469 "method:android.icu.text.Normalizer#getText(char[])", 470 "method:android.icu.text.Normalizer#isNormalized(String,Mode,int)", 471 "method:android.icu.text.Normalizer#isNormalized(char[],int,int,Mode,int)", 472 "method:android.icu.text.Normalizer#isNormalized(int,Mode,int)", 473 "method:android.icu.text.Normalizer#last()", 474 "method:android.icu.text.Normalizer#next()", 475 "method:android.icu.text.Normalizer#normalize(String,Mode)", 476 "method:android.icu.text.Normalizer#normalize(String,Mode,int)", 477 "method:android.icu.text.Normalizer#normalize(char[],char[],Mode,int)", 478 "method:android.icu.text.Normalizer#normalize(char[],int,int,char[],int,int,Mode,int)", 479 "method:android.icu.text.Normalizer#normalize(int,Mode)", 480 "method:android.icu.text.Normalizer#normalize(int,Mode,int)", 481 "method:android.icu.text.Normalizer#previous()", 482 "method:android.icu.text.Normalizer#quickCheck(String,Mode)", 483 "method:android.icu.text.Normalizer#quickCheck(String,Mode,int)", 484 "method:android.icu.text.Normalizer#quickCheck(char[],Mode,int)", 485 "method:android.icu.text.Normalizer#quickCheck(char[],int,int,Mode,int)", 486 "method:android.icu.text.Normalizer#reset()", 487 "method:android.icu.text.Normalizer#setIndex(int)", 488 "method:android.icu.text.Normalizer#setIndexOnly(int)", 489 "method:android.icu.text.Normalizer#setMode(Mode)", 490 "method:android.icu.text.Normalizer#setOption(int,boolean)", 491 "method:android.icu.text.Normalizer#setText(CharacterIterator)", 492 "method:android.icu.text.Normalizer#setText(String)", 493 "method:android.icu.text.Normalizer#setText(StringBuffer)", 494 "method:android.icu.text.Normalizer#setText(UCharacterIterator)", 495 "method:android.icu.text.Normalizer#setText(char[])", 496 "method:android.icu.text.Normalizer#startIndex()", 497 "method:android.icu.text.Normalizer$Mode#Mode()", 498 "method:android.icu.text.Normalizer$Mode#getNormalizer2(int)", 499 "method:android.icu.text.Normalizer2#Normalizer2()", 500 "method:android.icu.text.NumberFormat#getEffectiveCurrency()", 501 "method:android.icu.text.NumberFormat#getPattern(Locale,int)", 502 "method:android.icu.text.PluralFormat#setLocale(ULocale)", 503 "method:android.icu.text.PluralRules#addSample(String,Number,int,Set<Double>)", 504 "method:android.icu.text.PluralRules#compareTo(PluralRules)", 505 "method:android.icu.text.PluralRules#computeLimited(String,SampleType)", 506 "method:android.icu.text.PluralRules#getAllKeywordValues(String,SampleType)", 507 "method:android.icu.text.PluralRules#getDecimalSamples(String,SampleType)", 508 "method:android.icu.text.PluralRules#getKeywordStatus(String,int,Set<Double>,Output<Double>,SampleType)", 509 "method:android.icu.text.PluralRules#getRules(String)", 510 "method:android.icu.text.PluralRules#getSamples(String,SampleType)", 511 "method:android.icu.text.PluralRules#hashCode()", 512 "method:android.icu.text.PluralRules#isLimited(String)", 513 "method:android.icu.text.PluralRules#isLimited(String,SampleType)", 514 "method:android.icu.text.PluralRules#matches(FixedDecimal,String)", 515 "method:android.icu.text.PluralRules#select(FixedDecimal)", 516 "method:android.icu.text.PluralRules#select(double,int,long)", 517 "method:android.icu.text.PluralRules$Factory#Factory()", 518 "method:android.icu.text.PluralRules$Factory#forLocale(ULocale)", 519 "method:android.icu.text.PluralRules$Factory#forLocale(ULocale,PluralType)", 520 "method:android.icu.text.PluralRules$Factory#getAvailableULocales()", 521 "method:android.icu.text.PluralRules$Factory#getDefaultFactory()", 522 "method:android.icu.text.PluralRules$Factory#getFunctionalEquivalent(ULocale,boolean[])", 523 "method:android.icu.text.PluralRules$Factory#hasOverride(ULocale)", 524 "method:android.icu.text.PluralRules$FixedDecimal#FixedDecimal(String)", 525 "method:android.icu.text.PluralRules$FixedDecimal#FixedDecimal(double)", 526 "method:android.icu.text.PluralRules$FixedDecimal#FixedDecimal(double,int)", 527 "method:android.icu.text.PluralRules$FixedDecimal#FixedDecimal(double,int,long)", 528 "method:android.icu.text.PluralRules$FixedDecimal#FixedDecimal(long)", 529 "method:android.icu.text.PluralRules$FixedDecimal#compareTo(FixedDecimal)", 530 "method:android.icu.text.PluralRules$FixedDecimal#decimals(double)", 531 "method:android.icu.text.PluralRules$FixedDecimal#doubleValue()", 532 "method:android.icu.text.PluralRules$FixedDecimal#equals(Object)", 533 "method:android.icu.text.PluralRules$FixedDecimal#floatValue()", 534 "method:android.icu.text.PluralRules$FixedDecimal#get(Operand)", 535 "method:android.icu.text.PluralRules$FixedDecimal#getBaseFactor()", 536 "method:android.icu.text.PluralRules$FixedDecimal#getDecimalDigits()", 537 "method:android.icu.text.PluralRules$FixedDecimal#getDecimalDigitsWithoutTrailingZeros()", 538 "method:android.icu.text.PluralRules$FixedDecimal#getIntegerValue()", 539 "method:android.icu.text.PluralRules$FixedDecimal#getOperand(String)", 540 "method:android.icu.text.PluralRules$FixedDecimal#getShiftedValue()", 541 "method:android.icu.text.PluralRules$FixedDecimal#getSource()", 542 "method:android.icu.text.PluralRules$FixedDecimal#getVisibleDecimalDigitCount()", 543 "method:android.icu.text.PluralRules$FixedDecimal#getVisibleDecimalDigitCountWithoutTrailingZeros()", 544 "method:android.icu.text.PluralRules$FixedDecimal#hasIntegerValue()", 545 "method:android.icu.text.PluralRules$FixedDecimal#hashCode()", 546 "method:android.icu.text.PluralRules$FixedDecimal#intValue()", 547 "method:android.icu.text.PluralRules$FixedDecimal#isHasIntegerValue()", 548 "method:android.icu.text.PluralRules$FixedDecimal#isNegative()", 549 "method:android.icu.text.PluralRules$FixedDecimal#longValue()", 550 "method:android.icu.text.PluralRules$FixedDecimal#toString()", 551 "method:android.icu.text.PluralRules$FixedDecimalRange#FixedDecimalRange(FixedDecimal,FixedDecimal)", 552 "method:android.icu.text.PluralRules$FixedDecimalRange#toString()", 553 "method:android.icu.text.PluralRules$FixedDecimalSamples#addSamples(Set<Double>)", 554 "method:android.icu.text.PluralRules$FixedDecimalSamples#getSamples()", 555 "method:android.icu.text.PluralRules$FixedDecimalSamples#getStartEndSamples(Set<FixedDecimal>)", 556 "method:android.icu.text.PluralRules$FixedDecimalSamples#toString()", 557 "method:android.icu.text.RuleBasedCollator#doCompare(CharSequence,CharSequence)", 558 "method:android.icu.text.RuleBasedCollator#internalGetCEs(CharSequence)", 559 "method:android.icu.text.RuleBasedCollator#isHiraganaQuaternary()", 560 "method:android.icu.text.RuleBasedCollator#setHiraganaQuaternary(boolean)", 561 "method:android.icu.text.RuleBasedCollator#setHiraganaQuaternaryDefault()", 562 "method:android.icu.text.RuleBasedCollator#setVariableTop(String)", 563 "method:android.icu.text.RuleBasedCollator#setVariableTop(int)", 564 "method:android.icu.text.SearchIterator#setMatchNotFound()", 565 "method:android.icu.text.SimpleDateFormat#SimpleDateFormat(String,DateFormatSymbols,ULocale)", 566 "method:android.icu.text.SimpleDateFormat#getInstance(Calendar.FormatConfiguration)", 567 "method:android.icu.text.SimpleDateFormat#intervalFormatByAlgorithm(Calendar,Calendar,StringBuffer,FieldPosition)", 568 "method:android.icu.text.SimpleDateFormat#subFormat(StringBuffer,char,int,int,int,DisplayContext,FieldPosition,Calendar)", 569 "method:android.icu.text.SimpleDateFormat#subFormat(char,int,int,int,DisplayContext,FieldPosition,Calendar)", 570 "method:android.icu.text.SimpleDateFormat#zeroPaddingNumber(NumberFormat,StringBuffer,int,int,int)", 571 "method:android.icu.text.StringPrepParseException#hashCode()", 572 "method:android.icu.text.StringSearch#setMatchNotFound()", 573 "method:android.icu.text.TimeZoneNames#getDisplayNames(String,NameType[],long,String[],int)", 574 "method:android.icu.text.TimeZoneNames#loadAllDisplayNames()", 575 "method:android.icu.text.TimeZoneNames$Factory#Factory()", 576 "method:android.icu.text.TimeZoneNames$Factory#getTimeZoneNames(ULocale)", 577 "method:android.icu.text.UnicodeFilter#UnicodeFilter()", 578 "method:android.icu.text.UnicodeSet#addBridges(UnicodeSet)", 579 "method:android.icu.text.UnicodeSet#applyPattern(String,ParsePosition,SymbolTable,int)", 580 "method:android.icu.text.UnicodeSet#compare(Iterator<T>,Iterator<T>)", 581 "method:android.icu.text.UnicodeSet#findIn(CharSequence,int,boolean)", 582 "method:android.icu.text.UnicodeSet#findLastIn(CharSequence,int,boolean)", 583 "method:android.icu.text.UnicodeSet#getDefaultXSymbolTable()", 584 "method:android.icu.text.UnicodeSet#getRegexEquivalent()", 585 "method:android.icu.text.UnicodeSet#getSingleCodePoint(CharSequence)", 586 "method:android.icu.text.UnicodeSet#matchesAt(CharSequence,int)", 587 "method:android.icu.text.UnicodeSet#setDefaultXSymbolTable(XSymbolTable)", 588 "method:android.icu.text.UnicodeSet#spanAndCount(CharSequence,int,SpanCondition,OutputInt)", 589 "method:android.icu.text.UnicodeSet#stripFrom(CharSequence,boolean)", 590 "method:android.icu.text.UnicodeSetIterator#getSet()", 591 "method:android.icu.text.UnicodeSetIterator#loadRange(int)", 592 "method:android.icu.text.Transliterator#addSourceTargetSet(UnicodeSet,UnicodeSet,UnicodeSet)", 593 "method:android.icu.text.Transliterator#getFilterAsUnicodeSet(UnicodeSet)", 594 "method:android.icu.text.Transliterator#registerAny()", 595 "method:android.icu.util.Calendar#getDateTimePattern(Calendar,ULocale,int)", 596 "method:android.icu.util.Calendar#getDayOfWeekType(int)", 597 "method:android.icu.util.Calendar#getRelatedYear()", 598 "method:android.icu.util.Calendar#getWeekendTransition(int)", 599 "method:android.icu.util.Calendar#haveDefaultCentury()", 600 "method:android.icu.util.Calendar#setRelatedYear(int)", 601 "method:android.icu.util.Calendar$FormatConfiguration#getCalendar()", 602 "method:android.icu.util.Calendar$FormatConfiguration#getDateFormatSymbols()", 603 "method:android.icu.util.Calendar$FormatConfiguration#getLocale()", 604 "method:android.icu.util.Calendar$FormatConfiguration#getOverrideString()", 605 "method:android.icu.util.Calendar$FormatConfiguration#getPatternString()", 606 "method:android.icu.util.ChineseCalendar#ChineseCalendar(TimeZone,ULocale,int,TimeZone)", 607 "method:android.icu.util.ChineseCalendar#haveDefaultCentury()", 608 "method:android.icu.util.CopticCalendar#getJDEpochOffset()", 609 "method:android.icu.util.CopticCalendar#handleComputeFields(int)", 610 "method:android.icu.util.CopticCalendar#handleGetExtendedYear()", 611 "method:android.icu.util.Currency#parse(ULocale,String,int,ParsePosition)", 612 "method:android.icu.util.HebrewCalendar#isLeapYear(int)", 613 "method:android.icu.util.HebrewCalendar#validateField(int)", 614 "method:android.icu.util.JapaneseCalendar#haveDefaultCentury()", 615 "method:android.icu.util.MeasureUnit#MeasureUnit(String,String)", 616 "method:android.icu.util.MeasureUnit#addUnit(String,String,Factory)", 617 "method:android.icu.util.MeasureUnit#internalGetInstance(String,String)", 618 "method:android.icu.util.MeasureUnit#resolveUnitPerUnit(MeasureUnit,MeasureUnit)", 619 "method:android.icu.util.MeasureUnit$Factory#create(String,String)", 620 "method:android.icu.util.TimeZone#TimeZone(String)", 621 "method:android.icu.util.ULocale#getDisplayScriptInContext()", 622 "method:android.icu.util.ULocale#getDisplayScriptInContext(String,String)", 623 "method:android.icu.util.ULocale#getDisplayScriptInContext(String,ULocale)", 624 "method:android.icu.util.ULocale#getDisplayScriptInContext(ULocale)", 625 "method:android.icu.util.ULocale#minimizeSubtags(ULocale,Minimize)", 626 "method:android.icu.util.VersionInfo#getVersionString(int,int)", 627 "method:android.icu.util.VersionInfo#javaVersion()", 628 "type:android.icu.text.DateTimePatternGenerator$FormatParser", 629 "type:android.icu.text.DateTimePatternGenerator$VariableField", 630 "type:android.icu.text.Normalizer$Mode", 631 "type:android.icu.text.PluralRules$Factory", 632 "type:android.icu.text.PluralRules$FixedDecimal", 633 "type:android.icu.text.PluralRules$FixedDecimalRange", 634 "type:android.icu.text.PluralRules$FixedDecimalSamples", 635 "type:android.icu.text.PluralRules$SampleType", 636 "type:android.icu.text.PluralRules$StandardPluralCategories", 637 "type:android.icu.text.TimeZoneNames$Factory", 638 "type:android.icu.util.Calendar$FormatConfiguration", 639 "type:android.icu.util.MeasureUnit$Factory", 640 "type:android.icu.util.ULocale$Minimize", 641 }; 642 643 /** 644 * A set of declarations we don't want to expose in Android. 645 * We generally hide: 646 * Any API we find that relates to a final static primitive that a compiler could inline 647 * and could change between ICU releases. 648 * Methods that relate to registration of static defaults / factories, which cannot be 649 * configured on Android "before use", because a lot of initialization happens in the zygote. 650 */ 651 private static final String[] DECLARATIONS_TO_HIDE = { 652 /* ASCII order please. */ 653 "field:android.icu.lang.UCharacter$BidiPairedBracketType#COUNT", 654 "field:android.icu.lang.UCharacter$DecompositionType#COUNT", 655 "field:android.icu.lang.UCharacter$EastAsianWidth#COUNT", 656 "field:android.icu.lang.UCharacter$GraphemeClusterBreak#COUNT", 657 "field:android.icu.lang.UCharacter$HangulSyllableType#COUNT", 658 "field:android.icu.lang.UCharacter$JoiningGroup#COUNT", 659 "field:android.icu.lang.UCharacter$JoiningType#COUNT", 660 "field:android.icu.lang.UCharacter$LineBreak#COUNT", 661 "field:android.icu.lang.UCharacter$NumericType#COUNT", 662 "field:android.icu.lang.UCharacter$SentenceBreak#COUNT", 663 "field:android.icu.lang.UCharacter$UnicodeBlock#COUNT", 664 "field:android.icu.lang.UCharacter$WordBreak#COUNT", 665 "field:android.icu.lang.UCharacterEnums$ECharacterCategory#CHAR_CATEGORY_COUNT", 666 "field:android.icu.lang.UCharacterEnums$ECharacterDirection#CHAR_DIRECTION_COUNT", 667 "field:android.icu.lang.UProperty#BINARY_LIMIT", 668 "field:android.icu.lang.UProperty#DOUBLE_LIMIT", 669 "field:android.icu.lang.UProperty#INT_LIMIT", 670 "field:android.icu.lang.UProperty#MASK_LIMIT", 671 "field:android.icu.lang.UProperty#OTHER_PROPERTY_LIMIT", 672 "field:android.icu.lang.UProperty#STRING_LIMIT", 673 "field:android.icu.lang.UProperty$NameChoice#COUNT", 674 "field:android.icu.lang.UScript#CODE_LIMIT", 675 "field:android.icu.text.BidiClassifier#context", 676 "field:android.icu.text.CollationKey$BoundMode#COUNT", 677 "field:android.icu.text.Collator$ReorderCodes#LIMIT", 678 "field:android.icu.text.DateFormat#FIELD_COUNT", 679 "field:android.icu.text.DateTimePatternGenerator#TYPE_LIMIT", 680 "field:android.icu.util.LocaleData#ES_AUXILIARY", 681 "field:android.icu.util.LocaleData#ES_INDEX", 682 "field:android.icu.util.LocaleData#ES_PUNCTUATION", 683 "field:android.icu.util.LocaleData#ES_STANDARD", 684 // Hide new measure units until a clear use case on Android is found. 685 // The cost of these APIs is the storage due to the additional locale data embedded 686 // in the ICU data file. 687 "field:android.icu.util.MeasureUnit#DUNAM", 688 "field:android.icu.util.MeasureUnit#MOLE", 689 "field:android.icu.util.MeasureUnit#PERMYRIAD", 690 "field:android.icu.util.MeasureUnit#DAY_PERSON", 691 "field:android.icu.util.MeasureUnit#MONTH_PERSON", 692 "field:android.icu.util.MeasureUnit#WEEK_PERSON", 693 "field:android.icu.util.MeasureUnit#YEAR_PERSON", 694 "field:android.icu.util.MeasureUnit#BRITISH_THERMAL_UNIT", 695 "field:android.icu.util.MeasureUnit#ELECTRONVOLT", 696 "field:android.icu.util.MeasureUnit#NEWTON", 697 "field:android.icu.util.MeasureUnit#POUND_FORCE", 698 "field:android.icu.util.MeasureUnit#SOLAR_RADIUS", 699 "field:android.icu.util.MeasureUnit#SOLAR_LUMINOSITY", 700 "field:android.icu.util.MeasureUnit#DALTON", 701 "field:android.icu.util.MeasureUnit#EARTH_MASS", 702 "field:android.icu.util.MeasureUnit#SOLAR_MASS", 703 "field:android.icu.util.MeasureUnit#KILOPASCAL", 704 "field:android.icu.util.MeasureUnit#MEGAPASCAL", 705 "field:android.icu.util.MeasureUnit#NEWTON_METER", 706 "field:android.icu.util.MeasureUnit#POUND_FOOT", 707 "field:android.icu.util.MeasureUnit#BARREL", 708 "field:android.icu.util.MeasureUnit#FLUID_OUNCE_IMPERIAL", 709 "field:android.icu.util.MeasureUnit#BAR", 710 "field:android.icu.util.MeasureUnit#PASCAL", 711 "field:android.icu.util.MeasureUnit#THERM_US", 712 "field:android.icu.util.MeasureUnit#EARTH_RADIUS", 713 "field:android.icu.util.MeasureUnit#GRAIN", 714 "field:android.icu.util.MeasureUnit#DESSERT_SPOON", 715 "field:android.icu.util.MeasureUnit#DESSERT_SPOON_IMPERIAL", 716 "field:android.icu.util.MeasureUnit#DRAM", 717 "field:android.icu.util.MeasureUnit#DROP", 718 "field:android.icu.util.MeasureUnit#JIGGER", 719 "field:android.icu.util.MeasureUnit#PINCH", 720 "field:android.icu.util.MeasureUnit#QUART_IMPERIAL", 721 // Skeleton syntax can evolve over time. Currently, the skeleton APIs are not prioritized to 722 // be public. Android developers could easily miss the API version check for new syntax and 723 // cause app crashing on older devices. 724 // See the syntax details in https://github.com/unicode-org/icu/blob/master/docs/userguide/format_parse/numbers/skeletons.md. 725 "method:android.icu.number.NumberFormatterSettings#toSkeleton()", 726 "method:android.icu.number.NumberFormatter#forSkeleton(String)", 727 "method:android.icu.text.BreakIterator#registerInstance(BreakIterator,Locale,int)", 728 "method:android.icu.text.BreakIterator#registerInstance(BreakIterator,ULocale,int)", 729 "method:android.icu.text.BreakIterator#unregister(Object)", 730 "method:android.icu.text.CollationKey#CollationKey(String,RawCollationKey)", 731 "method:android.icu.text.Collator#getRawCollationKey(String,RawCollationKey)", 732 "method:android.icu.text.Collator#registerFactory(CollatorFactory)", 733 "method:android.icu.text.Collator#registerInstance(Collator,ULocale)", 734 "method:android.icu.text.Collator#unregister(Object)", 735 "method:android.icu.text.DecimalFormat#toNumberFormatter()", 736 "method:android.icu.text.DecimalFormatSymbols#getCurrencyPattern()", 737 "method:android.icu.text.NumberFormat#registerFactory(NumberFormatFactory)", 738 "method:android.icu.text.NumberFormat#unregister(Object)", 739 "method:android.icu.text.RuleBasedCollator#getRawCollationKey(String,RawCollationKey)", 740 "method:android.icu.text.UnicodeSet#addAllTo(Iterable<T>,T[])", 741 "method:android.icu.text.UnicodeSet#addAllTo(Iterable<T>,U)", 742 "method:android.icu.text.UnicodeSet#addAllTo(String[])", 743 "method:android.icu.text.UnicodeSet#compare(CharSequence,int)", 744 "method:android.icu.text.UnicodeSet#compare(Collection<T>,Collection<T>,ComparisonStyle)", 745 "method:android.icu.text.UnicodeSet#compare(Iterable<T>,Iterable<T>)", 746 "method:android.icu.text.UnicodeSet#compare(int,CharSequence)", 747 "method:android.icu.text.UnicodeSet#resemblesPattern(String,int)", 748 "method:android.icu.text.UnicodeSet#toArray(UnicodeSet)", 749 "method:android.icu.text.Transliterator#Transliterator(String,UnicodeFilter)", 750 "method:android.icu.text.Transliterator#baseToRules(boolean)", 751 "method:android.icu.text.Transliterator#handleGetSourceSet()", 752 "method:android.icu.text.Transliterator#handleTransliterate(Replaceable,Position,boolean)", 753 "method:android.icu.text.Transliterator#registerAlias(String,String)", 754 "method:android.icu.text.Transliterator#registerClass(String,Class<? extends Transliterator>,String)", 755 "method:android.icu.text.Transliterator#registerFactory(String,Factory)", 756 "method:android.icu.text.Transliterator#registerInstance(Transliterator)", 757 "method:android.icu.text.Transliterator#transform(String)", 758 "method:android.icu.text.Transliterator#unregister(String)", 759 "method:android.icu.text.Transliterator#setID(String)", 760 "method:android.icu.text.Transliterator#setMaximumContextLength(int)", 761 "method:android.icu.util.CECalendar#ceToJD(long,int,int,int)", 762 "method:android.icu.util.CECalendar#getJDEpochOffset()", 763 "method:android.icu.util.CECalendar#jdToCE(int,int,int[])", 764 "method:android.icu.util.Currency#registerInstance(Currency,ULocale)", 765 "method:android.icu.util.Currency#unregister(Object)", 766 "method:android.icu.util.IslamicCalendar#isCivil()", 767 "method:android.icu.util.IslamicCalendar#setCivil(boolean)", 768 "method:android.icu.util.LocaleData#getExemplarSet(int,int)", 769 "method:android.icu.util.LocaleData#getExemplarSet(ULocale,int)", 770 "method:android.icu.util.LocaleData#getExemplarSet(ULocale,int,int)", 771 "method:android.icu.util.LocaleData#getLocaleDisplayPattern()", 772 "method:android.icu.util.LocaleData#getLocaleSeparator()", 773 "method:android.icu.util.TimeZone#clearCachedDefault()", 774 "method:android.icu.util.TimeZone#getDefaultTimeZoneType()", 775 "method:android.icu.util.TimeZone#setDefault(TimeZone)", 776 "method:android.icu.util.TimeZone#setDefaultTimeZoneType(int)", 777 "method:android.icu.util.ULocale#setDefault(Category,ULocale)", 778 "method:android.icu.util.ULocale#setDefault(ULocale)", 779 "method:android.icu.util.VersionInfo#main(String[])", 780 "type:android.icu.text.Collator$CollatorFactory", 781 "type:android.icu.text.NumberFormat$NumberFormatFactory", 782 "type:android.icu.text.NumberFormat$SimpleNumberFormatFactory", 783 }; 784 785 /** 786 * ICU APIs that are in the Android SDK API but are deprecated on Android and not deprecated in 787 * ICU. Entries can be removed if ICU also decide to deprecate. 788 * Entries are usually the result of Android mistakenly exposing an API, an ICU API problem, 789 * and/or ICU's stability guarantees differing from Android's requirements. 790 */ 791 private static final Map<String, String> ANDROID_DEPRECATED_SET = Map.of( 792 /* ASCII order please. */ 793 794 // Unstable "constant" value - different values in different API levels. http://b/77850660. 795 "field:android.icu.util.JapaneseCalendar#CURRENT_ERA", 796 "Use era constants, e.g. {@link #REIWA}, instead.", 797 // The method reads unstable .nrm file format. http://b/173821060 798 "method:android.icu.text.Normalizer2#getInstance(InputStream,String,Mode)", 799 "Don't use because the binary {@code data} format is not stable across API levels." 800 ); 801 802 /** 803 * ICU APIs that are in the Android SDK API but are removed on Android and @stable in ICU. 804 * Entries can be removed if ICU also decide to remove the APIs. 805 * Entries are usually the result of Android mistakenly exposing an API, an ICU API problem, 806 * and/or ICU's stability guarantees differing from Android's requirements. 807 */ 808 private static final String[] ANDROID_REMOVED_SET = { 809 /* ASCII order please. */ 810 // Unstable "constant" value - different values in different API levels. http://b/77850660. 811 "field:android.icu.util.JapaneseCalendar#CURRENT_ERA", 812 }; 813 814 // The declarations with JavaDocs that have @.jcite tags that should be transformed to doclava 815 // @sample tags. Ones not on this list will just be escaped and could show up in the generated 816 // docs. It is assumed that the complete set of ones that should appear in the public API are 817 // listed below and it's ok to escape those that are not. 818 private static final String[] JCITE_TRANSFORM_SET = { 819 "method:android.icu.text.DateIntervalFormat#getInstance(String,Locale)", 820 "method:android.icu.text.DateIntervalFormat#getInstance(String,Locale,DateIntervalInfo)", 821 "method:android.icu.text.DateTimePatternGenerator#addPattern(String,boolean,PatternInfo)", 822 "method:android.icu.text.DateTimePatternGenerator#getBestPattern(String)", 823 "method:android.icu.text.DateTimePatternGenerator#replaceFieldTypes(String,String)", 824 "method:android.icu.text.PluralFormat#PluralFormat(ULocale,String)", 825 }; 826 827 private static final String[] DEFAULT_CONSTRUCTORS = { 828 "android.icu.text.DateTimePatternGenerator$DistanceInfo", 829 "android.icu.text.SpoofChecker$ScriptSet", 830 "android.icu.text.TimeZoneNames$DefaultTimeZoneNames$FactoryImpl", 831 }; 832 833 // Metalava disallows hidden abstract methods in public abstract classes because classes 834 // inheriting such class can cause runtime crashes instead of a compile error. Due to historic 835 // reason, we have such classes in the public SDK. This is the allowlist of hidden abstract 836 // methods, and @SuppressWarnings("HiddenAbstractMethod") annotation will be added into those 837 // methods. See http://b/147445486 for more details. 838 private static final String[] HIDDEN_ABSTRACT_METHODS = { 839 "method:android.icu.text.Collator#getRawCollationKey(String,RawCollationKey)", 840 "method:android.icu.text.Collator#setVariableTop(String)", 841 "method:android.icu.text.Collator#setVariableTop(int)", 842 }; 843 844 public static final String ANDROID_ICU4J_SAMPLE_DIR = 845 "external/icu/android_icu4j/src/samples/java"; 846 847 private static final boolean DEBUG = false; 848 849 static final String ORIGINAL_ICU_PACKAGE = "com.ibm.icu"; 850 static final String ANDROID_ICU_PACKAGE = "android.icu"; 851 Icu4jTransform()852 private Icu4jTransform() { 853 } 854 855 /** 856 * Usage: See {@link Icu4jRules#COMMAND_USAGE} 857 * 858 * The option --hide-non-allowlisted-api can be used to explicitly describe the API surface to be 859 * exposed; anything not in the list will be hidden in additional to other rules. This is useful 860 * when upgrading ICU when we haven't yet added new classes/methods to various hard-coded lists 861 * described below. 862 * 863 * This tool hides the following in the knowledge that classes that are not explicitly 864 * hidden are exposed in the public API set: 865 * 866 * 1) Public classes that are not in the PUBLIC_API_CLASSES list. 867 * 2) Types / fields / methods that were deprecated when the class was first exposed in Android, 868 * listed in INITIAL_DEPRECATED_SET 869 * 3) Types / fields / methods that we explicitly want to hide, listed in DECLARATIONS_TO_HIDE 870 * 4) Types / fields / methods that are flagged with ICU javadoc as draft / provisional or 871 * internal. 872 * 5) If the --hide-non-allowlisted-api option is provided, types / fields / methods that are not 873 * in the allowlisted-api-file. 874 */ main(String[] args)875 public static void main(String[] args) throws Exception { 876 Map<String, String> options = JavaCore.getOptions(); 877 options.put(JavaCore.COMPILER_COMPLIANCE, JavaCore.VERSION_1_8); 878 options.put(JavaCore.COMPILER_SOURCE, JavaCore.VERSION_1_8); 879 options.put(JavaCore.COMPILER_DOC_COMMENT_SUPPORT, JavaCore.ENABLED); 880 options.put(DefaultCodeFormatterConstants.FORMATTER_TAB_CHAR, JavaCore.SPACE); 881 options.put(DefaultCodeFormatterConstants.FORMATTER_TAB_SIZE, "4"); 882 883 new Main(DEBUG) 884 .setJdtOptions(options) 885 .execute(new Icu4jRules(args)); 886 } 887 888 static class Icu4jRules implements RuleSet { 889 890 private static final String SOURCE_CODE_HEADER = "/* GENERATED SOURCE. DO NOT MODIFY. */\n"; 891 private static final String COMMAND_USAGE = "Usage: " + Icu4jTransform.class.getCanonicalName() 892 + " [--hide-non-allowlisted-api <allowlisted-api-file>]" 893 + " <source-dir>+ <target-dir> <core-platform-api-file> <intra-core-api-file>" 894 + " <unsupported-app-usage-file>"; 895 896 private final InputFileGenerator inputFileGenerator; 897 private final List<Rule> rules; 898 private final BasicOutputSourceFileGenerator outputSourceFileGenerator; 899 Icu4jRules(String[] args)900 public Icu4jRules(String[] args) { 901 if (args.length < 3) { 902 throw new IllegalArgumentException(COMMAND_USAGE); 903 } 904 Path allowlistedApiPath = null; 905 if ("--hide-non-allowlisted-api".equals(args[0])) { 906 allowlistedApiPath = Paths.get(args[1]); 907 if (args.length < 6) { 908 throw new IllegalArgumentException(COMMAND_USAGE); 909 } 910 String[] newArgs = new String[args.length - 2]; 911 System.arraycopy(args, 2, newArgs, 0, args.length - 2); 912 args = newArgs; 913 } 914 915 // Extract the source directories. 916 String[] inputDirNames = new String[args.length - 4]; 917 System.arraycopy(args, 0, inputDirNames, 0, args.length - 4); 918 inputFileGenerator = Icu4jTransformRules.createInputFileGenerator(inputDirNames); 919 920 // Extract the additional arguments. 921 int argIndex = inputDirNames.length; 922 String targetDir = args[argIndex++]; 923 Path corePlatformApiFile = Paths.get(args[argIndex++]); 924 Path intraCoreApiFile = Paths.get(args[argIndex++]); 925 Path unsupportedAppUsageFile = Paths.get(args[argIndex++]); 926 927 // Ensure that all the arguments were used. 928 if (argIndex != args.length) { 929 throw new IllegalArgumentException(COMMAND_USAGE); 930 } 931 932 rules = createTransformRules(corePlatformApiFile, intraCoreApiFile, 933 unsupportedAppUsageFile, allowlistedApiPath); 934 outputSourceFileGenerator = Icu4jTransformRules.createOutputFileGenerator(targetDir); 935 } 936 937 @Override getRuleList(File ignored)938 public List<Rule> getRuleList(File ignored) { 939 return rules; 940 } 941 942 @Override getInputFileGenerator()943 public InputFileGenerator getInputFileGenerator() { 944 return inputFileGenerator; 945 } 946 947 @Override getOutputSourceFileGenerator()948 public OutputSourceFileGenerator getOutputSourceFileGenerator() { 949 return outputSourceFileGenerator; 950 } 951 952 // Rules for migrating com.ibm.icu source over to android.icu. Pulled out separately so they 953 // can be used for modifying ICU4J sample code as well. getRepackagingRules()954 static Rule[] getRepackagingRules() { 955 return new Rule[] { 956 // Doc change: Insert a warning about the source code being generated. 957 createMandatoryRule(new InsertHeader(SOURCE_CODE_HEADER)), 958 // AST change: Change the package of each CompilationUnit from com.ibm.icu to android.icu. 959 createMandatoryRule(new RenamePackage(ORIGINAL_ICU_PACKAGE, ANDROID_ICU_PACKAGE)), 960 // AST change: Change all qualified names in code and javadoc. 961 createOptionalRule(new ModifyQualifiedNames(ORIGINAL_ICU_PACKAGE, ANDROID_ICU_PACKAGE)), 962 // AST change: Change all string literals containing package names in code. 963 createOptionalRule(new ModifyStringLiterals(ORIGINAL_ICU_PACKAGE, ANDROID_ICU_PACKAGE)), 964 // AST change: Change all string literals containing paths in code. 965 createOptionalRule(new ModifyStringLiterals("com/ibm/icu", "android/icu")), 966 }; 967 } 968 createTransformRules(Path corePlatformApiFile, Path intraCoreApiFile, Path unsupportedAppUsagePath, Path allowlistedApiPath)969 private static List<Rule> createTransformRules(Path corePlatformApiFile, 970 Path intraCoreApiFile, 971 Path unsupportedAppUsagePath, 972 Path allowlistedApiPath) { 973 // The rules needed to repackage source code that declares or references com.ibm.icu code 974 // so it references android.icu instead. 975 Rule[] repackageRules = getRepackagingRules(); 976 977 // The rules needed to fix up Android's documentation rules. 978 Rule[] apiDocsRules = new Rule[] { 979 // Below are the fixes that ensure the Android API documentation generation can be run 980 // over the source. 981 982 // Doc change: Switch all documentation references from com.ibm.icu to android.icu. 983 // e.g. importantly in <code> blocks and unimportantly in non-Javadoc comments. 984 createOptionalRule( 985 new ReplaceTextCommentScanner(ORIGINAL_ICU_PACKAGE, ANDROID_ICU_PACKAGE)), 986 987 // AST change: Hide all ICU public classes except those in the PUBLIC_API_CLASSES 988 // allowlist. 989 createHidePublicClassesRule(), 990 991 // AST change: Hide ICU methods that are in INITIAL_DEPRECATED_SET and Android does not 992 // want to make public. 993 createHideOriginalDeprecatedClassesRule(), 994 // AST change: Explicitly hide blocklisted methods in DECLARATIONS_TO_HIDE such as those 995 // that get/set static default values that might lead to confusion or strange interactions 996 // between Android's ICU4J and java.text / java.util classes. 997 createHideBlocklistedDeclarationsRule(), 998 // AST change: Explicitly hide any elements that are marked as 999 // @draft / @provisional / @internal 1000 createOptionalRule(new HideDraftProvisionalInternal()), 1001 1002 // AST change: Hide new non-allowlisted API in Android temporarily 1003 // Usually used for avoiding the new API introduced by upstream to show up in Android. 1004 createHideNonAllowlistedRule(allowlistedApiPath), 1005 1006 // AST change: Add @Deprecated annotation and @deprecated doc to deprecated API in Android 1007 createMarkElementsWithDeprecatedAnnotationRule(), 1008 createMarkElementsWithDeprecatedJavadocTagRule(), 1009 1010 // AST change: Add @removed doc to removed API in Android 1011 createMarkElementsWithRemovedJavadocTagRule(), 1012 1013 1014 // AST change: Remove JavaDoc tags that Android has no need of: 1015 // @hide has been added in place of @draft, @provisional and @internal 1016 // @stable <ICU version> will not mean much on Android. 1017 createOptionalRule(new RemoveJavaDocTags( 1018 "@stable", "@draft", "@provisional", "@internal", "@since")), 1019 // AST change: Replace @icu and @icuenhanced with standard text. 1020 createOptionalRule(new ReplaceIcuTags()), 1021 1022 // AST change: Translate some of the @.jcite tags used by ICU into @sample tags used by 1023 // doclava. Those that are not translated are escaped. 1024 createTranslateJciteInclusionRule(), 1025 1026 // AST change: Add CorePlatformApi to specified classes and members 1027 createOptionalRule(AddAnnotation.markerAnnotationFromFlatFile( 1028 "libcore.api.CorePlatformApi", corePlatformApiFile)), 1029 1030 // AST change: Add CorePlatformApi to specified classes and members 1031 createOptionalRule(AddAnnotation.markerAnnotationFromFlatFile( 1032 "libcore.api.IntraCoreApi", intraCoreApiFile)), 1033 1034 // AST change: Add default constructors, must come before processor to add 1035 // UnsupportedAppUsage. 1036 createOptionalRule(new AddDefaultConstructor( 1037 TypeLocator.createLocatorsFromStrings(DEFAULT_CONSTRUCTORS))), 1038 1039 // AST change: Add UnsupportedAppUsage to specified classes and members 1040 createOptionalRule(Annotations.addUnsupportedAppUsage(unsupportedAppUsagePath)), 1041 1042 // AST change: Add @SuppressWarnings("HiddenAbstractMethod") to specified methods 1043 createHiddenAbstractMethodRule(), 1044 }; 1045 1046 List<Rule> rulesList = Lists.newArrayList(repackageRules); 1047 rulesList.addAll(Arrays.asList(apiDocsRules)); 1048 return rulesList; 1049 } 1050 createTranslateJciteInclusionRule()1051 private static Rule createTranslateJciteInclusionRule() { 1052 List<BodyDeclarationLocator> allowlist = 1053 BodyDeclarationLocators.createLocatorsFromStrings(JCITE_TRANSFORM_SET); 1054 TranslateJcite.InclusionHandler transformer = 1055 new TranslateJcite.InclusionHandler(ANDROID_ICU4J_SAMPLE_DIR, allowlist); 1056 return createOptionalRule(transformer); 1057 } 1058 createHideOriginalDeprecatedClassesRule()1059 private static Rule createHideOriginalDeprecatedClassesRule() { 1060 List<BodyDeclarationLocator> blocklist = 1061 BodyDeclarationLocators.createLocatorsFromStrings(INITIAL_DEPRECATED_SET); 1062 return createOptionalRule( 1063 new TagMatchingDeclarations(blocklist, "@hide original deprecated declaration")); 1064 } 1065 createMarkElementsWithDeprecatedAnnotationRule()1066 private static Rule createMarkElementsWithDeprecatedAnnotationRule() { 1067 List<BodyDeclarationLocator> locators = 1068 BodyDeclarationLocators.createLocatorsFromStrings( 1069 ANDROID_DEPRECATED_SET.keySet().toArray(new String[0])); 1070 return createOptionalRule(AddAnnotation.markerAnnotationFromLocators( 1071 "Deprecated", locators)); 1072 } 1073 createMarkElementsWithDeprecatedJavadocTagRule()1074 private static Rule createMarkElementsWithDeprecatedJavadocTagRule() { 1075 Map<BodyDeclarationLocator, String> locatorTags = ANDROID_DEPRECATED_SET.entrySet().stream() 1076 .collect(Collectors.toMap( 1077 (entry) -> BodyDeclarationLocators.fromStringForm(entry.getKey()), 1078 (entry) -> "@deprecated " + entry.getValue()) 1079 ); 1080 return createOptionalRule(new TagMatchingDeclarations(locatorTags)); 1081 } 1082 createMarkElementsWithRemovedJavadocTagRule()1083 private static Rule createMarkElementsWithRemovedJavadocTagRule() { 1084 List<BodyDeclarationLocator> locators = 1085 BodyDeclarationLocators.createLocatorsFromStrings(ANDROID_REMOVED_SET); 1086 return createOptionalRule(new TagMatchingDeclarations(locators, 1087 "@removed on Android but @stable in ICU")); 1088 } 1089 createHideBlocklistedDeclarationsRule()1090 private static Rule createHideBlocklistedDeclarationsRule() { 1091 List<BodyDeclarationLocator> blocklist = 1092 BodyDeclarationLocators.createLocatorsFromStrings(DECLARATIONS_TO_HIDE); 1093 return createOptionalRule( 1094 new TagMatchingDeclarations(blocklist, "@hide unsupported on Android")); 1095 } 1096 createHidePublicClassesRule()1097 private static Rule createHidePublicClassesRule() { 1098 List<TypeLocator> allowlist = TypeLocator.createLocatorsFromStrings(PUBLIC_API_CLASSES); 1099 return createOptionalRule( 1100 new HidePublicClasses(allowlist, "Only a subset of ICU is exposed in Android")); 1101 } 1102 createHiddenAbstractMethodRule()1103 private static Rule createHiddenAbstractMethodRule() { 1104 List<BodyDeclarationLocator> loactors = 1105 BodyDeclarationLocators.createLocatorsFromStrings(HIDDEN_ABSTRACT_METHODS); 1106 return createOptionalRule( 1107 AddAnnotation.markerAnnotationWithPropertyFromLocators("SuppressWarnings", 1108 "value", String.class, "HiddenAbstractMethod", loactors)); 1109 } 1110 } 1111 createHideNonAllowlistedRule(Path allowlistedApiPath)1112 private static Rule createHideNonAllowlistedRule(Path allowlistedApiPath) { 1113 List<BodyDeclarationLocator> bodyDeclarationLocators = null; 1114 if (allowlistedApiPath != null) { 1115 bodyDeclarationLocators = BodyDeclarationLocators.readBodyDeclarationLocators( 1116 allowlistedApiPath); 1117 } 1118 return createOptionalRule(new HideNonAllowlistedDeclarations(bodyDeclarationLocators, 1119 "@hide Hide new API in Android temporarily")); 1120 } 1121 } 1122