# android-base

**Repository Path**: cc123hh/android-base

## Basic Information

- **Project Name**: android-base
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-07
- **Last Updated**: 2026-11-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# android-base

Android 新项目基座：一条命令生成可编译的 Hello 空壳，工程债已由两个实战项目代踩。

> 提炼自 [Dfy](https://gitee.com/cc123hh/Dfy) 与 [KeyKeep](https://gitee.com/cc123hh/KeyKeep)
> 的公共骨架，收敛了全部已知的构建/发版/调试兼容债（Windows / macOS / Linux 三平台开发均可用）。

## 里面有什么

| 分类 | 内容 |
|---|---|
| 构建底座 | AGP 8.7.3 · Kotlin 2.0.21 · Gradle 8.9 · Compose BOM 2024.12 · minSdk 26 · Java 17 |
| 质量闸门 | ktlint（120 列 + Composable 命名豁免）+ lint abortOnError + JVM 单测，CI 四步串行 |
| 版本体系 | 百进制自增（0.2.99 → 0.3.0），versionCode = 10000 + major×10000 + minor×100 + patch |
| 签名策略 | keystore.properties（正式）→ 工程内 debug.keystore（跨机器一致）→ AGP 默认，三级回退 |
| 发版链路 | release.sh 出包 → publish-apk.py 发 Gitee release + version.json（App 内检查更新） |
| 源码骨架 | 薄壳 MainActivity + DataStore 设置（防截屏开关默认关，界面即存即生效）+ 环形内存日志（敏感红线）+ 双主题色板（WCAG 护栏单测） |
| 检查更新 | UpdateChecker（version.json 比对）+ UpdateDownloader（进度下载 + FileProvider 拉系统安装器）+ AppRoot 演示区 |
| 调试工具 | avd.py 零配置 AVD 工具箱（boot/install/launch/ui/settings/log，三平台） |
| 图标工具 | make_icon.py：方形原图 → 自适应图标位图图层（numpy + Pillow） |

## 快速开始

```bash
git clone https://gitee.com/cc123hh/android-base.git
cd android-base
python scripts/init_project.py --name HelloKit --pkg com.example.hellokit
# 生成到 D:/Projects（或 ~/Projects）/HelloKit，git init 完毕，直接可编译：
cd ../HelloKit
./gradlew :app:assembleDebug --no-daemon
```

交互模式（不带参数）会依次问 App 名 / 包名 / 仓库名；加 `--gitee` 生成后直接建私有仓并推送首提交
（需 `GITEE_TOKEN` 环境变量）。

## 生成的新项目里有什么

- 能跑的 Hello 页（带顶栏、双主题、防截屏开关默认关、检查更新演示区）
- 检查更新全链路（version.json 比对 → 下载进度 → 系统安装器），配合发版脚本开箱即用
- AppTheme/AppLog/AppSettings 三个中性命名的骨架件，改名零成本起步
- release.sh / publish-apk.py / avd.py / make_icon.py / bump_version.py 全套脚本，
  项目坐标已按替换元组改好
- AGENTS.md / QA.md / docs/ 空模板，惯例与基座一致

## 文档

| 文档 | 内容 |
|---|---|
| [AGENTS.md](AGENTS.md) | 基座工作手册：零配置约定、init 替换元组、反哺约定 |
| [docs/BUILD-RELEASE.md](docs/BUILD-RELEASE.md) | 构建与发版技巧：签名、版本咬合、三平台差异、AVD/真机调试 |
| [docs/CODESTYLE.md](docs/CODESTYLE.md) | 风格指南：Compose 写法、注释与命名、两项目沉淀的代码技巧 |
| [QA.md](QA.md) | 踩坑记录：两个实战项目的真实事故与教训 |

## 反哺约定

骨架级修复**先修基座再同步项目**（或项目先修回灌基座），基座是唯一权威版本；
项目侧新坑中通用性的部分复制进基座 QA.md。