android-kotlin-development

Android Kotlin 开发

目录

• 概览
• 适用场景
• 快速入门
• 参考指南
• 最佳实践

概览

使用 Kotlin 构建稳健的原生 Android 应用，采用现代架构模式、Jetpack 库和用于声明式 UI 的 Compose。

适用场景

• 遵循最佳实践创建原生 Android 应用
• 使用 Kotlin 进行类型安全开发
• 使用 Jetpack 实现 MVVM 架构
• 使用 Jetpack Compose 构建现代 UI
• 与 Android 平台 API 集成

快速入门

最简可运行示例：

// Models
data class User(
  val id: String,
  val name: String,
  val email: String,
  val avatarUrl: String? = null
)

data class Item(
  val id: String,
  val title: String,
  val description: String,
  val imageUrl: String? = null,
  val price: Double
)

// API Service with Retrofit
interface ApiService {
  @GET("/users/{id}")
  suspend fun getUser(@Path("id") userId: String): User

  @PUT("/users/{id}")
  suspend fun updateUser(
    @Path("id") userId: String,
    @Body user: User
// ... (see reference guides for full implementation)

参考指南

references/ 目录中的详细实现：

指南	内容
Models & API Service	Models & API Service
MVVM ViewModels with Jetpack	MVVM ViewModels with Jetpack
Jetpack Compose UI	Jetpack Compose UI

最佳实践

✅ 应该做

• 所有新的 Android 代码都使用 Kotlin
• 使用 Jetpack 库实现 MVVM
• 使用 Jetpack Compose 开发 UI
• 利用协程执行异步操作
• 使用 Room 持久化本地数据
• 实现妥善的错误处理
• 使用 Hilt 进行依赖注入
• 使用 StateFlow 管理响应式状态
• 在多种设备类型上进行测试
• 遵循 Android 设计指南

❌ 不要做

• 将令牌存储在 SharedPreferences 中
• 在主线程上发起网络请求
• 忽视生命周期管理
• 跳过空安全检查
• 将字符串和资源硬编码
• 忽视配置变更
• 在代码中存储密码
• 未经设备测试就部署
• 使用已弃用的 API
• 积累内存泄漏