harmony 鸿蒙位置服务子系统ChangeLog

  • 2023-06-24
  • 浏览 (420)

位置服务子系统ChangeLog

cl.location.1 @ohos.geolocation.d.ts接口迁移到新增的@ohos.geoLocationManager.d.ts

@ohos.geolocation.d.ts接口不支持抛出错误码,为了支持错误码功能,把@ohos.geolocation.d.ts中所有接口,迁移到新增的@ohos.geoLocationManager.d.ts中,并增加错误码描述。

后续需要import @ohos.geoLocationManager才能使用位置服务的接口:

import geoLocationManager from ‘@ohos.geoLocationManager’;

变更影响

对位置服务所有接口的使用有影响,需要import @ohos.geoLocationManager才能使用位置服务接口:

import geoLocationManager from ‘@ohos.geoLocationManager’;

关键的接口/组件变更

|类名|接口类型|接口声明|变更类型| | –|–|–|–| |geolocation|method|function on(type: ‘locationChange’, request: LocationRequest, callback: Callback): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function off(type: ‘locationChange’, callback?: Callback): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function on(type: ‘locationServiceState’, callback: Callback): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘locationServiceState’更改为type: ‘locationEnabledChange’| |geolocation|method|function off(type: ‘locationServiceState’, callback?: Callback): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘locationServiceState’更改为type: ‘locationEnabledChange’| |geolocation|method|function on(type: ‘cachedGnssLocationsReporting’, request: CachedGnssLocationsRequest, callback: Callback>): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘cachedGnssLocationsReporting’更改为type: ‘cachedGnssLocationsChange’| |geolocation|method|function off(type: ‘cachedGnssLocationsReporting’, callback?: Callback>): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘cachedGnssLocationsReporting’更改为type: ‘cachedGnssLocationsChange’| |geolocation|method|function on(type: ‘gnssStatusChange’, callback: Callback): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘gnssStatusChange’更改为type: ‘satelliteStatusChange’| |geolocation|method|function off(type: ‘gnssStatusChange’, callback?: Callback): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘gnssStatusChange’更改为type: ‘satelliteStatusChange’| |geolocation|method|function on(type: ‘nmeaMessageChange’, callback: Callback): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘nmeaMessageChange’更改为type: ‘nmeaMessage’| |geolocation|method|function off(type: ‘nmeaMessageChange’, callback?: Callback): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘nmeaMessageChange’更改为type: ‘nmeaMessage’| |geolocation|method|function on(type: ‘fenceStatusChange’, request: GeofenceRequest, want: WantAgent): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘fenceStatusChange’更改为type: ‘gnssFenceStatusChange’| |geolocation|method|function off(type: ‘fenceStatusChange’, request: GeofenceRequest, want: WantAgent): void;|接口迁移到@ohos.geoLocationManager.d.ts,type: ‘fenceStatusChange’更改为type: ‘gnssFenceStatusChange’| |geolocation|method|function getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getCurrentLocation(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getCurrentLocation(request?: CurrentLocationRequest): Promise;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getLastLocation(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function getLastLocation(): Location;| |geolocation|method|function getLastLocation(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function getLastLocation(): Location;| |geolocation|method|function isLocationEnabled(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function isLocationEnabled(): boolean;| |geolocation|method|function isLocationEnabled(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function isLocationEnabled(): boolean;| |geolocation|method|function requestEnableLocation(callback: AsyncCallback): void;|接口删除| |geolocation|method|function requestEnableLocation(): Promise;|接口删除| |geolocation|method|function enableLocation(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function enableLocation(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function disableLocation(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function disableLocation(): void;| |geolocation|method|function disableLocation(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function disableLocation(): void;| |geolocation|method|function getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback>): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getAddressesFromLocation(request: ReverseGeoCodeRequest): Promise>;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback>): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getAddressesFromLocationName(request: GeoCodeRequest): Promise>;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function isGeoServiceAvailable(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function isGeocoderAvailable(): boolean;| |geolocation|method|function isGeoServiceAvailable(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function isGeocoderAvailable(): boolean;| |geolocation|method|function getCachedGnssLocationsSize(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function getCachedGnssLocationsSize(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function flushCachedGnssLocations(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function flushCachedGnssLocations(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function sendCommand(command: LocationCommand, callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function sendCommand(command: LocationCommand): Promise;|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|method|function enableLocationMock(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function enableLocationMock(): void;| |geolocation|method|function enableLocationMock(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function enableLocationMock(): void;| |geolocation|method|function disableLocationMock(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function disableLocationMock(): void;| |geolocation|method|function disableLocationMock(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function disableLocationMock(): void;| |geolocation|method|function setMockedLocations(config: LocationMockConfig, callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function setMockedLocations(config: LocationMockConfig): void;| |geolocation|method|function setMockedLocations(config: LocationMockConfig): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function setMockedLocations(config: LocationMockConfig): void;| |geolocation|method|function enableReverseGeocodingMock(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function enableReverseGeocodingMock(): void;| |geolocation|method|function enableReverseGeocodingMock(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function enableReverseGeocodingMock(): void;| |geolocation|method|function disableReverseGeocodingMock(callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function disableReverseGeocodingMock(): void;| |geolocation|method|function disableReverseGeocodingMock(): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function disableReverseGeocodingMock(): void;| |geolocation|method|function setReverseGeocodingMockInfo(mockInfos: Array, callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function setReverseGeocodingMockInfo(mockInfos: Array): void;| |geolocation|method|function setReverseGeocodingMockInfo(mockInfos: Array): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function setReverseGeocodingMockInfo(mockInfos: Array): void;| |geolocation|method|function isLocationPrivacyConfirmed(type: LocationPrivacyType, callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function isLocationPrivacyConfirmed(type: LocationPrivacyType): boolean;| |geolocation|method|function isLocationPrivacyConfirmed(type: LocationPrivacyType,): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function isLocationPrivacyConfirmed(type: LocationPrivacyType): boolean;| |geolocation|method|function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback): void;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): void;| |geolocation|method|function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): Promise;|接口迁移到@ohos.geoLocationManager.d.ts,更改为function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): void;| |geolocation|interface|SatelliteStatusInfo|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|CachedGnssLocationsRequest|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|GeofenceRequest|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|Geofence|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|ReverseGeoCodeRequest|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|GeoCodeRequest|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|GeoAddress|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|LocationRequest|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|CurrentLocationRequest|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|interface|Location|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|enum|LocationRequestPriority|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|enum|LocationRequestScenario|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|enum|GeoLocationErrorCode|接口废弃| |geolocation|enum|LocationPrivacyType|接口迁移到@ohos.geoLocationManager.d.ts| |geolocation|enum|LocationCommand|接口迁移到@ohos.geoLocationManager.d.ts|

适配指导(可选,不涉及则可以删除)

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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Readme

harmony 鸿蒙xxx子系统ChangeLog

harmony 鸿蒙元能力子系统JS API变更Changelog

harmony 鸿蒙帐号子系统changeLog

harmony 鸿蒙arkui子系统ChangeLog

harmony 鸿蒙媒体子系统 JS API 变更 Changelog

harmony 鸿蒙公共基础类库子系统JS API变更Changelog

harmony 鸿蒙分布式数据管理子系统JS API变更Changelog

harmony 鸿蒙文件管理子系统ChangeLog

harmony 鸿蒙输入法框架changeLog

0  赞