发布时间:2023-05-14 文章分类:WEB开发, 电脑百科 投稿人:赵颖 字号: 默认 | | 超大 打印

前言

最近接到项目新需求,H5项目需要内嵌到微信小程序和APP里,然后将H5页面分享出去,被分享的人可以点击消息跳转到H5页面。H5页面不难,难的是要与微信小程序和APP进行交互,因为以前也没有接触过,所以这里卡的时间有点长。现分享出来

小程序内嵌H5页面

介绍

这里小编使用的是 uinapp 写的H5项目!!!
H5页面放入小程序中,需要使用小程序的一个组件 web-view
微信官方文档
官方文档中有详细介绍,H5页面主要需要的API为 相关接口1H5页面内嵌到微信小程序和APP,做分享操作

准备工作

其中 wx.miniProgram.postMessage 这个API就是H5做分享功能的主要的接口,在使用它之前还要下载 JSSDK ,这个 JSSDK.js文件 在官方文档中可以下载,然后放到你的项目中引入使用。
还可以使用 npm 下载: 用 npm install weixin-js-sdknpm install weixin-jsapi

正式开发

// 判断是否是微信环境
export function isWx() {
	return /MicroMessenger/i.test(window.navigator.userAgent)
}

引入

使用 npm 下载的,在项目的 main.js 文件中引入 jssdk ,这样就能在项目中全局使用:
H5页面内嵌到微信小程序和APP,做分享操作
官方文档中下载的,在需要使用 jssdk 的页面中引入使用:
H5页面内嵌到微信小程序和APP,做分享操作

页面使用

单页面引入jssdk的使用:

if(this.flagWeChat){ //判断是否为微信环境
	//提前发送消息给小程序,初始化分享参数
	let infoList = {
		type:"share",//H5消息的消息类型
		messageData:{
			shareTitle:"@你....!",//分享标题
			shareImageUrl: "",//分享截图(小程序可以截当前分享页面图,当然也可以使用传过去的图)
			sharePathUrl:"/pages/web-view/main",//分享小程序页面(如需要参数则此地址需要拼接,注意这里的参数有长度限制)
		}
	};
	wx.miniProgram.postMessage({data:infoList});//必须使用 {data:infoList} 格式
}else{
	console.log('分享时不在小程序里')
}
注意:这里的 infoList 里面所需参数名称皆为小程序那边的开发人员所规定的

main.js 全局引入的使用:

if(this.flagWeChat){ //判断是否为微信环境
	//提前发送消息给小程序,初始化分享参数
	let infoList = {
		type:"share",//H5消息的消息类型
		messageData:{
			shareTitle:"@你.....",//分享标题
			shareImageUrl: "",//分享截图
			sharePathUrl:"/pages/web-view/main", //分享小程序页面
		}
	};
	this.wx.miniProgram.postMessage({data:infoList})
}else{
	console.log('分享时不在小程序里')
}
注意:h5能做的就是发送这一条消息给小程序,具体的分享还是要通过小程序头部自带的3个点

ps:这里的分享主要是小程序分享给微信好友的分享,发送给微信好友时会以消息卡片的形式分享出去。

APP内嵌H5页面

介绍

在 APP 里内嵌H5页面,h5页面需要使用app定义的方法,首先需要app开发者把h5需要使用的方法公开到 window 中,这样h5才能使用。有的是需要引入js文件或是其他东西,这需要与app开发者协商。

正式开发

// 判断当前运行环境 ios,安卓
export function myProgramEnv() {
	if(/Android/i.test(window.navigator.userAgent)) {
		return 'android'
	}
	if(/ipad|iphone/i.test(window.navigator.userAgent)) {
		return 'ios'
	}
}

页面使用

