微信小程序部分功能踩坑指南

前言

开发项目时，实际遇到的一些功能需求和问题汇总。列出了当时参考的一些文章和官方文档。
开发框架：mpvue
官方文档：5分钟快速上手

小程序跳转外链

参考文章：小程序跳转到非小程序页面的外部链接地址

要跳转的链接必须是https的
需要用web-view组件，web-view组件是一个可以用来承载网页的容器，会自动铺满整个小程序页面。（个人类型与海外类型的小程序暂不支持使用。也就是说个人申请的小程序，就别想跳转了）
需要在小程序后台配置业务域名，也就是你要跳转网页地址的域名。（设置-开发设置 -业务域名）
配置业务域名时，会要求下载校验文件，该文件需要放置到访问外链地址的根目录下，可能会需要运维协助
跳转外链后，如果打开的二级页中有新的域名地址，同样需要重复上述步骤

小程序内部页面跳转

官方文档：小程序页面跳转

低版本兼容

为便于开发者解决低版本基础库无法兼容小程序的新功能的问题，开发者可设置小程序最低基础库版本要求。

开发者可以登录小程序管理后台，进入「设置 - 基本设置 - 基础库最低版本设置」进行配置。在配置前，开发者可查看近 30 天内访问当前小程序的用户所使用的基础库版本占比，以帮助开发者了解当前用户使用的情况。

官方文档：低版本兼容处理

微信小程序基础库版本与客户端版本对应关系

坑点：右上角按钮只是把小程序退到了后台，并没有关闭小程序，所以如果未做处理，下次进去还是上一次退出前的状态。不会像h5一样刷新打开页面。也没有开放销毁小程序的监听。前台、后台定义：当用户点击左上角关闭，或者按了设备 Home 键离开微信，小程序并没有直接销毁，而是进入了后台；当再次进入微信或再次打开小程序，又会从后台进入前台。

swiper 间距轮播

参考文章：微信小程序使用swiper组件实现类3D轮播图

参考文章：小程序swiper组件实现不同效果间距轮播

最后用的第二篇里面的方法三，需要用到Animation动画对象
第一篇文章里直接用css的transition，动画不流畅。

小程序swiper组件bug：

参考文章：微信小程序swiper组件卡死来回疯狂轮播

小程序引入外部字体

参考文章：小程序如何引入外部字体
用过里面的方法二

图片预览

只有图片全屏预览后，才能通过长按图片吊起菜单栏（保存图片，分享图片，收藏图片）

参考文章：图片预览

保存图片到相册

小程序保存图片到本地授权问题

// 保存图片
export function saveImg (imgurl) {
  wx.showLoading({
    title: '图片保存中...'
  })
  wx.downloadFile({
    url: imgurl,
    success: function (res) {
      // 图片保存到本地
      wx.saveImageToPhotosAlbum({
        filePath: res.tempFilePath,
        success: function (data) {
          wx.hideLoading()
          wx.showModal({
            title: '图片已存入相册',
            content: '好东西要分享，发给朋友们看看。',
            showCancel: false
          })
        },
        fail: function (err) {
          console.log(err)
          if (err.errMsg === 'saveImageToPhotosAlbum:fail:auth denied' || err.errMsg === 'saveImageToPhotosAlbum:fail auth deny' || err.errMsg === 'saveImageToPhotosAlbum:fail authorize no response') {
            // 这边微信做过调整，必须要在按钮中触发，因此需要在弹框回调中进行调用
            wx.showModal({
              title: '提示',
              content: '需要您授权保存相册',
              showCancel: false,
              success: modalSuccess => {
                wx.openSetting({
                  success (settingdata) {
                    console.log('settingdata', settingdata)
                    if (settingdata.authSetting['scope.writePhotosAlbum']) {
                      wx.showModal({
                        title: '提示',
                        content: '获取权限成功,再次点击按钮即可保存',
                        showCancel: false
                      })
                    } else {
                      wx.showModal({
                        title: '提示',
                        content: '获取权限失败，将无法保存到相册！',
                        showCancel: false
                      })
                    }
                  },
                  fail (failData) {
                    console.log('failData', failData)
                  },
                  complete (finishData) {
                    console.log('finishData', finishData)
                  }
                })
              }
            })
          }
        },
        complete (res) {
          wx.hideLoading()
        }
      })
    }
  })
}

