华为HarmonyOS灵活高效的消息推送服务(Push Kit) - 3 获取AAID

青瓷看世界2024-09-23 21:29

AAID（Anonymous Application Identifier）：应用匿名标识符，标识运行在移动智能终端设备上的应用实例，只有该应用实例才能访问该标识符，它只存在于应用的安装期，总长度32位。与无法重置的设备级硬件ID相比，AAID具有更好的隐私权属性。

AAID具有以下特性：

匿名化、无隐私风险：AAID和已有的任何标识符都不关联，并且每个应用只能访问自己的AAID。
同一个设备上，同一个开发者的多个应用，AAID取值不同。
同一个设备上，不同开发者的应用，AAID取值不同。
不同设备上，同一个开发者的应用，AAID取值不同。
不同设备上，不同开发者的应用，AAID取值不同。

场景介绍

AAID会在包括但不限于下述场景中发生变化：

应用卸载重装。
应用调用删除AAID接口。
用户恢复出厂设置。
用户清除应用数据。

接口说明

接口返回值有两种返回形式：Callback和Promise回调。下表中仅展示Promise回调形式的接口，Promise和Callback只是返回值方式不一样，功能相同。

接口名	描述
getAAID(): Promise<string>	获取AAID，使用Promise异步返回结果。
deleteAAID(): Promise<void>	删除AAID，使用Promise异步返回结果。

获取AAID

导入AAID模块。
TypeScript 复制代码
```
import { AAID } from '@kit.PushKit';
```

调用AAID.getAAID()方法获取AAID信息。

TypeScript 复制代码

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { AAID } from '@kit.PushKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
export default class EntryAbility extends UIAbility {
// 入参want与launchParam并未使用，为初始化项目时自带参数
async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): Promise<void> {
// 获取AAID
try {
const aaid: string = await AAID.getAAID();
hilog.info(0x0000, 'testTag', 'Succeeded in getting AAID.');
} catch (err) {
let e: BusinessError = err as BusinessError;
hilog.error(0x0000, 'testTag', 'Failed to get AAID: %{public}d %{public}s', e.code, e.message);
}
}
}