uni-app如何配置原生定位权限的描述文字

夏涛同学_4105

夏涛同学_4105

2026-08-29

997人浏览

原创

android权限描述文字无需用户可见文案,只需在manifest.json的distribute.android.permissions中声明标准xml权限字符串,如"",不可重复配置于其他废弃路径。

uni-app如何配置原生定位权限的描述文字

uni-app 的定位权限描述文字不能只写在 manifest.json 里,必须按平台分层配置,且 iOS 和 Android 的字段位置、格式、生效逻辑完全不同——漏掉任一层,真机上都会静默失败。

Android 权限描述文字写在哪?

Android 不需要「用户可见的描述文案」,它依赖的是 manifest.json 中 distribute.android.permissions 里声明的 XML 权限字符串本身。系统弹窗文案由 ROM 厂商决定(比如小米/华为会用自己的提示语),你无法控制。

但必须确保这个数组里包含标准格式的权限声明:

  • ["<uses-permission android:name='\"android.permission.ACCESS_FINE_LOCATION\"/'>"]</uses-permission>
  • 不能写成对象,不能混入 ACCESS_COARSE_LOCATION —— 两者同时声明会导致部分安卓机型(尤其 OPPO、vivo)直接拒绝定位请求
  • 不要在 app-plus.permissions 或 app-plus.modules.Maps.permissions 下重复配置,这些路径已废弃或仅用于旧版 HBuilderX 兼容

iOS 的描述文案必须填在 plist 字段里

iOS 系统级弹窗的提示文字,完全取决于 manifest.json 中 distribute.ios.plist 下的两个键值:

uni-app
uni-app

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

下载
  • NSLocationWhenInUseUsageDescription:对应「使用期间允许」,值必须是中文字符串,例如 "用于查找附近的服务网点"
  • NSLocationAlwaysAndWhenInUseUsageDescription:若需后台定位(如运动类 App),才需同时填此项,否则留空即可
  • 这两个字段的值会被直接透传给系统,空值、null、纯空格或英文都会导致审核被拒或弹窗不显示
  • 注意:不是 mp-weixin 或 permission.scope.userLocation.desc,那些只对小程序生效

为什么 uni.authorize 的 desc 在 App 端完全无效?

uni.authorize({ scope: 'scope.userLocation', desc: 'xxx' }) 中的 desc 参数在 App 端会被忽略——因为 uni.authorize 在 App 平台底层不走原生权限 API,它只是个兼容层壳子。

真实触发弹窗的是:

  • Android:plus.android.requestPermissions(['android.permission.ACCESS_FINE_LOCATION'])
  • iOS:plus.ios.requestPermission('location')
  • 这两者都不接受 desc 参数;它们的文案来源只可能是上面说的 AndroidManifest 声明或 iOS plist 配置
  • 所以你在 JS 里写的任何 desc,在 App 打包后都起不到作用

最容易被忽略的一点:HBuilderX 调试时,plus.* API 不会触发真实弹窗,也不会读取 plist 配置——必须真机运行才能验证描述文案是否生效。模拟器和调试基座都不行。

相关文章

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

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

下载

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

相关专题

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

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

2023.08.11

2583

5

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

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

2023.10.09

5583

6

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

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

2024.03.19

6590

13

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

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

2024.03.22

6238

10

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

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

2024.05.22

883

5

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

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

2026.10.16

100

10

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

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

2026.10.16

60

10

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

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

2026.10.16

40

10

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

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

2026.10.16

40

15

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习