Steven
7668799040
CI / backend (push) Canceled after 0s
需求是"改完 Android 端怎么送到手机上"。不发应用商店，也不想每次手动传包，
于是做了最小闭环：后端存一份安装包清单，App 启动时查、下载、交给系统安装器。
后端
- 新增 /app/release/latest 与 /app/release/download/{file}，都免登录：
还没装上新包的客户端未必带着有效令牌，检查更新不该被登录挡住
- download_url 用相对路径，客户端拿自己配置的 API 地址拼——同一份清单要在
内网、公网、模拟器之间共用，写死域名只会让其中一个坏掉
- has_update 只比对 version_code，不比版本名字符串（0.10.0 与 0.9.0 的字典序是坑）
- 下载只认清单里登记的文件名，含 ..%2F 一律 9001
- scripts/publish_apk.py 负责复制 APK 并写 latest.json（sha256/size/published_at），
backend/static/apk/ 不进版本库
安卓
- AppUpdater：查清单 → 下到应用自己的 updates 目录（先写 .part 再改名）→
校验 sha256 → 经 FileProvider 交给系统安装器
- UpdateDialog：版本号、更新说明、下载进度、失败重试；「允许安装未知应用」
是系统开关，只跳设置页，不代点
- 启动时自动查一次，首页底部另有「检查更新」入口
- 图标换成和 Web 的 <Logo/> 同一套图形：墨绿圆角底、三条米白圆头线、陶土点；
同时出 mipmap 各密度 PNG、自适应图标与 512px 预览
- versionCode=2 / versionName=0.2.0；发布签名从 android/keystore.properties 读，
没有该文件时回落调试签名，保证别人 clone 下来也能 assembleRelease
文档
- API.md 第 7 节：两个接口、清单字段、签名与 sha256 的约定、9001
- DEPLOY.md 第 5 节：出包命令（JDK 17 + Gradle 8.9 + 干净的 GRADLE_USER_HOME）、
发布清单、传到服务器、验证
- ROADMAP 第 6 节记录本次范围与本机踩过的构建环境坑
验证
- 后端 pytest 103 passed；ruff check / format --check 全绿
- assembleRelease 成功，app-release.apk 7.4 MB，apksigner 验签显示 CN=Dadao Task
- 本地与生产 GET /app/release/latest?version_code=1 → has_update=true，
version_code=2 → false；下载返回 200 / application/vnd.android.package-archive
62 lines
1.2 KiB
Plaintext
62 lines
1.2 KiB
Plaintext
# Python
|
||
__pycache__/
|
||
*.py[cod]
|
||
.venv/
|
||
venv/
|
||
.pytest_cache/
|
||
.ruff_cache/
|
||
.coverage
|
||
htmlcov/
|
||
*.egg-info/
|
||
|
||
# 环境与密钥：绝不进仓库
|
||
.env
|
||
.env.local
|
||
*.pem
|
||
*.key
|
||
|
||
# 前端
|
||
node_modules/
|
||
web/dist/
|
||
web/.vite/
|
||
*.tsbuildinfo
|
||
web/e2e/artifacts/
|
||
|
||
# 安卓
|
||
android/.gradle/
|
||
android/build/
|
||
android/app/build/
|
||
android/local.properties
|
||
# 发布签名证书与口令（只在发布者本机；仓库里没有它就用调试签名）
|
||
android/keystore.properties
|
||
*.jks
|
||
|
||
# 编辑器 / 系统
|
||
.DS_Store
|
||
.idea/
|
||
.vscode/
|
||
|
||
# pip 安装过程中的临时目录（Windows 上出现在 cwd）
|
||
pip-unpack-*/
|
||
pip-req-build-*/
|
||
tmprfx*
|
||
|
||
# 本机开发用的便携 PostgreSQL / 临时目录（不入库）
|
||
.local/
|
||
|
||
# Kotlin 编译器诊断日志（构建产物）
|
||
android/.kotlin/
|
||
|
||
# 本地上传文件（附件落盘目录，绝不入库）
|
||
backend/var/
|
||
|
||
# 发布的安卓安装包由 publish_apk.py 放在这里，APK 不进版本库
|
||
backend/static/apk/
|
||
|
||
# pytest 的临时目录（在 backend/ 下跑测试时生成）
|
||
backend/pytest-of-*/
|
||
|
||
# Vditor 运行时资源（lute/i18n/icons，约 3.8 MB）
|
||
# 由 web/scripts/vendor-vditor.mjs 从 node_modules 生成，不进版本库
|
||
web/public/vditor/
|