跳到主要内容

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,便于联调

文档目录

建议阅读顺序

  1. 项目概览 — 目标、原则、能力边界
  2. 环境准备 — Studio、SDK、仓库
  3. 架构与目录 — app / feature / core
  4. 模块怎么写 — 加 feature、UDF、边界
  5. 本地开发 — 编译、安装、端点覆盖
  6. 网络与数据层 — Retrofit、Room、Repository
  7. 安全与密钥 — Token、日志、备份
  8. 构建与发布 — 签名、release、检查清单

工程协作规范(提需求、验收、变更)见 工程规范与流程,与本教程互补。
后端契约可对照 Go 语言教程 与仓库 OpenAPI。