tencent cloud

腾讯云超级应用服务

文档腾讯云超级应用服务代码接入指引FlutterFlutter API小程序文件管理

小程序文件管理

PDF
聚焦模式
字号
最后更新时间： 2026-01-29 09:32:31
通过小程序文件管理 API，可以实现小程序的文件路径和 superapp 本地文件路径的转换及路径创建。
说明：
小程序文件路径：以 wxfile:// 开头的小程序开发者使用路径，是一个路径标识符号，每一个以 wxfile:// 开头的路径都会被小程序 SDK 映射到一个 superapp 内的本地文件路径。
Superapp 本地文件路径：superapp 在设备存储中的绝对路径，如：/data/data/com.tencent.miniapp.demo/app_T1701421723ASSNID/2121/files/mini/。

在小程序临时目录创建文件

SDK 支持原生在小程序的缓存目录创建文件，然后返回文件的本地路径，以供 superapp 使用。
appId： 小程序 appid
appVerType：小程序类型
suffix：文件类型后缀
Future<String?> getTmpPath(String miniAppId, int appVerType, String suffix)
示例代码：
Future<String?> getTmpPath(appId, appVerType, 'jpg')

绝对路径转换成 wxfile 路径

SDK 支持原生在小程序的缓存目录中创建的文件路径，转换成小程序使用的文件路径返回，供小程序内部使用。
appId： 小程序 appid
appVerType：小程序类型
path：文件真实路径
Future<String?> getWxFilePath(String miniAppId, int appVerType, String path)
示例代码：
_tcmppFlutterPlugin.getWxFilePath(appId, appVerType, path)

wxfile 路径转换为绝对路径

SDK 支持将缓存目录中的 wxfile 路径转换为本地完整路径，供 superapp 使用。
appId： 小程序 appid
appVerType：小程序类型
path：wxfile文件路径
Future<String?> getAbsolutePath(String miniAppId, int appVerType, String path)
示例代码：
_tcmppFlutterPlugin.getAbsolutePath(appId, appVerType, path)
上一篇: SDK 集成常见问题下一篇: 缓存管理

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