第 08 章 AI 辅助开发集成指南¶

// ✅ 好的注释引导Copilot生成代码
// 创建一个Retrofit实例，配置OkHttp客户端和JSON转换器
@Provides
@Singleton
fun provideRetrofit(okHttpClient: OkHttpClient): Retrofit {
    // Copilot会根据注释生成代码
    return Retrofit.Builder()
        .baseUrl(BuildConfig.BASE_URL)
        .client(okHttpClient)
        .addConverterFactory(Json.asConverterFactory())
        .build()
}

// ✅ 使用函数签名引导
// 实现一个带缓存的用户Repository
class CachedUserRepository(
    private val api: UserApi,
    private val dao: UserDao
) : UserRepository {
    // Copilot会生成实现代码
}

// OpenAI API客户端
class OpenAiClient @Inject constructor(
    private val client: OkHttpClient
) {
    suspend fun generateCode(
        prompt: String,
        language: String = "kotlin"
    ): Result<String> = withContext(Dispatchers.IO) {
        try {  // try/catch捕获异常
            val request = Request.Builder()
                .url("https://api.openai.com/v1/chat/completions")
                .addHeader("Authorization", "Bearer ${BuildConfig.OPENAI_API_KEY}")
                .post(
                    jsonBody {
                        put("model", "gpt-4o-mini")
                        putJsonArray("messages") {
                            addJsonObject {
                                put("role", "user")
                                put("content", prompt)
                            }
                        }
                        put("max_tokens", 500)
                        put("temperature", 0.7)
                    }
                )
                .build()

            val response = client.newCall(request).execute()
            // 解析响应...
            Result.success(generatedCode)
        } catch (e: Exception) {
            Result.failure(e)
        }
    }
}

// AI生成的Compose UI测试示例
@Test
fun loginScreen_displaysErrorWhenCredentialsInvalid() {
    // Given
    composeTestRule.setContent {
        LoginScreen(
            viewModel = LoginViewModel(
                loginUseCase = mockLoginUseCase
            )
        )
    }

    // When
    composeTestRule
        .onNodeWithText("Email")
        .performTextInput("invalid@email")

    composeTestRule
        .onNodeWithText("Password")
        .performTextInput("123")

    composeTestRule
        .onNodeWithText("Login")
        .performClick()

    // Then
    composeTestRule
        .onNodeWithText("Invalid credentials")
        .assertIsDisplayed()
}

// 示例：让Gemini添加一个新的功能模块
// 在Gemini聊天窗口输入：

"""
请帮我添加一个用户认证模块：
1. 创建LoginScreen Composable
2. 创建LoginViewModel
3. 添加Retrofit API接口
4. 创建数据模型（LoginRequest/LoginResponse）
5. 添加输入验证逻辑
6. 创建单元测试

要求：
- 使用MVVM架构
- 使用Hilt进行依赖注入
- 使用Kotlin Coroutines处理异步操作
- 支持邮箱和密码验证
"""

@Composable
fun ProfileCard(
    user: User,
    onEditClick: () -> Unit
) {
    Card(
        modifier = Modifier
            .fillMaxWidth()
            .padding(16.dp),
        elevation = CardDefaults.cardElevation(defaultElevation = 4.dp)
    ) {
        Row(
            modifier = Modifier.padding(16.dp),
            verticalAlignment = Alignment.CenterVertically
        ) {
            // 根据设计图生成的头像布局
            AsyncImage(
                model = user.avatarUrl,
                contentDescription = "Avatar",
                modifier = Modifier
                    .size(64.dp)
                    .clip(CircleShape),
                contentScale = ContentScale.Crop
            )

            Spacer(modifier = Modifier.width(16.dp))

            Column(modifier = Modifier.weight(1f)) {
                Text(
                    text = user.name,
                    style = MaterialTheme.typography.titleMedium
                )
                Text(
                    text = user.email,
                    style = MaterialTheme.typography.bodyMedium,
                    color = MaterialTheme.colorScheme.onSurfaceVariant
                )
            }

            IconButton(onClick = onEditClick) {
                Icon(Icons.Default.Edit, contentDescription = "Edit")
            }
        }
    }
}

// ✅ 好的提示示例
"""
请帮我重构这个ViewModel：
1. 将状态管理从LiveData迁移到StateFlow
2. 添加错误处理逻辑
3. 优化内存泄漏风险
4. 添加单元测试

当前代码：
[paste code here]
"""

// ❌ 不好的提示示例
"帮我改代码" // 太模糊，缺乏上下文