Repository navigation
Releases
Android China Setup v0.6.0 · 固定签名正式版
Android China Setup v0.6.0 — 固定签名正式版
此次更新让应用目录与 APK 版本解耦：以后新增、调整、下架应用，只需提交在线 JSON 清单并经过自动校验，不必为了应用名单变化重新编译、签名和安装 APK。
本次更新
- 新增 Canta（配合 Shizuku 管理预装应用）和 Spotube（开源音乐播放器），当前收录 17 个项目。
- 设置 → 应用目录 → 刷新应用目录：立即获取最新目录；启动时按约 12 小时间隔尝试后台同步。
- 离线兜底与校验：GitHub 在线目录不可达或内容无效时，继续使用已验证的本地缓存或内置目录；只接受合法 HTTPS 来源与受控下载字段。
- 新增
tools/catalog.py add / validate快捷维护工具。仅修改catalog/apps.json时，CI 只执行快速目录校验，不启动 Gradle 或 Android 模拟器。 - 保留 Material 3 分类应用展示、离线 README 快照、下载源测速、HTTP/SOCKS5 代理和应用内版本检查。
安装与更新
- 最低 Android 11（API 30）。
- 使用与 v0.5.0 相同的固定签名证书，使现有 v0.5.0 用户能够在系统安装确认后覆盖升级。
- 官方 APK 文件为
Android-China-Setup.apk，同时提供SHA256SUMS.txt校验文件。 - Android 11 与 Android 15 自动化回归测试各 53 项检查通过；发布工作流另外验证正式签名 APK 的身份与模拟器安装/核心页面操作。
- v0.3 / v0.4 采用过临时 Debug 签名，可能无法直接覆盖 v0.6.0，需先按提示处理旧版。
风险与限制
- Canta 删除错误的系统组件可能造成系统异常，建议先备份并确认 Shizuku 授权。
- DirtyFrag、KSuRoot、GhostLock 均为高风险项目，只显示原项目链接与 README 摘要，不自动运行提权程序。
- 在线目录依赖 GitHub 连通性；在中国大陆无法获取时使用离线缓存，不影响本地目录浏览。
- 尚未完成中国大陆所有运营商/镜像的长期可用性、ARM64 真机掉帧和全部第三方安装包逐项验证。
感谢所有被收录项目的开发者。欢迎通过 Issues 推荐新的 Android 开源应用。
在线目录 · 快速维护文档 · GitHub Actions
Android China Setup v0.5.0 · 固定签名正式版
Android China Setup v0.5.0 — 首个固定签名正式发布版
适用于 Android 11（API 30）及以上。本版本使用维护者提供的长期固定 JKS 密钥进行正式 APK 签名。后续版本只要继续使用相同签名证书且递增 versionCode，即可在系统安装器确认后覆盖升级。
主要更新
- 收录 15 个 Android 项目，按 6 类分组展示，一句话简介与离线 README 摘要
- 新增 DroidDeck、osu!、DirtyFrag、KSuRoot
- 移除应用复选框与底部导航；右上角设置统一容纳测速、代理和关于/自更新
- 重新设计开源终端风格自适应 Logo，并优化列表渲染结构，减少滑动期间多余操作
- 下载源支持官方 GitHub、社区镜像及自定义 HTTPS 地址；可查看响应延迟与采样速率
- 选择性下载和安全安装，使用 GitHub 官方 SHA-256 验证具备该摘要的 APK
发布验证
- 经过 12 项 JVM 单元测试及 APK 编译验证
- 同一应用源码的 Android 11 / 15 云端模拟器各 48/48 项 UI 检查通过
- 正式签名的 APK 另外执行签名验证、系统最低版本检查、Android 11 / 15 模拟器启动与设置页验收
- 提供
SHA256SUMS.txt以校验本页面附件的 APK 文件
安装和升级说明
v0.3.0 和 v0.4.0 使用临时 Debug 签名，证书不同，不能保证覆盖安装 v0.5.0。 若系统提示“安装失败/签名不一致”，需先卸载旧版再安装本版，本地配置可能丢失；请勿卸载需要保存数据的其他应用。从 v0.5.0 起，应保留这套正式签名，后续版本才能可靠升级。
DirtyFrag、KSuRoot 和 GhostLock 涉及设备内核提权，仅提供原项目及 README 摘要入口，不提供自动提权。DroidDeck 主要支持特定 Adreno GPU，不支持 MTK/Mali；osu! APK 体积较大，需要充足磁盘空间。
已知限制
- 云端 x86_64 软件 GPU 的掉帧数据不能代表真实 ARM64 手机，滑动卡顿仍需真机性能测试
- 尚未完成所有国内运营商与镜像的真实下载、全量第三方 APK 安装和代理端到端专项测试
- 软件检查更新依赖 GitHub API，应用更新安装需用户通过 Android 系统确认
欢迎在 Issues 提交问题和推荐开源 Android 应用。
Android China Setup v0.4.0 · 公开测试版
Android China Setup v0.4.0
公开测试版，最低 Android 11（API 30）。
本次更新
- 全新 Material 3 界面：四个底部导航页面、动态配色、暗色模式及极简自适应 Logo。
- 应用列表改为独立 LazyColumn，减少混合设置布局造成的滚动负担；真机流畅性还需进一步测量。
- 独立的下载源测速界面：显示连接延迟，以及最多 128 KiB 下载样本得到的估算速率。
- 增加「访问原项目」入口；下载源选择、HTTPS 自定义镜像保留。
- 新增应用内检查更新、下载更新和签名兼容检查，安装仍须 Android 系统确认。
下载
请下载本页面附件 Android-China-Setup.apk。另外提供 SHA256SUMS.txt 供完整性验证。
验证
- GitHub Actions Gradle 编译和 9 项 JVM 单元测试通过。
- Android 11（API 30）、Android 15（API 35）云端模拟器的 32/32 项 UI 检查分别通过（同版本源代码的测试）。
- 尚未完整验收：中国大陆运营商与镜像的实际 APK 下载、ARM64 真机卡顿/帧率、所有第三方应用安装、HTTP/SOCKS5 代理端到端测试。
必须知道的签名限制
本版本 APK 为 CI Debug 签名的公开测试包，不是使用长期固定证书签名的正式生产包。与 v0.3.0 等旧版本证书可能不相容，因此 Android 可能拒绝覆盖升级；需要卸载旧版再安装（旧版配置可能丢失）。应用内更新会拒绝不兼容的签名，不会绕过 Android 安全策略。后续稳定升级需要维护者使用同一个受保护的发布签名密钥。
致谢与反馈
感谢 Xime、Via、BiliPai、FlClash、Shizuku、GhostLock、知乎++、Obtainium、F-Droid、Material Files 和 LocalSend 的开发者与社区。欢迎通过 Issues 推荐其他优秀 Android 项目。
Android China Setup v0.3.0 · 首个公开测试版
Android China Setup v0.3.0 — 首个公开测试版
这是首个公开发布的 Android APK，用于社区体验、反馈与兼容性测试，并非经过全面验收的稳定版。
新功能
- 最低支持 Android 11（API 30），无需电脑、Root、ADB 或 Shizuku。
- 内置 11 个精选 Android 项目与官方地址，逐项选择、逐项下载和安装。
- 下载源选择：自动检测、GitHub 官方直连、4 个预设社区加速源，以及手机端自定义 HTTPS 镜像。
- 镜像下载仅在 GitHub Release 可提供可信 SHA-256 时启用，并在下载后校验。
- 可选 HTTP/SOCKS5 代理，默认关闭；下载进度、错误提示及 Android 系统安装确认。
- 内置 HiWiki 加速源参考入口，方便自行查找并添加更多源。
- 欢迎通过 Issues 推荐优秀 Android 项目。
下载和安装
下载附件 Android-China-Setup.apk，在 Android 11 或更高版本的手机上打开安装。
首次运行后可以通过「配置下载加速镜像」选择源或添加自定义 HTTPS 源。
当前验证状态与已知限制
- GitHub Actions Gradle 编译、7 项下载源单元测试：通过。
- Android 11 / Android 15 云端模拟器：应用安装启动、下载源选择、自定义源保存、代理设置界面、应用清单等检查通过。
- 最新云端测试中，GitHub 官方 APK 下载超时，完整下载到安装流程尚未在 V0.3 上通过复测。此前 V0.2 的 Material Files 下载与安装曾通过，但不能代替 V0.3 验证。
- 当前尚未验证中国大陆运营商网络环境、各镜像真实转发、HTTP/SOCKS5 代理端到端链路或 ARM64 真机。
- 如果 GitHub 官方 API 完全无法访问，镜像本身仍不足以获取软件最新 Release 元数据。
- 部分项目只有官网入口；GhostLock 仅作高风险工具链接，不执行 Root 或漏洞利用。
- 不包含清单导入/导出、静默批量安装、安装失败自动重试。
- 本安装包由 CI 使用 Android Debug 测试签名构建。后续签名不同的 APK 可能无法直接覆盖升级，请妥善保管应用配置，必要时卸载旧包后重装。请勿把它视为经过正式发布签名的生产版本。
开源项目与反馈
第三方应用各自版权、许可证与商标归原作者所有。本项目不重新打包这些第三方应用。感谢每一位维护者，并欢迎通过 Issues 推荐优质 Android 项目。