godotengine / godotengine/android-editor-buildenv-app

Help us translate the app (Call for Translators)

Open
#37 5 comments 1 reaction 0 assignees View on GitHub
help wanted i18n
Dominant language
Kotlin
Stars
68
Forks
11
Avg merge
21m
Merged PRs (30d)
1

Description

To make this app accessible to everyone around the world, we are looking for volunteers to help translate the app into different languages.

You **do not** need any coding experience to help!

> [!NOTE]
> The app currently has [very few strings](https://github.com/godotengine/android-editor-buildenv-app/blob/main/app/src/main/res/values/strings.xml), so it should only take you about 5-10 minutes of your time.

### Option 1: Translate Using Android Studio

If you're familiar with Android development, you can translate directly in Android Studio. See official doc for more details: https://developer.android.com/studio/write/translations-editor

---

### Option 2: Translate Without Android Studio

If you don't have Android Studio, you can still help!

**Step 0**: [Fork the Repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)
Before making any changes, you need your own copy of the project to work on.
- Look at the top-right corner of this repository page and click the Fork button.
- You can now make your changes directly inside your forked version (either on your computer or right here on GitHub using the web editor).

**Step 1**: Go to `app/src/main/res/` and look for your language's folder. Android uses specific folder names based on [ISO language codes](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) (example, `values-es` for Spanish, `values-hi` for Hindi).

- If your language folder ALREADY exists: Open that folder and move to Step 2.

- If your language folder DOES NOT exist: Set Up a New Translation File
- Create a new folder named `values-[language-code]`.
- Inside your new folder, create a blank file named `strings.xml`.
- Go to the main file at [app/src/main/res/values/strings.xml](https://github.com/godotengine/android-editor-buildenv-app/blob/main/app/src/main/res/values/strings.xml) and copy its entire content.
- Paste that copied content into your newly created `strings.xml` file.

**Step 2**: Open your language's `strings.xml` file. Look for the text wrapped inside the tags. Only translate the text between the `>` and `` symbols.
- Do NOT change the `name="..."` attribute. This is the key the app uses to find the text.
- Example: `Change Hello` to `Hola`.
- Note for existing translations: If the file already exists, look for lines that are still in English or compare it to the main English file `app/src/main/res/values/strings.xml` to see if we added new keys that need translating.

**Step 3**: Save your file and submit a Pull Request to this repository.

---
If you have any questions or get stuck, just leave a comment below and we will help you out.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.