[Swift/Kotlin] Jetpack Compose 与 AI 辅助开发：八年开源 GSYGithubApp 的技术演进与实战

GSYGithubApp 项目始于 2017 年，最初源于一个简单的想法：在 GitHub 官方客户端尚未推出时，打造一个方便开源贡献者日常使用的移动应用。历经八年，该项目已演变为一个覆盖多种主流前端与跨端框架的完整技术学习与对比案例。近日，其最新的 Jetpack Compose 版本已正式开源：https://github.com/CarGuo/GSYGithubAppCompose 。

该版本的诞生，很大程度上得益于当下 AI 代码生成与辅助开发能力的显著提升。回顾项目历程，其开源版本的演变顺序清晰地反映了移动开发技术栈的变迁：

• React Native: https://github.com/CarGuo/GSYGithubApp
• Weex: https://github.com/CarGuo/GSYGithubAppWeex
• Android Kotlin View: https://github.com/CarGuo/GSYGithubAppKotlin
• Flutter: https://github.com/CarGuo/GSYGithubAppFlutter
• Android Jetpack Compose: https://github.com/CarGuo/GSYGithubAppCompose

随着 GitHub 官方客户端的发布，GSYGithubApp 的核心价值已从工具应用转变为一个完整的技术学习项目，旨在为开发者提供同一业务场景下不同技术实现的横向对比参考。例如，过去闲鱼团队就曾利用其 React Native 与 Flutter 版本进行过性能测试。

项目维护本身是项持续投入的工作。在 AI 能力爆发前，除 Flutter 版本外，其他版本一度陷入停滞。而 2025 年 AI 工具的成熟，为这些“老项目”注入了新的活力：

• React Native 版本 成功从 0.61 升级至 0.82。
• Android Kotlin View 版本 得以适配最新的开发环境。
• 基于此，萌生了开发 Jetpack Compose 版本 的想法。

得益于明确的需求、现有的项目原型以及丰富的参考资料，GSYGithubAppCompose 从零到开源，约80%的代码由 AI 辅助完成，总耗时仅约两周。

高效的 AI 协作并非一蹴而就，关键在于为其制定清晰的开发规则（Rules）。由于 AI 的上下文理解存在局限，它通常只会针对当前任务进行局部思考。因此，在开发过程中逐步建立以下规则至关重要：

1. 提供模板与规范：在项目具备一定基础代码后，引导 AI 学习现有代码结构，并按照统一风格生成新代码。
2. 明确指令与纠错：对于新技术或 AI 易犯错的地方，需要显式、清晰地列出要求与约束。

本次开发主要使用了 Android Studio 集成的 Gemini for businesses，辅以 Copilot Web Agent 和 Claude。值得注意的是，新版 Android Studio 的 Agent 模式开始整合 Android 官方知识库，能主动检索最新文档，从而大幅提升代码生成的准确率。

当然，最终的代码审查环节必不可少。开发者仍需保持警惕，因为 AI 有时会产生令人费解的“迷惑行为”，例如在添加多语言支持时误删标签或添加无关权限。

除了代码编写，AI 在项目架构设计与分析方面也展现出强大能力。通过 https://deepwiki.com/CarGuo/GSYGithubAppCompose 等工具，可以自动生成项目的架构报告，并支持进一步的交互式问答。

以下是通过 AI 生成的 GSYGithubAppCompose 项目架构概览：

架构图

