跟着Cursor开发安卓APP：用TaoToken统一Key搭建基础框架与首页-育师

1. 从 iOS 到 Android：为什么首页数据请求要统一走一个 Key

如果你已经用 Cursor 把 Android 项目骨架搭起来了，接下来大概率会卡在同一个地方：首页要展示数据，数据从哪来？是自己写个假数据先顶着，还是直接接真实接口？我建议一开始就把网络层接好，因为后面模板管理、计数记录、设置同步都会复用同一套请求通道。

问题在于，很多人在这一步会陷入“每个模型厂商注册一个账号、每个账号配一个 Key”的泥潭。Cursor 帮你写代码很快，但 Key 管理是它替不了的。你需要在项目里维护一堆 baseUrl、apiKey、model 名称，改一个地方要翻好几个文件。更麻烦的是，Android 项目里 Key 一旦硬编码进 BuildConfig，打包出去就有泄露风险。

TaoToken 在这里的价值就很直接：它提供一个统一的 API 通道，你只需要在项目里配置一个 baseUrl 和一个 Key，就能调用多种模型。对于 Android APP 这种需要长期迭代、可能接入多个 AI 能力的场景，统一 Key 意味着网络层只需要写一次，后面换模型、加功能都不用动架构。

这篇要做的三件事：第一，把 Kotlin + Jetpack Compose 的项目骨架补上网络依赖；第二，用 TaoToken 的统一 Key 配置 Retrofit；第三，写一个首页 Compose 组件，真实发起一次请求并渲染结果。全程可以在 Android Studio 里跟做，Cursor 负责生成代码，你负责确认配置。

适合谁看：已经用 Cursor 创建了 Android 项目、能跑起 Hello World、但还没接网络层的开发者。不需要你精通 Kotlin 协程，但至少要能看懂 suspend 函数和 StateFlow。

2. TaoToken 前置：拿 Key、选通道、确认 baseUrl

在写代码之前，先把 TaoToken 这边的准备工作做完。这一步不涉及 Android 代码，但决定了后面配置能不能一次通。

首先打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册并登录。登录后进入控制台，找到 API Keys 页面，创建一个新的 Key。建议给这个 Key 起一个能识别的名字，比如android-bunnytally-dev，这样后面如果要在多个项目里用，不会搞混。

创建完 Key 之后，复制保存好。注意，Key 只在创建时完整显示一次，关掉页面就看不到了。如果你不小心关了，直接删掉重新建一个就行，不要试图找回。

接下来确认 API 地址。TaoToken 的 API 入口是 https://taotoken.net/api ，这个地址后面要填到 Retrofit 的 baseUrl 里。注意 baseUrl 必须以/结尾，否则 Retrofit 会报IllegalArgumentException。所以实际写的时候是https://taotoken.net/api/。

关于模型选择，首页演示用一个响应快、成本低的模型就够了。你可以在模型对话页面先手动试一条请求，确认 Key 和通道都正常。模型对话入口在这里： https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 。在页面里选一个模型，发一句“你好”，如果能正常返回，说明 Key 和通道没问题。

如果你后面打算长期用 Cursor 做编码、或者要接 Agent 类功能，可以了解一下 Coding Plan： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。它适合需要频繁调用、对额度有稳定预期的场景。首页这种轻量请求用按量计费就够了，不用一上来就上套餐。

注意：Key 不要写进代码里提交到 Git。后面我们会用local.properties或者环境变量的方式管理，确保仓库里看不到明文 Key。

3. 可复制配置：build.gradle.kts 依赖与网络层骨架

现在回到 Android Studio。打开你的项目，找到app/build.gradle.kts。如果你是用 Cursor 生成的骨架，依赖部分可能只有 Compose 基础库。我们需要补上 Retrofit、OkHttp、Kotlin 序列化（或者 Gson）、协程和 ViewModel 相关依赖。

