c001apk

原生 Android · miuix 界面 · 非官方酷安客户端

界面预览 · 功能 · 下载安装 · 自行构建 · 项目文档 · 致谢与许可

基于 frisk1127/c001apk-compose 继续开发，使用 Kotlin、Jetpack Compose 和原生 miuix 组件，围绕动态浏览、图文阅读和日常互动重新整理界面。

功能参考 TG-Twilight/c001apk 的 Android 增量，采用「主页 / 关注 / 我的」导航，补齐多账号、本地关注、Markdown、正文导出和应用更新等能力。视觉与交互规范参考 Mishka UI 规范，在 Android 上使用原生 Compose 实现。

通过 ADB 截取的 Android 真机画面，使用设备当前的深色主题与字体。可见头像、昵称及通知图标已在本地像素化处理，其余画面保持原样；「我的」展示游客状态。

主页	我的	外观与字号

• 围绕阅读整理页面：动态详情将作者与正文放入连续阅读卡片，评论独立分区；用户主页集中展示封面、头像、资料、统计与关注操作。
• 本地关注独立保存：游客也可以关注感兴趣的用户，按分类浏览动态；本地名单不会同步成酷安账号关注。
• 数盟 ID 自动管理：默认使用 native SDK 获取并缓存，已有标识继续复用，也支持手动填写与官方设备标识导入。
• 分享默认使用 Coolapk1s：生成 www.coolapk1s.com 链接，同时识别酷安官方域名及带、未带 www 的 Coolapk1s 链接。

功能实现与验证范围分别记录在 移植跟踪 和 验证记录。登录、验证码及部分账号操作仍受服务端限制；宽屏布局和部分互动流程尚需进一步真机验证。

当前源码支持 Android 7 / API 24 及以上的 ARM64 设备。模糊效果需要 Android 13 及以上；旧系统的顶部栏、标签栏和底部栏使用主题纯色。

正式 APK 请前往 GitHub Releases 下载，每个版本同时提供签名校验报告与 SHA256SUMS。也可按下方步骤自行构建；配置签名并手动运行 Android 工作流 后，可从 Actions 的 Artifacts 获取构建产物。

应用显示名称为 c001apk，独立包名为 com.example.c001apk.compose，可与其他包名的版本共存。账号与本地数据不会从原版或 Flutter 版自动迁移；同包名、同签名的后续版本可覆盖安装并保留数据。

本地未配置发布密钥时，Release 也会使用本机调试密钥签名；签名类型与是否启用 R8 是两个独立配置。公开分发时应使用并妥善保管固定的发布密钥，以保证后续覆盖更新。

• JDK 21（miuix-nav 的内联 API 使用 JVM 21 字节码）。
• Android SDK：platforms;android-34、platforms;android-35、platforms;android-37.0 和 build-tools;36.0.0。
• 使用仓库自带的 Gradle Wrapper；Gradle、AGP、Kotlin 等版本已固定在工程配置中。
• 克隆仓库时保留 Git 历史。versionCode 使用提交计数生成，直接下载不含 .git 的源码 ZIP 无法按当前配置构建。

配置 JAVA_HOME，通过 ANDROID_HOME 或 local.properties 中的 sdk.dir 指定 Android SDK。在仓库根目录执行：

# Release：默认启用 R8 和资源压缩
bash ./gradlew :app:assembleRelease

# Debug
bash ./gradlew :app:assembleDebug

Windows 可将 bash ./gradlew 替换为 gradlew.bat。

构建产物：

• Release：app/build/outputs/apk/release/c001apk_<版本名>(<版本号>).apk
• Debug：app/build/outputs/apk/debug/app-debug.apk

版本名可通过 -PappVersion=x.y.z 指定。发布签名支持以下环境变量，也支持 local.properties 中去掉 C001APK_ 前缀的同名配置：

C001APK_KEYSTORE_PATH
C001APK_KEYSTORE_PASSWORD
C001APK_KEY_ALIAS
C001APK_KEY_PASSWORD

配置完成后，可用 -PrequireReleaseSigning=true 要求构建必须使用已配置的发布密钥。GitHub Actions 的 Release 构建还要求 KEYSTORE_BASE64、KEYSTORE_PASSWORD、KEY_ALIAS、KEY_PASSWORD 和 SIGNING_CERT_SHA256 Secrets；工作流会校验 APK 身份和签名，再上传产物。推送 vMAJOR.MINOR.PATCH 标签会调用同一构建流程，并在校验通过后自动发布 APK、校验报告和 SHA256SUMS 到 GitHub Release。

# 单元测试、Lint 与安装包校验工具测试
bash ./gradlew :app:testDebugUnitTest :media-support:testDebugUnitTest :app:lintDebug
python3 -m unittest discover -s tools -p 'test_*.py'

# 校验 APK；替换为实际路径与预期签名证书摘要
python3 tools/verify_apk.py /path/to/app.apk \
  --sdk "$ANDROID_HOME" \
  --certificate-sha256 '预期证书的SHA256摘要'

校验工具检查包名、最低 Android 版本、ARM64、运行必需资源、原生库压缩、签名证书、v2/v3 签名与 ZIP 对齐。设备测试和显式启用网络测试的方式见 改造与构建说明。历史验证结果见 验证记录，不代表每次提交都已执行全部检查。

先更新 CHANGELOG.md，提交代码后创建并推送版本标签：

git tag v1.4.4
git push origin v1.4.4

发布工作流 从标签读取版本号，依次执行单元测试、Lint、Release 构建和签名校验。全部成功后才发布 Release，并使用对应版本的更新记录作为说明；重新运行同一标签时更新已有资产。正式签名已配置在本仓库的 Actions Secrets，私钥不存入 Git。其他 fork 需要自行配置签名 Secrets。

若发布因 CI 环境配置失败，可在 Actions 中手动运行 Publish Release，选择 main 并填写原标签（例如 v1.3.7）。重试使用当前工作流，但源码与更新记录仍检出该标签，无需移动或重建标签。

自更新从配置的 GitHub 仓库读取正式 Release，可在设置中填写 owner/repo，或在构建时传入：

bash ./gradlew :app:assembleRelease -PupdateRepository=owner/repo

本地构建默认使用 KiritoXDone/c001apk；CI 构建默认使用当前 GitHub 仓库。更新检查支持冷启动检查、手动检查和跳过版本，根据版本与设备 ABI 选择 APK，并交由浏览器下载。

反馈问题时请附应用版本、Debug / Release 类型、Android 版本、设备型号、复现步骤，以及期望和实际表现。截图或日志请先移除账号凭据、Cookie、token 和设备标识。

代码贡献请按功能或独立修复组织提交，使用 feat(scope): …、fix(scope): …、docs(scope): … 等 Conventional Commits 格式；移植功能注明对应上游提交，并写明实际完成的验证。

• frisk1127/c001apk-compose：原生 Compose 工程基线与原作者的实现。
• TG-Twilight/c001apk：功能增量、页面布局及本 README 的结构参考。
• compose-miuix-ui/miuix：原生 Compose 组件、图标、动画与模糊效果。
• YuKongA/Mishka：视觉与交互规范参考。
• daimiaopeng/coolapk-desktop：协议兼容实现参考。

项目沿用 GNU AGPL v3。第三方代码、图标、SDK 和素材按各自许可及权利声明使用，详见 功能与协议来源、图标来源 及 随包许可证。

本项目与酷安官方无隶属关系。酷安名称、商标及服务内容归相应权利人所有。