开发 HarmonyOS NEXT 导航SDK 入门指南

入门指南 最后更新时间: 2024年11月21日

本指南是向使用高德导航鸿蒙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=

注意

为了确保鉴权通过,请确保真机调试时使用的key是基于真机获取的appid申请的,而云真机调试时则应使用云真机appid对应的key

第四步申请高德API Key

具体获取key的步骤请参考 获取key

第五步在代码中设置申请的Key

提示

请保证在调用任何高德导航SDK的接口之前将apikey设置给高德导航SDK,建议放到Application的初始化之中

请使用api的方式将申请的高德api key设置给高德导航SDK。

//申请地址:https://console.amap.com/dev/key/app,appId在日志中过滤即可获取
const appkey = '你申请的 Key'
this.naviInstance = AMapNaviFactory.getAMapNaviInstance(getContext().getApplicationContext(), appkey)

完成以上5步之后,就可以愉快的使用鸿蒙版高德导航SDK了

返回顶部 示例中心 常见问题 智能客服 公众号
二维码