下面这段可以直接复制到dependencies块里。版本号我用的是写这篇文章时比较稳定的组合，你可以根据 Android Studio 的提示微调：

dependencies { // 已有的 Compose 依赖保留 implementation("androidx.core:core-ktx:1.12.0") implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.6.2") implementation("androidx.activity:activity-compose:1.8.2") implementation("androidx.compose.ui:ui:1.6.7") implementation("androidx.compose.material3:material3:1.2.1") implementation("androidx.compose.ui:ui-tooling-preview:1.6.7") implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.6.2") // 网络层 implementation("com.squareup.retrofit2:retrofit:2.11.0") implementation("com.squareup.retrofit2:converter-gson:2.11.0") implementation("com.squareup.okhttp3:okhttp:4.12.0") implementation("com.squareup.okhttp3:logging-interceptor:4.12.0") // 协程 implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.0") // 如果你用 Hilt，保留原来的 Hilt 依赖 // implementation("com.google.dagger:hilt-android:2.51.1") // kapt("com.google.dagger:hilt-android-compiler:2.51.1") }

这里我故意没有把 Hilt 写死，因为首页数据请求不一定需要依赖注入。如果你项目里已经配了 Hilt，可以把网络模块做成@Module提供；如果还没配，直接用单例对象管理 Retrofit 实例更简单，少一层学习成本。

接下来处理 Key 的存放。在项目根目录的local.properties里加一行：

TAOTOKEN_API_KEY=你的Key粘贴在这里

然后在app/build.gradle.kts的android块外面，读取这个值并注入 BuildConfig：

import java.util.Properties val localProperties = Properties().apply { val file = rootProject.file("local.properties") if (file.exists()) { file.inputStream().use { load(it) } } } android { // ... 其他配置 buildFeatures { compose = true buildConfig = true } defaultConfig { // ... 其他配置 buildConfigField( "String", "TAOTOKEN_API_KEY", "\"${localProperties.getProperty("TAOTOKEN_API_KEY") ?: ""}\"" ) } }

这样代码里通过BuildConfig.TAOTOKEN_API_KEY就能拿到 Key，而local.properties默认在.gitignore里，不会提交。

现在写网络层。新建一个文件data/remote/TaoTokenApi.kt：

package com.example.bunnytally.data.remote import retrofit2.http.Body import retrofit2.http.Header import retrofit2.http.POST data class ChatRequest( val model: String, val messages: List<Message> ) data class Message( val role: String, val content: String ) data class ChatResponse( val choices: List<Choice> ) data class Choice( val message: Message ) interface TaoTokenApi { @POST("v1/chat/completions") suspend fun chat( @Header("Authorization") auth: String, @Body request: ChatRequest ): ChatResponse }

再写一个单例提供 Retrofit 实例，文件data/remote/RetrofitClient.kt：

package com.example.bunnytally.data.remote import com.example.bunnytally.BuildConfig import okhttp3.OkHttpClient import okhttp3.logging.HttpLoggingInterceptor import retrofit2.Retrofit import retrofit2.converter.gson.GsonConverterFactory import java.util.concurrent.TimeUnit object RetrofitClient { private const val BASE_URL = "https://taotoken.net/api/" private val okHttpClient = OkHttpClient.Builder() .connectTimeout(30, TimeUnit.SECONDS) .readTimeout(60, TimeUnit.SECONDS) .addInterceptor( HttpLoggingInterceptor().apply { level = HttpLoggingInterceptor.Level.BASIC } ) .build() val api: TaoTokenApi by lazy { Retrofit.Builder() .baseUrl(BASE_URL) .client(okHttpClient) .addConverterFactory(GsonConverterFactory.create()) .build() .create(TaoTokenApi::class.java) } fun authHeader(): String = "Bearer ${BuildConfig.TAOTOKEN_API_KEY}" }

注意 baseUrl 结尾的/和接口路径v1/chat/completions拼接后是https://taotoken.net/api/v1/chat/completions，这是正确的。如果你漏了结尾斜杠，Retrofit 会直接抛异常，这是新手最容易踩的坑之一。

4. 首页 Compose 组件与一次真实请求验证

网络层有了，现在写首页。新建ui/home/HomeViewModel.kt：

package com.example.bunnytally.ui.home import androidx.lifecycle.ViewModel import androidx.lifecycle.viewModelScope import com.example.bunnytally.data.remote.ChatRequest import com.example.bunnytally.data.remote.Message import com.example.bunnytally.data.remote.RetrofitClient import kotlinx.coroutines.flow.MutableStateFlow import kotlinx.coroutines.flow.StateFlow import kotlinx.coroutines.launch data class HomeUiState( val loading: Boolean = false, val content: String = "", val error: String? = null ) class HomeViewModel : ViewModel() { private val _uiState = MutableStateFlow(HomeUiState()) val uiState: StateFlow<HomeUiState> = _uiState fun fetchGreeting() { _uiState.value = HomeUiState(loading = true) viewModelScope.launch { try { val response = RetrofitClient.api.chat( auth = RetrofitClient.authHeader(), request = ChatRequest( model = "gpt-4o-mini", messages = listOf( Message(role = "user", content = "用一句话介绍番茄计数法") ) ) ) val text = response.choices.firstOrNull()?.message?.content ?: "返回为空" _uiState.value = HomeUiState(content = text) } catch (e: Exception) { _uiState.value = HomeUiState(error = e.message ?: "未知错误") } } } }

这里模型名我写的是gpt-4o-mini，你可以换成 TaoToken 模型对话页面里确认可用的任意模型名。如果模型名不对，接口会返回错误，错误信息会显示在首页上，方便排查。

然后写ui/home/HomeScreen.kt：

package com.example.bunnytally.ui.home import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.foundation.layout.padding import androidx.compose.material3.Button import androidx.compose.material3.CircularProgressIndicator import androidx.compose.material3.MaterialTheme import androidx.compose.material3.Text import androidx.compose.runtime.Composable import androidx.compose.runtime.collectAsState import androidx.compose.runtime.getValue import androidx.compose.ui.Alignment import androidx.compose.ui.Modifier import androidx.compose.ui.unit.dp import androidx.lifecycle.viewmodel.compose.viewModel @Composable fun HomeScreen(viewModel: HomeViewModel = viewModel()) { val state by viewModel.uiState.collectAsState() Column( modifier = Modifier .fillMaxSize() .padding(24.dp), verticalArrangement = Arrangement.Center, horizontalAlignment = Alignment.CenterHorizontally ) { Text( text = "BunnyTally 首页", style = MaterialTheme.typography.headlineMedium ) when { state.loading -> { CircularProgressIndicator(modifier = Modifier.padding(16.dp)) } state.error != null -> { Text( text = "请求失败：${state.error}", color = MaterialTheme.colorScheme.error, modifier = Modifier.padding(16.dp) ) } state.content.isNotEmpty() -> { Text( text = state.content, style = MaterialTheme.typography.bodyLarge, modifier = Modifier.padding(16.dp) ) } } Button( onClick = { viewModel.fetchGreeting() }, modifier = Modifier.padding(top = 16.dp) ) { Text("请求 TaoToken") } } }

最后在MainActivity.kt里调用：

package com.example.bunnytally import android.os.Bundle import androidx.activity.ComponentActivity import androidx.activity.compose.setContent import com.example.bunnytally.ui.home.HomeScreen class MainActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContent { HomeScreen() } } }

