文档开发者中心
我的
|

DevEco Studio

HarmonyOS 5

ArkUI

HarmonyOS SDK

ArkTS

关于web类里申请权限的问题

30
cke_130.png
如上图,在说明方法之前,文档里提到了需要权限,这个需要权限指代的是在使用下面方法的时候,遇到需要访问地理位置时候就要申请权限吗,还是如果使用了这个类就需要首先申请权限呢
点赞
收藏
回复
6
分享
举报
浏览82 发布于2026-05-23 07:39黑龙江
全部评论
最多点赞
最新发布
最早发布
GeolocationPermissions是个工具类。方法都是static的。方便你在Web组件使用地图位置时做权限管理。
调用这个类的方法不需要权限。调用需要权限的方法时才需要权限。
需要权限很多都是方法级别的。如果需要会有标识。
cke_1880.png
2
4楼编辑于2026-05-25 15:59 来自北京
  • 150******47
    我想请问一下,除了提到的工具类、方法类 还有什么其他的类别吗
    2026-05-26 16:40 来自黑龙江
  • 慢行回复150******47
    如果全面了解下语言特性,可以看下《ArkTS语言介绍》。另外在线课程搜arkts也有系列课。
    2026-05-27 02:22 来自北京
需要再你使用位置权限之前通过动态申请权限(用户授权),授权成功后通过web组件的onGeolocationShow方法去管理位置权限;
目前官网已有相关文档,

管理位置权限

可根据这个链接查看
3楼回复于2026-05-25 08:55 来自江苏

如果不申请权限是使用不了定位的。你要想正常使用定位就一定绕不开申请权限。反过来,如果只是调用了定位的方法,而没有申请权限,是无法获取到定位信息的。

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);
                  }
                }
              })
            })
        }
      }
    }
    

展开全部
1楼回复于2026-05-25 01:56 来自北京

这里文档里的“需要权限”,指的是:

收起
自动换行
深色代码主题
复制
当 Web 页面真正访问地理位置能力时,需要应用先具备定位权限。

不是:

收起
自动换行
深色代码主题
复制
只要 import 或使用 GeolocationPermissions 类就必须先申请权限。

也就是说:

场景

是否必须提前申请定位权限

仅调用 allowGeolocation()

不一定

Web 页面触发 navigator.geolocation.xxx

必须

H5 请求定位

必须

Web 不访问定位

不需要


你可以理解为:

GeolocationPermissions

本质上只是:

收起
自动换行
深色代码主题
复制
“是否允许某个网页(origin)使用定位”

但:

收起
自动换行
深色代码主题
复制
真正的定位能力

还是系统权限控制的。


例如:

H5 页面:

收起
自动换行
深色代码主题
复制
navigator.geolocation.getCurrentPosition(...)

这时:

  1. Web 会请求定位
  2. ArkWeb 会检查:
    • 当前 origin 是否 allow
    • App 是否有 LOCATION 权限
  3. 缺任何一个都会失败

所以实际完整流程应该是:

正确流程

1. 申请系统定位权限

例如:

收起
自动换行
深色代码主题
复制
ohos.permission.LOCATION

必要时:

收起
自动换行
深色代码主题
复制
ohos.permission.APPROXIMATELY_LOCATION

后台定位再加:

收起
自动换行
深色代码主题
复制
ohos.permission.LOCATION_IN_BACKGROUND

2. 用户授权成功后

再:

收起
自动换行
深色代码主题
复制
webview.GeolocationPermissions.allowGeolocation(origin)

3. H5 才能正常获取定位


很多人容易误解成:

收起
自动换行
深色代码主题
复制
allowGeolocation = 已经拥有定位权限

其实不是。

它只是:

收起
自动换行
深色代码主题
复制
允许某个网页使用定位

真正权限仍然是:

收起
自动换行
深色代码主题
复制
系统 Runtime Permission

举个例子:

你即使:

收起
自动换行
深色代码主题
复制
allowGeolocation('https://xxx.com')

但用户没授权:

收起
自动换行
深色代码主题
复制
ohos.permission.LOCATION

H5 仍然会:

收起
自动换行
深色代码主题
复制
定位失败

所以建议实际开发里:

推荐做法

在:

收起
自动换行
深色代码主题
复制
Web 即将加载定位页面

之前:

先主动申请定位权限。

而不是等 H5 调定位时再处理。

这样兼容性最好。


总结一句:

收起
自动换行
深色代码主题
复制
GeolocationPermissions 类本身不要求必须先申请权限,
但只要 Web 页面真正访问定位能力,就必须提前拥有系统定位权限。
展开全部
2楼回复于2026-05-25 08:52 来自辽宁
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。