鸿蒙HarmonyOS NEXT如何生成设备唯一码

做过移动端开发的人应该都了解,需要给用户设备生成一个唯一标识即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

设备的唯一标识符

方式一:根据自己的业务需求,结合鸿蒙上标识符作为设备的唯一标识符,存到资产中。

方式二:根据自己的规则可以将字符串加密之后,存到资产中,生成设备的唯一标识符。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,923评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,154评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,775评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,960评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,976评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,972评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,893评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,709评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,159评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,400评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,552评论 1 346
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,265评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,876评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,528评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,701评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,552评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,451评论 2 352

推荐阅读更多精彩内容