CodeAssist：手机上的 Android IDE

项目简介

CodeAssist 是一个运行在 Android 手机上的 IDE。你可以在手机上编写 Kotlin 和 Java，预览 Compose 与 XML 布局，并直接在手机里构建、签名和安装 APK，不需要电脑，也不需要远程构建服务器。同一套代码还可以构建出适用于 Windows 和 Linux 的桌面版。

主要功能

• Kotlin / Java 编辑：代码补全、自动导入、输入时实时报错并提供快速修复、跳转到定义或实现、重新格式化和优化导入。
• Android XML 支持：为布局、Manifest 和资源文件提供补全与校验。
• 实时预览：Compose 的 @Preview 函数渲染在代码旁边，随编辑更新；XML 布局同样可以预览，包括自定义 View。
• 在设备上构建：内置 aapt2、kotlinc、ecj、D8/R8 和 apksigner，采用增量构建，可输出 debug APK，或用你自己的密钥签名的 release APK / App Bundle。
• 项目能力：多模块项目、构建变体、ViewBinding、AIDL、KSP（Room、Hilt）以及 Firebase 的 google-services.json。
• 依赖管理：支持 Maven Central、Google Maven 仓库，以及本地 JAR 和 AAR 文件。
• Gradle 互通：可以导入现有的 Gradle 项目，也可以把项目导出为 Gradle 项目，之后在 Android Studio 中打开。
• Git：克隆、提交、分支、合并、暂存和推送；登录 GitHub 后可以克隆私有仓库并发起 Pull Request。
• AI 编码助手（可选）：使用你自己的 API key（Anthropic、Gemini、OpenAI 或 OpenRouter）。
• 插件系统：插件可以添加语言、构建步骤、工具窗口和项目模板；C/C++（NDK）支持是一个单独的插件。

安装与使用

下载渠道：

• GitHub Releases：Android APK，以及 Windows 和 Linux 桌面版。
• Google Play。

从源码构建需要 JDK 17 或更新版本（CI 使用 JDK 25），只有完整构建才需要 Android SDK：

# 仅核心模块，纯 JVM，不需要 Android SDK
CI_CORE_ONLY=true ./gradlew check

# 完整构建，包含 Compose UI 和 Android 应用
./gradlew build

# 运行桌面版 IDE
./gradlew :ide-desktop:run

插件作者可以从 docs/writing-plugins.md 开始阅读。

注意事项

• CodeAssist 不运行 Gradle。导入项目时会读取构建脚本（依赖、version catalogs、常见的 android {} 配置），但不会执行 Gradle 插件和自定义构建逻辑。
• 只支持内置的 Kotlin 编译器插件：Compose、kotlinx.serialization 和 Parcelize。
• Kotlin 支持比 Java 支持更新，粗糙之处也更多。
• 在内存较小的手机上，大型项目的索引和构建会比较慢。
• Google Play 版与 GitHub APK 使用不同密钥签名，两者不能覆盖安装。
• 项目基于 GNU General Public License v3.0 或更高版本发布。

---

本作品整理自 GitHub 开源项目 tyron12233/CodeAssist，原作者 @tyron12233，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。