utils 部件可被各业务子系统及上层应用使用,依赖芯片文件系统实现,需要芯片平台提供文件打开、关闭、读写、获取大小等功能。
移植指导
OpenHarmony 文件系统需要适配如下 HAL 层接口:
表 1 文件打开或关闭
| 接口名 | 描述 |
|---|---|
| HalFileOpen | 文件打开或创建新文件。 |
| HalFileClose | 文件关闭。 |
表 2 文件操作
| 接口名 | 描述 |
|---|---|
| HalFileRead | 读文件。 |
| HalFileWrite | 写文件。 |
| HalFileDelete | 删除文件。 |
| HalFileStat | 获取文件属性。 |
| HalFileSeek | 文件查找。 |
厂商适配相关接口的实现,请参考 OpenHarmony 中 file 的接口和 hal 层适配接口的定义:
//utils/native/lite/file
├── BUILD.gn
└── src
└── file_impl_hal
└── file.c #file接口
//utils/native/lite/hals
└── file
└── hal_file.h #hal层接口头文件
其中 BUILD.gn 的内容如下:
import("//build/lite/config/component/lite_component.gni")
static_library("native_file") {
sources = [ "src/file_impl_hal/file.c", ]
include_dirs = [ "//utils/native/lite/include", "//utils/native/lite/hals/file", ]
deps = ["$ohos_vendor_adapter_dir/hals/utils/file:hal_file_static"] #依赖厂商的适配
}
lite_component("file") {
features = [ ":native_file", ]
}
从中可以看到厂商适配相关接口的存放目录应为“$ohos_vendor_adapter_dir/hals/utils/file”,且该目录下 BUILD.gn 文件中的目标应为 hal_file_static。 通常厂商可以采用下面三种方式适配 hal 层接口:
- 直接 flash 读写,模拟文件的操作。
- 使用 littlefs 或者 fatfs 文件系统进行适配,littlefs 或者 fatfs 都是轻量级文件系统适配简单,其中 OpenHarmony 的“//thirdparty”目录下已有 fatfs 可供参考。
- 使用厂商已有的文件系统进行适配。
DD一下:欢迎大家关注工粽号<程序猿百晓生>,可以了解到以下知识点。
`欢迎大家关注工粽号<程序猿百晓生>,可以了解到以下知识点。`
1.OpenHarmony开发基础
2.OpenHarmony北向开发环境搭建
3.鸿蒙南向开发环境的搭建
4.鸿蒙生态应用开发白皮书V2.0 & V3.0
5.鸿蒙开发面试真题(含参考答案)
6.TypeScript入门学习手册
7.OpenHarmony 经典面试题(含参考答案)
8.OpenHarmony设备开发入门【最新版】
9.沉浸式剖析OpenHarmony源代码
10.系统定制指南
11.【OpenHarmony】Uboot 驱动加载流程
12.OpenHarmony构建系统--GN与子系统、部件、模块详解
13.ohos开机init启动流程
14.鸿蒙版性能优化指南
.......
移植实例
- “config.json”添加文件系统。 路径:“vendor/MyVendorCompany/MyProduct/config.json” 修改如下:
{
"subsystem": "utils",
"components": [
{ "component": "file", "features":[] }
]
},
2.添加适配文件。 在“vendor/MyVendorCompany/MyProduct/config.json”文件中,vendor_adapter_dir 配置项通常进行如下配置: "vendor_adapter_dir": "//device/MyDeviceCompany/MyBoard/adapter"。 在该目录下进行 UtilsFile 接口适配:
hals/utils/file
├── BUILD.gn
└── src
└── hal_file.c
其中 BUILD.gn 内容如下:
import("//build/lite/config/component/lite_component.gni")
static_library("hal_file_static") { #目标名
sources = [ "src/hal_file.c" ] #厂商适配的源文件
include_dirs = [
"//utils/native/lite/hals/file",
]
}