UNI-APP/VUE 项目集成 微信SDK /微信开放标签 教程和避坑指南(下)——微信开放标签篇

28 篇文章 7 订阅
22 篇文章 7 订阅

UNI-APP/VUE 项目集成 微信开放标签 教程和避坑指南

文章同步发布于🚀前端知识营地,移动端用户可通过🐱‍🏍手机端查看以获得更佳的阅读体验和排版效果

前言

上一篇文章里详细介绍了UNI-APP/VUE项目如何集成微信的SDK,如果有需要在UNI-APP集成微信SDK的朋友,可以点击下方链接访问。

使用微信开放标签的前提条件

由于微信各方面要求严格,因此在开发前需要自检自己是否具备集成微信SDK/微信开放标签的先决条件。根据本人的开发经历,在开发集成之前需要具备的先行条件如下:

  1. 拥有自己的服务器

主要是用于安全认证和绑定JS接口安全域名

  1. 已经完成认证的微信服务号,以便使用开放标签

如果仅集成SDK,根据官方文档说明,好像微信公众号也可以,具体是否可行,有待读者验证

  1. 良好的心态

嗯!微信的文档你懂的,以及微信各种出于安全的限制让开发调试异常麻烦,因此一个良好的心态异常重要

  1. 满足微信官方的配置要求

微信开放标签有最低的微信版本要求,以及最低的系统版本要求。
微信版本要求为:7.0.12及以上。 系统版本要求为:iOS 10.3及以上、Android 5.0及以上。

  • 以上条件若有不满足的,请出门右拐

如何使用微信的开放标签

结合微信开发文档的说明和使用案列,根据提示在VUE项目中使用微信开放标签应当避免<template>标签冲突,需要使用<script type="text/wxtag-template"></script>【这里注意下,官方文档里<script>标签没有闭合,需要改正】进行代替。也就是在VUE项目中微信开放标签的使用案列如下:

<wx-open-launch-weapp
  id="launch-btn"
  username="gh_xxxxxxxx"
  path="pages/home/index.html?user=123&action=abc"
>
  <script type="text/wxtag-template">
    <style>.btn { padding: 12px }</style>
    <button class="btn">打开小程序</button>
  </script>
</wx-open-launch-weapp>
  • 相关说明
参数说明
username小程序原始id,即gh_xx格式。而非小程序appid,注意区分
path指定跳转到小程序具体页面的页面路径,必须以.html结尾 。不指定则跳转到小程序主页,初次指定建议不要填写,先保证开放标签接入成功

VUE页面中使用开放标签案列

<template>
  <view>
	  <wx-open-launch-weapp
		id="launch-btn"
		username="gh_your_gh_id"
		path=""
	 >
		<script type="text/wxtag-template">
			<style>.btn { padding: 12px }</style>
			<u-button type="primary">主要按钮</u-button>
		</script>
	</wx-open-launch-weapp> 
	<view>
	   页面中的其它内容
	</view>
  </view>
  
</template>
  • 注意事项
  1. 使用开放标签确保当前页面已经完成微信SDK集成。

微信SDK集成参考UNI-APP/VUE 项目集成微信SDK教程和避坑指南

  1. 配置微信config文件时确保明确指定了将要使用的微信开放标签。如下方openTagList:['wx-open-launch-weapp'],指定将使用跳转到小程序的开放标签。
//注入config权限配置  
    let wxConf = {
      debug: false,
      openTagList:['wx-open-launch-weapp'],  //将要使用的微信开放标签
      appId:"your_appid",
      timestamp,
      nonceStr,
      signature:res,
      jsApiList: [ //这里是需要用到的接口名称  
        'checkJsApi', //判断当前客户端版本是否支持指定JS接口  
        'updateAppMessageShareData', //分享给朋友及分享到QQ
        'updateTimelineShareData', //自定义“分享到朋友圈”及“分享到QQ空间”按钮的分享内容
        'onMenuShareTimeline', // 获取“分享到朋友圈”按钮点击状态及自定义分享内容接口(即将废弃)
        'onMenuShareAppMessage', // 获取“分享给朋友”按钮点击状态及自定义分享内容接口(即将废弃)
        'onMenuShareQQ', // 获取“分享到QQ”按钮点击状态及自定义分享内容接口(即将废弃)
        'onMenuShareQZone', // 获取“分享到QQ空间”按钮点击状态及自定义分享内容接口(即将废弃)
        'getLocation', //获取位置  
        'openLocation', //打开位置  
        'scanQRCode', //扫一扫接口  
        'chooseWXPay', //微信支付  
        'chooseImage', //拍照或从手机相册中选图接口  
        'previewImage', //预览图片接口  
        'uploadImage' //上传图片  
      ]
    };
  1. 请忽略控制台打印的Unknown custom element:<wx-open-launch-weapp>错误
    这个坑需要注意:如果通过控制台发现如下错误,请直接忽略。不要去百度解决办法什么的。
    在这里插入图片描述

  2. 必须真机调试才能看到效果

