华为帐号服务（HMS Toolkit）

简介

HMS Core华为帐号注册用户量已达到5亿，通过华为帐号可以一键登录应用，通过与华为帐号绑定，可以为应用快速引入新用户和登录。华为帐号开放遵循OAuth2.0以及OpenID Connect标准规范。
开发者需要：

在华为开发者联盟注册开发者帐号，并在AppGallery Connect上创建应用以及配置应用信息和开通华为帐号服务。
使用Android Studio IDE创建Project，并配置接入华为帐号依赖的SDK。
根据华为帐号开发指南，实现华为帐号开放服务的API调用以及调试。

您将建立什么

在这个Codelab中，您将使用已经创建好的Demo Project实现对华为帐号开放服务的API调用，通过Demo Project您可以体验到：

使用华为帐号授权登录的流程。
通过取消授权API接口取消应用的授权。

您将会学到什么

如何在AppGallery Connect上创建应用。
如何安装HMS Toolkit。
如何使用HMS Toolkit 配置HUAWEI Account服务开发环境。
如何借助HMS Toolkit快速调用华为帐号服务的API接口。
如何使用远程真机调试。

硬件要求

开发计算机（台式机或笔记本电脑），运行Windows 10操作系统。
预装了HMS Core（APK）4.0.0.300以上版本的HUAWEI手机一部（带USB线），用于真机调试运行Demo。

软件要求

Android Studio 3.X
JDK 1.8 及以上
SDK Platform 19及以上
Gradle 4.6及以上

通过Android Studio的Marketplace安装

打开Android Studio，进入"File > Settings > Plugins > Marketplace"，在搜索框中输入"HMS Toolkit"，然后点击"Install"进行安装。安装完成后，重启Android Studio。

通过本地导入插件包进行安装

下载HMS Toolkit工具包。
打开Android Studio，进入"File > Settings > Plugins"，选择Install Plugin from Disk进行安装。安装完成后，请重启Android Studio。

AppGallery Connect配置

在开发应用前，您需要在AppGallery Connect中创建相应的项目和应用，并设置应用的相关信息。
1. 使用华为帐号登录AppGallery Connect。如未注册，可参见帐号注册认证进行注册。
2. 参见创建项目和在项目下创建应用完成应用的创建，特殊配置如下。

选择平台：选择"Android"。
应用包名：需要与您正在开发的应用的包名保持一致。
配置完成后，无需根据界面向导进行下一步操作，按照Configuration Wizard配置进行操作，工具会自动进行设置。

Configuration Wizard配置

在调用HMS Core各Kit能力前，您还需要设置各Kit使用的依赖信息，请根据工具向导进行设置和检查。

1. 在Android Studio中，点击菜单栏中的"HMS > Configuration Wizard"。

2. 登录授权后，您可以选择团队名称、对应的工程模块、需要使用的Kit（支持多选，建议每次不超过5个Kit）和证书类型，然后点击"Start"。

关于证书类型说明如下：

Use Android debug certificate：选择Android自带的调试证书生成SHA256证书指纹，这种方式仅用于应用调试场景。
Use your certificate：使用您创建的证书生成SHA256证书指纹，这种方式可用于应用发布场景。

选择该方式后，您可以选择已有的证书文件，也可以选择创建一个新的证书。关于证书的指导可参见Android证书签名。

3. HMS Toolkit会对该Kit的使用环境和是否支持场景化接口调用进行检查，包括通用环境配置检查和各Kit专用环境配置检查。

4. HMS Toolkit会自动进行处理，并逐项检查是否配置正确。

如果出现检查不通过的项，请根据界面提示和点击"Link"进行手动设置，设置完成后，点击"Retry"重新进行检查。
如果全部检查项均通过，则可以点击"Go to coding assistant"按钮进行对应的接口调用，详细操作请参见Kit集成向导。

配置混淆脚本

如果开发者使用了AndResGuard，需要在混淆配置文件proguard-rules.pro中加入AndResGuard允许清单。


"R.string.hms*", 
"R.string.connect_server_fail_prompt_toast", 
"R.string.getting_message_fail_prompt_toast", 
"R.string.no_available_network_prompt_toast", 
"R.string.third_app_*", 
"R.string.upsdk_*", 
"R.layout.hms*", 
"R.layout.upsdk_*", 
"R.drawable.upsdk*", 
"R.color.upsdk*", 
"R.dimen.upsdk*", 
"R.style.upsdk*",
"R.string.agc*"

Coding Assistant为Account接入提供了API接口和代码样例，方便开发者快速集成。集成方法有如下两种：

场景集成：您只需要通过简单的拖拽场景卡片即可完成对应场景的集成。
API接口调用：支持通过简单的拖拽/复制API接口的代码样例即可完成对应接口的调用。

以"ID Token模式登录华为帐号场景"为例，分别介绍场景集成、API接口调用，其他场景操作同ID Token模式登录华为帐号场景类似。

场景集成

通过"HMS > Coding Assistant"或者在工具栏中点击如下图标打开Coding Assistant，然后在Kit列表中点击"Account Kit"，显示如下图所示的Account场景列表。

当需要调用"Sign in with a HUAWEI ID (ID Token)"场景时，在场景列表中找到对应的场景卡片，然后将场景卡片拖拽到代码编辑区。在拖动场景卡片的同时，工具会自动生成对应的Activity文件和xml布局文件，并在AndroidManifest、工程下的build.gradle和模块下的build.gradle文件中写入配置信息和工程运行所需要的依赖。
如果需要打开对应场景的Activity，需要您在代码中主动调用该Activity，调用完成后，您可以直接在设备中运行应用。