鸿蒙（API 12 Beta2版）NDK开发【内存管理purgeable内存开发指导】

news2024/10/2 12:17:36

场景介绍

HarmonyOS提供Purgeable Memory内存管理机制，开发者可以使用相关接口创建PurgeableMemory对象，从而管理purgeable内存。

开发者可以通过本指导了解在HarmonyOS应用中，如何使用Native层相关接口操作purgeable内存。功能包括purgeable内存的申请、释放等。

针对Purgeable Memory内存管理机制，常见的开发场景如下：

通过该机制提供的NAPI接口申请管理PurgeableMemory对象，并将数据内容写入该对象。
使用完毕后释放。

接口说明

接口名	描述
OH_PurgeableMemory OH_PurgeableMemory_Create(size_t size, OH_PurgeableMemory_ModifyFunc func, void funcPara)	创建PurgeableMemory对象，每次调用都会产生一个新的PurgeableMemory对象。
bool OH_PurgeableMemory_Destroy(OH_PurgeableMemory *purgObj)	对PurgeableMemory对象进行析构操作。
bool OH_PurgeableMemory_BeginRead(OH_PurgeableMemory *purgObj)	对PurgeableMemory对象进行读访问。
void OH_PurgeableMemory_EndRead(OH_PurgeableMemory *purgObj)	读操作结束，将PurgeableMemory对象的引用计数减1，当引用计数为0的时候，该PurgeableMemory对象可以被系统回收。
bool OH_PurgeableMemory_BeginWrite(OH_PurgeableMemory *purgObj)	对PurgeableMemory对象进行写访问。
void OH_PurgeableMemory_EndWrite(OH_PurgeableMemory *purgObj)	写操作结束，将PurgeableMemory对象的引用计数减1，当引用计数为0的时候，该PurgeableMemory对象可以被系统回收。
void OH_PurgeableMemory_GetContent(OH_PurgeableMemory purgObj)	获取PurgeableMemory对象内存数据。
size_t OH_PurgeableMemory_ContentSize(OH_PurgeableMemory *purgObj)	获取PurgeableMemory对象内存数据大小。
bool OH_PurgeableMemory_AppendModify(OH_PurgeableMemory purgObj, OH_PurgeableMemory_ModifyFunc func, void funcPara)	添加PurgeableMemory对象的修改方法。

Purgeable Memory应用开发步骤

以下步骤描述了在HarmonyOS中如何使用Purgeable Memory提供的NAPI接口，申请PurgeableMemory对象，并将内容写入PurgeableMemory对象后，对相应对象进行读写访问。

声明PurgeableMemory对象创建规则。

// 声明构建函数的参数struct ParaData{    int start;    int end;};
// 声明一个使用ModifyFuncbool FactorialFunc(void* data, size_t size, void* param){    bool ret = true;    ParaData *pdata = (ParaData*) param;    int* oriData = (int*)data;    int i = pdata->start;    while(i<pdata->end){        *oriData *= i;        i++;    }    return ret;}
// 声明修改PurgeableMemory对象扩展函数的参数struct AppendParaData{    int newPara;};
// 声明修改PurgeableMemory对象的扩展函数bool AddFunc(void* data, size_t size, void* param){    bool ret = true;    int *oriDatap = (int*) data;    AppendParaData* apData = (AppendParaData*)param;    *oriDatap += apData->newPara;    return ret;}

创建PurgeableMemory对象。

// 声明一个4MB的PurgeableMemory对象大小#define DATASIZE (4 * 1024 * 1024)
// 声明创建函数的参数struct ParaData pdata = {1,2};
// 创建一个PurgeableMemory对象OH_PurgeableMemory* pPurgmem = OH_PurgeableMemory_Create(DATASIZE, FactorialFunc, &pdata);

读访问PurgeableMemory对象。

//业务定义对象类型class ReqObj;
// 读取对象OH_PurgeableMemory_BeginRead(pPurgmem);
// 获取PurgeableMemory对象大小size_t size = OH_PurgeableMemory_ContentSize(pPurgmem);
// 获取PurgeableMemory对象内容ReqObj* pReqObj = (ReqObj*) OH_PurgeableMemory_GetContent(pPurgmem);
// 读取PurgeableMemory对象结束OH_PurgeableMemory_EndRead(pPurgmem);

写访问PurgeableMemory对象。

 //业务定义对象类型class ReqObj;
// 修改PurgeableMemory对象OH_PurgeableMemory_BeginWrite(pPurgmem);
// 获取PurgeableMemory对象数据ReqObj* pReqObj = (ReqObj*) OH_PurgeableMemory_GetContent(pPurgmem);
// 声明扩展创建函数的参数struct AppendParaData apdata = {1};
// 更新PurgeableMemory对象重建规则OH_PurgeableMemory_AppendModify(pPurgmem, AddFunc, &apdata);
// 修改PurgeableMemory对象结束OH_PurgeableMemory_EndWrite(pPurgmem);

销毁PurgeableMemory对象。

// 销毁对象OH_PurgeableMemory_Destroy(pPurgmem);// 置空指针防止UAFpPurgmem = nullptr;

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述