tencent cloud

打开小程序

PDF
聚焦模式
字号
最后更新时间: 2026-01-29 00:08:49

打开小程序

打开小程序时,会先判断本地是否有缓存的小程序,如果没有,则会自动从远程服务器上下载小程序,然后打开。如果有缓存的小程序,则会先打开本地小程序,同时后台校验服务器端是否有新版本。
说明:
如果有新版本,则下载新版小程序,下次打开时,就会使用新版小程序。
使用给定的 appId 启动小程序:
appId: 小程序 ID
选项: 此小程序的启动选项
Future<MiniAppStartResult?> startMiniAppWithId(String appId, MiniStartOptions? options)
示例代码:
_tcmppFlutterPlugin.startMiniAppWithId(appId!, null);
启动选项:
class MiniStartOptions {
/// 小程序的进入路径
String? entryPath;

/// 启动时始终更新小程序
bool? isForceUpdate;

/// 启动时传递给小程序的字符串参数
String? params;
/// 是否需要小程序启动结果
bool needResult;
}
使用给定链接启动小程序:
链接: 要启动的 uri 链接
options: 该小程序的启动选项
Future<MiniAppStartResult?> startMiniAppWithLink(String link, MiniStartOptions? options)
使用给定小程序信息启动:
AppInfo: 要启动的小程序信息
options: 该小程序的启动选项
Future<MiniAppStartResult?> startMiniAppWithAppInfo(AppInfo appInfo, MiniStartOptions? options)
示例代码:
_tcmppFlutterPlugin.startMiniAppWithAppInfo(appInfo, null);
使用扫描二维码的方式启动小程序:
Future<MiniAppStartResult?> startMiniAppByScan()

获取小程序启动结果

为了方便开发者排查问题,小程序 SDK 提供小程序启动结果的获取,可以通过 MiniStartOptions 的 needResult 进行设置,当设置为true时表示需要结果,默认为false。
class MiniAppStartResult {
/// 启动结果码
int code;
/// 启动结果信息
Map<dynamic, dynamic>? info;
}
Android端结果可参考 Android 错误码。iOS 端结果可参考 iOS 错误码


帮助和支持

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

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

文档反馈