Android Code Studio中文定制版在 Android 设备上开发真正的 Gradle Android 应用——并在原版基础上针对中文开发者、国内网络环境与 AI 辅助开发做了大量增强。这是什么Android Code StudioACS是一个运行在 Android 设备上的完整 IDEGradle 构建、终端、SDK/NDK 管理、代码补全、UI 设计器、Git 集成以及一个项目感知的 AI 编程助手。本仓库是它的一个 fork不是简单的代码镜像。在保持与上游同步的基础上本 fork 做了以下方向的深度定制本 fork 的定制优势1. AI 助手工具调用架构与 60 工具上游的 AI 助手是「生成文本 按标记写文件」的单轮模式。本 fork 移植并扩展了完整的工具调用 agent 循环——AI 能多轮调用工具、读构建日志、装应用、看崩溃形成「读代码 → 改代码 → 构建 → 安装 → 启动 → 读日志」的闭环。60 个内置工具ToolNames常量表 63 项覆盖文件、Shell、Git、构建、设备控制、Web、图像、MCP 等另有 MCP server 与自定义 agent 动态扩展的工具纯 JVM 工具层core/ai-tool等 4 个模块零 Android 依赖1100 条单元测试全绿后台命令执行run_in_backgroundtask_output/task_stop——跑长构建不再干等多子 agent 流水线agent_pipeline依赖编排 同层并行 写范围互斥长期记忆、Skill 市场、自定义 agent、MCP含 stdio 传输上下文裁剪与压缩、JSONL 会话持久化进程被杀后可恢复2. 13 个 AI 服务商预设国内服务商优先针对国内开发者补齐了服务商生态新增同类服务商只需加一行代码国际国内其他Anthropic Claude、OpenAI、xAI Grok、Groq、OpenRouterDeepSeek、智谱 GLM、月之暗面 Kimi、阿里通义千问、MiniMax、硅基流动本地模型Ollama 等、自定义端点默认服务商为DeepSeek国内直连可用支持 1M token 上下文窗口标记、推理强度reasoning effort逐服务商配置每个服务商可配置 4 槽位模型main / haiku / sonnet / opus 语义3. 云编译GitHub Actions 一键出包手机上点一下云端出包——无需本地构建工具栏与侧栏入口自动识别项目仓库与 workflow一键触发、job 级实时进度、失败自动提取关键日志行支持取消构建与历史构建列表出包目标选择勾选 Android / 桌面 / Web / iOS未选中的 job 直接跳过不耗配额GitHub 登录两种方式Device Flow浏览器授权或手动 PAT加密存储没有远程仓库一键创建 GitHub 私有仓库并推送AI 助手也能触发github_actions_build/github_actions_status4. 应用内热更新增量补丁接入了类 Tinker 的补丁机制小改动不必重新下载整包发版时 CI 自动从上一版本 APK 生成增量补丁只含差异 dex/资源用户端检测到补丁 → 下载 → SHA-256 校验 → base 版本校验 → 应用补丁生成失败不影响整包发布整包通道始终可用修复了 DEX 命名跳号导致补丁静默失效的关键缺陷5. 手机自动化与设备工具AI 助手可以直接操作手机做 UI 测试与调试phone_uiautomator——uiautomator2 代理Unicode 输入、等待消失、多点触控、滚动到元素phone_ocr——屏幕截图 OCR返回文本与像素包围盒phone_screenshot/phone_click/phone_swipe/phone_input_text等一整套设备操作工具 基线对比phone_baselineimage_tool——色键/亮度键抠图、裁剪、缩放、主色提取logcat_read/install_apk/launch_app——构建产物直接上机验证6. CodeGraph 语义索引为项目建立符号级语义索引——AI 检索代码从「grep 文本」升级为「符号 调用关系」一次查询拿到源码与调用链大幅减少无谓的文件读取。应用内一键下载/管理组件走 Gitee Release 分发规避国内设备访问 GitHub 超时AI 工具codegraph直接查询索引找符号 / 调用者 / 被调用者 / 影响面7. 中文开发者体验中文优先界面文案、模板描述、本 README 均为中文新建项目向导每个模板都带中文描述如「跨平台一份 Kotlin Compose 代码出 Android、桌面、网页三个平台」跨平台模板显示**「跨平台」徽标**、排在模板列表末尾便于区分国内镜像源内置三个跨平台模板生成的工程已配好阿里云 / 腾讯镜像仓库settings.gradle 仓库与 wrapper 下载地址设备上创建项目即可构建不必手动改源网络适配Gitee 镜像分发、CodeGraph 组件走 Gitee Release国内直连全部内置模板Empty、Basic Activity、Bottom Navigation、Navigation Drawer、Responsive、Compose、Native C、Game (LibGDX)、Quick Develop、Compose Multiplatform、React Native、Flutter8. 跨平台项目模板本 fork 新增上游只有 Android 模板。本 fork 新增三个跨平台模板均由真实工程骨架固化而成生成后可直接构建非占位文件模板技术栈出包编辑器支持Compose MultiplatformCMP 1.10.3 / Kotlin 2.2.20 / AGP 8.13.0Android 本地构建 桌面/Web 云端出包三 OS 矩阵Kotlin 补全原生React NativeRN 0.81.4 / Kotlin 2.1.20 / Gradle 8.14.3 / compileSdk 36Android 本地 iOS/Web 云端TS 语言服务器补全 诊断 TS/TSX 语法高亮FlutterFlutter 3.47.7 / Dart 3.13.5Android 本地 iOS/Web/桌面 云端Dart 分析服务器补全 诊断 Dart 语法高亮云端出包三个模板的 workflow 均支持「云编译」一键触发见上并支持出包目标选择勾选平台未选中的 job 跳过编辑器语言支持本 fork 为 RN/Flutter 模板接入了 TS / Dart 语言服务器与 tree-sitter 语法高亮上游编辑器对这两种语言只有纯文本零配置构建模板生成的工程自带 Gradle wrapper、图标、主题与镜像源在设备上npm install/flutter工具链就绪后即可构建 APK9. 其他增强编辑器与 AI 联动AI 改文件后编辑器自动刷新修复「自动保存静默覆盖 AI 修改」数据丢失级缺陷Dart / TypeScript 语法高亮集成 tree-sitter 语言包运行完成通知AI 任务完成时状态栏提醒CI 发布流水线GitHub Actions 构建 → 验签 → 发 Release → 同步updater.json→ 生成热更新补丁全自动安装请仅从可信来源安装——本 fork 的官方渠道为GitHub Releases主渠道https://github.com/706412584/android-code-studio/releasesGitee 镜像https://gitee.com/wu-yongchengsvip_admin/android-code-studio下载 APK 安装后按应用内指引安装构建工具SDK 等。本 fork 与上游使用不同的签名密钥。从上游版本切换过来需要卸载重装会丢失应用内数据本 fork 内部的版本升级支持覆盖安装并支持热更新增量补丁。与原版上游的关系上游https://github.com/AndroidCSOfficial/android-code-studio本 fork 定期合并上游更新定制功能以独立模块/提交形式维护尽量不侵入上游代码结构上游的 Issue 请不要提到本 fork 的定制功能本 fork 的问题请提到本仓库 Issues功能总览含上游能力Gradle 构建支持AGP 7.2.0 项目JDK 11 JDK 17终端内置 Termux 环境含常用包SDK NDK 管理自定义环境变量构建与终端共用API 信息提示since / removed / deprecated日志阅读器应用实时日志语言服务器Java / XML / Kotlin本 fork 增加 TS / DartUI 设计器布局预览、资源解析、拖拽、属性编辑器Asset Studio图标与图形生成插件/子模块创建器Git 集成AI Agent项目感知助手本 fork 大幅增强见上已知限制项目须使用 AGP v7.2.0 或更新版本旧项目需先迁移SDK Manager 部分工具如 NDK无法在设备上安装官方工具链不含 Android 版本后台命令的输出为命令结束后一次性交付非流式终端读取为只读不向终端注入命令热更新补丁要求补丁 base 版本与当前安装版本一致跨版本会回退整包更新应用仍处于积极开发阶段可能不稳定遇到问题欢迎提 Issue参与贡献上游贡献指南见 CONTRIBUTING.md翻译上游使用 Crowdin本 fork 的定制功能欢迎提交 Issue / PR致谢Rosemoe — sora-editorTermux — 终端模拟器Bogdan Melnychuk — AndroidTreeViewGeorge Fraser — Java Language ServerFWCD — Kotlin Language ServerItsaky — AndroidIDE 原作者Android Code Studio 及其上游项目均源自此AndroidCSOfficial — 本 fork 的上游仓库以及所有为本项目做出贡献的开发者联系我们本 fork Issueshttps://github.com/706412584/android-code-studio/issues上游社区Telegram / 官网许可证AndroidCodeStudio is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. AndroidCodeStudio is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with AndroidCodeStudio. If not, see https://www.gnu.org/licenses/.许可证违规可通过提交 Issue 或邮件举报。