做过移动端开发的人应该都了解,需要给用户设备生成一个唯一标识即dvid,做个性化推荐,用户拉新,推送等用途。那么如何在鸿蒙HarmonyOS NEXT获取设备的唯一标识符?
鸿蒙上标识符简介
首先我们需要知道在鸿蒙上标识符的分类,主要为UDID、OAID、AAID、ODID。
UDID
UDID是什么
设备Udid,仅限系统应用使用。说明:数据长度为65字节。可作为设备唯一识别码。需要权限:ohos.permission.sec.ACCESS_UDID。 这是设备唯一标识不错的选择,但是仅供系统使用,目前只能hdc命令可以获取,至少填加证书添加设备使用。
示例:9D6AABD147XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXE5536412
如何获取UDID
hdc shell bm get --udid
OAID
OAID是什么
OAID(Open Anonymous Device Identifier )即开放匿名设备标识符,同一台设备上不同的App获取到的OAID值一样。OAID的获取受应用的跟踪开关影响:当应用的跟踪开关开启时,该应用可获取到非全0的有效OAID;当应用的跟踪开关关闭时,该应用仅能获取到全0的OAID。同一台设备上首个应用开启应用跟踪开关时,会首次生成OAID。 OAID会在下述场景中发生变化,用户恢复手机出厂设置。用户操作重置OAID。
如何获取OAID
let odid: string = deviceInfo.ODID;
需要注意的是,需要在设置页面搜索跨应用关联,打开开关按钮,首次启动app的时候弹出OAID的权限弹框。
OAID
OAID是什么
OAID(Open Anonymous Device Identifier )即开放匿名设备标识符,同一台设备上不同的App获取到的OAID值一样。OAID的获取受应用的跟踪开关影响:当应用的跟踪开关开启时,该应用可获取到非全0的有效OAID;当应用的跟踪开关关闭时,该应用仅能获取到全0的OAID。同一台设备上首个应用开启应用跟踪开关时,会首次生成OAID。 OAID会在下述场景中发生变化,用户恢复手机出厂设置。用户操作重置OAID。
如何获取OAID
let odid: string = deviceInfo.ODID;
需要注意的是,需要在设置页面搜索跨应用关联,打开开关按钮,首次启动app的时候弹出OAID的权限弹框。
AAID
AAID是什么
AAID(Anonymous Application Identifier)即应用匿名标识符,标识运行在移动智能终端设备上的应用实例,只有该应用实例才能访问该标识符,它只存在于应用的安装期,总长度36位。与无法重置的设备级硬件ID相比,AAID具有更好的隐私权属性。 AAID会在包括但不限于下述场景中发生变化:应用卸载重装,应用调用删除AAID接口,用户恢复出厂设置,用户清除应用数据。
如何获取AAID
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);
}
}
}
ODID
ODID是什么
ODID:开发者匿名设备标识符,它主要用于开放给开发者的设备标识,同一设备上运行的同一个开发者的应用,ODID相同。帮助开发者更好地理解用户在不同应用间的行为,从而提供更个性化的服务和推荐。ODID具有以下特性: 同一设备上运行的同一个开发者的应用,ODID相同。 同一个设备上不同开发者的应用,ODID不同。 不同设备上同一个开发者的应用,ODID不同。 不同设备上不同开发者的应用,ODID不同。
如何获取ODID
export function requestOAIDTrackingConsentPermissions(context: common.Context): void {
const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
try {
atManager.requestPermissionsFromUser(context, ["ohos.permission.APP_TRACKING_CONSENT"]).then((data) => {
if (data.authResults[0] == 0) {
hilog.info(0x0000, 'testTag', '%{public}s', 'succeeded in requesting permission');
identifier.getOAID((err: BusinessError, data: string) => {
if (err.code) {
hilog.error(0x0000, 'testTag', '%{public}s', `get oaid failed, error: ${err.code} ${err.message}`);
} else {
const oaid: string = data;
hilog.info(0x0000, 'testTag', '%{public}s', `succeeded in getting oaid by callback , oaid: ${oaid}`);
}
});
} else {
hilog.error(0x0000, 'testTag', '%{public}s', 'user rejected');
}
}).catch((err: BusinessError) => {
hilog.error(0x0000, 'testTag', '%{public}s', `request permission failed, error: ${err.code} ${err.message}`);
})
} catch (err) {
hilog.error(0x0000, 'testTag', '%{public}s', `catch err->${err.code}, ${err.message}`);
}
}
鸿蒙上Asset Store Kit简介
Asset Store Kit(关键资产存储开发套件)包含了关键资产存储服务(ASSET)开放的接口能力集合,提供了用户短敏感数据的安全存储及管理能力。其中,短敏感数据可以是密码类(账号/密码)、Token类(应用凭据)、其他关键明文(如银行卡号)等长度较短的用户敏感数据。
为什么要说到资产?因为资产数据可以存到设备后,不会随着APP的卸载而消失,只要没有删除该资产或者恢复出厂设置,资产数据就不会消失。因此可以结合资产,去生成设备的唯一标识符,类似iOS中KeyChain功能。
资产的增删改查相关代码
function AssetAdd(alias: string, secret: string, isForever: boolean) {
if (isEmpty(alias) && isEmpty(secret)) {
return
}
let attr: asset.AssetMap = new Map();
attr.set(asset.Tag.SECRET, stringToArray(secret));
attr.set(asset.Tag.ALIAS, stringToArray(alias));
attr.set(asset.Tag.IS_PERSISTENT, isForever);
attr.set(asset.Tag.ACCESSIBILITY, asset.Accessibility.DEVICE_FIRST_UNLOCKED);
try {
asset.add(attr).then(() => {
console.info(`Asset added successfully.`);
}).catch((error: BusinessError) => {
console.error("AssetAdd error:" + JSON.stringify(error));
})
} catch (error) {
console.error("AssetAdd error2:" + JSON.stringify(error));
}
}
function AssetQuery(alias: string, callBack: AssetResCallBack) {
if (isEmpty(alias)) {
return
}
let query: asset.AssetMap = new Map();
query.set(asset.Tag.ALIAS, stringToArray(alias)); // 指定了关键资产别名,最多查询到一条满足条件的关键资产
query.set(asset.Tag.RETURN_TYPE, asset.ReturnType.ALL); // 此处表示需要返回关键资产的所有信息,即属性+明文
try {
asset.query(query).then((res: Array<asset.AssetMap>) => {
if (res && res.length > 0) {
for (let i = 0; i < res.length; i++) {
let secret: Uint8Array = res[i].get(asset.Tag.SECRET) as Uint8Array;
let secretStr: string = arrayToString(secret);
callBack.onSuccess(secretStr)
}
}
}).catch(() => {
console.error(`Failed to query Asset.`);
callBack.onFail('')
});
} catch (error) {
console.error(`Failed to query Asset.`);
callBack.onFail(JSON.stringify(error))
}
}
export interface AssetResCallBack {
onSuccess: (content: string) => string
onFail: (content: string) => string
}
function AssetDeleted(alias: string) {
if (isEmpty(alias)) {
return
}
let query: asset.AssetMap = new Map();
query.set(asset.Tag.ALIAS, stringToArray(alias)); // 此处指定别名删除单条数据,也可不指定别名删除多条数据
try {
asset.remove(query).then(() => {
console.info(`Asset removed successfully.`);
}).catch(() => {
console.error(`Failed to remove Asset.`);
});
} catch (error) {
console.error(`Failed to remove Asset.`);
}
}
function AssetUpdate(alias: string, secret: string) {
if (isEmpty(alias) && isEmpty(secret)) {
return
}
let query: asset.AssetMap = new Map();
query.set(asset.Tag.ALIAS, stringToArray(alias));
let attrsToUpdate: asset.AssetMap = new Map();
attrsToUpdate.set(asset.Tag.SECRET, stringToArray(secret));
try {
asset.update(query, attrsToUpdate).then(() => {
console.info(`Asset updated successfully.`);
}).catch(() => {
console.error(`Failed to update Asset.`);
});
} catch (error) {
console.error(`Failed to update Asset.`);
}
}
关键资产存储服务(ASSET)错误码
https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/errorcode-asset-V5
设备的唯一标识符
方式一:根据自己的业务需求,结合鸿蒙上标识符作为设备的唯一标识符,存到资产中。
方式二:根据自己的规则可以将字符串加密之后,存到资产中,生成设备的唯一标识符。