?
?Demo開(kāi)發(fā)準(zhǔn)備
1、 安裝Android Studio 3.5及以上版本颠蕴;
2寡键、 安裝JDK 1.8 及以上遭商;
3祠汇、 使用Android SDK Platform 19及以上;
4纳鼎、 使用Gradle 4.6及以上劝贸;
5、 在華為開(kāi)發(fā)者聯(lián)盟注冊(cè)成為華為開(kāi)發(fā)者,如已注冊(cè)虐秦,請(qǐng)?zhí)^(guò)此步驟;
?運(yùn)行環(huán)境配置
??之前按照華為帳號(hào)的官方指導(dǎo)試過(guò)demo開(kāi)發(fā)栋荸,發(fā)現(xiàn)前期接入華為開(kāi)發(fā)者聯(lián)盟的各種步驟有點(diǎn)繁瑣,各種界面來(lái)回切換凭舶,后來(lái)在Android Studio上發(fā)現(xiàn)HMS提供了一個(gè)IDE插件晌块,可以幫忙快速集成。本次文章主要就介紹通過(guò)這個(gè)IDE插件來(lái)快速創(chuàng)建一個(gè)華為帳號(hào)demo帅霜。
如果想自己手動(dòng)按照步驟創(chuàng)建帳號(hào)的demo匆背,可以直接查看這個(gè)官方指導(dǎo):
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/dev-process-0000001050443773
**IDE插件安裝**
??這個(gè)工具叫HMS Toolkit,后來(lái)發(fā)現(xiàn)華為官方也有介紹身冀,大家有興趣的可以去它們主頁(yè)了解下:https://developer.huawei.com/consumer/cn/huawei-toolkit/
安裝插件钝尸,直接在Android Studio里面,點(diǎn)擊“File > Settings > Plugins” 搂根,搜索“HMS”找到HMS Toolkit就可以了珍促,點(diǎn)擊安裝然后重啟Android Studio。
**創(chuàng)建android項(xiàng)目**
??在開(kāi)發(fā)應(yīng)用前剩愧,你得本地有一個(gè)Android項(xiàng)目猪叙,已有Android項(xiàng)目的可忽略。
??步驟 1 打開(kāi)Android Studio軟件,點(diǎn)擊“File > New > New Project” 穴翩,按自己需求選擇犬第,我這里選擇的“Empty Activity”,點(diǎn)擊“Next”芒帕。
??步驟 2 在“Configure Your Project”界面填入項(xiàng)目名稱(chēng)歉嗓、包名、項(xiàng)目存儲(chǔ)位置副签、項(xiàng)目語(yǔ)言以及最低SDK版本遥椿,然后點(diǎn)擊“Finish”完成項(xiàng)目創(chuàng)建。
**配置AppGallery Connect**
??為了接入華為淆储,我們還需要在AppGallery Connect中創(chuàng)建應(yīng)用冠场,并做些基本設(shè)置。
步驟 1 使用華為帳號(hào)登錄AppGallery Connect(https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)本砰。要是沒(méi)注冊(cè)碴裙,直接按照頁(yè)面指導(dǎo)完成帳號(hào)注冊(cè)就行,然后選擇“我的項(xiàng)目”点额。
步驟 2 在我的項(xiàng)目頁(yè)面點(diǎn)擊“添加項(xiàng)目”舔株。
步驟 3 輸入個(gè)名字作為項(xiàng)目名稱(chēng),點(diǎn)擊“確定”还棱。
步驟 4 項(xiàng)目創(chuàng)建成功后會(huì)自動(dòng)進(jìn)入“項(xiàng)目設(shè)置”頁(yè)面载慈,在這里找到“添加應(yīng)用”并點(diǎn)擊。
??如果你本來(lái)就有項(xiàng)目并且已經(jīng)有應(yīng)用了珍手,直接展開(kāi)頁(yè)面頂部的應(yīng)用選擇區(qū)域办铡,選擇“添加應(yīng)用”。
步驟 5 在“添加應(yīng)用”頁(yè)面中填寫(xiě)應(yīng)用信息琳要,特別注意平臺(tái)和包名的寡具,尤其是包名要和前面創(chuàng)建的android項(xiàng)目的包名一致。
??? 選擇平臺(tái):選擇“Android”稚补。
??? 應(yīng)用包名:需要與您正在開(kāi)發(fā)的應(yīng)用的包名保持一致童叠。
??配置完成后,后面的一些操作都可以忽略了课幕,直接去Android Studio操作就行厦坛,安裝的IDE插件可以幫忙進(jìn)行設(shè)置。
**在Android Studio上為項(xiàng)目配置華為AGC和華為帳號(hào)**
??步驟 1 在Android Studio中乍惊,菜單欄選擇“HMS > Configuration Wizard”粪般。如果你沒(méi)登錄AppGallery Connect,這個(gè)工具會(huì)幫忙自動(dòng)打開(kāi)瀏覽器并提示登錄污桦。
??步驟 2 登錄后,在Configuration Wizard界面可以選擇團(tuán)隊(duì)名稱(chēng)匙监、對(duì)應(yīng)的工程模塊凡橱、Integrated Kits(選擇Account Kit)和證書(shū)類(lèi)型小作,點(diǎn)擊“Generate”生成SHA256證書(shū)指紋,然后點(diǎn)擊“Next”稼钩。
選擇團(tuán)隊(duì)名稱(chēng)和對(duì)應(yīng)的工程模塊之后顾稀,Toolkit會(huì)自動(dòng)檢測(cè)AGC上是否有對(duì)應(yīng)的應(yīng)用。若有報(bào)錯(cuò)坝撑,根據(jù)界面點(diǎn)擊“Link”到AGC上檢查是否已創(chuàng)建應(yīng)用静秆。如果沒(méi)有,就創(chuàng)建個(gè)新的應(yīng)用(這個(gè)就是前面“配置AppGallery Connect”那步)巡李,然后點(diǎn)擊“Retry”抚笔。
??關(guān)于證書(shū)類(lèi)型說(shuō)明如下:
??? Use your certificate:直接使用你自己創(chuàng)建的證書(shū)生成SHA256證書(shū)指紋,這種是用來(lái)應(yīng)用發(fā)布的時(shí)候侨拦。關(guān)于證書(shū)的指導(dǎo)可參見(jiàn)Android證書(shū)簽名(https://developer.android.com/studio/publish/app-signing#generate-key)殊橙。
??? Use Android debug certificate:選擇Android自帶的調(diào)試證書(shū)生成SHA256證書(shū)指紋,這種方式僅用于應(yīng)用調(diào)試場(chǎng)景狱从。我們這就是個(gè)Demo膨蛮,為了簡(jiǎn)單我直接選的這個(gè)。
??點(diǎn)擊“Generate”可自動(dòng)生成證書(shū)指紋季研,如果生成失敗敞葛,檢查證書(shū)信息是否正確,確保證書(shū)信息和指紋相匹配与涡,或者根據(jù)生成證書(shū)指紋指導(dǎo)手工生成指紋惹谐,然后填寫(xiě)到指紋信息框內(nèi)。
??插件會(huì)自動(dòng)對(duì)Account Kit的使用環(huán)境進(jìn)行環(huán)境配置檢查递沪,我暫時(shí)還沒(méi)遇到過(guò)失敗的情況豺鼻。全部檢查項(xiàng)通過(guò)后直接點(diǎn)擊“Go to coding assistant”按鈕,就可以進(jìn)入Account Kit的頁(yè)面去選擇調(diào)用的接口了款慨。
**通過(guò)Coding Assistant集成Authorization Code模式登錄帳號(hào)**
??步驟 1 在Android Studio中儒飒,選擇“HMS > Coding Assistant”,然后在Kit列表中點(diǎn)擊“Account Kit”檩奠。
??步驟 2 鼠標(biāo)放到“Signing In With an ID(Authorization Code)”這個(gè)行上,拖拽下埠戳,把這行拖放到代碼區(qū)域。
鼠標(biāo)釋放后颗圣,會(huì)彈出新增代碼片段的選擇框,直接點(diǎn)擊“OK”在岂,可以看到會(huì)生成Authorization Code登錄的相關(guān)Activity文件和xml布局文件,并且AndroidManifest.xml蔽午、工程build.gradle和模塊build.gradle都有一些新增信息。具體文件有哪些變化看后面的登錄詳解及老。
??步驟 3 打開(kāi)“AndroiManifest.xml”文件抽莱,將應(yīng)用初始調(diào)用的Activity替換成步驟2生成的Activity,這樣我們的APP就可以主動(dòng)調(diào)用新加的Activity了骄恶。
??這樣食铐,一個(gè)帳號(hào)登錄的Demo就完成了。
??Demo的運(yùn)行調(diào)試叠蝇,可以在自己的設(shè)備或遠(yuǎn)程真機(jī)里運(yùn)行查看璃岳。
編譯、調(diào)試
**使用遠(yuǎn)程真機(jī)運(yùn)行**
步驟 1 在Android Studio的菜單欄中選擇“HMS > Cloud Debugging”或者在工具欄點(diǎn)擊如下圖標(biāo)悔捶。
步驟 2 遠(yuǎn)程真機(jī)界面铃慷,可以根據(jù)分辨率、Android版本那些來(lái)篩選要遠(yuǎn)程調(diào)試的真機(jī)蜕该。
這里有個(gè)坑犁柜,深圳地域的真機(jī)不知道什么原因,是不能進(jìn)入“設(shè)置”的堂淡,這導(dǎo)致帳號(hào)的Demo跑起來(lái)后無(wú)法拉起登錄頁(yè)面馋缅。強(qiáng)烈建議使用非深圳地域的真機(jī)進(jìn)行測(cè)試。
步驟 3 在菜單欄中點(diǎn)擊 (Run按鈕)或 (Debug按鈕)绢淀,在遠(yuǎn)程真機(jī)中運(yùn)行或調(diào)試App萤悴。
步驟 4 進(jìn)入運(yùn)行的項(xiàng)目,點(diǎn)擊“AUTHORIZATIONCODE MODE SIGNIN”按鈕皆的,拉起華為帳號(hào)登錄頁(yè)面覆履,這個(gè)頁(yè)面就是通過(guò)Authorization Code方式登錄的華為帳號(hào)。
** 使用本地真機(jī)運(yùn)行**
??在菜單欄中點(diǎn)擊 (Run按鈕)或 (Debug按鈕)费薄,在本地真機(jī)中運(yùn)行或調(diào)試App硝全。
??真機(jī)運(yùn)行結(jié)果示意如下:
**后續(xù)筆者會(huì)不斷輸出相關(guān)領(lǐng)域的優(yōu)質(zhì)內(nèi)容,希望大家持續(xù)關(guān)注本帳號(hào)楞抡!**