用途:当任务涉及 Android 权限请求流程、Activity Result API 或相机权限等场景时使用,目标是采用现代权限请求、Activity Result API 与按能力授权的交互方式。
主要能力:从用户实际需要的能力出发(照片选择器、文档选择器、相机拍摄、通知订阅),优先选择比宽泛运行时权限更窄的方案;选择合适的 Activity Result 契约,并把 launcher 放在稳定的生命周期持有者中(Activity、Fragment 或 Compose 中记忆化的 launcher);显式建模完整权限状态,包括已授予、已拒绝、永久拒绝、受限/部分访问、一次性访问以及通过设置恢复;处理 API 级别差异,如 Android 13+ 的 POST_NOTIFICATIONS、粗略与精确位置、后台位置单独流程、Android 14 的选定照片访问。
使用方式:需要选择器与权限对照矩阵或 API 级别行为清单时阅读 references/patterns.md;需要照片选择器、通知权限、受限媒体访问示例时阅读 references/scenarios.md。范围扩大时可交接给 android-media-files-sharing、android-testing-ui。示例命令:rg -n "rememberLauncherForActivityResult|RequestPermission|RequestMultiplePermissions|PickVisualMedia|OpenDocument|TakePicture" examples;rg -n "POST_NOTIFICATIONS|READ_MEDIA_|READ_EXTERNAL_STORAGE|PickVisualMedia" examples;python3 scripts/eval_triggers.py --skill android-permissions-activity-results。
适用场景:Android 应用中的权限与能力授权流程设计、代码审查与重构,尤其是相机、照片、文档、通知相关交互。
限制与约束:不要把加载、空、错误、离线、权限拒绝等状态当作次要情况;不要在组合期间无用户操作或显式副作用就启动权限或选择器契约;优先使用照片选择器或 SAF 等更窄能力面,而非宽泛存储权限;避免反复弹窗、把 Android 14 选定照片访问当作完整媒体库访问。官方参考链接见 developer.android.com 相关页面。具体实现细节与完整代码示例暂未提供。