uni-app怎么配置打包权限

夏浩姑娘_8280

夏浩姑娘_8280

2026-10-31

937人浏览

原创

uni-app权限配置需三步:manifest.json声明(Android用android.permission.前缀、iOS填NS*UsageDescription、鸿蒙需module.json5显式声明)、运行时调用API、各平台描述文案齐全,缺一导致静默失败或审核被拒。

uni-app怎么配置打包权限

uni-app 打包权限配置不是“配了就自动生效”,而是分三步走:manifest.json 声明、运行时调用 API 请求、iOS/Android/HarmonyOS 各平台描述文案缺一不可。漏掉任一环,真机上要么静默失败,要么弹窗被拒,且控制台几乎不报错。

manifest.json 里 Android 权限必须带 android.permission. 前缀

只写 CAMERA 或 camera 是无效的;HBuilderX 不报错,但打包后在 Android 6.0+ 上系统直接忽略该权限请求,plus.android.requestPermissions 回调中 deniedAlways 可能为空,误判成“用户没点”,实际是系统压根没认这个权限名。

  • 正确写法:"android.permission.CAMERA"、"android.permission.ACCESS_FINE_LOCATION"、"android.permission.READ_EXTERNAL_STORAGE"
  • Android 10+ 需额外注意:READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 配合 requestLegacyExternalStorage=true(仅调试期),正式版应迁移到 Scoped Storage
  • 云端打包时若同时使用 AndroidManifest.xml 自定义权限,需确保与 manifest.json 中声明不冲突,否则打包日志会提示 merge error

iOS 权限描述文案必须填进 NS*UsageDescription 字段

苹果审核强制要求——没有对应描述文案,权限申请会被系统拦截,uni.authorize 直接返回 fail,无任何提示。

  • 必须写在 "app-plus" → "permissions" 下,例如:"NSPhotoLibraryUsageDescription": "用于从相册选择图片"
  • 常见字段包括:NSCameraUsageDescription、NSLocationWhenInUseUsageDescription、NSMicrophoneUsageDescription
  • 老版本 HBuilderX 可能要求写在 "distribute" → "ios" 下,新项目统一推荐用 permissions 路径
  • 文案不能留空或只写英文占位符,App Store 审核可能因此拒审

微信小程序隐私接口必须精准匹配 requiredPrivateInfos

不是“开了相册权限就能调所有相册 API”,而是每个接口单独登记。漏一个,真机上调用就静默失败,errCode: -1,控制台不打印任何错误信息。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • 只用 uni.chooseImage?那就只填 "chooseImage"
  • 还用了 uni.getLocation 和 uni.chooseLocation?必须三个都列:["getLocation", "chooseLocation", "chooseImage"]
  • 字段名大小写敏感,不能写成 getlocation 或 getlocation
  • 该配置在 manifest.json 的 "mp-weixin" 节点下,不是全局配置

鸿蒙(HarmonyOS)需手动添加 ohos.permission.* 权限

uni-app 打包为鸿蒙 APP 时,manifest.json 的权限声明对鸿蒙无效。必须在生成的鸿蒙工程(app-harmony)中修改 module.json5 文件,显式声明鸿蒙权限。

  • 例如相机权限要加:"ohos.permission.CAMERA";位置权限加:"ohos.permission.LOCATION"
  • 鸿蒙权限名和 Android 不互通,不能复用 android.permission.*
  • 部分 API(如 uni.scanCode)在鸿蒙端依赖 ohos.permission.DISTRIBUTED_DATASYNC,不加则扫码失败
  • 调试证书和发布证书的包名必须一致,否则权限配置不生效

最容易被忽略的是:权限在 manifest.json 里只是“备案”,真正触发弹窗的是运行时那行 uni.authorize 或 plus.android.requestPermissions;而 iOS 和鸿蒙的描述文案一旦漏填或拼错,连弹窗机会都没有——它根本不会走到请求那步。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2743

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5963

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6910

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

6658

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

943

5

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

40

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

20

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

40

10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

140

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习