Android(GoStartKit 客户端)
本教程以 GoStartKit 风格的模块化 Android 客户端为对象,对照参考工程:
gostartkit/stub/android/base
讲解如何理解、本地运行、扩展与发布这类项目——不是传统「点按钮 Hello World」扫盲课。
参考实现对接 Alinode 设备管理 API,技术路线对齐 Google Now in Android:Jetpack Compose、Material 3、Hilt、UDF、offline-first(Room + Retrofit)。
你会学到什么
- 为什么默认用 模块化 + 离线优先,而不是单模块堆业务
- 仓库目录、
app/feature/*/core/*依赖方向 - 如何用 Android Studio / Gradle 跑 debug、接本地后端
- 网络鉴权、Token、Admin Token、日志与备份边界
- 签名、release APK/AAB 与发布检查清单
适合谁
- 有一门语言基础,想用 Kotlin + Compose 做可交付 App 的开发者
- 需要理解「feature 边界 + core 数据层」的团队
- 使用或二次开发 GoStartKit Android base / Alinode 客户端的工程师
先备条件
- 已安装 Android Studio(含 SDK、模拟器或真机)
- 熟悉命令行、
git、HTTP JSON API 基本概念 - 可选:本机可跑 Go 后端教程 中的 monolith,便于联调
文档目录
项目概览
GoStartKit Android base 项目概览:模块化 Compose 客户端、设计原则与能力范围。
环境准备
运行 GoStartKit Android base 所需的 Android Studio、SDK 与仓库准备。
架构与目录
GoStartKit Android base 架构:模块依赖、运行时图、数据层与导航。
模块怎么写
如何新增 feature 模块、ViewModel/UDF 形态与模块边界自检。
本地开发
本地编译、安装、API 端点覆盖、测试与常用 Gradle 任务。
网络与数据层
Retrofit/OkHttp、Room 离线优先、Repository 模式与分页约定。
安全与密钥
Token 存储、日志策略、一次性密钥、备份与发布安全检查。
构建与发布
签名配置、assembleRelease/bundleRelease、校验与发布检查清单。
建议阅读顺序
- 项目概览 — 目标、原则、能力边界
- 环境准备 — Studio、SDK、仓库
- 架构与目录 — app / feature / core
- 模块怎么写 — 加 feature、UDF、边界
- 本地开发 — 编译、安装、端点覆盖
- 网络与数据层 — Retrofit、Room、Repository
- 安全与密钥 — Token、日志、备份
- 构建与发布 — 签名、release、检查清单
工程协作规范(提需求、验收、变更)见 工程规范与流程,与本教程互补。
后端契约可对照 Go 语言教程 与仓库 OpenAPI。