用途:当需求涉及 Android 文件分享、照片选择器或 FileProvider 配置时使用本技能,核心解决 content URI、分享面板流程、选择器选型与应用间文件交换问题。若难点在运行时权限流程本身,应改用 android-permissions-activity-results。
主要能力:优先选用最窄的平台接口,如 Photo Picker、SAF 契约、FileProvider 或基于 chooser 的分享,而非宽泛的存储权限;明确文件归属与 URI 授权,包括应用私有存储、MIME 类型、临时授权与稳定 authority;覆盖返回流程、能力缺失时的回退以及接收方应用的兼容性。
使用方式:先确定资源移动路径(选取已有媒体、打开文档、创建或导出文件、采集新内容、分享应用自有内容);再选择最窄平台接口;保持 URI 授权与 MIME 类型显式;验证回退与互操作。示例命令:cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest;cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest;python3 scripts/eval_triggers.py --skill android-media-files-sharing。
适用场景:应用间文件交换、照片选择、文档打开与导出、分享应用自有内容。
限制与反模式:避免在 Photo Picker 或 SAF 足够时申请宽泛媒体/存储权限;不要分享 file:// 路径或全局可读文件;不要假设所有接收方都能正确处理任意 MIME 类型或 URI 权限;不要把权限流程设计与分享契约设计混在一起。官方参考见 developer.android.com 相关页面。