这个必须引起重视!!!必须真机调试才能看到效果。
也就是你必须将你的项目打包部署到设置了JS安全接口域名的服务器上,然后通过手机端访问,然后才能在手机上看到一个丑丑的打开小程序 的按钮。原谅我此处忘记截图了。

可能出错的点

如果按照上述配置未能成功出现打开小程序按钮,那么可能时如下几个地方有问题,请开发者自查。

  1. 是否已经成功集成了微信SDK

若成功接入微信SDK,控制台会有明显的提醒

  1. 是否在微信config配置中声明了将要使用的开放标签。
  2. 是否已经将项目打包部署到设置JS安全接口域名的服务器。

若是步骤3出现问题,则在微信开发者工具控制台会报40048错误

  1. 微信版本或者手机系统版本是否满足要求

根据前文前提条件自查

  1. 如果还有其它问题,欢迎留言讨论。

(正文完)

最近一直在作微信公众号的开发,自己也申请了一个公众号,刚开始弄,主要是分享作者从各个平台收集的前端优质文章,优质教程和工具; 以知识小报的形式周更,避免打扰! 有感兴趣的同好可以扫码关注下
🚀查看前端知识营地介绍
在这里插入图片描述

迁移微信小程序的登录功能至uni-app并保证跨平台兼容性,首先需要理解uni-app微信小程序在登录机制上的差异。微信小程序通常使用wx.login接口,而uni-app则需要根据运行环境使用uni-app提供的API或相应平台的SDK来实现登录功能。以下是迁移登录功能的步骤和注意事项: 参考资源链接:[微信小程序转uni-app:从搭建到迁移全面指南](https://wenku.csdn.net/doc/1jj79kkqcm?spm=1055.2569.3001.10343) 1. **了解登录机制差异**: - 微信小程序使用wx.login获取code,然后通过后端调用微信API换token。 - uni-app可在不同平台使用uni.getSetting获取用户授权,uni.getUserProfile获取用户信息。 2. **代码迁移**: - 将`app.js`的登录逻辑迁移到uni-app的`main.js`或`App.vue`。 - 替换微信小程序特有的`wx.login`调用,使用uni-app的登录API。 - 对于`app.wxss`的样式,调整到uni-app对应的`app.vue`或按需创建组件样式文件。 3. **页面配置转换**: - 将`app.json`转换为`pages.json`,确保页面配置正确映射。 - 根据uni-app页面配置规则调整小程序的页面配置项。 4. **兼容性测试**: - 在不同平台(如微信、支付宝、H5等)上进行登录功能的兼容性测试。 - 使用uni-app的条件编译指令`#ifdef`和`#ifndef`来处理不同平台的特有问题。 5. **环境安装与真机运行**: - 确保开发环境安装了HBuilderX或Vue CLI,并正确安装了对应的依赖包。 - 使用微信开发者工具进行真机调试,确保登录流程无误。 通过以上步骤,可以将微信小程序的登录功能迁移到uni-app项目,并确保其在不同平台上的兼容性。建议仔细阅读《微信小程序转uni-app:从搭建到迁移全面指南》以获取更详细的迁移指导和高级技巧,以助你顺利完成迁移并拓展小程序的应用场景。 参考资源链接:[微信小程序转uni-app:从搭建到迁移全面指南](https://wenku.csdn.net/doc/1jj79kkqcm?spm=1055.2569.3001.10343)
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

mingyong.g

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值