微信小程序跳转小程序 wx.navigateToMiniProgram

最新推荐文章于 2025-06-11 08:48:42 发布

-013-

最新推荐文章于 2025-06-11 08:48:42 发布

阅读量1.5w

点赞数 6

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/weixin_41316824/article/details/85340844

本文详细介绍了微信小程序中跳转至其他小程序的功能限制及配置方法。从特定版本开始，开发者需在代码中声明不超过10个可跳转的小程序名单，此名单不可动态修改，且需在审核前确定。文章还提供了如何在game.json文件中进行配置的示例，以及调用跳转接口的参数说明。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

每个小程序可跳转的其他小程序数量限制为不超过 10 个

从 2.4.0 版本以及指定日期（具体待定）开始，开发者提交新版小程序代码时，如使用了跳转其他小程序功能，则需要在代码配置中声明将要跳转的小程序名单，限定不超过 10 个，否则将无法通过审核。该名单可在发布新版时更新，不支持动态修改。配置方法如下：

小程序根目录下的 game.json 文件用来对微信小程序进行全局配置

 "navigateToMiniProgramAppIdList": ["wxcccccccccccc","wxcccccccccccc","wxcccccccccccc"]

调用此接口时，所跳转的 appId 必须在配置列表中，否则回调 fail appId "${appId}" is not in navigateToMiniProgramAppIdList。

要注意这个参数 envVersion ( "develop" 开发板 "trial" 体验版 "release" 正式版)

    // 小程序跳转
    /*
    * appId	string		是	要打开的小程序 appId	
    * path	string		否	打开的页面路径，如果为空则打开首页	
    * extraData	object		否	需要传递给目标小程序的数据，目标小程序可在 App.onLaunch，App.onShow 中获取到这份数据。	
    * envVersion	string	release	否	要打开的小程序版本。仅在当前小程序为开发版或体验版时此参数有效。如果当前小程序是正式版，则打开的小程序必定是正式版。  (develop 开发板 trial 体验版 release正式版)	
    * success	function		否	接口调用成功的回调函数	
    * fail	function		否	接口调用失败的回调函数	
    * complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
    */
    navigateToMiniProgram(mAppId)
    {
        wx.navigateToMiniProgram({
            appId: mAppId,
            path: 'page/index/index?id=123',
            extraData: {
              foo: 'bar'
            },
            envVersion: 'release',
            success(res) {
              // 打开成功
              ret_handler(res);
            },
            fail(res) {
            }
          })
    },