跳到主要内容

同步（备份恢复）关键资产(C/C++)

添加依赖​

在CMake脚本中链接相关动态库。

target_link_libraries(entry PUBLIC libasset_ndk.z.so)

引用头文件。

#include "napi/native_api.h"
#include <string.h>
#include "asset/asset_api.h"

新增支持同步的关键资产​

新增密码demo_pwd（别名demo_alias），附属信息为demo_label，支持同步的关键资产。

static napi_value AddSyncAsset(napi_env env, napi_callback_info info)
{
    char *secretStr = "demo_pwd";
    char *aliasStr = "demo_alias";
    char *labelStr = "demo_label";

    Asset_Blob secret = {(uint32_t)(strlen(secretStr)), (uint8_t *)secretStr};
    Asset_Blob alias = {(uint32_t)(strlen(aliasStr)), (uint8_t *)aliasStr};
    Asset_Blob label = {(uint32_t)(strlen(labelStr)), (uint8_t *)labelStr};
    Asset_Attr attr[] = {
        {.tag = ASSET_TAG_SECRET, .value.blob = secret},
        {.tag = ASSET_TAG_ALIAS, .value.blob = alias},
        {.tag = ASSET_TAG_DATA_LABEL_NORMAL_1, .value.blob = label},
        {.tag = ASSET_TAG_SYNC_TYPE, .value.u32 = ASSET_SYNC_TYPE_TRUSTED_DEVICE}, // 需指定在可信设备间同步（如新旧设备间克隆）。
    };

    int32_t addResult = OH_Asset_Add(attr, sizeof(attr) / sizeof(attr[0]));
    napi_value ret;
    napi_create_int32(env, addResult, &ret);
    return ret;
}

接入备份恢复扩展能力​

为触发应用数据备份恢复，需要应用接入数据备份恢复。

查询关键资产同步结果​

接口介绍​

通过API文档查看查询关键资产同步结果接口OH_Asset_QuerySyncResult。

在查询关键资产时，关键资产属性的内容参数如下表所示。

属性名称（Asset_Tag）属性内容（Asset_Value）是否必选说明
ASSET_TAG_REQUIRE_ATTR_ENCRYPTED14+类型为bool。是是否查询业务自定义附属信息被加密的关键资产同步结果。true表示查询业务自定义附属信息加密存储的关键资产同步结果，false表示查询业务自定义附属信息不加密存储的关键资产同步结果。默认值为false。
ASSET_TAG_GROUP_ID18+类型为uint8[]，长度为7-127字节。是待查询的关键资产所属群组，默认查询不属于任何群组的关键资产同步结果。

代码示例​

static napi_value QuerySyncResult(napi_env env, napi_callback_info info)
{
    Asset_SyncResult syncResult = {0};
    int32_t queryResult = OH_Asset_QuerySyncResult(NULL, 0, &syncResult);
    napi_value ret;
    napi_create_int32(env, queryResult, &ret);
    return ret;
}

约束和限制​

在可信设备间同步过程中，新旧设备的关键资产均需处于可访问的状态，否则可能出现关键资产无法同步的情况。

  • 仅设置密码时可访问的关键资产，如果新旧设备中任意一台设备未设置锁屏密码，则无法同步成功。
  • 仅屏幕处于解锁状态时可访问的关键资产，如果新旧设备中任意一台设备的屏幕未处于解锁状态，则无法同步成功。
  • 仅用户认证通过后可访问的关键资产，如果旧设备未设置锁屏密码，则无法同步成功。