概述

地圖SDK適配鴻蒙NEXT特性介紹

賦能開發者-提供地圖鴻蒙原生ArkTS開發接口

• 開發者可以使用鴻蒙NEXT推薦的ArkTS接口開發應用集成地圖功能，組件使用ArkUI原生組件，兼容方舟UI框架
• 代碼全面適配鴻蒙NEXTSDK，所有系統接口均使用鴻蒙NEXTAPI。

接口易用性-最大程度的保證和Android/鴻蒙歷史版本的接口的一致性

• 接口設計最大程度的保證和之前android/鴻蒙歷史版本接口的架構的一致性，方便開發者能夠快速接入使用。

使用高德地圖鴻蒙SDK的快速入門指南。

第一步搭建鴻蒙開發環境

開發鴻蒙應用需要使用鴻蒙的IDE進行開發。

1. 開始前請參考 [下載與安裝軟件]、[配置開發環境]，完成DevEco Studio的安裝和開發環境配置。
2. 開發環境配置完成后，請參考 [創建和運行Hello World]創建工程。
3. 工程創建完成后，使用 [預覽器]或Phone[模擬器]運行該工程。

第二步配置應用的簽名信息

應用工程創建完成后，需要配置簽名信息，才可以使用真機調試和發布應用。

第三步獲取應用的appId

配置完簽名信息之后，就可以獲取當前應用的appId了，這個appId主要用于申請高德的apiKey，請確定最終發布應用的appId, 防止最終高德SDK鑒權失敗。

目前只能通過代碼獲取應用的appId，具體代碼請參考如下代碼

let flag = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO;
let bundleInfo = bundleManager.getBundleInfoForSelfSync(flag)
let appId = bundleInfo.signatureInfo.appId;

最終獲取的appId格式類似于：com.amap.demo_BGtGgVB3ASqU7ar1nHkwX4s0nIexDbEwqNrVoatUDs17GrClWC7V2/zhoYh6tFQHAd5DASWVTEAgvZfzrEGljjs=

注意

目前通過DevEco Studio連接云真機獲取到的appId不全，只獲取到了"包名_", 使用云真機調試高德地圖SDK時會導致鑒權不通過。

第四步申請高德API Key

第五步在代碼中設置申請的Key

注意

請保證在調用任何高德地圖SDK的接口之前將apikey設置給高德地圖SDK，建議放到Application的初始化之中。

請使用api的方式將申請的高德api key設置給高德地圖SDK。

/**
 * 動態設置apiKey。
 *
 * @param apiKey 在高德官網上申請的apiKey。
 * @since 1.0.0
 */
public static setApiKey(apiKey: string):  void

完成以上5步之后，就可以愉快的使用鴻蒙版高德地圖SDK了

審核編輯 黃宇