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的運作調試,可以在自己的裝置或遠端真機裡運作檢視。