withShareTicket的设置方法

什么是withShareTicket？

withShareTicket是一个用于在小程序中获取分享卡片的配置项，通过配置该选项，可以实现在小程序中生成带有自定义内容的分享卡片，方便用户将内容分享给朋友或群聊。

如何设置withShareTicket？

1、在小程序的app.json文件中添加withShareTicket配置项：

{
  "pages": [
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle": "black"
  },
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    }, {
      "pagePath": "pages/logs/logs",
      "text": "日志"
    }]
  },
  "withShareTicket": true // 在这里添加withShareTicket配置项，并设置为true
}

2、在需要生成分享卡片的页面的js文件中，调用wx.updateAppMessageShareData方法更新分享卡片的数据：

Page({
  onShareAppMessage: function () {
    return {
      title: '自定义分享标题', // 分享卡片标题
      path: '/pages/index/index', // 分享卡片打开的页面路径，相对路径
      imageUrl: 'https://www.112.run/upload/y20241217/14fuy23r0sb.jpg', // 分享卡片的图片链接，支持网络图片和本地图片
      success: function (res) {
        // 分享成功的回调函数
      },
      fail: function (res) {
        // 分享失败的回调函数
      }
    }
  }
})

相关问题与解答

问题1：为什么设置了withShareTicket为true，但分享卡片还是没有自定义内容？

答：请确保在需要生成分享卡片的页面的js文件中，调用了wx.updateAppMessageShareData方法更新分享卡片的数据，如果没有调用该方法，即使设置了withShareTicket为true，分享卡片也不会有自定义内容。

问题2：为什么设置了withShareTicket为false，但分享卡片还是有自定义内容？

答：当设置了withShareTicket为false时，表示不使用自定义的分享卡片，如果在其他页面的js文件中调用了wx.updateAppMessageShareData方法更新了分享卡片的数据，那么在当前页面进行分享时，仍然会使用之前设置的自定义内容，如果想要完全禁用自定义分享卡片，需要在每个页面的js文件中都调用wx.updateAppMessageShareData方法，并将数据设置为空对象{}。