现在点 Android Studio 顶部的 Run。应用启动后，首页会显示一个按钮。点一下按钮，如果配置正确，你会看到 loading 转圈，然后显示模型返回的一句话。这就是一次完整的接口连通性验证。

如果你在 Logcat 里看到--> POST https://taotoken.net/api/v1/chat/completions和<-- 200 OK，说明请求已经通了。如果看到 401，说明 Key 没读到或者格式不对；如果看到 404，检查 baseUrl 和路径拼接。

5. 本篇常见错排查：从 401 到编译不过

这一节把首页接通过程中最容易遇到的几个问题集中列一下，方便你对照排查。

问题一：BuildConfig.TAOTOKEN_API_KEY 为空

现象是请求返回 401，Logcat 里 Authorization 头是Bearer后面空的。原因是local.properties没读到，或者buildConfigField没生效。检查两点：第一，local.properties是否在项目根目录，不是 app 目录；第二，改完 gradle 后有没有点 Sync。如果还不行，在build.gradle.kts里加一句println("Key length: ${localProperties.getProperty("TAOTOKEN_API_KEY")?.length}")，Sync 时看 Build 窗口有没有输出长度。

问题二：Retrofit baseUrl 报 IllegalArgumentException

错误信息通常是baseUrl must end in /。检查RetrofitClient里的BASE_URL，确认是https://taotoken.net/api/，结尾有斜杠。这个错误在编译期不会出现，只有运行时创建 Retrofit 实例才会抛，所以容易漏。

