小程序跳转 -凯发app官方网站

更新时间：2022-12-21 10:47:04

贡献者

我的文档

设置

简介

小程序跳转可以拆分为3种行为，即外部跳转小程序、小程序内部页面之间跳转、小程序内部跳转到外部。

外部跳转小程序

外部跳转小程序场景有很多种，详情可查看下方说明。

二维码跳转小程序

二维码跳转小程序分为

小程序码

与

关联普通二维码

。

小程序二维码

适用场景

●

支付宝凯发k8官方网娱乐官方首页扫一扫跳转小程序。

●

二维码链接跳转小程序

（其它app/浏览器、h5 页面，支付宝端内等都可以使用）。

参数获取

app.js 中 onlaunch/onshow 启动函数：options.query.key 获取（注意做

热启动和冷启动

兼容处理）。

示例代码

app({

onlaunch(options) {

my.alert({

content: '启动参数：'json.stringify(options.query.key),

});

console.log('query', options.query);

console.log('app launch', options);

onshow() {

console.log('app show')

}})

普通关联二维码

适用场景

只能通过支付宝凯发k8官方网娱乐官方首页扫一扫跳转小程序。

参数获取

app.js 中 onlaunch/onshow 启动函数：options.query.qrcode 获取（注意做热启动和冷启动兼容处理）。

示例代码

支付宝 url scheme 跳转小程序

具体拼接和参数入参/获取可查看

如何跳转小程序

（启动参数获取和二维码一致，注意做热启动和冷启动兼容处理）。

适用场景

●

h5页面跳转小程序

●

生活号场景如何跳转小程序

●

支付宝卡包跳转小程序

●

其它app/浏览器跳转小程序

（适用于钉钉、高德、淘宝、其它三方可跳转app、浏览器等）

●

商家会员卡跳转小程序

获取参数示例（与小程序二维码相同）

小程序跳转小程序

小程序跳转小程序使用

my.navigatetominiprogram

。

适用场景

●

同主体其它小程序跳转小程序：同主体小程序可直接互跳，无需任何设置。支付宝客户端10.1.10及以上版本支持。

●

其它主体小程序跳转小程序：需对方登录支付宝开放平台在小程序详情页 >

开发服务

开发设置

基础设置

小程序相互跳转

中设置为

允许所有小程序跳转

或

指定小程序跳转

。支付宝客户端10.1.25及以上版本支持。

参数获取

在目标小程序的 app.onlaunch()/app.onshow() 启动参数 extradata 中获取数据（注意做

热启动和冷启动

兼容处理）。

获取示例

其它场景跳转小程序

模板消息跳转小程序

带参

详情可查看

模板消息跳转小程序带参

。

获取参数

由于模板消息的参数是拼接在 path 后面传入，获取参数和小程序页面之间跳转带参一致，在对应页面 page.onload(query) 启动函数 query 中获取。

获取示例代码

分享链接跳转小程序

具体接入使用可查看

小程序自定义分享

，这里只说明带参和获取参数。

注意

：如果分享的页面依赖上一页跳转时传递的参数做逻辑运算展示，通过分享链接进入该页面需要自行在自定义分享入参中去拼接该参数，否则分享链接不会带上该参数。

带参

可以在 onshareappmessage 的 path 路径参数后拼接自定义参数（参数传递遵循 http get 的传参规则），如：pages/index/index?key1=value1

获取参数

path 中的自定义参数可在小程序生命周期的 page.onload(query) 方法中获取，path 路径里不能带根目录 /。

获取示例代码

如何测试跳转未上架小程序版本

注意

：普通关联二维码测试需要先发布配置规则，使用规则自行生成二维码来测试跳转（不要使用配置时的第二步测试二维码测试）。

小程序内部页面之间跳转

小程序内页面之间跳转，小程序提供了路由 api 供开发者根据自己的场景选择对应的路由 api，路由 api 具体使用可查看凯发app官方网站官网 api 文档，这里只说明带参和获取参数。小程序路由 api 带参和获取参数方式一致。

带参

在 url 入参路径后拼接参数，如：url:"page/index/index?key1=value1&key2=value2"。

获取参数

在对应跳转页面的 page.onload(query) 启动函数中 query 获取。

获取示例代码

小程序页面路由 api 支持带参跳转情况

路由api	是否支持带参
my.switchtab	不支持
my.relaunch	支持
my.redirectto	支持
my.navigateto	支持
my.navigateback	不支持

常用场景中可用路由api

●

普通页面之间跳转：my.navigateto、my.redirectto、my.relaunch、my.navigateback。

●

tab 页面跳转普通页面：my.navigateto、my.redirectto、my.relaunch、my.navigateback。

●

tab 页面跳转 tab 页面：my.switchtab。

●

普通页面跳转 tab 页面：my.switchtab。

●

小程序页面跳转 web-view 内嵌页面（根据具体跳转的小程序页面选择）：my.navigateto、my.redirectto、my.relaunch、my.navigateback、my.switchtab。

●

web-view

内嵌页面跳转小程序页面（内嵌页面跳转小程序页面也是用的小程序路由 api，根据具体跳转的小程序页面选择）：my.navigateto、my.redirectto、my.relaunch、my.navigateback、my.switchtab。

注意

：小程序规定最多不能超过 10 层页面栈，建议通过

getcurrentpages

方法判断页面栈峰值，超过后用重定向跳转页面。

小程序内部跳转小程序外部

小程序对外跳有限制条件，以下为具体条件说明。

支持外跳

●

小程序

web-view

内嵌式跳转 h5 页面，不能真正跳出小程序环境。

带参：可以在 url 后拼接参数和 get 方式一致（参数传递遵循 http get 的传参规则），如

https://www.baidu.com?key1=value1

。

●

小程序支持通过

关注生活号

组件关注并跳转生活号（不可带参）。

●

小程序支持跳转以

https://render.alipay.com/p

域名开头的生活号文章/部分支付宝官方业务页面或者通过固定 appcode 值跳转对应支付宝端页面，详情可查看

my.ap.navigatetoalipaypage

。

●

小程序支持跳转支付宝卡包/商家会员卡，可使用以下接口：

接口名称	接口描述
my.opencardlist	打开支付宝卡包中的“卡”列表
my.openmerchantcardlist	打开当前用户领取某个商家的“卡”列表
my.opencarddetail	打开当前用户领取某张卡的详情页
my.openvoucherlist	打开支付宝卡包中的“券”列表
my.openmerchantvoucherlist	打开当前用户领取某个商户的“券”列表
my.openvoucherdetail	打开当前用户领取某张券的详情页（非口碑券）
my.openkbvoucherdetail	打开当前用户领取某张券的详情页（口碑券）
my.openticketlist	打开支付宝卡包中的“票”列表
my.openmerchantticketlist	打开当前用户领取某个商家的“票”列表
my.openticketdetail	打开当前用户领取某张票的详情页

●

外跳其它小程序。可查看上文

外部跳转小程序-小程序跳转小程序

。

不支持外跳

●

小程序不支持外跳其它 app。

●

小程序不支持跳转 appstore。

相关问题