微信小程序API 打开小程序

2017-08-17

wx.navigateToMiniProgram(OBJECT)


基础库 1.3.0 开始支持,低版本需做兼容处理

iOS 微信客户端 6.5.9 版本开始支持,Android 客户端即将在 6.5.10 版本开始支持,请先使用 iOS 客户端进行调试

打开同一公众号下关联的另一个小程序。

OBJECT参数说明:

参数名类型必填说明
appIdString要打开的小程序 appId
pathString打开的页面路径,如果为空则打开首页
extraDataObject需要传递给目标小程序的数据,目标小程序可在 App.onLaunch()App.onShow()中获取到这份数据。详情
envVersionString要打开的小程序版本,有效值 develop(开发版),trial(体验版),release(正式版) ,仅在当前小程序为开发版或体验版时此参数有效;如果当前小程序是体验版或正式版,则打开的小程序必定是正式版。默认值 release
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数名类型说明
errMsgString调用结果

示例代码:

wx.navigateToMiniProgram({
  appId: '',
  path: 'pages/index/index?id=123',
  extraData: {
    foo: 'bar'
  },
  envVersion: 'develop',
  success(res) {
    // 打开成功
  }
})

Bug & Tip

  1. tip: 在开发者工具上调用此 API 并不会真实的跳转到另外的小程序,但是开发者工具会校验本次调用跳转是否成功详情
  2. tip: 开发者工具上支持被跳转的小程序处理接收参数的调试详情
  3. tip: 只有同一公众号下的关联的小程序之间才可相互跳转 详情

wx.navigateBackMiniProgram(OBJECT)


基础库 1.3.0 开始支持,低版本需做兼容处理

iOS 微信客户端 6.5.9 版本开始支持,Android 客户端即将在 6.5.10 版本开始支持,请先使用 iOS 客户端进行调试

返回到上一个小程序,只有在当前小程序是被其他小程序打开时可以调用成功

OBJECT参数说明:

参数名类型必填说明
extraDataObject需要返回给上一个小程序的数据,上一个小程序可在App.onShow()中获取到这份数据。详情
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数名类型说明
errMsgString调用结果

示例代码:

wx.navigateBackMiniProgram({
  extraData: {
    foo: 'bar'
  },
  success(res) {
    // 返回成功
  }
})