目录

1. AppGallery Connect配置

在开始开发应用前,需要在AppGallery Connect中配置相关信息。

1.1 注册成为开发者

在开发应用前需要在华为开发者联盟网站上注册成为开发者并完成实名认证,具体方法可参考帐号注册认证。

1.2 创建应用

参见 创建项目 和在 项目中添加应用 完成应用的创建,游戏应用的特殊配置如下:

1.3 生成签名证书指纹

签名证书指纹用于在通过华为HMS SDK调用HMS Core(APK)时,校验应用的真实性。开发者在使用HMS Core(APK)前必须将签名证书指纹配置到华为开发者联盟,在配置前需要根据签名证书在本地生成签名证书指纹。在申请前需要满足以下2个条件:
●已创建应用程序的签名文件,签名证书创建属于通用技术,此处不详细描述。
●当前开发的PC已经安装JDK。

操作步骤如下:

1、在命令行工具栏里输入以下内容,其中<keystore-file>为应用签名文件的完整路径。

  1. keytool -list -v -keystore <keystore-file>


2、可以看到类似下图所示的输出。在结果中获取对应的SHA256指纹。

  1. 别名: <alias-name>
  2. 创建日期: 2019-8-29
  3. 条目类型: PrivateKeyEntry
  4. 证书链长度: 1
  5. 证书[1]:
  6. 所有者: CN=Android Debug, OU=hua, C=zg
  7. 发布者: CN=Android Debug, OU=hua, C=zg
  8. 序列号: 1e46890c
  9. 有效期为 Thu Aug 29 21:09:44 CST 2019 至 Mon Jan 14 21:09:44 CST 2047
  10. 证书指纹:
  11.         MD5:  EC:29:9E:ED:18:35:E0:A0:93:EA:AD:E2:D9:4D:B7:6A
  12.         SHA1: E6:6B:61:C9:E5:86:81:E7:3A:7A:86:11:87:FB:DD:B6:2F:72:9D:80
  13.         SHA256: 39:B1:5E:52:70:8C:07:6D:5A:F7:0B:96:8B:D1:77:A0:8F:CA:09:08:72:90:FD:2A:1E:DB:9A:6C:2F:4E:B5:97
  14. 签名算法名称: SHA256withRSA
  15. 主体公共密钥算法: 2048 位 RSA 密钥
  16. 版本: 3


1.4 配置签名证书指纹


1、登录AppGallery Connect网站,选择“我的应用”。

2、点击需要配置的应用。

3、选择“开发”页签,在“项目设置”页面的“应用”区域,将“SHA256证书指纹”配置为生成签名证书指纹中生成的SHA256指纹。

4、配置完成后,点击。

2. 集成HMS SDK

当您下载或使用Location Kit组件时,您应当确认同意《华为开发者服务协议》、《华为APIs使用协议》、《AppGallery Connect数据处理附录》,否则您不得下载或使用Location Kit组件。您理解并承诺,您的下载或使用相应Kit的行为,视为您同意前述所有协议,且您将基于这些协议承担相应的法律责任与义务。

2.1 在Android Studio项目中集成HMS SDK

针对AndroidStudio开发环境,华为提供了maven仓集成方式的HMS SDK包。在开始开发前,您需要将HMS SDK集成到您的AndroidStudio开发环境中。

1、在AndroidStudio开发环境中添加当前应用的AppGallery Connect配置文件。

a. 登录 AppGallery Connect 网站,选择“我的项目”。

b. 在项目列表中找到您的项目,在项目中点击需要集成HMS SDK的应用。

c. 在“项目设置”页面中,单击“应用”栏下的“agconnect-services.json”下载配置文件。

d. 将“agconnect-services.json”文件拷贝到应用级根目录下。

2、配置HMS SDK的maven仓地址。

a.  打开AndroidStudio项目级build.gradle文件。

b.  在allprojects ->repositories和buildscript->repositories里面增添配置。

  1. allprojects {
  2.            repositories {
  3.                      maven {url 'https://developer.huawei.com/repo/'}
  4.            }
  5.        }  
  6. buildscript {
  7.            repositories {
  8.                      maven {url 'https://developer.huawei.com/repo/'}
  9.            }
  10.            dependencies {
  11.                     classpath 'com.huawei.agconnect:agcp:1.2.1.301'  
  12.            }
  13.        }
说明:
maven仓地址直接在浏览器中打开无法访问,只能在IDE中配置。

3、添加编译依赖。

a.  打开应用级的build.gradle文件。

b.  在“dependencies ”中添加如下编译依赖。

  1. dependencies {        
  2.         implementation 'com.huawei.hms:location:{version}'        
  3. }
说明:

{version} 替换为实际的SDK版本号,例如当前版本依赖:

implementation 'com.huawei.hms:location:4.0.4.300'。

c. 在文件头添加配置。

  1. apply plugin: 'com.huawei.agconnect'

4、重新打开修改完的build.gradle文件,右上方出现Sync Now链接。点击“Sync Now”等待同步完成。

说明:
如果出现错误,请检查网络连接是否正常,以及检查gradle文件是否正确。

5、多语言设置

打开应用级根目录的build.gradle文件。

