宿主应用启动小程序时可实现如下功能

  • 支持传入参数到小程序环境，
  • 支持启动后直接打开指定页面

下面讲解一下具体实现

API 说明

iOS 平台

  1. Class DCUniMPSDKEngine
  2. /// 启动小程序
  3. + (void)openApp:(NSString *)appid
  4.       arguments:(NSDictionary * _Nullable)arguments
  5.    redirectPath:(NSString * _Nullable)redirectPath;
参数类型说明
appidNSString小程序的 appid
argumentsNSDictionary启动小程序传入的参数
redirectPathNSString指定启动应用后直接打开的页面路径

Android 平台

  1. // 启动小程序
  2. DCUniMPSDK.getInstance().startApp(context, appid, splashClass, redirectPath, arguments)
参数类型必填说明
contextContext是上下文
appidString是小程序的 appid
splashClassIDCUniMPAppSplashView否自定义splashView接口类
redirectPathString否指定启动应用后直接打开的页面路径
argumentsJSONObject否启动小程序传入的参数

Tips

Android startApp详细说明可参考uni小程序SDK API参考手册

启动小程序并传参

宿主启动小程序时支持传入参数到小程序环境，小程序中可以通过 plus.runtime.arguments 获取宿主传入的参数

iOS 示例

  1. // 启动小程序并传入参数
  2. NSDictionary *arguments = @{@"value":@"Hello uni microprogram"};
  3. [DCUniMPSDKEngine openApp:appid arguments:arguments];

Android 示例

  1. // 启动小程序并传入参数 "Hello uni microprogram"
  2. try {
  3.     JSONObject arguments = new JSONObject();
  4.     arguments.put("MSG","Hello uni microprogram");
  5.     DCUniMPSDK.getInstance().startApp(context, "__UNI__04E3A11", arguments);
  6. } catch (Exception e) {
  7.     e.printStackTrace();
  8. }

小程序中获取参数

  1. var arguments = plus.runtime.arguments;

启动打开指定页面

宿主启动小程序时可通过传入页面路径来打开指定页面

页面路径格式要求

路径从 pages/ 开始填写绝对路径并支持参数 示例：

  1. pages/component/view/view?action=redirect

iOS 示例

  1. // 启动直达页面
  2. NSString *pagePath = @"pages/component/view/view?action=redirect";
  3. [DCUniMPSDKEngine openApp:k_AppId arguments:nil redirectPath:pagePaht];

Android 示例

  1. // 启动直达页面
  2. DCUniMPSDK.getInstance().startApp(context,"__UNI__04E3A11", "pages/component/view/view?action=redirect");

屏蔽返回

直达二级页面如果您想屏蔽返回按钮及返回手势，可以在小程序页面的 onLoad() 方法中获取当前页面调用 setStyle() 方法实现，代码如下

Tips

onLoad(e){} 方法的参数e即为直达页面时传入的参数比如pages/component/view/view?action=redirect，框架会自动将参数转换成 jsonObject 类型 {“action”:”redirect”}

  1. // 启动直达二级页面屏蔽返回手势及返回按钮
  2. <script>
  3.     export default {
  4.         onLoad(e) {
  5.             // #ifdef APP-PLUS
  6.             // 判断是否为启动直达页面
  7.             if (e.action === "redirect") {
  8.                 const currentWebview = this.$scope.$getAppWebview();
  9.                 currentWebview.setStyle({
  10.                     popGesture: 'none', // 取消手势返回
  11.                     titleNView: { 
  12.                         autoBackButton: false // 取消默认返回按钮
  13.                     }
  14.                 })
  15.             }
  16.             // #endif
  17.         }
  18.     }
  19. </script>

发现错误？想参与编辑？在 GitHub 上编辑此页面！