用途:为 Android 项目建立统一的网络通信标准,使用 Retrofit 2 搭配 OkHttp 4 处理后端通信,并用 Kotlinx Serialization 与 @SerialName 完成 JSON 字段映射,实现类型安全的 API 调用。
主要能力与要求:
- HTTP 栈配置:统一使用 Retrofit 2 + OkHttp 4;对敏感生产域名实施证书固定(Certificate Pinning)。
- 接口定义:所有 API 调用必须为 suspend 函数;接口中只声明端点,错误处理放在 Repository 层。
- 横切关注点:用 OkHttp Interceptor 注入 Bearer token;HttpLoggingInterceptor 仅用于调试;在 Repository 层用 Result 包装器或 Either 包装响应;当 isMinifyEnabled = true 时,为 Retrofit/OkHttp 定义 R8/ProGuard 规则;使用 MockWebServer 做单元与集成测试,覆盖 500、401、403 等错误场景。
反模式(禁止):不得使用阻塞式网络调用,所有 API 函数必须 suspend;不得在 API 接口中写业务逻辑;不得使用原始 Converter Factory,需显式设置 "application/json" MediaType 配合 kotlinx.serialization。
适用场景:构建 Android API 客户端、添加拦截器、配置序列化与证书固定、编写网络层测试时。
限制:资料未提供具体依赖版本号、Gradle 配置代码、完整示例代码及安装命令,相关细节暂未提供。