概述

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

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

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

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

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

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

第一步搭建鴻蒙開發(fā)環(huán)境

開發(fā)鴻蒙應(yīng)用需要使用鴻蒙的IDE進(jìn)行開發(fā)。

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

第二步配置應(yīng)用的簽名信息

應(yīng)用工程創(chuàng)建完成后，需要配置簽名信息，才可以使用真機(jī)調(diào)試和發(fā)布應(yīng)用。

第三步獲取應(yīng)用的appId

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

目前只能通過代碼獲取應(yīng)用的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連接云真機(jī)獲取到的appId不全，只獲取到了"包名_", 使用云真機(jī)調(diào)試高德地圖SDK時會導(dǎo)致鑒權(quán)不通過。

第四步申請高德API Key

第五步在代碼中設(shè)置申請的Key

注意

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

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

/**
 * 動態(tài)設(shè)置apiKey。
 *
 * @param apiKey 在高德官網(wǎng)上申請的apiKey。
 * @since 1.0.0
 */
public static setApiKey(apiKey: string):  void

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

審核編輯 黃宇