9***@qq.com
9***@qq.com
  • 发布:2026-06-10 10:30
  • 更新:2026-06-10 10:30
  • 阅读:86

为什么云打包没有添加android:usesPermissionFlags="neverForLocation"

分类:uni-app

在 Android 11 (API 级别 30) 及更早的版本中,系统底层逻辑将蓝牙扫描与位置权限强绑定,因此无法在关闭定位权限的情况下进行蓝牙搜索。

但是,从 Android 12 (API 级别 31) 开始,官方引入了新的蓝牙权限模型,允许应用在不请求位置权限的情况下进行蓝牙扫描。如果你的目标是在 Android 12 及以上版本的平台上实现这一功能,可以通过以下方案解决:

解决方案:使用 neverForLocation 标志

如果你的应用确实不需要通过蓝牙扫描结果来推导用户的实际物理位置,你可以在 AndroidManifest.xml 中为 BLUETOOTH_SCAN 权限添加 neverForLocation 标志。

修改 AndroidManifest.xml

在你的清单文件中,添加以下权限声明:

<!-- Android 12 及以上版本的蓝牙扫描权限,并声明绝不用于定位 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"
android:usesPermissionFlags="neverForLocation" />

<!-- 如果不需要精确定位,可以移除或限制 ACCESS_FINE_LOCATION 权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
android:maxSdkVersion="30" />

关键注意事项

系统行为变化:当使用了 neverForLocation 标志后,系统在执行蓝牙扫描时,会自动过滤掉那些专门用于位置推导的 BLE 信标(如 iBeacon 等)。
适用场景:这个标志仅适用于那些只需要连接已知设备(如蓝牙耳机、打印机、手环等)或扫描非定位用途的 BLE 设备的应用。
Android 11 及以下的兼容性:在 Android 11 及以下版本中,蓝牙扫描仍然强制需要位置权限。因此,你仍然需要在代码中针对旧版本进行兼容处理(即在旧版本上请求位置权限,在新版本上则不需要)。

总结

Android 11 及以下:必须开启定位并授予位置权限才能使用蓝牙搜索,这是系统底层的安全机制,无法绕过。
Android 12 及以上:通过在 BLUETOOTH_SCAN 权限中添加 android:usesPermissionFlags="neverForLocation",即可在不请求位置权限的情况下正常使用蓝牙搜索功能。

2026-06-10 10:30 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

好的,我理解你的问题。你想知道为什么在 uni-app 云打包时,没有自动为 BLUETOOTH_SCAN 权限添加 android:usesPermissionFlags="neverForLocation" 标志,从而在 Android 12+ 设备上实现不依赖位置权限的蓝牙扫描。

这个问题的核心在于云打包对 AndroidManifest.xml 的处理机制和权限配置方式。

云打包未添加 neverForLocation 的原因

根据知识库中的信息,核心原因可以归纳为以下几点:

  1. 历史兼容性限制:早在 2022 年就有开发者反馈过此问题(ask社区问题 #146985)。当时官方的回复是:“此问题确认是云端打包 Android SDK 版本没有升级到 31 导致,近期会升级。android:usesPermissionFlags 属性需要编译 SDK (compileSdkVersion) 至少为 31 才能被识别。在早期,云打包环境不支持此属性,强行添加会导致打包失败并报错 AAPT: error: attribute android:usesPermissionFlags not found

  2. 权限配置方式的限制:uni-app 项目通常是在 manifest.json 的源码视图中,通过 "permissions" 数组来声明额外权限,例如:

    "permissions": [  
        "<uses-permission android:name=\"android.permission.BLUETOOTH_SCAN\"/>"  
    ]  

    本助手使用国产模型,生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
    这种配置方式只能添加标准的 <uses-permission> 节点,无法直接为其添加额外的属性,如 android:usesPermissionFlags。这与配置 BLUETOOTH_SCAN 权限本身不同,后者是 uni-app 的蓝牙模块会自动添加的。

  3. 自定义清单文件合并问题:即使开发者尝试通过更高级的方式——创建自定义的 AndroidManifest.xml 文件并放入 nativeResources/android 目录下来声明带有 neverForLocation 标志的权限,也可能遇到问题。根据 ask社区反馈,云打包在合并清单文件时,可能会错误地将 android:usesPermissionFlags="neverForLocation" 解析为数值 android:usesPermissionFlags="0x00010000",导致标志失效,依然无法在不申请位置权限的情况下搜索到蓝牙设备。

解决方案与建议

虽然云打包没有直接提供“一键勾选”来添加此标志,但你仍有方法可以实现这个功能:

  • 使用自定义 AndroidManifest.xml 并密切关注官方更新:目前解决此问题最标准的方法是使用应用原生资源配置。你可以在项目中创建 nativeResources/android/AndroidManifest.xml 文件,并在其中完整声明带有 neverForLocation 标志的权限。请确保你的 HBuilderX 是最新版本,因为云端打包环境的 SDK 版本已经更新,能够正确处理此属性。如果遇到 0x00010000 这样的问题,建议向官方反馈,因为这可能是一个清单合并的 Bug。

  • 考虑使用成熟的插件:插件市场中有一些权限管理插件(如 permission-handler-plus)已经处理了这类复杂的权限场景。它们内部封装了对不同 Android 版本的适配逻辑,包括为新权限添加必需的属性。你可以访问 DCloud 插件市场 搜索“蓝牙”或“权限”来寻找合适的插件,这通常是最高效、最稳妥的解决方案。

总结来说,云打包未自动添加此标志,主要是受历史编译环境限制和其权限配置方式的约束。虽然可以通过自定义清单文件来解决,但过程可能存在一些需要官方修复的兼容性问题。因此,优先推荐使用成熟的插件来规避这些底层的复杂性。

内容为 AI 生成,仅供参考

要回复问题请先登录注册