# android-CN

**Repository Path**: OpenFlun/android-CN

## Basic Information

- **Project Name**: android-CN
- **Description**: 安卓IDE汉化教程及所需附件
- **Primary Language**: Unknown
- **License**: ISC
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-17
- **Last Updated**: 2026-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



 介绍
适配安卓IDE中文包(通用版)

安装教程

步骤1:![步骤1:](1.png)


步骤2:![步骤2:](2.png)
步骤3:

![步骤3:](3.png)

步骤4:![步骤4:](4.png)


步骤5:![步骤5:](5.png)
步骤6:

![步骤6:](6.png)

---

## 通用版制作指南

本指南适用于已从官方下载原始语言包插件(`zh.xxx.zip`),希望自行修改并制作成通用版的场景;

---

### 前置准备

- 从 [JetBrains 官方插件页面](https://plugins.jetbrains.com/plugin/13710-chinese-simplified-language-pack----/versions) 下载对应版本的 `Chinese (Simplified) Language Pack` 插件(`.zip` 文件);
- 安装 **7-Zip**(推荐)或 WinRAR,用于直接编辑 JAR 包内的文件,无需反复解压打包;
- 确认你的 Android Studio 版本 Build 号(`Help` > `About` 中查看);

---

### 核心原理

插件安装时,IDE 会检查 `<idea-version>` 标签中的版本范围:
- `since-build` ≤ 你的 IDE Build 号 ≤ `until-build`

官方包为了"稳定",会将 `until-build` 锁定为当前大版本(例如 `261.*`),导致在新版 IDE 上提示"不兼容";
**只需将 `until-build` 改大(如 `9999.*`),即可解除限制,让插件通用于所有未来版本;**

---

### 操作步骤

#### 步骤 1:解压原始 ZIP
将下载的 `zh.xxx.zip` 解压,你会得到:
```
zh.xxx/
├── lib/
│   └── zh.xxx.jar    (核心文件)
└── (可能还有 dotnet/ 等无关文件夹,无需理会)
```

#### 步骤 2:直接修改 JAR 包内的 plugin.xml(关键)
1. 用 **7-Zip** 直接**双击打开** `lib` 文件夹下的 `zh.xxx.jar`(**不要解压**);
2. 在 7-Zip 窗口中,进入 `META-INF` 文件夹,找到 `plugin.xml`;
3. **将 `plugin.xml` 拖拽到桌面**(这会自动解压出该文件);
4. 用任意文本编辑器(记事本、VS Code 等)打开桌面的 `plugin.xml`,找到以下代码:
   ```xml
   <idea-version since-build="252" until-build="261.*" />
   ```
   将其中的 `until-build` 修改为:
   ```xml
   <idea-version since-build="252" until-build="9999.*" />
   ```
   > **注意**:`since-build` 保持原样不动(例如 `252`),无需修改;
5. 保存文件,然后将桌面上修改好的 `plugin.xml` **拖回** 7-Zip 窗口中的 `META-INF` 文件夹内,弹出提示时选择"确定"覆盖原文件;
6. 关闭 7-Zip 窗口,修改完成;

#### 步骤 3:(可选)重命名 JAR 文件
将修改后的 `zh.xxx.jar` 重命名为便于识别的名称,例如:
```
zh_CN_Universal.jar
```

#### 步骤 4:安装(终极简便方式)
1. 打开 Android Studio,进入 `File` > `Settings` > `Plugins`;
2. 点击齿轮图标 ⚙️,选择 **`Install Plugin from Disk...`**;
3. 在文件选择对话框中,**将右下角的文件类型筛选器切换为 `*.jar`**;
4. 选中你修改好的 `zh_CN_Universal.jar`,点击 **OK**;
5. 安装完成后,重启 IDE,在 `Settings` > `Appearance & Behavior` > `System Settings` > `Language and Region` 中切换语言为 `Chinese`;

> ✅ **就是这么简单!** 你不需要再折腾任何 ZIP 打包,因为 `.jar` 本身就是一个完整且合法的单文件插件包,IDE 原生支持直接安装;

---

### 为什么推荐直接用 JAR 安装?

| 打包方式         | 优点                                     | 缺点                                                                            |
| :--------------- | :--------------------------------------- | :------------------------------------------------------------------------------ |
| **标准 ZIP 包**  | 符合官方发布形式,适合大规模分发          | 打包时极易因目录层级问题导致 `Fail to load plugin descriptor` 错误,新手容易踩坑 |
| **直接安装 JAR** | 操作简单,零打包错误风险,一次修改永久使用 | 文件类型需手动切换为 `.jar`(仅此一步)                                         |

**结论**:对于个人使用或小范围分享,直接安装 `.jar` 是最省心、最可靠的方式;

---

### 附:文件结构示意(仅供参考,无需执行)

如果你**确实需要**制作标准的 ZIP 安装包(例如用于正式发布),请确保压缩包内第一层目录直接是:

```
your_plugin.zip
├── lib/
│   └── zh_CN_Universal.jar
└── META-INF/
    ├── plugin.xml
    └── pluginIcon.svg
```

> ⚠️ **打包提醒**:进入文件夹内部,**全选** `lib` 和 `META-INF` 两个文件夹,右键压缩,**绝对不能**多一层父目录;

---

### 常见问题 Q&A

**Q:`since-build` 需要改成我的版本号(如 261)吗?**
A:**不需要;** 保持 `252` 即可;它代表"最低兼容版本",设低一点没有副作用,且能兼容更多旧版 IDE;你只需要改大 `until-build`;

**Q:修改后安装时提示"插件签名无效"怎么办?**
A:这是正常提示,因为修改后签名已失效;在插件设置中勾选 **`Accept non-bundled plugins from any source`**(接受来自任何来源的非捆绑插件)即可继续安装;

**Q:以后 Android Studio 升级了,还需要重新修改吗?**
A:不需要;因为 `until-build="9999.*"` 已覆盖所有未来版本,只要插件内部字符串资源没有发生结构性变动,就可以一直通用;

**Q:为什么我打包的 ZIP 总是报 `Fail to load plugin descriptor`?**
A:100% 是目录层级错误;请直接用上述"直接安装 JAR"的方式,跳过 ZIP 打包这一陷阱;

---

### 版本记录

| 日期       | 版本 | 说明                                                |
| :--------- | :--- | :-------------------------------------------------- |
| 2026-08-12 | v1.0 | 初始通用版制作指南,基于 `until-build="9999.*"` 方案 |

---

现在,你可以将修改好的 `zh_CN_Universal.jar` 作为最终附件随 README 一同发布;使用者只需按"安装教程"中的步骤直接选择该 JAR 文件即可,无需任何额外操作;🎉