Skip to main content
版本:v1.0

文件系统

介绍

Zepp OS 小程序文件系统目录分为两个部分,/assets 资源目录和 /data 数据目录。

其中 /assets 目录存放小程序的资源,此目录下只可以执行可读操作。

信息

hmFS.stat_assethmFS.open_asset 两个 API 以 /assets 资源目录为根目录

每一个小程序都会有自己的 /data 数据文件目录,此目录可以读取和写入,每个小程序之间的数据相互隔离。

信息

除了 hmFS.stat_assethmFS.open_asset 两个 API,其余文件系统操作 API 都是以 /data 为根目录

/assets 资源目录

这里需要明确两个 /assets 目录概念

  • 小程序开发时目录结构中的 /assets 目录
  • 小程序文件系统 /assets 目录

两者存在非常紧密的联系,直接看一个例子。

下图是小程序开发时目录结构中的 /assets 目录

.
assets
├── gtr-3
│ ├── icon.png
│ └── image
│ └── logo.png
├── gtr-3-pro
│ ├── icon.png
│ └── image
│ └── logo.png
└── gts-3
│ ├── icon.png
│ └── image
│ └── logo.png
└── raw
└── data.txt

小程序编译构建完之后,小程序文件系统 /assets 目录就对应如下。

.
assets
├── icon.png
└── image
│ └── logo.png
└── raw
└── data.txt

相关 assets 目录操作的 API 路径参照上图写即可,比如需要访问 raw/data.txt

page.js
Page({
build() {
const fileId = hmFS.open_asset('raw/data.txt', hmFS.O_RDONLY)
}
})
提示

/raw 是一个约定的目录名,/raw 目录在编译打包的时候会复制到 /assets 目录下

文件系统 API 说明

警告

所有文件系统 API 都需要在 App 或者 Page 的生命周期内调用,否则会出现错误

错误代码

错误代码说明
0操作成功
-1磁盘错误
-2内部错误
-3磁盘错误
-4无法找到路径
-5无法找到路径
-6路径格式不正确
-7无访问权限
-8无访问权限
-9无效的文件句柄
-10磁盘写入保护
-11磁盘错误
-12磁盘空间不足
-13磁盘空间不足
-14执行失败
-15无访问权限
-16磁盘错误
-17同时打开过多文件
-18传入参数无效