开发与构建

Aerial 是一个 Kotlin / Android 开源项目，使用 Gradle 构建，MIT 协议开源。

环境要求

  • JDK 17
  • Android SDK 36
  • Gradle（./gradlew 即可）

构建

./gradlew assembleStandardRelease assembleGuardRelease
  • assembleStandardRelease：完整版 APK（声明 HOME，作为默认桌面安装）
  • assembleGuardRelease：Guard 版（不声明 HOME，用于系统禁止安装桌面类 App 的场景）

安装到电视

BUILD=1 KEEP_ADB=1 TV=<电视IP> tools/install.sh
  • BUILD=1：自动触发 Gradle 构建
  • KEEP_ADB=1：安装后保持 ADB 常开（小米待机后会关闭）
  • TV=<IP>：电视的 Wi-Fi IP 地址

模块结构

模块 说明
app/（standard） 完整版：Compose 界面、航拍壁纸、控制中心、手机页
app/（guard） Guard 版：不声明 HOME，可装在被锁主页的固件上
lite/ Aerial Lite：原生 View，适配 Android 4.0–4.4

代码文档

  • ARCHITECTURE.md：代码结构说明（模块、关键类、数据流）
  • HANDOFF.md：当前状态与开发规则
  • docs/devices/：各机型笔记（ADB 路径、适配记录）
  • docs/LITE.md：Aerial Lite 开发细节（见本书 LITE 专章）

测试

./gradlew test
./gradlew :lite:testReleaseUnitTest :lite:lintRelease

发版

./gradlew assembleStandardRelease assembleGuardRelease :lite:assembleRelease

Release 里包含 aerial-standard.apk、aerial-guard.apk、aerial-lite.apk 三个包；官网 download/ 目录由 tools/deploy-site.sh 同步。

内容来源：Aerial 官方 GitHub 仓库 与 README「开发」一节