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

uni-app怎么配置Android原生权限申请列表

冬丽小哥_2331

冬丽小哥_2331

发布时间:2026-10-12 14:12:17

|

547人浏览过

|

来源于php中文网

原创

manifest.json中permissions必须为字符串数组,如["android.permission.CAMERA"];全限定名、字符串、数组三者缺一不可,否则云端打包忽略、真机申请失败。

uni-app怎么配置android原生权限申请列表

manifest.json里permissions必须写成数组,不是对象

很多项目跑不起来,根源就卡在这——manifest.json里的permissions字段被写成对象格式,比如{"android.permission.CAMERA": {}}。HBuilderX不会报错,但云端打包时直接忽略,真机上plus.android.requestPermissions调用后进fail回调,控制台连错误提示都没有。

正确写法只有一种:"permissions": ["android.permission.CAMERA", "android.permission.ACCESS_FINE_LOCATION"]。全限定名、字符串、数组,三者缺一不可。

  • 漏掉android.permission.前缀(如写成CAMERA)→ 系统不识别,静默失败
  • 混用大小写(如access_fine_location)→ Android 严格区分大小写,匹配失败
  • 可视化勾选后手动改了代码视图却没重新「发行」→ 配置未生效,还是旧包

哪些权限必须提前声明,哪些可以不配

不是所有权限都要写进manifest.json。Android系统只对「危险权限」强制要求运行时申请,而这些权限在manifest中也必须声明;普通权限(如android.permission.INTERNET)云端打包默认已包含,不声明也不影响使用。

常见必须声明的危险权限包括:

  • android.permission.CAMERA
  • android.permission.RECORD_AUDIO
  • android.permission.ACCESS_FINE_LOCATION
  • android.permission.READ_EXTERNAL_STORAGE 和 android.permission.WRITE_EXTERNAL_STORAGE(Android 10+需配合requestLegacyExternalStorage临时适配)
  • android.permission.NFC(注意:不能简写为NFC)

像android.permission.READ_PHONE_STATE这类默认权限,除非你明确要禁用,否则不用手动加。

动态申请时权限名必须和manifest完全一致

plus.android.requestPermissions传入的权限字符串,必须和manifest.json中声明的**逐字符一致**。哪怕多一个空格、少一个点,都会导致系统拒绝弹窗,回调直接走deniedAlways分支,你以为用户点了“不再询问”,其实是配置错了。

Android Adb
Android Adb

执行 Android ADB(Android 调试桥)命令,用于设备管理、应用管理、调试和自动化。当用户请求任何与 ADB 相关的操作时使用。

下载

典型错误示例:

  • manifest写了"android.permission.ACCESS_FINE_LOCATION",但代码里传"android.permission.ACCESS_COARSE_LOCATION" → 匹配失败
  • manifest写了"android.permission.WRITE_EXTERNAL_STORAGE",但代码里传["WRITE_EXTERNAL_STORAGE"] → 缺前缀,静默失败
  • 一次申请多个权限时,其中某一个拼错,整个数组都失效(Android机制:全成功才算成功)

建议把权限常量统一抽成变量或枚举,避免硬编码重复出错。

Android 10+ 存储权限要额外注意targetSdkVersion和作用域

如果你的目标是Android 10(API 29)及以上,READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE即使声明并申请成功,也无法访问应用外部目录的任意文件——这是Scoped Storage强制策略。此时仅靠requestLegacyExternalStorage: true只能用于调试期,正式包会被华为/小米等市场拒收。

真正合规的做法是:

  • 优先用uni.getFileSystemManager()操作沙盒路径(uni.env.USER_DATA_PATH)
  • 需要访问公共媒体文件时,改用uni.saveFileToPhotosAlbum或uni.chooseImage等封装接口
  • 若必须读取其他App生成的文件,走Intent.ACTION_OPEN_DOCUMENT方式(UTS插件级实现)

别指望靠requestLegacyExternalStorage蒙混过审,它已在Android 12+被废弃,且主流应用市场明确禁止在正式版APK中启用。

热门AI工具

更多
豆包大模型

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

WorkBuddy

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

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

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

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

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

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

2503

2023.08.11

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

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

5403

2023.10.09

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

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

6430

2024.03.19

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

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

6058

2024.03.22

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

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

863

2024.05.22

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

0

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

0

2026.10.16

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

0

2026.10.16

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

0

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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