一、手动申请位置权限

1.1、申请位置权限

申请ohos.permission.LOCATION、ohos.permission.APPROXIMATELY_LOCATION权限。

"requestPermissions": [
     {
         "name": "ohos.permission.LOCATION",
         "reason": '$string:locationReason',
         "usedScene": {
             "abilities": ["EntryAbility"],
             "when": "inuse"
         }
     },
     {
         "name": "ohos.permission.APPROXIMATELY_LOCATION",
         "reason": '$string:locationReason',
         "usedScene": {
             "abilities": ["EntryAbility"],
             "when": "inuse"
         }
     }
 ]
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.

1.2、检查权限是否授予

在进行权限申请之前,需要先检查当前应用程序是否已经被授予权限。可以通过调用checkAccessToken()方法来校验当前是否已经授权。如果已经授权,则可以直接访问目标操作,否则需要进行下一步操作,即向用户申请授权。

/**
   * 检查是否授予权限
   */
  async checkPermission(permission: Permissions) {
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    let grantStatus: abilityAccessCtrl.GrantStatus = abilityAccessCtrl.GrantStatus.PERMISSION_DENIED;
    // 获取应用程序的accessTokenID。
    let tokenId: number = 0;
    try {
      let bundleInfo: bundleManager.BundleInfo =
        await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
      let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo;
      tokenId = appInfo.accessTokenId;
    } catch (error) {
      const err: BusinessError = error as BusinessError;
      console.error(`Failed to get bundle info for self. Code is ${err.code}, message is ${err.message}`);
    }
    // 校验应用是否被授予权限。
    try {
      grantStatus = await atManager.checkAccessToken(tokenId, permission);
    } catch (error) {
      const err: BusinessError = error as BusinessError;
      console.error(`Failed to check access token. Code is ${err.code}, message is ${err.message}`);
    }
    return grantStatus;
  }
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.

HarmonyNEXT手动申请权限以及使用系统控件获取地址坐标的案例(区别)_鸿蒙5.0

HarmonyNEXT手动申请权限以及使用系统控件获取地址坐标的案例(区别)_鸿蒙权限申请_02

1.3、二次申请权限

如果第一次申请权限用户拒绝, 该步骤后续执行将不会再次弹出权限申请确定弹窗, 如果需要改功能只能调用二次申请权限

/**
   * 第一次用户拒接以后就不会弹出权限申请框,我要引导用户到设置界面手动授予权限
   */
  async systemSetPermissions(permissions:Array<Permissions>) {
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    let context: Context = getContext() as common.UIAbilityContext;
    await atManager.requestPermissionOnSetting(context, permissions).then((data: Array<abilityAccessCtrl.GrantStatus>) => {
      console.info('data:' + JSON.stringify(data));
    }).catch((err: BusinessError) => {
      console.error('data:' + JSON.stringify(err));
    });
  }
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.

HarmonyNEXT手动申请权限以及使用系统控件获取地址坐标的案例(区别)_鸿蒙权限申请_03

HarmonyNEXT手动申请权限以及使用系统控件获取地址坐标的案例(区别)_HarmonyOS NEXT_04

1.4、获取地理位置

* 申请权限
   */
  async grantPermissions() {
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    const context: common.UIAbilityContext = getContext() as common.UIAbilityContext;
    let locationGrantStatus: boolean = await this.checkPermission('ohos.permission.LOCATION') ===
    abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED; // 获取精确定位权限状态。
    let approximatelyStatus: boolean = await this.checkPermission('ohos.permission.APPROXIMATELY_LOCATION') ===
    abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED; // 获取模糊定位权限状态。
    if (!approximatelyStatus) {
      // 申请模糊定位权限。
      let permissions: Array<Permissions> = ['ohos.permission.APPROXIMATELY_LOCATION'];
      //申请权限
      await atManager.requestPermissionsFromUser(context, permissions).then(data =>{
        let grantStatus: Array<number> = data.authResults;
        if (grantStatus[0] === 0) {
          //用户同意授权
          approximatelyStatus = true;
        }
      })
    }
    if (approximatelyStatus && !locationGrantStatus) {
      // 申请精确定位权限
      let permissions: Array<Permissions> = ['ohos.permission.LOCATION'];
      await atManager.requestPermissionsFromUser(context, permissions).then(data =>{
        let grantStatus: Array<number> = data.authResults;
        if (grantStatus[0] === 0) {
          //用户同意授权
          locationGrantStatus = true;
        }
      })
    }
    if (locationGrantStatus && approximatelyStatus) {
      //权限申请通过, 获取地理位置
      try {
        //获取设备缓存的位置, 具体的位置获取后续讲解, 当前只是举个例子
        let location = geoLocationManager.getLastLocation();
        AlertDialog.show({
          message: JSON.stringify(location)
        })

      } catch (err) {
        console.error("errCode:" + JSON.stringify(err));
      }
    } else {
      if (!locationGrantStatus) {
        let permissions: Array<Permissions> = ['ohos.permission.LOCATION'];
        await this.systemSetPermissions(permissions);
      }
      if (!approximatelyStatus) {
        let permissions: Array<Permissions> = ['ohos.permission.APPROXIMATELY_LOCATION'];
        await this.systemSetPermissions(permissions);
      }
    }
  }
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.

