三方sdk权限需手动补全完整限定名并分路径配置:manifest.json中须在modules→sdk→permissions下写全android.permission.xxx;androidmanifest.xml需手写uses-permission/uses-feature,且仅云端打包生效。

manifest.json 中三方 SDK 的权限不能只靠勾选“Android 权限配置”面板来搞定,必须手动补全完整权限声明,否则在 Android 6.0+ 真机上会静默失败——系统根本不认你申请的权限。
三方 SDK 权限必须写全限定名(android.permission.XXX)
比如高德地图 SDK 需要定位,manifest.json 里得显式写 "android.permission.ACCESS_FINE_LOCATION",不能简写成 "ACCESS_FINE_LOCATION" 或 "location"。HBuilderX 不报错,但打包后 APK 在 Android 10 设备上调用 plus.android.requestPermissions 时,deniedAlways 可能为空,你以为用户没点授权,其实是系统压根没看到这个权限声明。
- 正确示例(高德模块):
{"app-plus": {"modules": {"AMap": {"permissions": [{"name": "android.permission.ACCESS_FINE_LOCATION"}, {"name": "android.permission.ACCESS_COARSE_LOCATION"}]}}}} - 错误写法:
"ACCESS_FINE_LOCATION"、"fine_location"、"location" - 注意:所有三方 SDK 涉及的权限,都得走这个
modules→XXX→permissions路径,不能塞进顶层app-plus.distribute.android.permissions里混用
微信小程序 requiredPrivateInfos 必须与 API 调用严格一一对应
调了 uni.getLocation 就必须在 manifest.json 的 mp-weixin.requiredPrivateInfos 里写 "getLocation";如果还用了 uni.chooseLocation,就得一并加上,漏一个就真机静默失败,控制台连 errCode 都不抛,只返回 -1。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 合法值仅限微信文档白名单:
"getLocation"、"chooseLocation"、"getPhoneNumber"、"getUserInfo"等 - 禁止驼峰变体:
"getlocation"、"get_user_location"、"uniGetLocation"全部无效 -
permission.scope.userLocation.desc字段必须存在且非空,否则华为/小米商店审核大概率拒掉
极光推送、友盟等 SDK 的权限要拆开配,不能只靠“自动添加”
HBuilderX 默认打包会加基础权限(如 INTERNET、READ_PHONE_STATE),但极光(JPush)、个推这类 SDK 往往需要额外硬件特性声明,比如:<uses-feature android:name="android.hardware.camera"></uses-feature>,这类声明无法通过可视化面板配置,必须手写进 AndroidManifest.xml。
- 操作路径:项目根目录右键 → 新建 → 自定义文件 → 命名为
AndroidManifest.xml - 必须包含命名空间:
xmlns:android="http://schemas.android.com/apk/res/android"和package属性(值应与云端打包配置的包名一致) - 三方 SDK 的
<uses-permission></uses-permission>和<uses-feature></uses-feature>都得放在这里,和manifest.json中已配内容避免重复,否则合并时冲突
最常被忽略的是:AndroidManifest.xml 配置只在云端打包生效,真机运行(包括自定义基座)不会读取;而 manifest.json 里的 modules 权限又只对 HBuilderX 封装的 SDK 生效——所以 SDK 文档里写的每个权限,你得自己判断该塞哪边,不能偷懒全扔一个地方。










