Android-Studio-ZH

Android Studio Simplified Chinese localization helper.

This repository documents and automates a reproducible way to install the official JetBrains Simplified Chinese language bundle into Android Studio builds that do not expose the bundle through the plugin marketplace.

Source

The Simplified Chinese language bundle is provided by JetBrains in recent IntelliJ IDEA distributions.

• Official source archive: JetBrains IntelliJ IDEA Linux tarball
• Bundle location inside the archive: plugins/localization-zh/lib/localization-zh.jar
• Plugin ID: com.intellij.zh
• Locale: zh-CN

This repository does not redistribute JetBrains or Google binaries. The script downloads the matching IntelliJ IDEA archive from JetBrains, extracts the localization bundle locally, adjusts the compatible build range for Android Studio, and installs it into the current user's Android Studio plugin directory.

Tested Build

Tested with:

• Android Studio build: AI-261.23567.138.2611.15646644
• IntelliJ platform build: 261.23567.138
• Source bundle: IntelliJ IDEA 2026.1.1, localization-zh.jar

Quick Install

git clone https://github.com/wintopic/Android-Studio-ZH.git
cd Android-Studio-ZH
./scripts/install-android-studio-zh.sh

By default, the script expects Android Studio at:

$HOME/.local/opt/android-studio

Use --studio-dir if your Android Studio is installed elsewhere:

./scripts/install-android-studio-zh.sh --studio-dir /path/to/android-studio

After installation, fully quit Android Studio and start it again.

What The Script Does

1. Reads Android Studio's build.txt, for example AI-261.23567.138.2611.15646644.
2. Extracts the IntelliJ platform build, for example 261.23567.138.
3. Finds the matching IntelliJ IDEA release from JetBrains' official release API.
4. Downloads the official IDEA Linux tarball.
5. Extracts plugins/localization-zh.
6. Updates META-INF/plugin.xml so the bundle can load in Android Studio's 261.* platform branch.
7. Installs it to the user plugin directory, for example:

$HOME/.local/share/Google/AndroidStudio2026.1.1/localization-zh

8. Sets Android Studio's selected locale to zh-CN in:

$HOME/.config/Google/AndroidStudio2026.1.1/options/ide.general.xml

General Manual Method

If you want to do it manually:

1. Open Android Studio's build.txt.
2. Convert the build from AI-261.23567.138.2611.15646644 to the IntelliJ platform build 261.23567.138.
3. Download the IntelliJ IDEA release with the same platform build from JetBrains.
4. Extract:

plugins/localization-zh

5. Edit localization-zh/lib/localization-zh.jar:

mkdir /tmp/localization-zh-patch
cd /tmp/localization-zh-patch
unzip /path/to/localization-zh.jar META-INF/plugin.xml

Change:

<idea-version since-build="261.23567.138" until-build="261.23567.138" />

to:

<idea-version since-build="261" until-build="261.*" />

Then update the jar:

zip -u /path/to/localization-zh.jar META-INF/plugin.xml

6. Copy the localization-zh directory into Android Studio's user plugin directory:

$HOME/.local/share/Google/<AndroidStudioDataDirectory>/localization-zh

The data directory is recorded in Android Studio's product-info.json as dataDirectoryName.

Uninstall

Remove the installed plugin directory:

rm -rf "$HOME/.local/share/Google/AndroidStudio2026.1.1/localization-zh"

Then change the IDE language back to English from Android Studio settings, or remove the LocalizationStateService component from:

$HOME/.config/Google/AndroidStudio2026.1.1/options/ide.general.xml

Notes

• This is not an official JetBrains or Google project.
• The script only installs files into the current user's home directory.
• Android Studio updates may require running the script again, because the IntelliJ platform build can change.
• The repository license covers only the scripts and documentation in this repository. JetBrains and Google binaries remain governed by their own licenses.

Related Project

The approach is inspired by:

• kitty-panics/android-studio-ja-ko-zh