在App中打开小程序的功能发布有一段时间了,网上关于这个的新闻很多,但是技术资料并不多,我们有项目需要尝试这种方式,特意试了一下,发现还是有一些坑,分享给大家。
首先微信官方文档在微信.开放平台上,截图如下:
一. 开发前先得做好几个准备工作:
-
在微信开放平台上有账号而且有通过的移动应用。
-
在微信公众平台有账号而且有小程序,最好发布为体验版本
在微信开放平台把对应的移动应用和小程序建立关联。这个过程来回需要登陆和扫二维码n次。
二. 在android和ios调试官方sample打开小程序
注意官方下载的sample配置的证书和bundle id必须和在微信开放平台对应的移动应用使用的一致。
打开小程序的核心代码不多,里面有几个参数必须设置正确
String appId = "wxd930ea5d5a258f4f"; // 填应用AppId
IWXAPI api = WXAPIFactory.createWXAPI(context, appId);
WXLaunchMiniProgram.Req req = new WXLaunchMiniProgram.Req();
req.userName = "gh_d43f693ca31f"; // 填小程序原始id
req.path = path; //拉起小程序页面的可带参路径,不填默认拉起小程序首页
req.miniprogramType = WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE;// 可选打开 开发版,体验版和正式版
api.sendReq(req);
上面几个参数再详细说一下:
- appId指的是微信开放平台对应移动应用的appId,而不是小程序的appId,这里注意
-
userName是微信公众平台里小程序的原始Id,是gh开头的。
- req.path就是打开小程序的路径,传递参数就是通过这个来传递,但是文档上并没有说,试出来的。
req.path="page/index?key1=xxx&key2=yyy";//类似http的url方法来传递参数
*req.miniprogramType选的是开发和体验版本,正式版本的小程序没有测试过。
ios和android类似,不再细说。
3. 在小程序端接受App传递过来的参数
上面的App打开的path是'path/index',所以需要把App的onLaunch事件定义在page/index.js上
这里的options.scene是1069,这个场景id表示从app打开。
options.query.key1和options.query.key2就是app打开小程序传递的参数。
4. 关闭小程序回到App并传递数据
//小程序端通过navigateBackApplication来关闭
f1: function (e) {
wx.navigateBackApplication({
"extraData":"传递到app的数据"
})
}
其中navigateBackApplication是一个新的函数,在微信小程序的API和IDE的自动提示里都没有。
Android和iOS通过一个回调函数来接受这个参数:
public void onResp(BaseResp resp) {
if (resp.getType() == ConstantsAPI.COMMAND_LAUNCH_WX_MINIPROGRAM) {
WXLaunchMiniProgram.Resp launchMiniProResp = (WXLaunchMiniProgram.Resp) resp;
String extraData =launchMiniProResp.extMsg; // 对应JsApi navigateBackApplication中的extraData字段数据
}
}
这里有一个坑,应该是bug或许后期微信会解决。就是Android接受的参数必须是一个js对象,ios接受的参数是一个字符串。
也就是在小程序端现在必须这么写:
//小程序端通过navigateBackApplication来关闭
f1: function (e) {
if(在android下){//wx.getSystemInfo
wx.navigateBackApplication({
"extraData":{key:"传递到app的数据"}
})
else{
wx.navigateBackApplication({
"extraData":"传递到app的数据"
})
}
}
大概过程就是这样,能在app里打开小程序而且还能传递参数这个功能还是非常有用的,小程序和app很多共通的功能可以只实现一套小程序就可以了。
AppWorker官方已经在do_TencentWX 组件集成了这个功能,可以跨平台使用这个功能。