在android->defaultConfig中新增resConfigs配置,en(英语) 和 zh-rCN(简体中文)为必须配置的语种,配置格式如下:

  1. android {
  2.        defaultConfig {
  3.                ...
  4.                resConfigs "en", "zh-rCN", "需要支持的其他语言"
  5.        }
  6. }

HMS SDK支持的语言列表请参考HMS SDK支持的语言。

2.2 在Eclipse项目中集成HMS SDK

1.获取SDK

下载Eclipse SDK,将所有SDK工程导入到您的工作空间。

解压hmssdk-eclipse-{version}.zip和locationsdk-eclipse-{version}.zip。

2.添加工程依赖关系


  1. <application>
  2.    <provider
  3.        android:name="com.huawei.agconnect.core.provider.AGConnectInitializeProvider"
  4.        android:authorities="${applicationId}.AGCInitializeProvider"
  5.        android:exported="false" />
  6.    <service
  7.        android:name="com.huawei.agconnect.core.ServiceDiscovery"
  8.        android:exported="false" />
  9. </application>

3.拷贝资源文件到您的工程目录

由于eclipse不能自动合并assets目录,请手动将子工程assets文件夹里的文件拷贝您的工程中assets目录下,需要拷贝的资源文件如下表所示。

子工程    资源文件    
HMSSdkStats

hianalytics_njjn, grs_sdk_global_route_config_opensdkService.json

Update

updatesdkcas.bks

Network-grs

grs_sdk_server_config.json, grs_sp.bks


4.配置工程project.properties文件

打开您的工程的project.properties文件,添加如下代码,用于合并子工程中的Manifest文件。

  1. manifestmerger.enabled=true

说明:
ADT必须是17以上版本。

5.在AndroidManifest.xml文件中配置appid

a.打开您的工程的AndroidManifest.xml文件。

b.配置应用的appid。

将“value”的值123456789替换为您在华为开发者联盟网站上申请的appid。

  1. <meta-data
  2.    android:name="com.huawei.hms.client.appid"
  3.    android:value="123456789" />

6 添加当前应用的AppGallery Connect配置文件

1、登录AppGallery Connect 网站,选择“我的应用”。

2、在名称列表中找到应用所在的产品,点击对应的“Android应用”链接。

3、选择“开发 > 概览”。

4、单击“应用”栏下的“agconnect-services.json”下载配置文件。

5、由于eclipse不支持agcp插件,您需要将agconnect-services.json文件放置到您的工程assets目录下,并且在工程的Application子类中添加如下代码。如果工程没有Application子类,则需要您新建一个从Application继承的子类,例如新建MyApplication类。

  1. public class MyApplication extends Application{
  2.    @Override
  3.    public void onCreate() {
  4.        super.onCreate();
  5.    }
  6.    // TODO: Add the following code:
  7.    @Override
  8.    protected void attachBaseContext(Context context) {
  9.        super.attachBaseContext(context);
  10.        AGConnectServicesConfig config = AGConnectServicesConfig.fromContext(context);
  11.        config.overlayWith(new LazyInputStream(context) {
  12.            public InputStream get(Context context) {
  13.                try {
  14.                    return context.getAssets().open("agconnect-services.json");
  15.                } catch (IOException e) {
  16.                    return null;
  17.                }
  18.            }
  19.        });
  20.    }
  21.    // TODO: End
  22. }

添加代码后需要导入以下类:

  1. import java.io.IOException;
  2. import java.io.InputStream;
  3. import com.huawei.agconnect.config.AGConnectServicesConfig;
  4. import com.huawei.agconnect.config.LazyInputStream;
  5. import android.app.Application;
  6. import android.content.Context;
  7. import android.util.Log;

6、打开您的工程AndroidManifest.xml文件,在“application”模块中添加Application子类名称,如果已经添加,则跳过此步骤。例如,添加MyApplication类名称。

  1. <application
  2.    android:name=".MyApplication"
  3.    …
  4.    >
  5. …

7、在eclipse菜单栏中点击“Project”,执行“Clean”操作,即完成SDK集成。

3. 配置混淆脚本

开发者编译APK前需要配置不要混淆HMS SDK,避免功能异常。

Android Studio开发环境里的配置文件是“proguard-rules.pro”,Eclipse开发环境里的配置文件是“proguard-project.txt”。

1、打开Android工程的混淆配置文件。

2、加入排除HMS SDK的混淆配置。

  1. -ignorewarnings
  2. -keepattributes *Annotation*
  3. -keepattributes Exceptions
  4. -keepattributes InnerClasses
  5. -keepattributes Signature
  6. -keepattributes SourceFile,LineNumberTable
  7. -keep class com.hianalytics.android.**{*;}
  8. -keep class com.huawei.updatesdk.**{*;}
  9. -keep class com.huawei.hms.**{*;}

3、如果开发者使用了AndResGuard,需要在混淆配置文件中加入AndResGuard允许清单。

  1. "R.string.hms*",
  2. "R.string.connect_server_fail_prompt_toast",
  3. "R.string.getting_message_fail_prompt_toast",
  4. "R.string.no_available_network_prompt_toast",
  5. "R.string.third_app_*",
  6. "R.string.upsdk_*",
  7. "R.layout.hms*",
  8. "R.layout.upsdk_*",
  9. "R.drawable.upsdk*",
  10. "R.color.upsdk*",
  11. "R.dimen.upsdk*",
  12. "R.style.upsdk*"