目录

使用工具快速集成Map Kit

HMS Toolkit是一个IDE工具插件,提供一套含应用创建、编码和转换、调测、测试和发布的开发工具。可以帮助您以更低的开发成本和更高的开发效率集成HMS Core服务。

HMS Toolkit的“Configuration Wizard”为您提供配置向导,借助该工具可将“开发准备”中多个模块的手动操作自动化完成。

Configuration Wizard操作

安装工具

Windows平台:打开Android Studio,选择“File > Settings > Plugins > Marketplace”,在搜索框中输入“HMS Toolkit”,然后点击“Install”进行安装。安装完成后,请重启Android Studio。

MacOS平台:打开Android Studio,选择“Preferences > Plugins > Marketplace”,在搜索框中输入“HMS Toolkit”,然后点击“Install”进行安装。安装完成后,请重启Android Studio。

配置开发环境

[h2]配置AppGallery Connect

在开发应用前,您需要在AppGallery Connect中创建应用,并设置应用的相关信息。

  1. 使用华为帐号登录AppGallery Connect。如未注册,可参见帐号注册认证进行注册。
  2. 参见创建项目和创建应用完成应用的创建。特殊配置:软件包类型选择“APK(Android应用)”。

    配置完成后,无需根据界面向导进行下一步操作,按照配置HMS Toolkit环境进行操作,工具会自动进行设置。

[h2]配置HMS Toolkit环境

在调用Map Kit能力前,您还需要进行环境配置。

  1. 在Android Studio中,选择菜单栏中的“HMS > Configuration Wizard”。

    如果您还未登录AppGallery Connect,工具会自动打开浏览器提示您进行登录和授权。

  2. 登录授权后,选择团队名称、对应的工程模块、Integrated Kits(选择Map Kit)和证书类型,点击“Generate”生成SHA256证书指纹,然后点击“Next”。

    您在选择团队名称和对应的工程模块之后,HMS Toolkit会自动检测AppGallery Connect上是否有对应的应用。若有以下报错,请根据界面提示点击“Link”到AppGallery Connect上检查是否已创建应用。

    • 如果没有,请创建新的应用,然后点击“Retry”重试。
    • 如果已有应用,请根据界面提示检查团队名称和工程模块是否选择正确,然后点击“Retry”重试。

    关于证书类型:

    • Use your certificate:使用您创建的证书生成SHA256证书指纹,这种方式可用于应用发布场景。
    • Use Android debug certificate:选择Android自带的调试证书生成SHA256证书指纹,这种方式仅用于应用调试场景。选择该方式后,您可以选择已有的证书文件,也可以选择创建一个新的证书。关于证书的指导可参见Android证书签名。

    点击“Generate”可自动生成证书指纹,如果生成失败,请检查证书信息是否正确,确保证书信息和指纹相匹配,或者根据生成证书指纹指导手工生成指纹,然后填写到指纹信息框内。

    HMS Toolkit会自动对Map Kit的使用环境进行环境配置检查,包括通用环境配置检查和Kit专用环境配置检查。

    HMS Toolkit会自动处理检查项,并逐项检查是否配置正确。

    • 如果出现环境配置检查失败项,如上图所示,请根据界面提示点击“Link”进行手动设置,也可以点击或参见如下表格查看具体处理方法。设置完成后,点击“Retry”重新进行环境配置检查。

      序号

      环境配置检查项

      失败时处理建议

      1

      Obtain the package name of your application

      需要提前在AppGallery Connect中创建一个应用,并且对应的包名需要与当前模块的包名保持一致。

      说明:

      HMS Toolkit只会根据当前应用的包名,去AppGallery Connect中查询对应的应用,不会主动创建应用。包名对应的是模块下的build.gradle中android.defaultConfig.applicationId。

      2

      Check whether there is any app corresponding to your application's package name in AppGallery Connect

      3

      Verify the package name

      该配置项是校验包名是否以“.huawei”或“.HUAWEI”结尾,只有联运游戏的应用才需要此限制。

      4

      Generate a signing certificate

      如果选择您生成的证书文件,请检查证书文件是否创建成功,keyPassword和storePassword是否输入正确。

      5

      Configure signing certificate information

      6

      Generate a certificate fingerprint

      7

      Configure the certificate fingerprint in AppGallery Connect

      请手工拷贝SHA256证书指纹,填写到“Generate a certificate fingerprint”检查项下面的输入框内,或点击插件界面提示的链接,将SHA256证书指纹填写到应用中。

      8

      Check whether the data storage location was set

      点击插件界面提示的链接,手动设置数据存储区域。

      9

      Check whether the required xxx Kit service was enabled

      开通对应的Kit服务,单击插件界面提示的链接,然后手动开通服务。

      服务开通后,还需要在AppGallery Connect界面点击左侧的“项目设置 > API管理”,打开对应的Kit API。

      10

      Check whether the required xxx Kit API was enabled

      11

      Download the agconnect-services.json file

      确保AppGallery Connect中创建应用的包名与选择的工程模块的包名完全一致。

      12

      Copy the agconnect-services.json file to the module directory

      13

      Add the HMS Maven repository address to the build.gradle file in the project directory for xxx Kit

      无需手动处理。

      14

      Add dependencies from AppGallery Connect to the build.gradle file in the project directory for xxx Kit

      15

      Add dependencies from AppGallery Connect to the build.gradle file in the module directory for xxx Kit

      16

      Add dependencies from the xxx Kit SDK to the build.gradle file in the module directory

      17

      Configure obfuscation scripts of xxx Kit

    • 如果全部检查项均通过,则可以点击“Go to coding assistant”调用对应的接口,详细操作请参见Kit集成向导。

