快速集成认证服务-HarmonyOS平台

​

  我们可以通过在应用中集成认证服务SDK来轻松快速地向用户推出注册、登录等相关功能。下面来介绍如何在HarmonyOS平台集成使用AGC认证服务。

集成内容

通过harmony sdk插件集成AGC 验证服务，在AGC上开启认证服务，并添加手机验证与邮箱验证两种方式，同时端侧集成SDK调用后由AGC发送验证码至手机或邮箱，输入验证码和密码后完成用户注册。

集成准备

1. 安装DevEco Studio开发工具，并熟悉Harmony应用的开发流程。
2. AGC创建工程并开通服务。

        a)在AGC创建Harmony应用并开通验证服务。

​

​

启用手机和邮箱验证

​

3、DevEco Studio中创建Harmony工程

     a)打开IDE工具，选择File-New-New project，选择Java语言编译模板后，点击Next进入创建工程配置界面。

​

注意选择应用（Application），包名和AGC创建的应用包名相同。

​

 

  b)将agconnect-services.json文件拷贝到项目的entry模块的目录下

​

c)配置Maven仓地址和AGC插件地址。

  打开harmony项目级build.gradle文件。

  在allprojects ->repositories里面配置maven仓地址。

  在buildscript->repositories中配置maven仓地址。

  在buildscript->dependencies中配置AppGallery Connect插件地址。

测试环境需要配置内部私仓地址，正式环境需要配置外部正式仓。

buildscript {
    repositories {
        maven {
            url 'https://repo.huaweicloud.com/repository/maven/'
        }
        maven {
            url 'https://developer.huawei.com/repo/'
        }
        maven { url 'http://language.cloudartifact.dgg.dragon.tools.huawei.com/artifactory/product_maven' }
        maven { url 'http://szg1.artifactory.inhuawei.com/artifactory/sz-maven-public/' }
        jcenter()
    }
    dependencies {
        classpath 'com.huawei.ohos:hap:2.4.4.2'
        classpath 'com.huawei.ohos:decctest:1.2.4.0'
        classpath 'com.huawei.agconnect:agcp-harmony:1.2.0.200'
    }
}

allprojects {
    repositories {
        maven {
            url 'https://repo.huaweicloud.com/repository/maven/'
        }
        maven {
            url 'https://developer.huawei.com/repo/'
        }
        maven { url 'http://language.cloudartifact.dgg.dragon.tools.huawei.com/artifactory/product_maven' }
        maven { url 'http://szg1.artifactory.inhuawei.com/artifactory/sz-maven-public/' }
        jcenter()
    }
}

d)添加编译依赖和集成SDK。

打开harmony项目应用级(entry)的build.gradle文件，添加插件地址。

apply plugin: 'com.huawei.ohos.hap'
apply plugin: 'com.huawei.ohos.decctest'
apply plugin: 'com.huawei.agconnect'

在“dependencies”中添加添加agconnect-core的编译依赖和crash SDK。

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
    implementation 'com.huawei.agconnect:agconnect-auth-harmony:1.2.0.1-snapshot'
    implementation 'com.huawei.agconnect:agconnect-tasks-harmony:1.2.0.1-snapshot'
}

e）entry (hap)模块添加配置信息

enrty模块的config.json文件的module/abilities中，加入如下配置，注意包名的替换。

{
  "permissions": [
    "com.huawei.agconnect.core.DataAbilityShellProvider.PROVIDER"
  ],
  "name": "com.huawei.agconnect.core.provider.AGConnectInitializeAbility",
  "type": "data",
  "uri": "dataability://com.huawei.agconnect.auth.AGConnectInitializeAbility"
}

f)同步工程配置

​

4、配置签名信息

Harmony应用安装到真机进行测试，需要配置签名信息，有手动签名和自动签名两种方式，具体可以参见：配置签名信息。建议优先使用自动签名方式，如自动签名失败，可以选择手动签名方式。这里使用自动签名方式：

a)连接真机设备，确保DevEco Studio与真机设备已连接，真机连接成功后如下图所示

​

b)进入File > Project Structure > Project > Signing Configs界面，点击“Sign In”按钮进行登录，选择Debug,勾选Automatically generate signing，点击try again即可自动进行签名。自动生成签名所需的密钥（.p12）、数字证书（.cer）和Profile文件（.p7b）会存放到用户user目录下的.ohos\config目录下。

