150******47DevEco Studio
HarmonyOS 5
ArkUI
HarmonyOS SDK
ArkTS
关于web类里申请权限的问题

如上图,在说明方法之前,文档里提到了需要权限,这个需要权限指代的是在使用下面方法的时候,遇到需要访问地理位置时候就要申请权限吗,还是如果使用了这个类就需要首先申请权限呢
慢行
调用这个类的方法不需要权限。调用需要权限的方法时才需要权限。
需要权限很多都是方法级别的。如果需要会有标识。

150******47我想请问一下,除了提到的工具类、方法类 还有什么其他的类别吗2026-05-26 16:40 来自黑龙江
慢行回复150******47如果全面了解下语言特性,可以看下《ArkTS语言介绍》。另外在线课程搜arkts也有系列课。2026-05-27 02:22 来自北京
why
华夏
如果不申请权限是使用不了定位的。你要想正常使用定位就一定绕不开申请权限。反过来,如果只是调用了定位的方法,而没有申请权限,是无法获取到定位信息的。
Web组件根据GeolocationPermissions类和onGeolocationShow方法的响应结果,决定是否赋予前端页面权限。用户可以获取位置信息,以便使用出行导航、天气预报等服务。
需要权限
使用获取位置功能,需在module.json5中配置位置权限。具体添加方法请参考在配置文件中声明权限。
"requestPermissions":[
{
"name" : "ohos.permission.LOCATION" // 精准定位
},
{
"name" : "ohos.permission.APPROXIMATELY_LOCATION" // 模糊定位
},
{
"name" : "ohos.permission.LOCATION_IN_BACKGROUND" // 后台定位
}
]
申请位置权限
在下面的示例中,用户点击前端页面"获取位置"按钮,Web组件通过弹窗通知应用侧位置权限请求消息。
-
前端页面代码。
收起自动换行深色代码主题复制<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>位置信息</title> </head> <body> <p id="locationInfo">位置信息</p> <button onclick="getLocation()">获取位置</button> <script> var locationInfo=document.getElementById("locationInfo"); function getLocation(){ if (navigator.geolocation) { // 访问设备地理位置 navigator.geolocation.getCurrentPosition(showPosition); } } function showPosition(position){ locationInfo.innerHTML="Latitude: " + position.coords.latitude + "<br />Longitude: " + position.coords.longitude; } </script> </body> </html> - 应用代码。 收起自动换行深色代码主题复制
import { webview } from '@kit.ArkWeb'; import { BusinessError } from '@kit.BasicServicesKit'; import { abilityAccessCtrl, common } from '@kit.AbilityKit'; let atManager = abilityAccessCtrl.createAtManager(); @Entry @Component struct WebComponent { controller: webview.WebviewController = new webview.WebviewController(); uiContext: UIContext = this.getUIContext(); // 组件的生命周期函数,创建组件实例后触发 aboutToAppear(): void { let context : Context | undefined = this.uiContext.getHostContext() as common.UIAbilityContext; if (!context) { console.error("context is undefined"); return; } // 向用户请求位置权限,对整个应用生效 atManager.requestPermissionsFromUser(context, ["ohos.permission.APPROXIMATELY_LOCATION"]).then((data) => { console.info('data:' + JSON.stringify(data)); console.info('data permissions:' + data.permissions); console.info('data authResults:' + data.authResults); }).catch((error: BusinessError) => { console.error(`Failed to request permissions from user. Code is ${error.code}, message is ${error.message}`); }) } build() { Column() { // Web组件的geolocationAccess属性默认为true,可以显式配置为false以禁止Web组件获取地理位置信息 Web({ src: $rawfile('getLocation.html'), controller: this.controller }) .geolocationAccess(true) .onGeolocationShow((event) => { // 位置权限申请通知仅对当前Web组件生效,应用内的其他Web组件不受影响 this.uiContext.showAlertDialog({ title: '位置权限请求', message: '是否允许获取位置信息', primaryButton: { value: 'cancel', action: () => { if (event) { // 不允许此站点位置权限请求 // 注意invoke的第3个参数表示是否记住当前选择,如果传true,则下次不再弹框 event.geolocation.invoke(event.origin, false, false); } } }, secondaryButton: { value: 'ok', action: () => { if (event) { // 允许此站点位置权限请求 // 注意invoke的第3个参数表示是否记住当前选择,如果传true,则下次不再弹框 event.geolocation.invoke(event.origin, true, false); } } }, cancel: () => { if (event) { // 不允许此站点位置权限请求 // 注意invoke的第3个参数表示是否记住当前选择,如果传true,则下次不再弹框 event.geolocation.invoke(event.origin, false, false); } } }) }) } } }
不羁的木木这里文档里的“需要权限”,指的是:
当 Web 页面真正访问地理位置能力时,需要应用先具备定位权限。不是:
只要 import 或使用 GeolocationPermissions 类就必须先申请权限。也就是说:
| 场景 | 是否必须提前申请定位权限 |
|---|---|
| 仅调用 | 不一定 |
| Web 页面触发 | 必须 |
| H5 请求定位 | 必须 |
| Web 不访问定位 | 不需要 |
你可以理解为:
GeolocationPermissions
本质上只是:
“是否允许某个网页(origin)使用定位”但:
真正的定位能力还是系统权限控制的。
例如:
H5 页面:
navigator.geolocation.getCurrentPosition(...)这时:
- Web 会请求定位
- ArkWeb 会检查:
- 当前 origin 是否 allow
- App 是否有 LOCATION 权限
- 缺任何一个都会失败
所以实际完整流程应该是:
正确流程
1. 申请系统定位权限
例如:
ohos.permission.LOCATION必要时:
ohos.permission.APPROXIMATELY_LOCATION后台定位再加:
ohos.permission.LOCATION_IN_BACKGROUND2. 用户授权成功后
再:
webview.GeolocationPermissions.allowGeolocation(origin)3. H5 才能正常获取定位
很多人容易误解成:
allowGeolocation = 已经拥有定位权限其实不是。
它只是:
允许某个网页使用定位真正权限仍然是:
系统 Runtime Permission举个例子:
你即使:
allowGeolocation('https://xxx.com')但用户没授权:
ohos.permission.LOCATIONH5 仍然会:
定位失败所以建议实际开发里:
推荐做法
在:
Web 即将加载定位页面之前:
先主动申请定位权限。
而不是等 H5 调定位时再处理。
这样兼容性最好。
总结一句:
GeolocationPermissions 类本身不要求必须先申请权限,
但只要 Web 页面真正访问定位能力,就必须提前拥有系统定位权限。- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS electron HarmonyOS创建日志无权限(API12+)
创建一个FastWeb是否可以绑定多个H5页面
HarmonyOS Web加载 H5的getUserMedia问题 (API12+)
Web组件缩放比例与滚动偏移量精确值获取及换算
HarmonyOS 位置权限申请问题 (API12+)
HarmonyOS H5页面如何申请定位权限?(API12+)
react-native-webview位置权限与页面拦截配置
HarmonyOS 应用向用户索取权限使用目的说明不明确(API12+)




































苏公安网备 32011402010933号