华为帐号服务学习笔记（三）：10分钟完成Authorization Code模式客户端Demo开发

 

Demo开发准备

1、 安装Android Studio 3.5及以上版本；
2、 安装JDK 1.8 及以上；
3、 使用Android SDK Platform 19及以上；
4、 使用Gradle 4.6及以上；
5、 在华为开发者联盟注册成为华为开发者，如已注册，请跳过此步骤；
 

运行环境配置

  之前按照华为帐号的官方指导试过demo开发，发现前期接入华为开发者联盟的各种步骤有点繁琐，各种界面来回切换，后来在Android Studio上发现HMS提供了一个IDE插件，可以帮忙快速集成。本次文章主要就介绍通过这个IDE插件来快速创建一个华为帐号demo。
如果想自己手动按照步骤创建帐号的demo，可以直接查看这个官方指导：

https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/dev-process-0000001050443773

 
IDE插件安装
  这个工具叫HMS Toolkit，后来发现华为官方也有介绍，大家有兴趣的可以去它们主页了解下：https://developer.huawei.com/...
安装插件，直接在Android Studio里面，点击“File > Settings > Plugins” ，搜索“HMS”找到HMS Toolkit就可以了，点击安装然后重启Android Studio。

 
创建android项目
  在开发应用前，你得本地有一个Android项目，已有Android项目的可忽略。
  步骤 1 打开Android Studio软件，点击“File > New > New Project” ，按自己需求选择，我这里选择的“Empty Activity”，点击“Next”。

  步骤 2 在“Configure Your Project”界面填入项目名称、包名、项目存储位置、项目语言以及最低SDK版本，然后点击“Finish”完成项目创建。

 
配置AppGallery Connect
  为了接入华为，我们还需要在AppGallery Connect中创建应用，并做些基本设置。
步骤 1 使用华为帐号登录AppGallery Connect（https://developer.huawei.com/...

步骤 2 在我的项目页面点击“添加项目”。

步骤 3 输入个名字作为项目名称，点击“确定”。

步骤 4 项目创建成功后会自动进入“项目设置”页面，在这里找到“添加应用”并点击。

  如果你本来就有项目并且已经有应用了，直接展开页面顶部的应用选择区域，选择“添加应用”。

步骤 5 在“添加应用”页面中填写应用信息，特别注意平台和包名的，尤其是包名要和前面创建的android项目的包名一致。
   选择平台：选择“Android”。
   应用包名：需要与您正在开发的应用的包名保持一致。
  配置完成后，后面的一些操作都可以忽略了，直接去Android Studio操作就行，安装的IDE插件可以帮忙进行设置。
 
在Android Studio上为项目配置华为AGC和华为帐号
  步骤 1 在Android Studio中，菜单栏选择“HMS > Configuration Wizard”。如果你没登录AppGallery Connect，这个工具会帮忙自动打开浏览器并提示登录。
  步骤 2 登录后，在Configuration Wizard界面可以选择团队名称、对应的工程模块、Integrated Kits（选择Account Kit）和证书类型，点击“Generate”生成SHA256证书指纹，然后点击“Next”。
选择团队名称和对应的工程模块之后，Toolkit会自动检测AGC上是否有对应的应用。若有报错，根据界面点击“Link”到AGC上检查是否已创建应用。如果没有，就创建个新的应用（这个就是前面“配置AppGallery Connect”那步），然后点击“Retry”。

  关于证书类型说明如下：
   Use your certificate：直接使用你自己创建的证书生成SHA256证书指纹，这种是用来应用发布的时候。关于证书的指导可参见Android证书签名（https://developer.android.com...
   Use Android debug certificate：选择Android自带的调试证书生成SHA256证书指纹，这种方式仅用于应用调试场景。我们这就是个Demo，为了简单我直接选的这个。
  点击“Generate”可自动生成证书指纹，如果生成失败，检查证书信息是否正确，确保证书信息和指纹相匹配，或者根据生成证书指纹指导手工生成指纹，然后填写到指纹信息框内。

  插件会自动对Account Kit的使用环境进行环境配置检查，我暂时还没遇到过失败的情况。全部检查项通过后直接点击“Go to coding assistant”按钮，就可以进入Account Kit的页面去选择调用的接口了。

 
通过Coding Assistant集成Authorization Code模式登录帐号
  步骤 1 在Android Studio中，选择“HMS > Coding Assistant”，然后在Kit列表中点击“Account Kit”。

  步骤 2 鼠标放到“Signing In With an ID(Authorization Code)”这个行上，拖拽下，把这行拖放到代码区域。

鼠标释放后，会弹出新增代码片段的选择框，直接点击“OK”，可以看到会生成Authorization Code登录的相关Activity文件和xml布局文件，并且AndroidManifest.xml、工程build.gradle和模块build.gradle都有一些新增信息。具体文件有哪些变化看后面的登录详解。

  步骤 3 打开“AndroiManifest.xml”文件，将应用初始调用的Activity替换成步骤2生成的Activity，这样我们的APP就可以主动调用新加的Activity了。

  这样，一个帐号登录的Demo就完成了。
  Demo的运行调试，可以在自己的设备或远程真机里运行查看。
 

编译、调试

 
使用远程真机运行
步骤 1 在Android Studio的菜单栏中选择“HMS > Cloud Debugging”或者在工具栏点击如下图标。

步骤 2 远程真机界面，可以根据分辨率、Android版本那些来筛选要远程调试的真机。
这里有个坑，深圳地域的真机不知道什么原因，是不能进入“设置”的，这导致帐号的Demo跑起来后无法拉起登录页面。强烈建议使用非深圳地域的真机进行测试。

步骤 3 在菜单栏中点击 （Run按钮）或 （Debug按钮），在远程真机中运行或调试App。

步骤 4 进入运行的项目，点击“AUTHORIZATIONCODE MODE SIGNIN”按钮，拉起华为帐号登录页面，这个页面就是通过Authorization Code方式登录的华为帐号。



 

使用本地真机运行
  在菜单栏中点击 （Run按钮）或 （Debug按钮），在本地真机中运行或调试App。

  真机运行结果示意如下：

后续笔者会不断输出相关领域的优质内容，希望大家持续关注本帐号！