鸿蒙开发实例【使用高德地图鸿蒙SDK】（一）

概述

地图SDK适配鸿蒙NEXT特性介绍

赋能开发者-提供地图鸿蒙原生ArkTS开发接口

开发者可以使用鸿蒙NEXT推荐的ArkTS接口开发应用集成地图功能，组件使用ArkUI原生组件，兼容方舟UI框架
代码全面适配鸿蒙NEXTSDK，所有系统接口均使用鸿蒙NEXTAPI。

接口易用性-最大程度的保证和Android/鸿蒙历史版本的接口的一致性

接口设计最大程度的保证和之前android/鸿蒙历史版本接口的架构的一致性，方便开发者能够快速接入使用。

使用高德地图鸿蒙SDK的快速入门指南。

第一步搭建鸿蒙开发环境

开发鸿蒙应用需要使用鸿蒙的IDE进行开发。

开始前请参考 [下载与安装软件]、[配置开发环境]，完成DevEco Studio的安装和开发环境配置。
开发环境配置完成后，请参考 [创建和运行Hello World]创建工程。

工程创建完成后，使用 [预览器]或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的步骤请参考gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md鸿蒙更多内容已更新文档

QQ浏览器截图20240320150855.png

第五步在代码中设置申请的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了

最后

鸿蒙开发岗位需要掌握那些核心要领？

目前还有很多小伙伴不知道要学习哪些鸿蒙技术？不知道重点掌握哪些？为了避免学习时频繁踩坑，最终浪费大量时间的。

自己学习时必须要有一份实用的鸿蒙（Harmony NEXT）资料非常有必要。这里我推荐，根据鸿蒙开发官网梳理与华为内部人员的分享总结出的开发文档。内容包含了：【ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战】等技术知识点。

废话就不多说了，接下来好好看下这份资料。

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。鸿蒙OpenHarmony知识←前往。下面是鸿蒙开发的学习路线图。