diff options
| -rw-r--r-- | data/fonts/fonts.xml | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/data/fonts/fonts.xml b/data/fonts/fonts.xml index d8e6db7e35a4..76598a06c165 100644 --- a/data/fonts/fonts.xml +++ b/data/fonts/fonts.xml @@ -1,8 +1,22 @@ <?xml version="1.0" encoding="utf-8"?> <!-- - All fonts without names are added to the default list. Fonts are chosen - based on a match: full BCP-47 language tag including script, then just - language, and finally order (the first font containing the glyph). + WARNING: Parsing of this file by third-party apps is not supported. The + file, and the font files it refers to, will be renamed and/or moved out + from their respective location in the next Android release, and/or the + format or syntax of the file may change significantly. You must not + parse this file for information about system fonts. Instead, you must + call android.text.FontManager#getSystemFonts(). For example, it can be + called as context.getSystemService(FontManager.class).getSystemFonts(). + Note that the returned FontConfig includes data on all the defined font + families and all the details about weight, style, etc. It also provides + an open file descriptor to each font file. Note that callers of the API + should ensure they close the given file descriptors once they are done + using them. + + In this file, all fonts without names are added to the default list. + Fonts are chosen based on a match: full BCP-47 language tag including + script, then just language, and finally order (the first font containing + the glyph). Order of appearance is also the tiebreaker for weight matching. This is the reason why the 900 weights of Roboto precede the 700 weights - we |