​

设置完签名信息后，点击OK进行保存，然后可以在工程下的build.gradle中查看签名的配置信息。

​

登录AGC，进入“用户与访问”-“证书管理”，点击新增证书，上传前面生成的.csr文件，类型选择调试证书

完成签名配置后即可点击安装应用到调试设备。

功能实现

手机验证登录布局设计

​

参考如上布局，四个文本框输入分别输入国家码、手机号、密码、验证码，点击验证后收到验证码短信，输入验证码，点击登录，完成注册和登录布局代码如下:

<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
    xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:width="match_parent"
    ohos:height="match_parent">

    <TextField
        ohos:id="$+id:countryCode"
        ohos:height="match_content"
        ohos:width="150vp"
        ohos:hint="Your countryCode"
        ohos:text_input_type="pattern_number"
        ohos:text_size="50"
        ohos:top_margin="10vp"
        />

    <TextField
        ohos:id="$+id:phoneNumber"
        ohos:height="match_content"
        ohos:width="150vp"
        ohos:hint="Your phone"
        ohos:text_input_type="pattern_number"
        ohos:text_size="50"
        ohos:bottom_margin="10vp"
        />

    <TextField
        ohos:id="$+id:password"
        ohos:height="match_content"
        ohos:width="150vp"
        ohos:hint="Password"
        ohos:text_input_type="pattern_password"
        ohos:text_size="50"
        ohos:bottom_margin="10vp"
        />

    <TextField
        ohos:id="$+id:verifyCode"
        ohos:height="match_content"
        ohos:width="150vp"
        ohos:hint="verifyCode"
        ohos:text_input_type="pattern_number"
        ohos:text_size="50"
        ohos:bottom_margin="10vp"
        />

    <DirectionalLayout
        ohos:height="match_content"
        ohos:width="match_parent"
        ohos:orientation="horizontal">
        <Button
            ohos:id="$+id:Verify"
            ohos:height="match_content"
            ohos:width="100vp"
            ohos:background_element="$graphic:background_ability_main"
            ohos:left_margin="15vp"
            ohos:text="Verify"
            ohos:text_size="16fp"/>

        <Button
            ohos:id="$+id:Login"
            ohos:height="match_content"
            ohos:width="100vp"
            ohos:background_element="$graphic:background_ability_main"
            ohos:left_margin="15vp"
            ohos:text="Login"
            ohos:text_size="16fp"/>
    </DirectionalLayout>

</DirectionalLayout>

验证和登录：

输入国家码、手机号、后点击Verify，返回验证码发送成功日志，手机收到验证码，输入密码和验证码后点击Login返回登录成功日志：

​

页面跳转到登录成功页面：

​

验证和登录代码如下：

private void verify() {
    String countryCode = getCountryCode();
    String phoneNumber = getPhoneNumber();

    int action = VerifyCodeSettings.ACTION_REGISTER_LOGIN;
    VerifyCodeSettings settings = VerifyCodeSettings.newBuilder()
            .action(action)
            .sendInterval(30)
            .build();

    HarmonyTask<VerifyCodeResult> task = AGConnectAuth.getInstance()
            .requestVerifyCode(countryCode, phoneNumber, settings);

    task.addOnSuccessListener(TaskExecutors.uiThread(), new OnSuccessListener<VerifyCodeResult>() {
        @Override
        public void onSuccess(VerifyCodeResult verifyCodeResult) {
            log("verifyPhoneCode success");
        }
    }).addOnFailureListener(TaskExecutors.uiThread(), new OnFailureListener() {
        @Override
        public void onFailure(Exception e) {
            log("verifyPhoneCode fail:" + e);
        }
    });

}

private void login() {
    String countryCode = getCountryCode();
    String phoneNumber = getPhoneNumber();
    String password = getPassword();
    String verifyCode = getVerify();

    AGConnectAuthCredential phoneAuthCredential =
            PhoneAuthProvider.credentialWithVerifyCode(countryCode, phoneNumber, password, verifyCode);

    /* signIn */
    HarmonyTask<SignInResult> task = AGConnectAuth.getInstance().signIn(phoneAuthCredential);
    task.addOnSuccessListener(new OnSuccessListener<SignInResult>() {
        @Override
        public void onSuccess(SignInResult signInResult) {
            log("signIn success");
            showUser(signInResult.getUser());
        }
    }).addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(Exception e) {
            log("signInWithCode fail:" + e);
        }
    });
}

