位置服务子系统ChangeLog

cl.location.1 系统API和API9接口迁移到新增的@ohos.geoLocationManager.d.ts

@ohos.geolocation.d.ts接口不支持抛出错误码，而API9和systemApi都需要支持抛出错误码，为了支持该功能，把@ohos.geolocation.d.ts中systemApi和API9所有接口，迁移到新增的@ohos.geoLocationManager.d.ts中，并增加错误码描述。

后续需要import @ohos.geoLocationManager才能使用位置服务的系统API和API9接口：

import geoLocationManager from ‘@ohos.geoLocationManager’;

变更影响

仅对系统API和API9所有接口的使用有影响，需要import @ohos.geoLocationManager才能使用位置服务的系统API和API9接口：

import geoLocationManager from ‘@ohos.geoLocationManager’;

对于其他接口无影响。

关键的接口/组件变更

|类名|接口类型|接口声明|变更类型| | –|–|–|–| |geolocation|namespace|declare namespacegeolocation|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|export interface ReverseGeocodingMockInfo|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|export interface LocationMockConfig|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|export interface CountryCode |API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|enum|export enum CountryCodeType |API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation.GeoAddress|field|isFromMock?: Boolean;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation.Location|field|isFromMock?: Boolean;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation.GeoLocationErrorCode|field|NOT_SUPPORTED = 100|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation.GeoLocationErrorCode|field|QUERY_COUNTRY_CODE_ERROR|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function on(type: ‘countryCodeChange’, callback: Callback<CountryCode>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function off(type: ‘countryCodeChange’, callback?: Callback<CountryCode>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getCountryCode(callback: AsyncCallback<CountryCode>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getCountryCode(): Promise<CountryCode>;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function enableLocationMock(scenario: LocationRequestScenario, callback: AsyncCallback<void>): void;|API9接口变更，该接口删除。| |geolocation|method|function enableLocationMock(callback: AsyncCallback<void>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function enableLocationMock(scenario: LocationRequestScenario): Promise<void>;|API9接口变更，该接口删除。| |geolocation|method|function enableLocationMock(): Promise<void>;| API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function disableLocationMock(scenario: LocationRequestScenario, callback: AsyncCallback<void>): void;|API9接口变更，该接口删除。| |geolocation|method|function disableLocationMock(callback: AsyncCallback<void>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function disableLocationMock(scenario: LocationRequestScenario): Promise<void>;|API9接口变更，该接口删除。| |geolocation|method|function disableLocationMock(): Promise<void>;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function setMockedLocations(config: LocationMockConfig, callback: AsyncCallback<void>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function setMockedLocations(config: LocationMockConfig): Promise<void>;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function enableReverseGeocodingMock(callback: AsyncCallback<void>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function enableReverseGeocodingMock(): Promise<void>;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function disableReverseGeocodingMock(callback: AsyncCallback<void>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function disableReverseGeocodingMock(): Promise<void>;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>, callback: AsyncCallback<void>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): Promise<void>;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function isLocationPrivacyConfirmed(type: LocationPrivacyType, callback: AsyncCallback<boolean>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function isLocationPrivacyConfirmed(type: LocationPrivacyType): Promise<boolean>;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback<boolean>): void;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts，callback返回值改为void。| |geolocation|method|function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): Promise<boolean>;|API9接口变更，迁移到@ohos.geoLocationManager.d.ts，promise返回值改为void。|

适配指导（可选，不涉及则可以删除）

以enableLocation为例，在新版本上需要使用如下方式进行调用：

  import geoLocationManager from '@ohos.geoLocationManager';
  try {
      geoLocationManager.enableLocation((err, data) => {
          if (err) {
              console.log('enableLocation: err=' + JSON.stringify(err));
          }
      });
  } catch (err) {
      console.error("errCode:" + err.code + ",errMessage:" + err.message);
  }

cl.location.2 位置服务权限变更

从API9开始，增加ohos.permission.APPROXIMATELY_LOCATION，表示模糊位置权限。

如果应用开发者使用的API版本大于等于9，则需要同时申请ohos.permission.LOCATION和ohos.permission.APPROXIMATELY_LOCATION，单独申请ohos.permission.LOCATION会失败。

变更影响

如果是存量应用（使用的API版本小于9），则无影响。如果使用的API版本大于等于9，位置服务权限申请方式有变更，详情如下：

应用在使用系统能力前，需要检查是否已经获取用户授权访问设备位置信息。如未获得授权，可以向用户申请需要的位置权限，申请方式请参考下文。

系统提供的定位权限有：

• ohos.permission.LOCATION

• ohos.permission.APPROXIMATELY_LOCATION

• ohos.permission.LOCATION_IN_BACKGROUND

访问设备的位置信息，必须申请权限，并且获得用户授权。

API9之前的版本，申请ohos.permission.LOCATION即可。

API9及之后的版本，需要申请ohos.permission.APPROXIMATELY_LOCATION或者同时申请ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION；无法单独申请ohos.permission.LOCATION。

如果应用在后台运行时也需要访问设备位置，除需要将应用声明为允许后台运行外，还必须申请ohos.permission.LOCATION_IN_BACKGROUND权限，这样应用在切入后台之后，系统可以继续上报位置信息。

开发者可以在应用配置文件中声明所需要的权限，具体可参考授权申请指导。

关键的接口/组件变更

如果是存量应用（使用的API版本小于9），则无影响。

如果使用的API版本大于等于9，则在使用@ohos.geolocation和@ohos.geoLocationManager中需要ohos.permission.LOCATION权限的接口时，都需要按照上文所述方式申请对应权限。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙分布式调度子系统ChangeLog

harmony 鸿蒙基础通信WIFI子系统ChangeLog

harmony 鸿蒙元能力子系统ChangeLog

harmony 鸿蒙帐号子系统ChangeLog

harmony 鸿蒙定制子系统ChangeLog

harmony 鸿蒙多媒体子系统ChangeLog

harmony 鸿蒙事件通知子系统ChangeLog

harmony 鸿蒙用户IAM子系统Changelog