二、使用系统位置控件获取地址位置

位置控件使用直观且易懂的通用标识,让用户明确地知道这是一个获取位置信息的按钮。这满足了授权场景需要匹配用户真实意图的需求。只有当用户主观愿意,并且明确了解使用场景后点击位置控件,应用才会获得临时的授权,获取位置信息并完成相应的服务功能。

一旦应用集成了位置控件,用户点击该控件后,无论应用是否已经申请过或被授予精准定位权限,都会在本次前台期间获得精准定位的授权,可以调用位置服务获取精准定位。

对于不是强位置关联应用(例如导航、运动健康等)的应用,只在部分前台场景需要使用位置信息(例如定位城市、打卡、分享位置等)。如果需要长时间使用或是在后台使用位置信息,建议申请位置权限。

  • 当用户首次点击应用中的位置控件,系统将弹窗请求用户授权。如果用户点击“取消”,弹窗消失,应用无授权,用户再次点击位置控件时,将会重新弹窗;如果用户点击“允许”,弹窗消失,应用将被授予临时位置权限,此后点击该应用的位置控件将不会弹窗。
  • 精准定位的临时授权会持续到灭屏、应用切后台、应用退出等任一情况发生,然后恢复到临时授权之前的授权状态(授予/未授予/未申请)
  • 应用在授权期间没有调用次数限制。
  • 为了保障用户的隐私不被恶意应用获取,应用需确保安全控件是可见的且用户能够识别的。开发者需要合理的配置控件的尺寸、颜色等属性,避免视觉混淆的情况,如果发生因控件的样式不合法导致授权失败的情况,请检查设备错误日志。

以在聊天界面发送实时定位信息为例。在当前场景下,应用仅需要在前台期间,短暂地访问当前位置,不需要长时间使用。此时,可以直接使用安全控件中的位置控件,免去权限申请和权限请求等环节,获得临时授权,满足权限最小化,提升用户的隐私体验。

参考以下步骤,实现效果:点击控件“当前位置”获取临时精准定位授权,获取授权后,弹窗提示具体位置信息,效果图请见上文。

1.1、引入位置服务依赖。

import { geoLocationManager } from '@kit.LocationKit';
  • 1.

1.2、添加位置控件和获取当前位置信息。

安全控件是由图标、文本、背景组成的类似Button的按钮,其中图标、文本两者至少有其一,背景是必选的。图标和文本不支持自定义,仅支持在已有的选项中选择。应用申明安全控件的接口时,分为传参和不传参两种,不传参默认创建图标+文字+背景的按钮,传参根据传入的参数创建,不包含没有配置的元素。

import { geoLocationManager } from '@kit.LocationKit';
import { promptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
// 获取当前位置信息
function getCurrentLocationInfo() {
  const requestInfo: geoLocationManager.LocationRequest = {
    //表示优先级信息  
    'priority': geoLocationManager.LocationRequestPriority.FIRST_FIX,
    //表示场景信息  
    'scenario': geoLocationManager.LocationRequestScenario.UNSET,
    //表示上报位置信息的时间间隔,单位为秒。  
    'timeInterval': 1,
    //表示上报位置信息的距离间隔。  
    'distanceInterval': 0,
    //应用向系统请求位置信息时要求的精度值,单位为米。
    'maxAccuracy': 0
  };
  try {
    geoLocationManager.getCurrentLocation(requestInfo)
      .then((location: geoLocationManager.Location) => {
        promptAction.showToast({ message: JSON.stringify(location) });
      })
      .catch((err: BusinessError) => {
        console.error(`Failed to get current location. Code is ${err.code}, message is ${err.message}`);
      });
  } catch (err) {
    console.error(`Failed to get current location. Code is ${err.code}, message is ${err.message}`);
  }
}


@Entry
@Component
struct TestLocationButton {
  build() {
    Row() {
      Column({ space: 10 }) {
        LocationButton({
          icon: LocationIconStyle.LINES,
          text: LocationDescription.CURRENT_LOCATION,
          buttonType: ButtonType.Normal
        })
          .padding({top: 12, bottom: 12, left: 24, right: 24})
          .onClick((event: ClickEvent, result: LocationButtonOnClickResult) => {
            if (result === LocationButtonOnClickResult.SUCCESS) {
              // 免去权限申请和权限请求等环节,获得临时授权,获取位置信息授权
              getCurrentLocationInfo();
            } else {
              promptAction.showToast({ message: '获取位置信息失败!' })
            }
          })
      }
      .width('100%')
    }
    .height('100%')
    .backgroundColor(0xF1F3F5)
  }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.
  • 58.

HarmonyNEXT手动申请权限以及使用系统控件获取地址坐标的案例(区别)_鸿蒙权限申请_05

HarmonyNEXT手动申请权限以及使用系统控件获取地址坐标的案例(区别)_鸿蒙5.0_06