高版本Andriod Studio集成HMS服務看這篇就夠了(附加步驟多圖、資源下載、源代碼、問題總結)

0.前言

博主基于華為開發者學堂1+X初級開發課程
由于博主版本與教程中所用不一致
因此遇到許多配置語法上的不一致問題
其他與博主開發環境有區別的朋友們，僅供參考

1.開發環境介紹

a) Java版本

java 1.8

b) Android Studio版本

Android Studio 2020.3.1 Patch3

c) Gradle/SDK版本

Gradle: Gradle 7.0.2

SDK: Android 4.0

2.注冊認證華為開發者聯盟(個人開發者)

a) 進入網址，點擊右上角管理中心

https://developer.huawei.com/consumer/cn/

b) 注冊/登錄賬號

使用手機號或其他形式注冊并登陸賬號(需接收驗證碼)

c) 實名認證開發者

認證個人開發者，是否上架敏感應用，選否 > 使用身份證、銀行卡、手機號等進行實名認證，提交完成

3.新建Android Studio專案

a) 選擇Phone and Table->Empty Activity

b) 專案基本配置

如下，專案名、包名、保存路徑皆可自定，語言選Java，最小SDK選4.1

4.創建并配置簽名檔案

a) 創建簽名檔案

創建好專案后，點上方選單欄Build->Generate Signed Bunlde/APK

新建jks檔案

特別注意加重的四個地方：將jks檔案放到專案檔案的app目錄下，設定KeyStore密碼為’123456’，設定Key別名，Key密碼設為’123456’，下面資訊自填，完成后OK->Next

點擊Finish

b) 配置簽名檔案

右側Module級別的build.gradle檔案，android閉包下添加這段簽名配置（注意配置在buildTypes上方）
storeFile file()中填寫剛剛創建的jks檔案
keyAlias 對應key別名
keyPassword 對應key密碼
storePassword 對應keyStore密碼

在相同位置下方的buildTypes中添加以下代碼
1.release中加入signingConfig signingConfigs.release
2.release下方添加debug閉包，加入如圖兩句代碼

5.開發者聯盟中新建專案、系結應用

a) 創建專案

登錄華為開發者聯盟，進入右上角管理中心

進入我的專案

b) 系結應用

創建應用

選擇平臺android，設備手機，系結android專案名和包名-如：com.example.myapplication

c) 添加組態檔

下載專案生成的.json檔案，將其按步驟放在專案中

d) 添加SDK(Gradle 7.0.2，版本不同，配置方法可能不同)

在專案級build.gradle檔案下加入以下maven配置資訊和依賴
在settings.gradle檔案下配置如下一條maven，對應上面專案級build.gradle檔案的maven

在模塊級的build.gradle檔案下，添加以下一條依賴包，對應build.gradle檔案下的依賴
在模塊級的build.gradle檔案最上方plugins閉包中添加以下一條插件

6.生成、配置簽名證書指紋

a) 使用cmd命令生成簽名證書指紋

注意事項：
1.keytool命令為java內置命令，需提前設定JAVA_HOME環境變數
2.-keystore 后面的路徑對應專案路徑\app\簽名檔案.jks

b) 配置簽名證書指紋

找到SHA256，配置到應用中的SHA256證書

c) 開通賬號服務

在上方導航欄->API管理中將服務全部開啟

7.集成Account SDK

a) 添加依賴

在模塊級的build.gradle檔案下，添加以下一條依賴包

b) 添加混淆配置

在proguard_rules.pro檔案中添加如圖代碼，避免HMS Core SDK被混淆

c) 添加權限

在AndroidManifest.xml檔案中添加網路和WIFI權限，如下

d) 添加元資料

在AndroidManifest.xml檔案中添加如下元資料，當用戶手機上未安裝HMS Core ( APK)或者版本過低時，可引導用戶安裝或升級HMS Core ( APK )

e) 同步專案

最后，全部步驟完成后，點擊編譯器右上角，大象樣子的按鍵，同步專案，無報錯就配置完成了

8.總結

a) 配置步驟總結

1. 注冊并實名華為開發者聯盟賬號
2. 新建Android專案，專案名和包名后續會用
3. 新建并配置簽名檔案
4. 使用華為開發者聯盟新建專案、使用Android專案和包名系結應用，開啟各項服務
5. 按斬訓為開發者聯盟步驟集成基礎SDK、添加插件
6. 使用簽名檔案生成SHA256證書指紋并系結到華為開發者聯盟專案中
7. Android專案集成HMS環境，如添加依賴、配置混淆
8. Android專案添加權限、添加元資料

b) 代碼匯總(本文中所出現的代碼，以下都是部分代碼，不可直接運行)

Ⅰ.配置簽名檔案

signingConfigs{
        release{
            storeFile file('HMSAccountApp.jks')
            keyAlias 'HMSAccountApp'
            keyPassword '123456'
            storePassword '123456'
            v1SigningEnabled true
            v2SigningEnabled true
        }
    }
buildTypes {
    release {
        signingConfig signingConfigs.release
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
    debug {
        signingConfig signingConfigs.release
        debuggable true
    }
}

Ⅱ.生成簽名證書

keytool -list -v -keystore 'jks檔案路徑'

Ⅲ.集成SDK

// 專案級
maven { url 'https://developer.huawei.com/repo/' }
classpath 'com.huawei.agconnect:agcp:1.5.2.300'

// 模塊級
id 'com.huawei.agconnect'
implementation 'com.huawei.hms:hwid:5.1.0.301'
implementation 'com.huawei.agconnect:agconnect-core:1.5.2.300'

// 混淆
-ignorewarnings
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile, LineNumberTable
-keep class com.huawei.hianalytics.**{*;}
-keep class com.huawei.updatesdk.**{*;}
-keep class com.huawei.hms.**{*;}

Ⅳ.權限和元資料

// 權限
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

// 元資料
<meta-data
            android:name="com.huawei.hms.client.channel.androidMarket"
            android:value="false"/>

c) 資源下載（阿里云盤）

Java 1.8.0_271:
https://www.aliyundrive.com/s/usj3zxdxhwa

Android Studio 2020.3.1 Patch3:
https://www.aliyundrive.com/s/EaDqU6wvUSh

d) 問題總結

1. signingConfigs寫在了buildTypes下方
   

2. 依賴包路徑hms后面的 : 打成了 .
   

3. 混淆配置中Annotation兩邊的 * 打成了 ’
   圈中的 . 后面兩個 * 只打了一個
   

4. 在運行在中出現以下或類似報錯
   將在模塊級的build.gradle檔案下，默認配置中的minSdk和targetSdk版本改為如圖所示