┌─────────────────────────────────────────────────────────────────────────┐
│                          GSYGithubAppCompose                            │
│                       (Jetpack Compose + MVVM)                          │
└─────────────────────────────────────────────────────────────────────────┘
                                 │
                ┌───────────────────┼───────────────────┐
                │                   │                   │
        ┌───────▼────────┐   ┌──────▼──────┐    ┌───────▼────────┐
        │  Presentation  │   │    Data     │    │      Core      │
        │     Layer      │   │    Layer    │    │     Layer      │
        └────────────────┘   └─────────────┘    └────────────────┘
                │                   │                   │
        ┌───────▼────────┐   ┌──────▼──────┐    ┌───────▼────────┐
        │   feature/*    │   │    data     │    │  core/network  │
        │                │   │             │    │  core/database │
        │ - welcome      │   │ Repository  │    │  core/common   │
        │ - login        │   │   Pattern   │    │  core/ui       │
        │ - home         │   │             │    └────────────────┘
        │ - dynamic      │   │ - User      │
        │ - trending     │   │ - Event     │
        │ - profile      │   │ - Repo      │
        │ - search       │   └─────────────┘
        │ - detail       │
        │ - code         │
        │ - issue        │
        │ - push         │
        │ - list         │
        │ - notification │
        │ - info         │
        └────────────────┘

模块依赖关系图

┌─────────┐
│   app   │
└────┬────┘
     │
     ┌───────────────────────┼────────────────────────┐
     │                       │                        │
 ┌──────▼──────┐         ┌─────▼─────┐          ┌──────▼──────┐
 │  feature/*  │         │    data   │          │   core/ui   │
 │             │         │           │          │             │
 │所有功能模块 │◄────────┤Repository │          │  通用UI组件  │
 │             │         │           │          │             │
 └──────┬──────┘         └─────┬─────┘          └──────┬──────┘
        │                      │                       │
        │              ┌───────┼────────┐              │
        │              │       │        │              │
        └──────────────┼───────┼────────┼──────────────┘
                       │       │        │
           ┌───────────▼─┐  ┌──▼────────▼──┐  ┌─────────────┐
           │core/network │  │core/database │  │core/common  │
           │             │  │              │  │             │
           │ Retrofit    │  │    Room      │  │ DataStore   │
           │ Apollo      │  │    Entity    │  │   Token     │
           │ Model       │  │    DAO       │  │  Resources  │
           └─────────────┘  └──────────────┘  └─────────────┘

技术架构图

┌─────────────────────────────────────────────────────────────────────┐
│                         技术栈 (Tech Stack)                          │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  UI层                  Jetpack Compose + Material 3                 │
│                        Navigation Compose                           │
│                        Coil (图片加载)                               │
│  ├─────────────────────────────────────────────────────────────┤    │
│                                                                     │
│  状态管理               StateFlow + ViewModel                         │
│                        Kotlin Coroutines + Flow                     │
│  ├─────────────────────────────────────────────────────────────┤    │
│                                                                     │
│  依赖注入               Hilt (Dagger 2)                               │
│  ├─────────────────────────────────────────────────────────────┤    │
│                                                                     │
│  网络层                Retrofit 2 + OkHttp                           │
│                        Apollo GraphQL                               │
│                        Gson / Kotlinx Serialization                 │
│  ├─────────────────────────────────────────────────────────────┤    │
│                                                                     │
│  数据库层              Room Database                                 │
│                        DataStore (替代 SharedPreferences)            │
│  ├─────────────────────────────────────────────────────────────┤    │
│                                                                     │
│  架构模式              MVVM + Repository Pattern                     │
│                        Clean Architecture                           │
│                        Unidirectional Data Flow                     │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

数据流向图

┌──────────────┐        ┌──────────────┐        ┌──────────────┐
│              │        │              │        │              │
│   Screen     │◄───────┤  ViewModel   │◄───────┤  Repository  │
│  (Compose)   │ State  │   (MVVM)     │  Flow  │   (Data)     │
│              │        │              │        │              │
└──────┬───────┘        └──────┬───────┘        └──────┬───────┘
       │                       │                       │
       │ User Action           │ Business Logic        │ Data Source
       │                       │                       │
       ▼                       ▼                       ▼
┌──────────────┐        ┌──────────────┐        ┌──────────────┐
│              │        │              │        │              │
│   onClick    │───────►│  loadData()  │───────►│  Network /   │
│   onRefresh  │ Event  │  refresh()   │ API    │  Database    │
│              │        │              │ Call   │              │
└──────────────┘        └──────────────┘        └──────────────┘

分层职责

总结而言，GSYGithubApp 系列项目如今的核心价值在于技术学习与对比。而 GSYGithubAppCompose 的诞生，则额外凸显了 AI 在现代项目开发与维护中的应用价值。对于开发者而言，掌握如何高效利用 AI 辅助编程，已成为一项重要技能。

对于尚未接触 Jetpack Compose 的 Android 原生开发者，该项目提供了一个结合 AI 实践的学习范本。掌握 Compose 不仅意味着拥抱现代化的声明式 UI 开发方式，也为未来探索 Compose MultiPlatform 等多平台框架奠定了基础。