ArkTS实现:
import fontNapi from 'libentry.so'; @Entry @Component struct Index { message: string = 'Hello World'; aboutToAppear(): void { // 此处是模拟的读取本地字体文件后得到ArrayBuffer,实际场景中可以直接传入字体的ArrayBuffer const fontName = 'MyCustomFont'; // 自定义字体名称 const fontPath = 'XXXX.ttf'; // 此处仅为示例,请开发者替换为可用的字体文件。 const file = this.getUIContext().getHostContext()?.resourceManager.getRawFileContentSync(fontPath); fontNapi.registerFontFamily(fontName, file?.buffer); } build() { Row() { Column({ space: 10 }) { Text(this.message) .fontFamily('MyCustomFont'); } .width('100%'); } .height('100%'); } }
NAPI实现:
/* * Copyright (c) Huawei Technologies Co., Ltd. 2025-2025. All rights reserved. */ #include "napi/native_api.h" #include "native_drawing/drawing_register_font.h" #include "native_drawing/drawing_font_collection.h" static napi_value registerFontFamily(napi_env env, napi_callback_info info) { // 获取全局字体集对象OH_Drawing_FontCollection OH_Drawing_FontCollection *fontCollection = OH_Drawing_GetFontCollectionGlobalInstance(); size_t argc = 2; napi_value args[2]; napi_get_cb_info(env, info, &argc, args, nullptr, nullptr); // 获取字体名称 char fontName[256]; size_t fontNameLen; napi_get_value_string_utf8(env, args[0], fontName, sizeof(fontName), &fontNameLen); // 获取字体的ArrayBuffer数据 void *bufferData; size_t bufferLength; napi_get_arraybuffer_info(env, args[1], &bufferData, &bufferLength); // 注册字体 OH_Drawing_RegisterFontBuffer(fontCollection, fontName, reinterpret_cast<uint8_t *>(bufferData), bufferLength); return nullptr; } EXTERN_C_START static napi_value Init(napi_env env, napi_value exports) { napi_property_descriptor desc[] = { {"registerFontFamily", nullptr, registerFontFamily, nullptr, nullptr, nullptr, napi_default, nullptr}}; napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc); return exports; } EXTERN_C_END static napi_module demoModule = { .nm_version = 1, .nm_flags = 0, .nm_filename = nullptr, .nm_register_func = Init, .nm_modname = "entry", .nm_priv = ((void *)0), .reserved = {0}, }; extern "C" __attribute__((constructor)) void RegisterEntryModule(void) { napi_module_register(&demoModule); }
Index.d.ts声明:
export const registerFontFamily: (fontName: string, file: ArrayBuffer) => void;
CMakeLists.txt:
# the minimum version of CMake. cmake_minimum_required(VERSION 3.5.0) project(registerFontBuffer) set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR}) if(DEFINED PACKAGE_FIND_FILE) include(${PACKAGE_FIND_FILE}) endif() include_directories(${NATIVERENDER_ROOT_PATH} ${NATIVERENDER_ROOT_PATH}/include) add_library(entry SHARED napi_init.cpp) target_link_libraries(entry PUBLIC libace_napi.z.so libnative_drawing.so)
OH_Drawing_GetFontCollectionGlobalInstance这个接口是API 14才支持,需要把DevEco Studio和系统版本升级到对应的配套版本上进行使用,DevEco Studio请使用5.0.7.210及以上版本。