用途:为 Android 应用提供基于 Ktor 的 HTTP 客户端配置与调用模式,适合使用 Kotlin 协程进行网络请求的项目。
主要能力:客户端初始化时可通过 install(ContentNegotiation) 配置 JSON 序列化(ignoreUnknownKeys、isLenient、prettyPrint);通过 install(HttpTimeout) 设置请求、连接与套接字超时;通过 install(Logging) 在调试环境输出日志;通过 defaultRequest 设置默认 URL 与 Content-Type;通过 install(Auth) 的 bearer 配置令牌加载与刷新。API 层可用挂起函数封装 get、post、put、delete 等请求。错误处理提供 ApiException 与 safeRequest 扩展,将响应转为 Result。DTO 使用 @Serializable 与 @SerialName 映射字段,并提供 toDomain 转换。拦截器通过 install(HttpSend) 的 intercept 修改请求头。证书固定通过 OkHttp 引擎的 certificatePinner 添加 sha256 指纹与备用 pin。
使用方式:在 Android 项目中引入 Ktor 客户端与 OkHttp 引擎,按上述模式组装 HttpClient,再以 UserApi、UserRepository 等类组织请求与领域模型转换。
适用场景:需要统一网络层配置、令牌刷新、错误封装与安全校验的 Kotlin/Android 应用。
限制:资料未提供具体依赖版本、安装命令、收费信息与完整项目结构;示例中的 URL、令牌存储与 BuildConfig 需按实际项目替换。