通过Coding Assistant集成

选择“HMS > Coding Assistant”,然后在Kit列表中点击“Map Kit”,整个Map Kit的场景如下图:

[h2]拖拽场景卡片补齐业务代码

选择要进行开发的场景卡片,以“Map Creation”为例,拖拽整个卡片到代码区域生成创建地图的代码。

当您直接拖动场景卡片时,工具会自动生成对应的Activity文件和XML布局文件,并在AndroidManifest.xml、项目级的build.gradle和应用级的build.gradle文件中写入配置信息和工程运行所需要的依赖。如果需要打开该Activity,需要您在代码中主动调用该Activity,完成后,您可以直接在设备中运行应用。

[h2]Map Kit场景模拟工具

Map Kit提供场景模拟工具(Develop),可以为您提供端云位置数据比对服务、距离测量服务和路径规划服务。

场景模拟工具的使用方法如下:

  1. 在Map Kit卡片的工具栏中,点击Develop工具,进入场景模拟工具的页面。
  2. 选择对应服务的卡片,如Data Comparison(端云位置数据比对)、Distance Calculation(距离测量)和Path Planning(路径规划)。
    • Data Comparison(端云位置数据比对):
      1. 首先确定模拟地点的位置。Develop工具提供了两种输入地点信息的方式:

        Simulated position:通过输入地点名称来确定模拟地点的位置。

        Latitude and Longitude:通过输入地点的经纬度来确定模拟地点的位置。

        确定了模拟地点的位置之后,工具会自动查询云端存储的该模拟地点的位置数据。

      2. 获取终端设备侧的模拟地点的位置数据。

        Method of Obtaining Device-Side Data:获取终端设备侧的位置数据,可以选择从日志中解析(Log scraping),或者选择手动输入(Manual input)。选择从日志中解析时,需要您将工程运行起来后,点击“Start”,工具会弹出一个窗口展示从日志中解析出的位置数据列表,选择相应的位置数据后点击“Capture”即可抓取该条位置数据,并注入到下图的对比界面中。

      对比界面如图所示。左侧框中的是云端数据,右侧框中的是终端设备侧的数据。点击“Run”即可开始进行端云位置数据比对,橙色表示左右两侧的数据存在差异。

    • Distance Calculation(距离测量):在工具中,输入起点和终点的位置信息(可以输入地点,也可以输入经纬度信息),点击“Run”即可测量起点和终点之间的直线距离。

    • Path Planning(路径规划):在工具中,输入起点和终点位置信息(可以输入地点,也可以输入经纬度信息),并选择Movement state,点击“Run”即可规划出具体的行进路线。