问题三：Unresolved reference: BuildConfig

如果你在RetrofitClient里引用BuildConfig报红，说明buildConfig = true没开。在android块的buildFeatures里加上buildConfig = true，然后 Sync。另外确认 import 的是你自己包名的 BuildConfig，不是其他模块的。

问题四：请求超时或连接失败

先确认设备网络正常。然后检查OkHttpClient的超时设置，首页请求我设了 connect 30 秒、read 60 秒，一般够用。如果还是超时，在模型对话页面手动发一条请求，确认 Key 本身可用。如果手动可以、代码不行，大概率是 baseUrl 或路径拼接问题。

问题五：Cursor 改了代码但 Android Studio 没同步

这个在上一篇文章里也遇到过。Cursor 和 Android Studio 同时打开同一个项目时，Studio 不一定能实时感知外部改动。解决办法是在 Studio 里点 File > Synchronize，或者直接关掉文件重新打开。如果还不行，重启 Studio。建议同一时间只用一个编辑器改代码，避免冲突。

问题六：模型名不存在返回 400

不同通道支持的模型名可能不一样。如果你填的模型名在 TaoToken 这边不可用，接口会返回错误。最稳妥的方式是先去模型对话页面确认当前可用的模型名，再填到代码里。首页演示用一个轻量模型即可，不用追求最强模型。

提示：如果你在排障过程中需要确认 Key 状态或重新生成，直接去 API Keys 页面操作： https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。接入相关的完整说明在文档里： https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

6. 下一步：把首页请求模式复制到其他页面

首页跑通之后，你其实已经拥有了一个可复用的网络请求模板。后面做模板管理、计数记录、设置同步，都可以照这个模式来：ViewModel 里发请求、StateFlow 暴露状态、Compose 组件根据状态渲染。区别只是接口路径和请求体不同。

如果你打算继续用 Cursor 生成后续页面，建议把这一篇里的RetrofitClient、TaoTokenApi、HomeViewModel三个文件作为上下文喂给它，让它理解你的网络层约定。这样它生成的代码不会又给你塞一套新的 Retrofit 配置，避免项目里出现两套网络层。

对于需要长期编码、频繁调用模型的场景，可以看看 Coding Plan 是否适合你的使用节奏： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。首页这种按需请求用按量计费就够，等你的 APP 真正需要批量生成内容或者接 Agent 时再考虑套餐。

最后提醒一句：Key 的管理从第一天就要规范。local.properties只适合本地开发，如果后面要接 CI 或者多人协作，记得把 Key 放到环境变量或者密钥管理服务里，不要图省事直接写进代码。首页能跑通只是开始，网络层的整洁程度决定了你后面加功能时有多轻松。