Updating locales for specific projects

These are instructions to update locales for Android mobile products living within the android-l10n project.

Edit the l10n.toml file(s)

All Android products live within the android-l10n repository. Depending on the product that requires a locale to be added or removed, the corresponding l10n.toml file will have to be edited by updating the list of locale codes in it.

The l10n.toml files live in their corresponding project folder, located here for:

• Fenix
• Android Components
• Focus for Android

Each l10n.toml file typically looks like this:

basepath = "."

locales = [
    "an",
    "ar",
    "as",
    "ast",
    "az",
...
]

[env]

[[paths]]
  reference = "app/src/main/res/values/strings.xml"
  l10n = "app/src/main/res/values-{android_locale}/strings.xml"

Identify the locales section, add or update the desired locale code in this list, making sure that the list is in alphabetical order.

Save your edited file, then commit and push from your local clone to the android-l10n repository.

Note that:

• All products share strings with Android Components, so you will also have to edit the Android Components l10n.toml file as well if it’s a brand new locale.
• In case of removal of a locale, files need to be manually removed from the repository.

Updating locales in Pontoon

Once the patch has landed, the locale has to be added — or removed — in Pontoon as well. The steps to follow can be found in the existing Pontoon documentation.

One thing to note is that, once you merge the pull request adding or removing locales in the localization repository, automation will send that updated list over to the mozilla-firefox Android code repository.

You can check the status of l10n imports by using this filtered search.

Language names

English and native language names are used in the language switcher, but they’re not always available through CLDR.

For Firefox for Android there are two separate maps defined in LocaleUtils.kt:

• LOCALE_TO_DISPLAY_NATIVE_NAME_MAP. When adding a new locale, the native language name should be added to this map. While not strictly required in all cases, given that different versions of Android support different versions of CLDR it’s generally safer to add it.
• LOCALE_TO_DISPLAY_ENGLISH_NAME_MAP. This is a map of language names in English. It’s not necessary to add a new locale in this map if the native and English names are identical.

For Focus, there is a supplemental map defined in LocaleDescriptor.kt (fillLanguageCodeAndNameMap). Unlike Firefox for Android, Focus falls back to Android’s built-in locale.getDisplayName() for locales not in this map. A new locale only needs to be added here if Android/ICU doesn’t know it — in practice, this usually affects smaller languages that are not available in CLDR.