华为帐号服务学习笔记(三):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/consumer/cn/huawei-toolkit/

安装插件,直接在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/consumer/cn/service/josp/agc/index.html)。要是没注册,直接按照页面指导完成帐号注册就行,然后选择“我的项目”。


步骤 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/studio/publish/app-signing#generate-key)。

   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。


  真机运行结果示意如下:


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

你可能感兴趣的:(华为帐号服务学习笔记(三):10分钟完成Authorization Code模式客户端Demo开发)