mcpField
A
android-networking-retrofit-okhttp

android-networking-retrofit-okhttp

github.com/midudev开发7.0k61 次安装今天更新
代码仓库

关于 android-networking-retrofit-okhttp

面向 Android 开发者的网络开发技能，指导使用 Retrofit 和 OkHttp 构建网络层，涵盖拦截器、API 契约及错误处理，并关注离线、重试和数据持久性。

主要功能

  1. 01Retrofit 与 OkHttp 配置
  2. 02拦截器和 API 契约
  3. 03类型化模型与错误映射
  4. 04离线及重试行为验证
  5. 05关注取消与数据持久性

适用场景

  1. 01搭建 Android 网络层
  2. 02处理 API 错误与重试
  3. 03验证缓存过期后的恢复行为

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/midudev/autoskills --skill android-networking-retrofit-okhttp

安装后在 Claude Code 中输入/android-networking-retrofit-okhttp确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
official-links.md
patterns.md
scenarios.md
scripts/
run_examples.sh

详细介绍

Android 网络 Retrofit OkHttp

适用场景

  • 在请求涉及以下内容时使用此技能：Android Retrofit 设置、Android OkHttp 拦截器、Android API 错误映射。
  • 主要目标：使用 Retrofit、OkHttp、拦截器、API 契约和稳健的错误处理构建 Android 网络栈。
  • 当范围扩大时转交给以下技能：
  • android-serialization-offline-sync
  • android-security-best-practices

工作流

  1. 确认涉及的数据源、持久化边界、同步模型和设备能力。
  2. 在接入网络、存储、媒体或后台 API 之前，明确建模契约。
  3. 应用推荐的 AndroidX 或平台模式，并采用便于安全迁移的默认设置。
  4. 根据示例应用和场景验证离线、重试和进程终止后的行为。
  5. 必要时将安全、性能或发布风险升级给关联的支持技能。

防护措施

  • 优先使用类型化模型和显式序列化器，而非临时映射或 bundle。
  • 确保后台工作具备幂等性，并能感知取消操作。
  • 不要将存储、媒体或网络细节泄漏到表示层代码中。
  • 将用户数据持久性、隐私和迁移路径视为实现的一部分。

反模式

  • 在主线程执行磁盘或网络调用，导致线程阻塞。
  • 将可重试的同步失败视为面向用户的终止错误。
  • 在没有映射层的情况下混用缓存模型和网络传输模型。
  • 在存在范围更窄的 API 时，仍请求广泛的存储或通知权限。

示例

顺利路径
  • 场景：为任务刷新建模同步请求和网络故障。
  • 命令：cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest
边缘情况
  • 场景：处理 XML 夹具中的过期缓存和重试行为。
  • 命令：cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest
故障恢复
  • 场景：区分网络提示词与序列化、安全和离线同步请求。
  • 命令：python3 scripts/eval_triggers.py --skill android-networking-retrofit-okhttp

完成检查清单

  • 实现路径明确且精简，并且对应正确的 Android 接口。
  • 已运行或更新相关示例命令和基准提示词。
  • 请求涉及相邻技能时，已记录技能交接信息。
  • 官方参考资料涵盖所选模式以及主要迁移或故障排查路径。

官方参考资料

评论

支持 Markdown