讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app怎么配置打包权限

夏浩姑娘_8280

夏浩姑娘_8280

发布时间:2026-10-31 06:36:42

|

937人浏览过

|

来源于php中文网

原创

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,无任何提示。

uni-app
uni-app

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

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

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

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

  • 只用 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 和鸿蒙的描述文案一旦漏填或拼错,连弹窗机会都没有——它根本不会走到请求那步。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

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

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

2763

2023.08.11

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

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

5983

2023.10.09

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

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

6930

2024.03.19

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

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

6698

2024.03.22

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

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

963

2024.05.22

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

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

60

2026.10.28

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

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

40

2026.10.28

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

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

160

2026.10.28

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

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

140

2026.10.22

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn