wx.miniapp.launchMiniProgram

WARNING

请注意，当前域名 https://dev.weixin.qq.com/docs/framework 文档已不维护，请前往微信文档中心 找到对应的新文档继续使用

App 拉起微信小程序

接入前注意事项

• 该能力依赖微信 Open SDK，需按照指引在微信开放平台创建移动应用账号，以完成相关初始化配置，详情可查看微信移动应用能力初始化指引

参数

对齐微信 opensdk 跳转小程序参数，方便理解

属性	类型	默认值	必填	说明
userName	string		是	小程序原始ID，如 gh_d43f693ca31f，点击查看获取方式
path	string	默认拉起小程序首页	否	拉起小程序页面的可带参路径，如：传入 "?foo=bar"。
miniprogramType	number	默认为正式版	否	可选打开 0-正式版，1-开发版，2-体验版
success	function		是	获取后成功回调

JSAPI 代码例子

// login
 wx.miniapp.launchMiniProgram({
            userName: 'gh_d43f693ca31f', //小程序原始ID
            path: 'originfiles/pages/miniapp/miniapp?action=login',
            miniprogramType: 2, //0 release ，1 test, 2 preview
            success: (res) => {
                wx.showModal({
                    content: res.data,
                })
                console.log('get wx phonenumber success:', res)
            }
        })

微信小程序返回App

开发者可以使用button标签跳转回App。

注意：安卓的情况下, 当 SDK 1.2.17 版本以下的情况下，开发者需要在app-parameter携带App的信息才能正常返回多端App，细节如下。iOS不需要。

多端App在唤起微信小程序的时候，会携带App相关的信息，开发者可以在页面的onLoad函数的参数中获取到。

获取的信息需要在button标签的app-parameter中给回App。同时可以带上开发者自己希望返回的信息。

安卓 App 如果未做上述操作，可能会出现报错：sendOpenReq failed:fail opensdk failed 并没有通过微信返回多端App。

onLoad(res) {  
    // Page对应onLoad函数中获取App带过来的信息
    transitiveData = res;

    // App带过来的信息需要将transitiveData作为key，同时可以在data带上开发者自己的数据。
    const data = {
        data: "MsgBackToApp",
        transitiveData
    };

    // 将需要的信息设置到data中，让button标签可以获取到
    this.setData({
        dataStr: JSON.stringify(data)
    });
}

<button open-type="launchApp" app-parameter="{{dataStr}}" bindtap="tap">
返回App
</button>