L10N: Better first-run experience / language choice

Summary

As part of the first run experience, this feature provides a locale selector available for a user to select a language available from a multi-locale build.

Reference

• Infrastructure
  • bug 634679 - Language pack add-ons installed on nightly builds must remain compatible
• Design
  • bug 653141 - allow language choice on first-run
  • bug 658278 - revise language pref UI to match new system

Available Languages (07/04 Nightly)

• Pусский
• Español
• Italiano
• Čeština
• Français
• Deutsch
• Português
• English (US)
• Dansk
• 日本語
• Suomi
• Polski
• Norsk bokmål
• Nederlands

Use Cases to Test

Note: This test outline is a brain storm and checklist of all possible conditions to consider for testing.

Basic Functional Testing

• First-Run Screen
  • If the detected Android Operating system language in use is a language other than en-US (English), the Language Picker will be shown on first run. The Language Picker will allow one to download an available language pack through AMO and apply it to the newly created Firefox profile:
    • Note: Android phones ship with a varied amount of different languages
    • Testing
      • Nightly: http://people.mozilla.org/~wjohnston/nightly_locales.xml
      • Aurora: Using http://people.mozilla.org/~wjohnston/aurora_locales.xml
  • If the detected Android Operating system language is en-US (English), the Language Picker selection screen will be skipped.
  • After selecting a language and continuing in the selected language, Firefox should start with the first-run experience after downloading and applying the selected language.
• Choosing a different language screen
  • Available languages should be listed and scrollable in both landscape and portrait mode
  • Each language item should be selectable
  • Locale changes to UI should take affect on selection (Continue in language) and (Choose a different language) if locales are localized

Edge Cases

• Selecting an Android Operating System device language *while* Firefox is running *with* internal language set to 'Automatic Detection' should not trigger a restart of the browser and apply the device language if available.

Release Criteria

The locale selector feature must exhibit and execute the following functions successfully

1. First-run entry (on new profile creation) gate
2. Ability to select a number of available locales through user input via radio button
3. Proceed to start Firefox with the locale selected and applied to the profile

Test Cases

Litmus

• #22913 - Verify presence of locale picker on first-run
• #22914 - Verify listing of available languages in locale picker
• #22915 - Verify selecting and applying new locale
• #22926 - Verify that no locale picker is visible on first run, if Android OS language is not set to English
• #22930 - Verify the presence of the "Change Language" link on about:home on first run
• #22931 - Verify language selection using the "change language" link on about:home on first run

Bugs

• bug 653141 - Allow language choice on first-run
• bug 662623 - After application multi-task, language selection screen is not restored resulting in no language selection and a broken user interface
• bug 668834 - Show "Change Language" link on about:home on firstrun
• bug 666973 - Don't show localepicker if system locale is available
• bug 664285 - Locale picker shows an empty box on first start (Dutch locale)
• bug 666357 - Offered locale picker with Japanese Android OS locale

Localization Related

• bug 665523 - Reference to *English* despite language change in the continue button

 bug 665583 - [es-AR] Spanish (Argentina) name should refer to this locale's language name  
 bug 665584 - [ar] Arabic name should refer to this locale's language name  
 bug 665585 - [cs] Czech name should refer to this locale's language name  
 bug 665587 - [gl] Galician name should refer to this locale's language name  
 bug 665589 - [lt] Lithuanian name should refer to this locale's language name  
 bug 665590 - [pt-PT] Portuguese (Portugal) name should refer to this locale's language name  
 bug 665591 - [ru] Russian name should refer to this locale's language name  
 bug 665592 - [zh-TW] Chinese (Traditional) name should refer to this locale's language name  
 bug 665593 - [tr] Turkish name should refer to this locale's language name