用户身份服务

简介

华为用户身份服务（HUAWEI Identity Kit）为用户提供统一的地址管理服务，您可通过用户授权直接获取地址信息，高效便利。

您将建立什么

在这个Codelab中，你将使用已经创建好的Demo Project实现对华为Identity开放服务的API调用，通过Demo Project你可以体验到:

调用华为Identity获取用户地址API及处理响应过程。

您将会学到什么

如何在华为开发者联盟上创建应用
如何集成HUAWEI Identity SDK
如何调用HUAWEI Identity API获取用户地址及处理响应过程

硬件要求

开发计算机（台式机或笔记本电脑）。
HUAWEI手机一部，用于运行开发集成Identity的应用。
一根数据线，用于连接开发计算机与手机。

软件要求

Android Studio 3.0 或更高版本
JAVA SDK 1.7 或更高版本
华为移动服务（APK）为4.0.0.300及以上版本
HMS SDK为4.0.0.300及以上版本

集成HUAWEI HMS Core能力，需要完成以下准备工作

创建AppGallery Connect应用
创建Android Studio工程
生成签名证书
生成签名证书指纹
配置签名证书指纹
添加应用包名并保存配置文件
配置Maven仓地址及AppGallery Connect gradle插件
在Android Studio配置签名文件

具体操作，请按照《HUAWEI HMS Core集成准备》中详细说明来完成。

下载代码

下载并解压CodeLab_Identity_Demo.zip。

源码下载

在Android Studio中打开工作项目

打开Android Studio。
选择"File"->"import project..."，选择刚解压的源代码路径。
点击完成按钮。

添加当前应用的AGC配置文件

登录华为开发者联盟AppGallery Connect网站，选择"我的应用"。在名称列表中找到应用所在的产品，点击对应手机设备的"Android应用"链接。

选择"开发 > 概览"。单击"应用"栏下的"agconnect-service.json"下载配置文件。

将下载的"agconnect-services.json"文件移至Android Studio开发工程app的根目录下。

配置SDK仓库及依赖包

在应用级build.gradle文件中配置依赖包，需添加下面内容


dependencies {
    // ...

    implementation 'com.huawei.hms:identity:4.0.0.300'
}

配置混淆脚本，在app/proguard-rules.pro文件中添加如下两行


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

点击sync now同步工程

Demo实现

在MainActivity.java类中增加查询用户地址和启动选择用户地址界面。


private void getUserAddress() {
    UserAddressRequest req = new UserAddressRequest();
    Task<GetUserAddressResult> task = Address.getAddressClient(this).getUserAddress(req);
    task.addOnSuccessListener(new OnSuccessListener<GetUserAddressResult>() {
        @Override
        public void onSuccess(GetUserAddressResult result) {
            Log.i(TAG, "onSuccess result code:" + result.getReturnCode());
            try {
                startActivityForResult(result);
            } catch (IntentSender.SendIntentException e) {
                e.printStackTrace();
            }
        }
    }).addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(Exception e) {
            Log.i(TAG, "on Failed result code:" + e.getMessage());
        }
    });

}

private void startActivityForResult(GetUserAddressResult result) throws IntentSender.SendIntentException {
    Status status = result.getStatus();
    if (result.getReturnCode() == 0 && status.hasResolution()) {
        Log.i(TAG, "the result had resolution.");
        status.startResolutionForResult(this, GET_ADDRESS);
    } else {
        Log.i(TAG, "the response is wrong, the return code is " + result.getReturnCode());
    }
}

在MainActivity.java文件的OnCreate方法中最后增加查询用户地址按钮点击事件。


queryAddrButton.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        getUserAddress();
    }
});

MainActivity.java中覆写onActivityResult解析用户选择后返回的用户地址数据并显示到文本框中。


@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    Log.i(TAG, "onActivityResult requestCode " + requestCode + " resultCode " + resultCode);
    switch (requestCode) {
        case GET_ADDRESS:
            switch (resultCode) {
                case Activity.RESULT_OK:
                    UserAddress userAddress = UserAddress.parseIntent(data);
                    if (userAddress != null) {
                        StringBuilder sb = new StringBuilder();
                        sb.append("name:" + userAddress.getName() + ",");
                        sb.append("city:" + userAddress.getAdministrativeArea() + ",");
                        sb.append("area:" + userAddress.getLocality() + ",");
                        sb.append("address:" + userAddress.getAddressLine1() + userAddress.getAddressLine2() + ",");
                        sb.append("phone:" + userAddress.getPhoneNumber());
                        Log.i(TAG, "user address is " + sb.toString());
                        textView.setText(sb.toString());
                    } else {
                        textView.setText("Failed to get user address.");
                    }
                    break;
                case Activity.RESULT_CANCELED:
                    break;
                default:
                    Log.i(TAG, "result is wrong, result code is " + resultCode);
                    break;
            }
        default:
            break;
    }
}

测试开发完成后，点击图标，运行Android Studio工程打包生成APK，并安装在测试手机上，运行效果如下图所示：

干得好，你已经成功完成了Codelab并学到了：

如何在开发者联盟上申请应用以及配置应用的相关信息。
如何集成Identity服务SDK。
如何获取和使用用户地址。

您可以阅读下面链接，了解更多相关的信息。
HUAWEI Identity SDK开发指南

API文档

FAQ

已复制代码