2、邮箱验证登录布局设计

​

参考如上布局，三个文本框输入分别输入邮箱号、密码、验证码，点击验证后收到验证码短信，输入验证码，点击登录，完成注册和登录，布局代码如下：

<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
    xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:width="match_parent"
    ohos:height="match_parent">
    
    <TextField
        ohos:id="$+id:phoneNumber"
        ohos:height="match_content"
        ohos:width="150vp"
        ohos:hint="Your phone"
        ohos:text_input_type="pattern_number"
        ohos:text_size="50"
        ohos:bottom_margin="10vp"
        />

    <TextField
        ohos:id="$+id:password"
        ohos:height="match_content"
        ohos:width="150vp"
        ohos:hint="Password"
        ohos:text_input_type="pattern_password"
        ohos:text_size="50"
        ohos:bottom_margin="10vp"
        />

    <TextField
        ohos:id="$+id:verifyCode"
        ohos:height="match_content"
        ohos:width="150vp"
        ohos:hint="verifyCode"
        ohos:text_input_type="pattern_number"
        ohos:text_size="50"
        ohos:bottom_margin="10vp"
        />

    <DirectionalLayout
        ohos:height="match_content"
        ohos:width="match_parent"
        ohos:orientation="horizontal">
        <Button
            ohos:id="$+id:Verify"
            ohos:height="match_content"
            ohos:width="100vp"
            ohos:background_element="$graphic:background_ability_main"
            ohos:left_margin="15vp"
            ohos:text="Verify"
            ohos:text_size="16fp"/>

        <Button
            ohos:id="$+id:Login"
            ohos:height="match_content"
            ohos:width="100vp"
            ohos:background_element="$graphic:background_ability_main"
            ohos:left_margin="15vp"
            ohos:text="Login"
            ohos:text_size="16fp"/>
    </DirectionalLayout>

</DirectionalLayout>

输入邮箱号后点击Verify，返回验证码发送成功日志，邮箱收到验证码，输入密码和验证码后点击Login返回登录成功日志：

​

页面跳转到登录成功页面：

​

邮箱验证和登录代码如下：

private void verify() {
    //String countryCode = getCountryCode();
    String emailStr = getEmailStr();

    int action = VerifyCodeSettings.ACTION_REGISTER_LOGIN;
    VerifyCodeSettings settings = VerifyCodeSettings.newBuilder()
            .action(action)
            .sendInterval(30)
            .build();

    HarmonyTask<VerifyCodeResult> task = AGConnectAuth.getInstance()
            .requestVerifyCode(emailStr, settings);

    task.addOnSuccessListener(TaskExecutors.uiThread(), new OnSuccessListener<VerifyCodeResult>() {
        @Override
        public void onSuccess(VerifyCodeResult verifyCodeResult) {
            log("verifyEmailCode success");
        }
    }).addOnFailureListener(TaskExecutors.uiThread(), new OnFailureListener() {
        @Override
        public void onFailure(Exception e) {
            log("verifyEmailCode fail:" + e);
        }
    });

}

private void login() {
    //String countryCode = getCountryCode();
    String emailStr = getEmailStr();
    String password = getPassword();
    String verifyCode = getVerify();

    AGConnectAuthCredential emailAuthCredential =
            EmailAuthProvider.credentialWithVerifyCode(emailStr, password, verifyCode);

    /* signIn */
    HarmonyTask<SignInResult> task = AGConnectAuth.getInstance().signIn(emailAuthCredential);
    task.addOnSuccessListener(new OnSuccessListener<SignInResult>() {
        @Override
        public void onSuccess(SignInResult signInResult) {
            log("signIn success");
            showUser(signInResult.getUser());
        }
    }).addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(Exception e) {
            log("signInWithCode fail:" + e);
        }
    });
}

功能测试

在登陆成功后，打开AGC验证服务，在后台查询数据：

使用手机和邮箱注册的用户在后台均有显示账号信息和验证次数，验证次数与请求验证次数相同；

​

​

在AGC上删除账户，再次使用相同用户名和密码登录会报用户名或密码错误

​

在停用账户后登录会报账户已禁用错误。

​

​欲了解更多更全技术文章，欢迎访问https://developer.huawei.com/consumer/cn/forum/?ha_source=zzh