转发小程序

1. 显示转发按钮

wx.showShareMenu(Object object)

  mounted () {
    wx.showShareMenu({
      withShareTicket: true
    })
  },

2. 自定义转发的标题、图片

onShareAppMessage(Object) 监听用户点击页面内转发按钮（<button> 组件 open-type="share"）或右上角菜单“转发”按钮的行为，并自定义转发内容。

官网文档：onShareAppMessage(Object)

mpvue中与mounted写的位置类似

  onShareAppMessage: function (options) {
    return sharehanle(options)
  },

处理设置菜单分享和按钮分享的自定义标题、图片等。

export function sharehanle (options) {
  // var that = this
  // 设置菜单中的转发按钮触发转发事件时的转发内容
  console.log(options)
  var shareObj = {
    title: '分享标题', // 默认是小程序的名称(可以写slogan等)
    path: '/pages/index/main', // 默认是当前页面，必须是以‘/’开头的完整路径
    imageUrl: '', // 自定义图片路径，可以是本地文件路径、代码包文件路径或者网络图片路径，支持PNG及JPG，不传入 imageUrl 则使用默认截图。显示图片长宽比是 5:4
    success: function (res) {
      // 转发成功之后的回调
      if (res.errMsg === 'shareAppMessage:ok') {
        console.log('分享成功')
      }
    },
    fail: function (res) {
      // 转发失败之后的回调
      if (res.errMsg === 'shareAppMessage:fail cancel') {
        // 用户取消转发
      } else if (res.errMsg === 'shareAppMessage:fail') {
        // 转发失败，其中 detail message 为详细失败信息
      }
    },
    complete: function () {
      // 转发结束之后的回调（转发成不成功都会执行）
    }
  }
  // 来自页面内的按钮的转发
  // if (options.from === 'button') {
  //   var eData = options.target.dataset
  //   console.log(eData.name) // shareBtn
  //   // 此处可以修改 shareObj 中的内容
  //   shareObj.path = '/pages/btnname/btnname?btn_name=' + eData.name
  // }
  // 返回shareObj
  return shareObj
}

export default {
  sharehanle
}

微信自带loading，提示和弹窗API

1. loading

显示
wx.showLoading({
    title: '图片保存中...'
})
隐藏
wx.hideLoading()

2. Modal

wx.showModal({
    title: '提示',
    content: '获取权限成功,再次点击按钮即可保存',
    showCancel: false
    })

3.Toast

wx.showToast({
  title: '提交成功',
  icon: 'succes',
  duration: 1000,
  mask: true
})

统计

官方文档

会用到的应该是自定义分析，也就是按钮点击等事件的统计。

其他

background-image只能用网络url或者base64.本地图片要用image标签才行。
小程序里有视频播放，审核的时候会有资质问题，需使用封装的视频插件
后台发送的模板消息，需要前端提交数据时，提供formId。详见小程序form组件
mpvue 事件的参数通过绑定是用$event传入以swiper举例

  <swiper class="sub_swiper"
    :indicator-dots="indicatorDots"
    :autoplay="autoplay"
    :interval="interval"
    :duration="duration"
    :previous-margin="previousMargin"
    :next-margin="nextMargin"
    :current ="curMovieIndex"
    <!--传入事件参数-->
    @change="handleChange($event)">
      <block v-for="(item, index) in datalist" :key="index">
          <swiper-item>
            <div class="item" :class="{'active_item': curMovieIndex === index }" :animation="index == curMovieIndex ? animationData : animationData2">
              <image class="img" :src="item.coverImg"></image>
            </div>
          </swiper-item>
      </block>
  </swiper>

    handleChange (e) {
     // 这里获取参数
      let oIndex = e.mp.detail.current
      // 修改swiper展示index
      store.commit('setCurMovieIndex', oIndex)
      this.changeActive()
      this.changeNormal()
    },