背景
这篇文章主要记录,个人开发者在获取华为用户授权后,拿到用户的头像和名字。获取用户的电话号码的获取需要应用获得scope权限,现仅对企业开发者开放。
环境配置
在项目中生成证书请求文件(CSR)
- 在build->Generate Key and CSR中选择
- 根据下面填写内容生成CSR文件
- 创建Key store,密码要记住的哈~~
- 输入Alias(别名)后面再项目结构配置的时候需要填写的哈,要记住。(尴尬,写到才发现单词写错了。。。)
- 保存CSR地址,点击Finish完成创建
在AGC中创建项目
- 在证书、APPID和Profile中创建APP
- 新建证书,然后下载证书,后续的项目配置需要使用
- 新建Profile,并下载后续给项目配置使用
- 在项目中添加公钥指纹,选择自己新建的公钥
在项目结构中手动添加证书
先查看Bundle name和AGC的项目上填写的是否一致。像我这里的,AGC是com.myapp.accentdemo,项目的是com.example.accountdemo,因此,需要先调整好Bundle name
在AppScope的app.json5文件中进行修改
在Signing Configs选项卡中配置项目信息
配置Client ID,在Entry->module.json5中添加Client ID,在AGC中复制ID
获取用户信息代码编写
UI
- 需要引用 authentication 和 ImageType
import { ImageType } from '@kit.UIDesignKit'
import { authentication } from '@kit.AccountKit'
import { util } from '@kit.ArkTS'
@Entry
@ComponentV2
struct Index {
@Local UserIcon: ImageType = $r('app.media.user_dark')
@Local UserName: string = "炸鸡仔"
AuthRequest?: authentication.AuthorizationWithHuaweiIDRequest
build() {
Column({ space: 10 }) {
Image(this.UserIcon)
.width(80)
.height(80)
.borderRadius(40)
Text(this.UserName)
.fontWeight(FontWeight.Bold)
.margin({ top: 5 })
Button("获取用户头像和名字")
.width("80%")
.onClick(async () => {
}
}
.height('100%')
.width('100%')
}
}
获取用户信息请求对象代码
- 通过authentication.HuaweiIDProvider().createAuthorizationWithHuaweiIDRequest()的方式创建请求对象
this.AuthRequest = new authentication.HuaweiIDProvider().createAuthorizationWithHuaweiIDRequest();
// 获取头像昵称需要传如下scope
this.AuthRequest.scopes = ['profile', 'openid'];
// 若开发者需要进行服务端开发,则需传如下permission获取authorizationCode
this.AuthRequest.permissions = ['serviceauthcode'];
// 用户是否需要登录授权,该值为true且用户未登录或未授权时,会拉起用户登录或授权页面
this.AuthRequest.forceAuthorization = false;
// 用于防跨站点请求伪造
this.AuthRequest.state = util.generateRandomUUID();
// 用户没有授权的时候,是否弹窗提示用户授权
this.AuthRequest.forceAuthorization = true;
- 授权请求对象几个重要的属性:
- scopes:获取用户数据,与permissions属性不能同时为空,否则会报错,默认值:[‘openid’]。其中的参数有
- profile:华为账号用户的基本信息,如昵称头像等。
- openid:华为账号用户的OpenID、UnionID。UnionID作为用户标识,OpenID为用户在当前应用的用户标识。
- phone:华为账号快速验证手机号,需要scope权限,也就是企业用户哈。
- quickLoginAnonymousPhone:获取华为账号绑定的匿名手机号,需要scope权限,也就是企业用户哈。
- permissions:用于获取用户授权临时凭据和用户身份认证信息,与scopes属性不能同时为空。
- serviceauthcode:用户授权临时凭据。
- idtoken:用户身份认证信息。
- forceAuthorization:表示华为账号未登录时,是否需要强制拉起华为账号登录页。默认值:true。
- state:随机数并做一致性校验。该参数与响应体中返回的state比较。
- nonce:该参数会包含在返回的ID Token中,通过校验一致性,可用于防止重放攻击。
- idTokenSignAlgorithm:默认值:PS256,用于指定ID Token的签名算法。
- supportAtomicService:在元服务场景下,当传入scopes包含profile时,是否支持获取用户头像昵称。如果该值为true,可以正常获取用户头像昵称。如果该值为false,执行授权请求将返回1001500003 错误代码。
- scopes:获取用户数据,与permissions属性不能同时为空,否则会报错,默认值:[‘openid’]。其中的参数有
获取请求数据
const controller = new authentication.AuthenticationController(this.getUIContext().getHostContext());
const data: authentication.AuthorizationWithHuaweiIDResponse =
await controller.executeRequest(this.AuthRequest);
const authorizationWithHuaweiIDResponse = data as authentication.AuthorizationWithHuaweiIDResponse;
const state = authorizationWithHuaweiIDResponse.state;
if (state && this.AuthRequest.state !== state) {
console.error(`Failed to authorize. The state is different, response state: ${state}`);
return;
}
if (authorizationWithHuaweiIDResponse && authorizationWithHuaweiIDResponse.data) {
//用户头像链接,有效期较短,建议先将头像下载保存后再使用,这里只是用于演示哈
if (authorizationWithHuaweiIDResponse.data.avatarUri) {
this.UserIcon = authorizationWithHuaweiIDResponse.data.avatarUri;
}
//用户昵称
if (authorizationWithHuaweiIDResponse.data.nickName) {
this.UserName = authorizationWithHuaweiIDResponse.data.nickName;
}
//唯一ID
const userUnionID = authorizationWithHuaweiIDResponse?.data?.unionID;
//当前应用ID
const userOpenID = authorizationWithHuaweiIDResponse?.data?.openID;
}
请求返回的结果
- data:用户授权结果数据,可以查看SDK文档,AuthorizationWithHuaweiIDCredential
- state:响应体中返回的state
完整代码
import { ImageType } from '@kit.UIDesignKit'
import { authentication } from '@kit.AccountKit'
import { util } from '@kit.ArkTS'
@Entry
@ComponentV2
struct Index {
@Local UserIcon: ImageType = $r('app.media.user_dark')
@Local UserName: string = "炸鸡仔"
AuthRequest?: authentication.AuthorizationWithHuaweiIDRequest
build() {
Column({ space: 10 }) {
Image(this.UserIcon)
.width(80)
.height(80)
.borderRadius(40)
Text(this.UserName)
.fontWeight(FontWeight.Bold)
.margin({ top: 5 })
Button("获取用户头像和名字")
.width("80%")
.onClick(async () => {
this.AuthRequest = new authentication.HuaweiIDProvider().createAuthorizationWithHuaweiIDRequest();
// 获取头像昵称需要传如下scope
this.AuthRequest.scopes = ['profile', 'openid'];
// 若开发者需要进行服务端开发,则需传如下permission获取authorizationCode
this.AuthRequest.permissions = ['serviceauthcode'];
// 用户是否需要登录授权,该值为true且用户未登录或未授权时,会拉起用户登录或授权页面
this.AuthRequest.forceAuthorization = false;
// 用于防跨站点请求伪造
this.AuthRequest.state = util.generateRandomUUID();
// 用户没有授权的时候,是否弹窗提示用户授权
this.AuthRequest.forceAuthorization = true;
const controller = new authentication.AuthenticationController(this.getUIContext().getHostContext());
const data: authentication.AuthorizationWithHuaweiIDResponse =
await controller.executeRequest(this.AuthRequest);
const authorizationWithHuaweiIDResponse = data as authentication.AuthorizationWithHuaweiIDResponse;
const state = authorizationWithHuaweiIDResponse.state;
if (state && this.AuthRequest.state !== state) {
console.error(`Failed to authorize. The state is different, response state: ${state}`);
return;
}
if (authorizationWithHuaweiIDResponse && authorizationWithHuaweiIDResponse.data) {
//用户头像链接,有效期较短,建议先将头像下载保存后再使用,这里只是用于演示哈
if (authorizationWithHuaweiIDResponse.data.avatarUri) {
this.UserIcon = authorizationWithHuaweiIDResponse.data.avatarUri;
}
//用户昵称
if (authorizationWithHuaweiIDResponse.data.nickName) {
this.UserName = authorizationWithHuaweiIDResponse.data.nickName;
}
//唯一ID
const userUnionID = authorizationWithHuaweiIDResponse?.data?.unionID;
//当前应用ID
const userOpenID = authorizationWithHuaweiIDResponse?.data?.openID;
}
})
}
.height('100%')
.width('100%')
}
}
实现的效果如下
- 未授权时,会有弹窗提示:
- 然后就可以显示用户头像和名字了