Skip to content

存储 ​

文件系统是 OpenPaaS 提供的一套以小游戏和用户维度隔离的存储以及一套相应的管理接口。通过 sud.getFileSystemManager() 可获取全局唯一文件管理器, 所有文件系统的管理操作都需要通过管理器。

文件主要分为两大类:

  • 代码包: 代码包文件指的是在项目目录中添加的文件。
  • 本地文件: 通过调用接口本地产生,或通过网络下载后存储到本地的文件。

其中本地文件又分成:

  • 本地临时文件

  • 本地缓存文件

代码包文件 ​

由于代码包文件大小限制,代码包文件适用于放置首次加载时需要的文件,对于内容较大或需要动态替换的文件,不推荐用添加到代码包中,推荐在小游戏启动之后再用下载接口下载到本地。

访问代码包文件 ​

代码包文件的访问方式是从项目根目录开始写文件路径,不支持相对路径的写法。

修改代码包文件 ​

代码包内的文件无法在运行后动态修改或删除,修改代码包文件需要重新发布版本。

本地文件 ​

本地文件指的是小游戏被用户添加到手机后,会有一块独立的文件存储区域,以用户维度隔离。即同一台手机,每个用户不能访问到其他登录用户的文件,同一个用户不同 appId 之间的文件也不能互相访问。

本地临时文件 ​

本地临时文件只能通过调用特定接口产生,不能直接写入内容。本地临时文件产生后,仅在当前生命周期内有效,重启之后即不可用。因此,不可把本地临时文件路径存储起来下次使用。如果需要下次在使用,可通过FileSystemManager.saveFile 或 FileSystemManager.copyFile 接口把本地临时文件转换成本地缓存文件或本地用户文件。

本地缓存文件 ​

本地缓存文件只能通过调用特定接口产生,不能直接写入内容。本地缓存文件产生后,重启之后仍可用。本地缓存文件只能通过 FileSystemManager.saveFile 接口将本地临时文件保存获得。

本地缓存文件修改 ​

开发者可以通过 FileSystemManager.readFile 和 FileSystemManager.writeFile 对本地文件进行修改。

详见 客户端API