# AndroidResTranslator

**Repository Path**: abbasspace/android-res-translator

## Basic Information

- **Project Name**: AndroidResTranslator
- **Description**: java控制台构建的安卓res语言翻译程序。使用dom4j解析。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-13
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AndridStringsXML, translation, dom4j, CIL, WindowsCIL

## README

# AndroidResTranslator

> **⚠️ 本仓库已废弃（Deprecated）**
>
> 本项目为早期 **Java 控制台** 版本，已不再维护。请使用 successor 项目 **AndroidResTranslator（KMP Translator）**——基于 Kotlin Multiplatform + Compose Multiplatform，提供图形界面，支持桌面 / Android / iOS，功能更完整、使用更简单。
>
> **新仓库（推荐）**：[https://gitee.com/abbasspace/translator](https://gitee.com/abbasspace/translator)  
> GitHub 镜像：[https://github.com/Abdulla-abs/Translator](https://github.com/Abdulla-abs/Translator)

---

## 为什么迁移到新项目？

| 本仓库（已废弃） | 新项目 [translator](https://gitee.com/abbasspace/translator) |
|------------------|--------------------------------------------------------------|
| Java 控制台，需改代码或跑 `Dom4j.java` | **图形界面**：拖拽上传、进度条、设置页配置 API |
| 单模块命令行工具 | **跨平台**：Windows / macOS / Linux / Android / iOS |
| 基础批量翻译、xls 互转 | 单文件全量/增量翻译、双 XML 对比、多语言 `res/` 项目管理、版本历史、导出 xlsx/xml |
| 多厂商 API（需手写 `config.properties`） | 同上厂商支持，可在 **设置** 内填写密钥，无需改代码 |

**快速开始（桌面版）**：克隆新仓库 → 配置 `config.properties` → 运行 `./gradlew :composeApp:run`（Windows 使用 `gradlew.bat`）。详见新仓库 README。

---

## 历史说明（仅供查阅）

以下为旧版 Java 控制台项目的文档摘要。**新用户请勿再基于本仓库开发或部署。**

#### 介绍

java 控制台构建的安卓 res 语言翻译程序，使用 **dom4j** 解析。

- **一键翻译**：单语言转多语言、单语言转单语言
- **支持配置多种翻译 API**：某厂商不支持 A→B 时可切换 B 厂商（需自行配置）
- **转 xls 表格**：按 key 整合各语言 `strings.xml` 为 xls（无排序）
- **xls 转 xml**：对比 value 后写回 xml
- **多态翻译**：全量翻译、填充翻译

更详细的旧版介绍与 demo：[CSDN - AndroidTranslator 使用介绍](https://blog.csdn.net/qq_49757305/article/details/141025484)

#### 软件架构（旧版）

- `TranslationConsumer`：翻译接口
  - `AbsTranslationConsumer`：文件翻译流程
    - `FilledTranslationConsumer`：填充翻译
    - `AllReplaceTranslationConsumer`：全量翻译
- `TranslationAble` → `LangSupportHandler` → 各厂商实现（百度、火山、腾讯、有道、Lingvanex 等）
- `TranslationManager`：翻译入口

#### 旧版使用入口

- 翻译：`Dom4j.java`
- xml 转 xls：`StringXmlOutput.java`
- xls 转 xml：`Jxl2Dom4j.java`
- 配置：`config.properties`（私有配置可用 `config-private.properties`）

#### 许可证

本仓库历史代码的许可以仓库内文件为准。Successor 项目采用 **MIT License**。