鸿蒙开发实践——基于C++能力的资源访问

场景描述

开发过程中可能需要在native侧实现资源访问，应用经常会遇到如下的业务诉求：

• 场景一：c++访问公共目录的文件图片等资源(图库和文管)

• 场景二：c++访问沙箱文件/图片等资源

• 场景三：c++访问应用包里的文件/图片资源 rawfile和resource

场景一：c++访问公共目录的文件图片等资源(图库和文管)

一、获取拥有读/写权限的文件URI，当前需要在arkts侧获取并通过NAPI的方式将uri传递给C++侧，如通过picker获取对应uri，再将uri传递到c++侧。

二、使用FileManagement_ErrCode OH_FileUri_GetPathFromUri根据uri获取对应的文件路径。

//将传入的uri转换成路径path。
FileManagement_ErrCode OH_FileUri_GetPathFromUri (const char * uri, unsigned int length, char ** result )

三、使用C++标准的文件接口打开文件。

fp = fopen(path, "r");

场景二：c++访问沙箱文件/图片等资源

一、获取沙箱路径

方式一：通过arkts侧传递

在应用arkts侧，提供了ApplicationContext对象，可获取沙箱路径：

应用arkts侧

在ApplicationContext对象中获取应用沙箱路径，传递应用沙箱路径到Native C++侧。

let applicationContext = getContext().getApplicationContext(); // 获取应用上下文对象
let filesDir = applicationContext.filesDir; // 应用通用文件路径
let cacheDir = applicationContext.cacheDir; // 应用缓存文件路径
let tempDir = applicationContext.tempDir; // 应用临时文件路径

方式二：拼接

根据应用沙箱目录的 规范 ，在Native C++侧定义完整的沙箱路径。如：/data/app/el2/100/base/{包名}/haps/entry/files/test.txt

二、根据沙箱路径打开文件/图片等资源

参考场景一的使用C++标准的文件接口打开文件，path传入对应文件所在的沙箱路径。

fp = fopen(path, "r");

场景三：c++访问应用包里的文件/图片资源（rawfile和resource）

一、js侧传入对应的资源管理对象resourceManager

获取本应用包资源resourceManager对象的示例如下:

private resmgr = getContext().resourceManager;  // 获取本应用包的资源对象

二、获取文件/资源路径一般是由开发者自行规划的，可由开发者自行拼接。在传递ResourceManger的同时传递了对应的文件夹名称。

let rawfilelist = testNapi.getFileList(this.resmgr, "rawdir"); //传入资源对象，以及访问的rawfile文件夹名称

三、C++侧访问rawfile和resource下的资源文件

通过arkts传入的resourceManager访问资源文件，整个过程按照以下步骤进行：

1、初始化resourceManager2、打开rawfile文件初始化：

NativeResourceManager *manager = OH_ResourceManager_InitNativeResourceManager(env, args[0]);

为使用OH_ResourceManager_OpenRawFile打开rawfile文件（mNativeResMgr为js传入的resourceManager）：

RawFile *rawFile = OH_ResourceManager_OpenRawFile(mNativeResMgr, filename.c_str());
if (rawFile != nullptr) {
  OH_LOG_Print(LOG_APP, LOG_ERROR, GLOBAL_RESMGR, tag, "OH_ResourceManager_OpenRawFile success");
}

使用OH_ResourceManager_GetRawFileSize获取rawfile大小并申请内存：

long len = OH_ResourceManager_GetRawFileSize(rawFile);
std::unique_ptr<uint8_t[]> data= std::make_unique<char[]>(len);

读取rawfile：方式一：使用OH_ResourceManager_ReadRawFile一次性读取rawfile全部内容：

int res = OH_ResourceManager_ReadRawFile(rawFile, data.get(), len);

方式二：使用OH_ResourceManager_ReadRawFile多次部分读取rawfile, 每次读取100 Byte。获取全部内容：

long offset = 0;
while (OH_ResourceManager_GetRawFileRemainingLength(rawFile) > 0) {
  OH_ResourceManager_ReadRawFile(rawFile, data.get() + offset, 100);
  offset += 100;
}

使用OH_ResourceManager_CloseRawFile关闭打开的指针对象：

OH_ResourceManager_CloseRawFile(rawFile);
OH_ResourceManager_ReleaseNativeResourceManager(mNativeResMgr);

转为arkts对象（可以根据这个arkts对象在arkts侧调用）：

return CreateJsArrayValue(env, data, len);