[h2]其他功能

地图交互、在地图上绘制等其他功能请参见相应的卡片和代码片段通过拖拽或者拷贝的方式来进行开发,同时也可以参见地图服务开发指南中的内容进行手动开发。

编译、加载、调试

完成上述代码后,可以使用HMS Toolkit中的Cloud Debugging来进行真机调试,具体可以参见Cloud Debugging。

[h2]使用远程真机运行

  1. 在菜单栏中选择“HMS > Cloud Debugging”或者在工具栏点击如下图标。

  2. 在远程真机界面,您可以根据手机的分辨率、Android版本、EMUI版本及华为手机系列等条件,筛选出需要远程调试的真机,也可以根据真机的状态“Available Devices”进行筛选。

  3. 在菜单栏中点击(Run按钮)或(Debug按钮),在远程真机中运行或调试App。您也可以使用ADB相关命令进行操作,详情请参见ADB命令。

[h2]使用本地真机运行

在菜单栏中点击(Run按钮)或(Debug按钮),在本地真机中运行或调试App。

使用云测工具测试APK

  1. 在菜单栏中选择“HMS > Cloud Testing”或者在工具栏点击如下图标。

  2. 在“Cloud Testing”中,点击“New Task”。

  3. 配置各项任务参数,点击“Confirm”,启动测试任务。
    • Select Category:选择测试类别。测试类别包括“Compatibility Test”(兼容性测试)、“Stability Test”(稳定性测试)、“Performance Test”(性能测试)和“Consumption Test”(功耗测试)。
    • Please Select Apk File:选择需要测试的APK文件。
    • Test Devices:选择用于测试应用的远程真机。测试稳定性(“Stability Test”)时,只能选择一个设备进行测试,其他测试项可以同时选择多个设备。
    • Test Duration:(可选)仅测试类别选择“Stability Test”生效,设置测试周期,范围为10~60分钟。

    • Application Classification:(可选)仅测试类别选择“Performance Test”和“Consumption Test”生效,设置应用分类信息。

  4. 等待测试任务完成后,点击查看测试报告。

    点击“Download report”,可以将测试报告下载到本地,点击,可以查看测试详情。各测试项的报告说明请参见云测试指南。

Publish to AppGallery Connect

您的应用程序开发、调试完成后,可以直接通过HMS Core提供的Publish to AppGallery Connect功能,将您的应用程序APK文件发布到华为应用市场。

  1. 在HMS菜单中,点击“Publish to AppGallery Connect”。
  2. 选择团队名称和要发布的APK文件(最大不超过1GB),点击“Upload”完成上传。

    上传APK文件会有如下两个检验,如有报错,请修改后重新上传。

    • APK文件的格式必须是release。生成方法请参见如何在项目工程中生成release.apk文件。
    • 获取SHA256证书指纹且已经配置到AGC的应用中。操作步骤:在cmd中输入以下命令来读取APK文件的信息值,然后从信息值里获取SHA256证书指纹,再将SHA256证书指纹填写到对应的应用中。
      >keytool -printcert -jarfile 工程目录下的app-release.apk路径

      “工程目录下的app-release.apk路径”请根据实际路径进行替换。

  3. 上传完成后,点击“RELEASE”,进入“应用上架 > 准备提交”页面。

  4. 填写应用上架的相关信息并提交审核。