SuperAPI AI 工具集

android-sdk-knowledge-patch

编程与开发

查看项目

更新于 10-27 22:43

技能介绍

Android SDK Knowledge Patch 是一个用于更新 Android 应用、库、构建逻辑或 Play 发布设置时参考的技能,重点处理近期平台与 Android Gradle Plugin(AGP)行为变化可能带来的兼容性问题。

用途 该技能适用于需要评估或迁移 Android 项目以适配新平台版本、新 AGP 版本或新 Play 政策要求的场景。它强调在应用受 targetSdk 门控的指导前,先检查项目的 compileSdk、targetSdk、minSdk、AGP、Gradle、JDK、Kotlin、KSP、NDK 以及设备形态(手机、平板、桌面窗口、Wear OS、Android Auto、Automotive OS、TV、XR)。当项目自身的清单、构建文件、测试和实际运行时行为与通用指导不一致时,应优先以项目实际情况为准。

主要能力 技能提供多个参考主题索引,包括:AGP 工具链与 API(工具链下限、Kotlin、公共 DSL、Variant API、已移除 API、迁移阶段);蓝牙、媒体与设备(蓝牙、伴侣设备、健康、相机、编解码器、闹钟、小部件、设备集成);Google Play 目标 API 政策(提交下限、现有应用可用性、扩展、豁免);R8、打包与测试(缩减、keep 规则、打包、原生兼容性、报告、性能分析);运行时、UI 与调度(作业、并发、返回、边到边、大屏、IME、音频、桌面 UI);安全、网络与数据(Intent、局域网访问、TLS、SMS、联系人、URI 授权、Keystore、媒体访问)。

使用方式 技能建议从兼容性门控开始:从项目读取 compileSdk、targetSdk、minSdk、AGP、Gradle 和 JDK,而不是假设它们同步变化;识别设备与形态范围;在测试中区分平台级行为与 targetSdk 门控行为;仅将兼容性标志作为临时诊断手段,在提升 target SDK 前实现持久行为;对于构建插件,在启用更严格的 AGP 行为前迁移到惰性公共 API。

技能还列出破坏性平台行为,涉及调度与并发、导航/窗口/配置、权限与受保护数据;破坏性构建行为,涉及 AGP 工具链对齐、遗留 DSL 与 Variant API 的替换、默认值与已移除功能的审计;以及高价值迁移模式,包括安全嵌套 Intent 启动、局域网迁移、R8 keep 规则、蓝牙读取循环。此外还介绍值得采用的新能力,如 PhotoPickerUiCustomizationParams、CameraCaptureSession.updateOutputConfigurations()、setExactAndAllowWhileIdle() 的监听器重载、复杂 IME 文本变更元数据、外部显示器小部件、伴侣 Handoff、医疗设备与健身追踪器配置文件、APK Signature Scheme v3.2 等。

适用场景 适用于 Android 应用或库的版本升级、targetSdk 提升、AGP 迁移、Play 提交合规检查、大屏与多形态适配、后台作业与调度行为调整、权限与隐私合规、R8 缩减与打包配置、局域网与网络安全迁移等开发与发布流程。

限制 技能内容基于特定平台版本(如 Android 16、Android 17、API 36、API 37)和 AGP 版本(如 AGP 9.x、AGP 9.0、AGP 9.3、AGP 10)的行为描述,实际项目应结合自身构建文件、测试和运行时行为验证。技能中提到的具体 API、标志、命令和配置需以官方文档和项目实际环境为准。关于收费、价格、平台支持范围等未在资料中提供的信息,暂未提供。