Skip to content

docs: update testing-in-different-locales.md to include OS version #138

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: update testing-in-different-locales.md to include OS version #138

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 39 additions & 1 deletion advanced/testing-in-different-locales.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
# Test in different locales

It is possible to use `maestro start-device` command to create a new device with a custom locale. This functionality enables an option to write and test Maestro flows for different languages. The parameter `--device-locale` is a combination of [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) + [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1), separated by an underscore `_` symbol in between them.
It is possible to use `maestro start-device` command to create a new device with a custom locale and OS version. This functionality enables an option to write and test Maestro flows for different languages and operating system versions.

The parameter `--device-locale` is a combination of [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) + [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1), separated by an underscore `_` symbol in between them.

The parameter `--os-version` allows you to specify the operating system version for the device:
- **iOS**: 16, 17, 18
- **Android**: 28, 29, 30, 31, 33

Let's see some examples:

Expand All @@ -20,8 +26,40 @@ maestro start-device \
```
{% endcode %}

{% code title="Create a new iOS simulator with specific OS version and locale" %}
```console
maestro start-device \
--platform ios \
--os-version 17 \
--device-locale it_IT
```
{% endcode %}

{% code title="Create a new Android emulator with specific API level and locale" %}
```console
maestro start-device \
--platform android \
--os-version 33 \
--device-locale fr_FR
```
{% endcode %}

Below you can find a full list of supported device locales per platform.

## Supported OS Versions

### iOS
- **16**: iOS 16.x
- **17**: iOS 17.x
- **18**: iOS 18.x

### Android (API Level)
- **28**: Android 9 (API level 28)
- **29**: Android 10 (API level 29)
- **30**: Android 11 (API level 30)
- **31**: Android 12 (API level 31)
- **33**: Android 13 (API level 33)

### Supported device locales on Android

| Language code | Language name |
Expand Down