本项目是一个系统性学习 Jetpack Compose 和 Kotlin Multiplatform 开发的教程项目，支持 Android、Web(WASM)、Desktop 三个平台。

learn-jetpack-compose/
├── lesson-01-basic-composables/         # 第1课：基础Composable组件
├── lesson-02-layout-system/             # 第2课：布局系统与修饰符
├── lesson-03-state-management/          # 第3课：状态管理与响应式编程
├── lesson-04-material3-components/      # 第4课：Material 3组件库
├── lesson-05-custom-components/         # 第5课：自定义组件开发 ✅
├── lesson-06-app-architecture-navigation/ # 第6课：应用架构与导航 ✅
├── lesson-08-viewmodel-state/           # 第8课：ViewModel 状态管理入门 ✅
├── lesson-09-kotlin-coroutines/         # 第9课：Kotlin 协程深度解析 ✅
├── lesson-10-stateflow-management/      # 第10课：StateFlow 状态管理深度解析 ✅
├── lesson-11-todo-app/                  # 第11课：完整 Todo 应用实战 ✅
├── ui-components/                       # 共享UI组件库
├── DEVELOPMENT_NOTES.md                # 开发注意事项 ⚠️
├── LEARNING_PATH.md                    # 完整学习路径
└── README.md                           # 项目说明

开始开发前请先阅读:

• 📖 WRITING_GUIDE.md - 写作规范指南（撰写文章前必读）
• ⚠️ DEVELOPMENT_NOTES.md - 开发注意事项（编码前必读）
• 📚 LEARNING_PATH.md - 完整学习路径

写作规范 (WRITING_GUIDE.md) 包含：

• "前端开发者的 Kotlin 之旅"系列文章的统一写作规范
• 文章结构模板和检查清单
• 前端对比教学方法论
• 代码示例和注释规范

开发注意事项 (DEVELOPMENT_NOTES.md) 包含：

• 已知的平台兼容性问题（特别是 WASM 平台）
• 新 Lesson 开发完整 Checklist
• 调试方法和最佳实践
• 避免重复踩坑的重要经验

# 运行最新的 lesson-11 Todo 应用 Web 版本
./gradlew :lesson-11-todo-app:wasmJsBrowserDevelopmentRun

# 运行 StateFlow 课程
./gradlew :lesson-10-stateflow-management:wasmJsBrowserDevelopmentRun

# 运行协程课程
./gradlew :lesson-09-kotlin-coroutines:wasmJsBrowserDevelopmentRun

# 运行其他课程
./gradlew :lesson-XX:wasmJsBrowserDevelopmentRun

# 运行最新的 lesson-11 Todo 应用桌面版本
./gradlew :lesson-11-todo-app:run

# 运行其他课程
./gradlew :lesson-XX:run

1. Lesson 01: 基础Composable组件 ✅

   • Text、Button、Image 组件使用
   • Composable 函数的定义和调用
   • 基础属性和参数传递

2. Lesson 02: 布局系统与修饰符 ✅

   • Column、Row、Box 布局容器
   • Modifier 修饰符系统
   • 响应式布局设计

3. Lesson 03: 状态管理与响应式编程 ✅

   • remember 和 mutableStateOf
   • 状态提升原则
   • 副作用处理

4. Lesson 04: Material 3 组件库 ✅

   • MaterialTheme 主题系统
   • 常用 Material 组件
   • 暗色模式支持

5. Lesson 05: 自定义组件开发 ✅

   • 组件设计原则
   • 参数化组件和组合模式
   • 性能优化技巧
   • 📝 学习笔记：自定义组件开发实战

6. Lesson 06: 应用架构与导航 ✅

   • 自定义导航系统设计
   • Material 3 应用主题架构
   • 应用脚手架架构
   • 📝 学习笔记：应用架构与导航系统

7. Lesson 07: Navigation Compose 深入实战 ✅

   • 集成官方 Navigation Compose 库
   • 类型安全的路由系统（Sealed Class）
   • Material 3 底部导航栏集成
   • 嵌套导航实现
   • 页面状态保持机制
   • 📝 学习笔记：Navigation Compose 深入实战

8. Lesson 08: ViewModel 状态管理入门 ✅

   • ViewModel 核心概念与生命周期
   • remember vs ViewModel 深度对比
   • Compose Multiplatform 正确用法
   • 状态封装和单向数据流
   • 📝 学习笔记：ViewModel 状态管理入门

9. Lesson 09: Kotlin 协程深度解析 ✅

   • 协程基础概念与作用域
   • 挂起函数和协程调度器（Dispatchers）
   • 并发与并行（async/await、结构化并发）
   • 协程取消与超时处理
   • 错误处理（try-catch、supervisorScope）
   • 6 个实战案例（定时刷新、搜索防抖、分页加载）
   • 📝 学习笔记：Kotlin 协程深度解析

10. Lesson 10: StateFlow 状态管理深度解析 ✅

    • StateFlow vs mutableStateOf 对比
    • 响应式操作符（map、filter、combine、debounce）
    • 购物车完整实战案例
    • 与 DataStore、Room 集成
    • 📝 学习笔记：StateFlow 状态管理深度解析

11. Lesson 11: 完整 Todo 应用实战 ✅
    • MVVM 架构完整实践
    • StateFlow 状态管理
    • Material 3 完整应用
    • 单向数据流设计
    • 📝 README 包含完整学习笔记

💡 Lesson 11 已经是一个完整的、可用于生产的 Todo 应用实战。后续课程方向待讨论。

📚 完整学习路径请查看 LEARNING_PATH.md

• Kotlin Multiplatform: 跨平台代码共享
• Jetpack Compose: 现代UI工具包
• Material 3: Google最新设计系统
• Compose Multiplatform: 跨平台Compose支持

• 💡 每个课程模块都包含详细的 README 说明
• ⚠️ WASM 平台有特殊的兼容性要求，详见 DEVELOPMENT_NOTES.md
• 🔧 推荐使用渐进式开发，每次添加功能后立即测试
• 📝 遇到问题时请更新开发注意事项文档

• Kotlin Multiplatform
• Compose Multiplatform
• Material 3 Design Guidelines
• Kotlin/Wasm

---

这是一个持续更新的学习项目，随着课程进展会不断添加新的内容和功能。