Beeware 中在 Android 上安全播放 MP3 文件的完整实践指南-Python教程-PHP中文网

Beeware 中在 Android 上安全播放 MP3 文件的完整实践指南

本文详解如何在 Beeware（Toga）开发的 Android 应用中，通过 FileProvider 安全调用系统音乐播放器打开本地 MP3 文件，规避 FileUriExposedException 和 ActivityNotFoundException，涵盖权限配置、URI 生成、Manifest 注入及路径适配等关键步骤。

本文详解如何在 beeware（toga）开发的 android 应用中，通过 `fileprovider` 安全调用系统音乐播放器打开本地 mp3 文件，规避 `fileuriexposedexception` 和 `activitynotfoundexception`，涵盖权限配置、uri 生成、manifest 注入及路径适配等关键步骤。

在 Beeware 构建的跨平台 Python 移动应用中，直接通过 Intent 启动 Android 系统音乐播放器播放 MP3 是常见需求。但自 Android 7.0（API 24）起，系统强制要求使用 FileProvider 替代裸 file:// URI，否则将抛出 android.os.FileUriExposedException；而即使修复 URI，若未正确匹配目标 Activity 或 MIME 类型，又易触发 ActivityNotFoundException。以下为经过实测验证的端到端解决方案。

✅ 正确配置 FileProvider（核心前提）

首先，确保 pyproject.toml 中已声明 FileProvider 组件（注意包名一致性）：

[tool.briefcase.android.gradle]
android_manifest_application_extra_content = """
<provider android:name="androidx.core.content.FileProvider" android:authorities="${applicationId}.fileprovider" android:exported="false" android:granturipermissions="true"><meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/provider_paths"></meta-data></provider>
"""

⚠️ 关键点：

android:authorities 必须与代码中 getUriForFile(...) 的第二个参数完全一致（如 cz.pd.Level.fileprovider）；
${applicationId} 由 Briefcase 自动替换为实际包名（如 com.example.myapp），请勿硬编码；
android:exported="false" 是安全必需项，禁止外部应用直接访问 provider。

接着，在项目资源目录 src/android/app/src/main/res/xml/provider_paths.xml 中创建路径映射文件：

<?xml version="1.0" encoding="utf-8"?><paths><!-- 允许访问外部存储根目录（含 /Music/） --><external-path name="external_files" path="."></external-path><!-- 或更精确地限定 Music 目录（推荐） --><!-- <external-path name="music_dir" path="Music/" /> --></paths>

? 提示：<external-path></external-path> 对应 Environment.getExternalStorageDirectory()，即 /storage/emulated/0/。若需访问应用私有目录（如 app/src/main/assets/），应改用 <files-path></files-path> 并配合 context.getFilesDir()。

Windows-Android_SSH_Remote_Control
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南，适用于远程桌面访问、安全 RDP 等。

下载

✅ 安全构建 Intent 并启动播放器

以下为可直接集成到 Toga Button 回调中的完整异步代码（适配 Android API 24+）：

import os
from toga.platform import current_platform

async def pate_tlacitko(self, widget):
    if current_platform != "android":
        return

    # 导入 Android 原生类（仅在 Android 运行时有效）
    from android.content import Intent
    from androidx.core.content import FileProvider
    from android.net import Uri
    from java.io import File
    from android.os import Environment

    # ✅ 推荐方式：从公共 Music 目录读取（无需额外权限）
    music_dir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MUSIC)
    file_path = os.path.join(str(music_dir), "test.mp3")

    # 验证文件存在
    if not os.path.exists(file_path):
        print(f"MP3 文件不存在：{file_path}")
        return

    # ✅ 使用 FileProvider 生成 content:// URI
    context = self.app._impl.native
    file_obj = File(file_path)
    authority = f"{context.getPackageName()}.fileprovider"  # 与 manifest 中 authorities 严格一致
    uri = FileProvider.getUriForFile(context, authority, file_obj)

    # ✅ 构造 Intent：使用 ACTION_VIEW + 正确 MIME 类型
    intent = Intent(Intent.ACTION_VIEW)
    intent.setDataAndType(uri, "audio/*")  # ⚠️ 关键！改用 audio/* 而非 application/mp3
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)

    # ✅ 尝试启动（兼容性更强）
    try:
        await self.app._impl.intent_result(intent)
    except Exception as e:
        print(f"启动播放器失败：{e}")

? 关键修正说明：

*MIME 类型必须为 `"audio/"**：CATEGORY_APP_MUSIC是过时的启动类别，现代 Android 更推荐ACTION_VIEW+audio/*`，系统会自动匹配支持音频播放的 Activity（如 Google Play Music、Samsung Music、系统默认播放器）；
FLAG_GRANT_READ_URI_PERMISSION 不可省略：授予目标 Activity 临时读取该 URI 的权限；
避免硬编码路径：优先使用 Environment.getExternalStoragePublicDirectory(DIRECTORY_MUSIC) 获取标准音乐目录，既符合用户习惯，也规避权限问题（Android 10+ Scoped Storage 下仍可读写 Music/ 目录）。

⚠️ 注意事项与调试建议

权限声明：虽然读取 Music/ 目录在 Android 10+ 无需 READ_EXTERNAL_STORAGE，但若需访问其他路径，请在 pyproject.toml 中添加：

[tool.briefcase.android.gradle]
android_manifest_application_extra_permissions = ["<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>"]

APK 重建：每次修改 pyproject.toml 或 provider_paths.xml 后，必须重新执行 briefcase create android（而非仅 briefcase build），否则更改不会生效；
真机调试：模拟器可能缺少预装音乐 App，务必在真实设备（如 Pixel、三星、华为）上测试；
错误排查：
- 若报 ActivityNotFoundException：检查 intent.setDataAndType(...) 的 MIME 是否为 audio/*，并确认设备已安装至少一个音频播放器；
- 若报 SecurityException：确认 FileProvider 的 authorities 与代码中完全一致，且 android:exported="false"。

✅ 总结

在 Beeware Android 应用中播放 MP3，本质是桥接 Python 逻辑与 Android 原生 Intent 机制。成功的关键在于三点：
① 通过 FileProvider 合规暴露文件（解决 FileUriExposedException）；
② 使用 ACTION_VIEW + audio/* 替代过时的 CATEGORY_APP_MUSIC（解决 ActivityNotFoundException）；
③ 依赖 Environment.DIRECTORY_MUSIC 访问标准路径，兼顾兼容性与用户体验。

完成上述配置后，你的 Python 编写的跨平台应用即可在 Android 设备上无缝调起系统音乐播放器——真正实现“Write once, deploy everywhere”的 Beeware 承诺。