# Kotlin / Android 开发 ## 项目设置 ### Gradle Kotlin DSL // 设置.gradle.kts 插件管理 { 存储库{ 谷歌() mavenCentral() gradlePluginPortal() } } 依赖解析管理{ repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) 存储库{ 谷歌() mavenCentral() } } rootProject.name = "MyApp" 包括（“：应用程序”） ### build.gradle.kts（应用程序）插件{ 别名（libs.plugins.android.application）别名（libs.plugins.kotlin.android）别名（libs.plugins.kotlin.compose） } 安卓{ 命名空间 =“com.example.myapp” 编译SDK = 35 默认配置{ applicationId =“com.example.myapp” 最小SDK = 26 目标SDK = 35 版本代码 = 1 版本名称 = "1.0" } 构建功能{ 撰写=真 } 编译选项{ 源兼容性 = JavaVersion.VERSION_17 目标兼容性 = JavaVersion.VERSION_17 } 科特林选项 { jvmTarget = “17” } } 依赖项{ 实现（libs.androidx.core.ktx）实现（libs.androidx.lifecycle.runtime.ktx）实现（libs.androidx.activity.compose）实现（平台（libs.androidx.compose.bom））实现（libs.androidx.ui）实现（libs.androidx.material3）测试实现（libs.junit） androidTestImplementation(libs.androidx.junit) androidTestImplementation(libs.androidx.espresso.core) } ### 版本目录 (libs.versions.toml) [版本] 科特林 =“2.0.0” 撰写-bom =“2024.06.00” 生命周期=“2.8.0” [图书馆] androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version = "1.13.1" } androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version.ref = "lifecycle" } androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "compose-bom" } [插件] android-application = { id = "com.android.application", version = "8.5.0" } kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" } kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" } ## 类型模式 ### 空安全 // 安全调用运算符 val 长度 = 名称?.长度 // 埃尔维斯运算符 val displayName = user?.name ?: "访客" // 安全转换 val 数 = 值作为？ INT // 非空断言（谨慎使用） val 名称 = 用户!!.名称 // let 进行空检查用户？.let { safeUser -> println(安全用户名) } ### 密封课程密封类 Result { 数据类 Success(val data: T) : Result() 数据类错误（val异常：Throwable）：Result() 数据对象加载：Result() } // 详尽的当 fun handleResult(结果: Result<用户>) = when (结果) { 是 Result.Success -> showUser(result.data) 是 Result.Error -> showError(result.Exception) 结果.Loading -> showLoading() } ### 数据类数据类用户（有效 ID：字符串， val 电子邮件：字符串，值名称：字符串， val createAt: Instant = Instant.now() ） // 复制并修改 val UpdatedUser = user.copy(name = "新名称") // 解构 val（ID、电子邮件、姓名）= 用户 ### 值类 @JvmInline 值类 UserId(val 值: String) @JvmInline 值类电子邮件（val值：字符串）{ 初始化{ require(value.contains("@")) { "无效的电子邮件" } } } ## 错误处理 ### 结果类型 fun parseNumber(输入：字符串): Result { 返回尝试{ 结果.成功(input.toInt()) } catch (e: NumberFormatException) { 结果.失败(e) } } // 用法解析编号(“123”) .onSuccess { number -> println("已解析：$number") } .onFailure { 错误 -> println("错误: ${error.message}") } // 变换 val doubled = parseNumber("42") .map { 它 * 2 } .getOrDefault(0) ### runCatching val 结果 = runCatching { 有风险的操作() }.getOrElse { 错误 -> 日志错误（错误）默认值 } // 链式操作 runCatching { fetchUser(id) } .mapCatching { 用户 -> processUser(用户) } .onSuccess { 结果 -> 显示（结果） } .onFailure { 错误 -> showError(错误) } ## 协程 ### 基本协程 // 暂停函数暂停乐趣 fetchUser(id: String): User { 返回 withContext(Dispatchers.IO) { api.getUser(id) } } // 启动协程 viewModelScope.launch { 尝试{ val 用户 = fetchUser("123") _uiState.value = UiState.Success(用户) } catch (e: 异常) { _uiState.value = UiState.Error(e.message) } } ### 流量 // 创建流有趣的observeUsers(): Flow> = flow { 而（真）{ 发出（存储库.getUsers（））延迟(5000) } }.flowOn(调度程序.IO) // 收集流量 viewModelScope.launch { 观察用户() .catch { e -> 发出(emptyList()) } .collect { 用户 -> _users.value = 用户 } } ### 状态流类 UserViewModel : ViewModel() { 私有 val _uiState = MutableStateFlow(UiState.Loading) val uiState: StateFlow = _uiState.asStateFlow() 有趣的loadUser（id：字符串）{ viewModelScope.launch { _uiState.value = UiState.Loading 尝试{ val 用户=repository.getUser(id) _uiState.value = UiState.Success(用户) } catch (e: 异常) { _uiState.value = UiState.Error(e.message ?: "未知错误") } } } } ## Jetpack 组合 ### 基本可组合项 @可组合有趣的问候语（名称：字符串，修饰符：修饰符=修饰符）{ 文本（文本=“你好，$name！”，修饰符 = 修饰符.padding(16.dp), 样式 = MaterialTheme.typography.headlineMedium ） } @Preview(显示背景 = true) @可组合有趣的问候预览（）{ 我的应用程序主题 { 问候语（“Android”） } } ### 状态管理 @可组合有趣的计数器（）{ var count by Remember { mutableIntStateOf(0) } 列（修饰符 = Modifier.padding(16.dp), 水平对齐 = Alignment.CenterHorizontally ）{ 文本（ text = "计数: $count", 样式 = MaterialTheme.typography.headlineMedium ）间隔（修饰符= Modifier.height（8.dp））按钮(onClick = { count++ }) { 文本（“增量”） } } } ### ViewModel 集成 @可组合有趣的用户屏幕（ viewModel: UserViewModel = hiltViewModel() ）{ val uiState 通过 viewModel.uiState.collectAsStateWithLifecycle() 当（val状态= uiState）{ 是 UiState.Loading -> CircularProgressIndicator() 是 UiState.Success -> UserContent(state.user) 是 UiState.Error -> ErrorMessage(state.message) } } @可组合有趣的用户内容（用户：用户）{ 列（修饰符= Modifier.padding（16.dp））{ 文本（用户名，样式= MaterialTheme.typography.titleLarge）文本（用户.电子邮件，样式= MaterialTheme.typography.bodyMedium） } } ### 副作用 @可组合有趣的 UserDetailScreen(userId: String, viewModel: UserViewModel = hiltViewModel()) { // 当userId改变时运行一次启动效果（用户ID）{ viewModel.loadUser(userId) } // 在每次重组时运行副作用{ 分析.trackScreen（“用户详细信息”） } // 离开组合时清理一次性效果（单位）{ val 监听器 = viewModel.addListener() onDispose { 监听器.remove() } } } ## 测试 ### 单元测试 (JUnit 5) 类 UserViewModelTest { @测试 fun `loadUser 将状态更新为成功`() = runTest { val 存储库 = mockk() coEvery {repository.getUser("123") } 返回 User("123", "test@example.com") val viewModel = UserViewModel(存储库) viewModel.loadUser("123") 断言等于( UiState.Success（用户（“123”，“test@example.com”））， viewModel.uiState.value ） } @测试 fun `loadUser 在失败时将状态更新为错误`() = runTest { val 存储库 = mockk() coEvery {repository.getUser(any()) } 抛出 IOException("网络错误") val viewModel = UserViewModel(存储库) viewModel.loadUser("123") assertTrue(viewModel.uiState.value 是 UiState.Error) } } ### 编写 UI 测试类用户屏幕测试{ @get:规则 val composeTestRule = createComposeRule() @测试有趣的显示用户名（）{ val user = User("1", "test@example.com", "John Doe") composeTestRule.setContent { 我的应用程序主题 { 用户内容（用户=用户） } } composeTestRule.onNodeWithText("John Doe").assertIsDisplayed() composeTestRule.onNodeWithText("test@example.com").assertIsDisplayed() } @测试有趣的按钮ClickIncrementsCounter() { composeTestRule.setContent { 我的应用程序主题 { 计数器() } } composeTestRule.onNodeWithText("计数：0").assertIsDisplayed() composeTestRule.onNodeWithText("增量").performClick() composeTestRule.onNodeWithText("计数：1").assertIsDisplayed() } } ## 工具 # 构建 ./gradlew 构建 ./gradlew assemble调试 ./gradlew assembleRelease # 运行测试 ./gradlew test # 单元测试 ./gradlewconnectedAndroidTest # 仪器测试 # 检测 ./gradlew detekt # 代码气味 ./gradlew ktlintCheck # 样式检查 ./gradlew ktlintFormat # 自动修复样式 # 代码分析 ./gradlew lint # Android Lint # 清洁 ./gradlew 干净 ### 检测.yml 构建：最大问题数：0 复杂性：长方法：阈值：30 复杂条件：阈值：4 风格：最大线长：最大线长度：120 通配符导入：活跃：真实命名：函数命名：函数模式：'[a-z][a-zA-Z0-9]*' ### .editorconfig (ktlint) [*.{kt,kts}] 缩进大小 = 4 最大行长度 = 120 ktlint_code_style = android_studio

科特林

包含技能