let shareInfo = {
	shareScene:"friends", //分享场景,friends代表微信好友
	shareType:"miniProgram",//消息类型,miniProgram代表分享小程序
	title:"@你.....",//分享标题
	desc:"....",//分享描述
	imageData: "",//图片地址
	link:"",//分享小程序页面,此地址需要拼接,如:/pages/web-view/main?webViewData={linkUrl="xxxxx",isLoginNeeded=true,navigationTitle="xxxxxx"},其中 "linkUrl":"xxxxxx",//分享H5链接;"isLoginNeeded":false,//是否需要账号信息"navigationTitle","xxxx",目标页面标题,可不传
	webPageUrl:""//网页地址,值与linkUrl值相同,主要用于兼容
}
// wechatShare是app提供的方法,我们只要在需要的地方调用就好
if(this.flagSystemAPP == "android"){
	try {						
		// 安卓
		//MoveCallNative 为安卓开发人员规定的名称,如若未特别规定则使用 window.android......
		window.MoveCallNative.wechatShare(
			JSON.stringify(shareInfo)
		)
	} catch (e) {
		console.log('android分享错误--',e)
	}
}else if(this.flagSystemAPP == "ios"){ //ios
	try {					
		// ios
		window.webkit.messageHandlers.wechatShare.postMessage(
			JSON.stringify(shareInfo)						
		);
	} catch (e) {
		console.log('ios分享错误--',e)
	}
}
注意:这里的 shareInfo 里所需参数名称皆为APP开发人员所规定
	传参数时必须是字符串 JSON.stringify(shareInfo)

ps:这个分享也是分享给微信好友的分享,分享给好友时是以链接的形式分享的

H5页面

介绍

分享出去的链接或卡片最终还是会回到H5页面,所以在H5页面需要接受参数,做出相应的操作

正式开发

在 App.vue 页面接收参数,分割参数和目标页面路径

<script>
	export default {
		globalData:{  // 存放全局数据
			familyDetail: {}, // 当前登录人的家庭数据
			initPage: null, // 第一次进入页面的页面path
			mbrid: null, // 去获取用户信息的参数 
		},
		/* 程序初始化逻辑 
			1、获取用户初始化进入的相关数据,包括mid(用户身份标识),存储到全局变量
			2、判断本地有没有token,有就去对应的页面,没有则拦截到授权页面
			3、拦截前,保存第一次进入的页面地址,用于获取token后,去到该页面
		*/
		onLaunch: function(option) {
			console.log('App.vue初始化数据option---', option)		
			if(window.location.search){ //获取链接里的参数
				let parameter = window.location.search.split('mbrid=')[1].split('#')[0];
				console.log('App.vue初始化数据mbrid---', parameter);
				getApp().globalData.mbrid = parameter;  // 存储授权数据
			}else{
				console.log('路径未带参数---')
			}
			getApp().globalData.initPage = window.location.hash.substr(1); //获取链接里的页面路径
			uni.reLaunch({url: '/pages/auth/auth'}); //跳转到授权页面
			return
		},
		onShow: function() {
		},
		onHide: function() {
		},
		methods: {
		}
	}
</script>

授权页面:授权和跳转到目标页面

<script>
	/* auth页面,只做授权使用,去获取token*/
	import { http_getWeChatLogin } from '@/common/api/index.js'
	import { cache_set_token } from 'common/utils/cache.js'
	import { ENV } from 'common/utils/constant.js'
	export default{
		data() {
			return {}
		},
		onLoad(option) {
			console.log('auth.vue初始数据:getApp().globalData---:',getApp().globalData)
			if(['AY_DEV'].includes(ENV)) { //判断是否为正式环境
				this.handleGetToken('1');
			} else {
				this.handleGetToken(getApp().globalData.mbrid);//app.vue里截获的参数
			}
		},
		methods:{
			async handleGetToken(mbrid) {
				if(!mbrid) {
					console.log('mbrid没有----')
					uni.showToast({
						title: '非法闯入',
						icon: 'none'
					})
					return
				}
				const { code, data, msg } = await http_getWeChatLogin({ mbrId: mbrid }); //请求接口获取toke
				if(code == 200) {
					const { accessToken } = data
					cache_set_token(accessToken) //存储toke
					getApp().globalData.familyDetail = data; //存储家庭信息
					if(getApp().globalData.initPage.indexOf('pages/auth/auth') > -1) { //判断是否为开发打开页面
						uni.reLaunch({url: '/pages/client_side/activity/activity' }); //跳转到首页
					} else {
						uni.reLaunch({url: getApp().globalData.initPage }); //跳转到app.vue里截获的路径
					}
				} else {
					uni.showToast({
						title: msg,
						icon: 'none'
					})
				}
			} 
		}
	}
</script>

至此,整个分享过程完结