uni-app--》如何制作一个APP并使用?

Posted 亦世凡华、

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了uni-app--》如何制作一个APP并使用?相关的知识,希望对你有一定的参考价值。

🏍️作者简介:大家好,我是亦世凡华、渴望知识储备自己的一名在校大学生

🛵个人主页:亦世凡华、

🛺系列专栏:uni-app

🚲座右铭:人生亦可燃烧,亦可腐败,我愿燃烧,耗尽所有光芒。

👀引言

        ⚓经过web前端的学习,相信大家对于前端开发有了一定深入的了解,今天我开设了uni-app专栏,主要想从移动端开发方向进一步发展,而对于我来说写移动端博文的第二站就是uni-app开发,希望看到我文章的朋友能对你有所帮助。

目录

项目搭建

配置tabBar路由

设置基础内容

导航栏点击样式设置

新闻详情页布局

新闻列表数据的详细展示

实现上拉触底效果

获取参数并跳转到详情页

项目的打包上线

项目开源Github


项目搭建

今天实现一个简单的新闻列表的小案例,并制作成一个APP在手机上下载使用,项目很简单,仅仅就只需要有两个路由来实现:index和user。如果第一次接触uni-app的话,欢迎订阅一下本专栏,学习里面的文章,项目的实现原理基本可以搞懂,废话不多说,直接上手操作。

配置tabBar路由

因为仅有两个路由,所有在pages页面新建页面时,会自动生成配置路径,只要自己设置导航栏的标题即可,如下:

接下来需要对导航栏的标题颜色进行设置,这里我就设置在全局样式里面了,如果你对某一个页面需要指定特别的样式,可以在当前页面的路径的pages里单独设置颜色来覆盖全局样式,这里不再赘述,如下:

设置好导航栏的样式之后,便可以着手配置tabBar的相关样式设置了,这里的话可以设置一个点击的图表,图表可以自己在阿里云的字体图标库进行寻找,地址:iconfont-阿里巴巴矢量图标库

选择自己喜欢的图表样式,将图片下载下来即可,然后导入到本地中进行引入即可:

设置基础内容

接下来实现新闻列表的基础内容,如下:

<template>
	<view>
		<scroll-view scroll-x class="navscroll">
			<view class="item">国内</view>
			<view class="item">国内</view>
			<view class="item">国内</view>
			<view class="item">国内</view>
			<view class="item">国内</view>
			<view class="item">国内</view>
			<view class="item">国内</view>
			<view class="item">国内</view>
		</scroll-view>
		<view class="connent">
			<view class="row" v-for="item in 10">
				数据
			</view>
		</view>
	</view>
</template>

<script>
	export default 
		data() 
			return 
				title: 'Hello'
			
		,
		onLoad() 

		,
		methods: 

		
	
</script>

<style lang="scss" scoped>
.navscroll
	height: 100rpx;
	background: #F7F8FA;
	white-space: nowrap;
	// 去掉H5端的滚动条
	/deep/ ::-webkit-scrollbar 
		width: 4px !important;
		height: 1px !important;
		overflow: auto !important;
		background: transparent !important;
		-webkit-appearance: auto !important;
		display: block;
	
	.item
		font-size: 40rpx;
		display: inline-block;
		line-height: 100rpx;
		padding: 0 30rpx;

	


.connent 
	padding: 30rpx;
	.row
		border: 1px dotted #efefef;
		padding: 15rpx 0;
	

</style>

接下来实现浏览历史的基础内容,如下:

<template>
	<view class="user">
		<view class="top">
			<image src="../../static/logo.png" mode=""></image>
			<text>浏览历史</text>
		</view>
		<view class="connent">
    		数据
		</view>
	</view>
</template>

<script>
	export default 
		data() 
			return 
				
			;
		
	
</script>

<style lang="scss">
.user
	.top
		padding: 50rpx 0;
		background: #F8F8F8;
		color: #555;
		display: flex;
		flex-direction: column;
		justify-content: center;
		align-items: center;
		image
			width: 150rpx;
			height: 150rpx;
		
		.text
			font-size: 38rpx;
			padding-top: 20rpx;
		
	
	.connent 
		padding: 30rpx;
		.row
			border: 1px dotted #efefef;
			padding: 15rpx 0;
		
	

</style>

因为新闻列表界面和浏览历史界面都需要一些相同的数据,这里的话就可以将要展现的数据单独放在一个components组件里面进行一些数据的共享,通过设置一个props对象,将相关要展示的界面内容通过父组件传递过来的props数据进行相关展示,如下:

<template>
	<view class="newsbox">
		<view class="pic">
			<image :src="item.picurl" mode="aspectFill"></image>
		</view>
		<view class="text">
			<view class="title">item.title</view>
			<view class="info" v-if="!item.looktime">
				<text>作者:item.author</text>
				<text>item.hits浏览</text>
			</view>
			<view class="info" v-else>
				<text>浏览时间:item.looktime</text>
			</view>
		</view>
	</view>
</template>

<script>
	export default 
		name:"newsbox",
		props:
			item:
				type:Object,
				default()
					return 
						title:"组件内默认的标题",
						author:"张三",
						hits:668,
						picurl:"../../static/nopic.png",
						looktime:"2023-04-04 18:14:46"
					
				
			
		,
		data() 
			return 
				
			;
		
	
</script>

<style lang="scss"> 
.newsbox
	display: flex;
	.pic
		width: 229.5rpx;
		height: 160rpx;
		image
			width: 100%;
			height: 100%;
		
	
	.text
		flex: 1;
		padding: 20rpx;
		display: flex;
		flex-direction: column; // 上下排列
		justify-content: space-between; // 两侧排列
		.title
			font-size: 32rpx;
			color: #333;
			text-overflow: -o-ellipsis-lastline;
			overflow: hidden;				//溢出内容隐藏
			text-overflow: ellipsis;		//文本溢出部分用省略号表示
			display: -webkit-box;			//特别显示模式
			-webkit-line-clamp: 1;			//行数
			line-clamp: 2;					
			-webkit-box-orient: vertical;	//盒子中内容竖直排列
		
		.info
			font-size: 26rpx;
			color: #999;
			text
				padding-right: 30rpx;
			
		
	

</style>

新闻列表和浏览历史调用components组件,并通过props进行数据传参:

导航栏点击样式设置

接下来设置导航栏的点击样式,当用户进行相关导航按钮的点击时,该文章会产生高亮效果,我们只需要动态绑定一个class属性,当我们选择的按钮等于当前的元素下标时,产生高亮效果,具体操作如下:

新闻详情页布局

设置点击新闻列表页面的新闻内容进行页面的跳转,这里可以使用自定义事件,如果要将原生事件绑定到组件当中去,可以通过 .native 进行解决,详情可参考官方文档,如下:        

这里我设置好新闻列表的路由界面后,设计点击事件可以通过navigateTo实现页面跳转,如下:

设置好跳转路径后,接下来可以通过设置新闻详情页的内容布局,大致情况设置如下:

<template>
	<view class="detail">
		<view class="title">新闻标题</view>
		<view class="info">
			<view class="author">编辑:张三</view>
			<view class="time">2023-12-13 15:34:59</view>
		</view>
		<view class="content">
			内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容as
		</view>
		<view class="description">
			声明:本站的内容均采集与腾讯新闻,如果侵权请联系管理(12345676890@qq.com)进行整改删除,本站进行了内容采集不代表本站及作者观点,若有侵权请及时联系管理员,谢谢您的支持。
		</view>
	</view>
</template>

<script>
	export default 
		data() 
			return 
			;
		
	
</script>

<style lang="scss">
.detail
	padding: 30rpx;
	.title
		font-size: 46tpx;
		color: #333;
	
	.info
		background: #f6f6f6;
		padding: 20rpx;
		font-size: 25rpx;
		color: #666;
		display: flex;
		justify-content: space-between;
		margin: 40rpx 0;
	
	.content
		padding-bottom: 50rpx;
	
	.description
		background: #FEF0F0;
		font-size: 26rpx;
		padding: 20rpx;
		color: #F89898;
		line-height: 1.8em;
	

</style>

新闻列表数据的详细展示

接下来实现调用接口来展示详细的数据,如下:

通过传递item的id来获取不同id下导航栏给我们展示的新闻数据

然后给一个图片用来展示,没有数据时页面的样式

具体实现的结果如下:

实现上拉触底效果

接下来需要实现上拉触底的效果,实现上拉触底效果的函数为:onReachBottom,如下:

为了呈现具体的效果,我将浏览器的网速设置为低速3G,如下:

获取参数并跳转到详情页

通过设置点击函数传参,将item参数传递到函数当中,并通过模板字符串实现传参,如下:

传递完参数之后,设置新闻详情界面的布局,将访问的数据进行缓存,相同的数据进行去重,详细代码如下:

<template>
	<view class="detail">
		<view class="title">detail.title</view>
		<view class="info">
			<view class="author">编辑:detail.author</view>
			<view class="time">发布日期:detail.posttime</view>
		</view>
		<view class="content">
			<rich-text :nodes="detail.content"></rich-text>
		</view>
		<view class="description">
			声明:本站的内容均采集与腾讯新闻,如果侵权请联系管理(12345676890@qq.com)进行整改删除,本站进行了内容采集不代表本站及作者观点,若有侵权请及时联系管理员,谢谢您的支持。
		</view>
	</view>
</template>

<script>
	import  parseTime  from '../utils/tool.js'
	export default 
		data() 
			return 
				options:null,
				detail:,
			;
		,
		onLoad(e) 
			this.options = e
			this.getDetail()
		,
		methods:
			getDetail()
				uni.request(
					url:'https://ku.qingnian8.com/dataApi/news/detail.php',
					data:this.options,
					success:res=>
						// res.data.posttime = parseTime(res.data.posttime) // 时间有点老,我就注释掉了换固定时间
						res.data.posttime = '2023-04-04 18:37:49'
						res.data.content = res.data.content.replace(/<img/gi,'<img style="max-width:100%"')
						this.detail = res.data
						this.saveHistory()
						uni.setNavigationBarTitle(
							title:this.detail.title
						)
					
				)
			,
			// 保存浏览历史
			saveHistory()
				let historyArr = uni.getStorageSync("historyArr") || []
				let item = 
					id:this.detail.id,
					classid:this.detail.classid,
					picurl:this.detail.picurl,
					title:this.detail.title,
					looktime:parseTime(Date.now())
				
				let index = historyArr.findIndex(i=>
					return i.id == this.detail.id
				)
				if(index>=0)
					historyArr.splice(index,1)
				
				historyArr.unshift(item)
				historyArr=historyArr.slice(0,10)		
				uni.setStorageSync("historyArr",historyArr)
			
		
	
</script>

<style lang="scss">
.detail
	padding: 30rpx;
	.title
		font-size: 46tpx;
		color: #333;
	
	.info
		background: #f6f6f6;
		padding: 20rpx;
		font-size: 25rpx;
		color: #666;
		display: flex;
		justify-content: space-between;
		margin: 40rpx 0;
	
	.content
		padding-bottom: 50rpx;
		// H5端
		// /deep/ img
		// 	max-width: 100%;
		// 
	
	.description
		background: #FEF0F0;
		font-size: 26rpx;
		padding: 20rpx;
		color: #F89898;
		line-height: 1.8em;
	

</style>

设置完新闻列表的具体内容之后,当我们再点击浏览历史的路由之后,将获取传递过来的参数以及存放在浏览器缓存中的数据,并在页面中进行展现,详细代码如下:

<template>
	<view class="user">
		<view class="top">
			<image src="../../static/logo.png" mode=""></image>
			<text>浏览历史</text>
		</view>
		<view class="connent">
			<view class="row" v-for="item in listArr">
				<newsbox :item="item" @click.native='goDetail(item)'></newsbox>
			</view>
		</view>
		<view class="nohistory" v-if="!listArr.length">
			<image src="../../static/images/no-data.jpg" mode="widthFix"></image>
			<text>暂无浏览记录</text>
		</view>
	</view>
</template>

<script>
	export default 
		data() 
			return 
				listArr:[]
			;
		,
		onShow() 
			this.getData()
		,
		methods:
			// 跳转到详情页
			goDetail(item)
				uni.navigateTo(
					url:`/pages/detail/detail?cid=$item.classid&id=$item.id`
				)
			,
			// 获取缓存浏览记录
			getData()
				let hisArr = uni.getStorageSync("historyArr") || []
				this.listArr = hisArr
			
		
	
</script>

<style lang="scss">
.user
	.top
		padding: 50rpx 0;
		background: #F8F8F8;
		color: #555;
		display: flex;
		flex-direction: column;
		justify-content: center;
		align-items: center;
		image
			width: 150rpx;
			height: 150rpx;
		
		.text
			font-size: 38rpx;
			padding-top: 20rpx;
		
	
	.connent 
		padding: 30rpx;
		.row
			border: 1px dotted #efefef;
			padding: 15rpx 0;
		
	
	.nohistory
		display: flex;
		flex-direction: column;
		justify-content: center;
		align-items: center;
		image
			width: 450rpx;
		
		.text
			font-size: 26rpx;
			color:#888;
		
	

</style>

具体效果如下:

项目的打包上线

项目没问题之后,可以在微信小程序下进行模拟运行,如下:

没有问题之后,项目文件就会出现一个打包的文件夹,unpackage,如下:

接下来进行各个平台进行上线,如果你是第一次使用这个工具的话,需要进行一些基础的配置:

H5平台上线

设置如下Web配置的基础设施

接下来点击编辑器工具栏上的发行选项,选择 网站-PC Web或手机H5

微信小程序平台上线

点击发行中的小程序-微信平台发行

这里也可以设置为体验版,扫码进入之后应该是没数据的,可以通过手机打开调试模式来或取数据

APP平台上线

这里先进行App图表进行设置,选择相应的图表

点击编辑器发行的第一个,原生App云打包,选择云端证书直接打包即可。

经过一段时间的等待,控制台提示我们打包成功,如下:

弄到这个apk文件之后,可以发到QQ或微信上进行安装下载即可

ok,传递到手机QQ上,点击下载即可,如下

项目开源Github

接下来进行项目的开源,给出如下详细步骤:

创建远程仓库:进入github网址,登录自己的账号后点击右上角头像新建仓库,如下

创建完成后,会跳转到如下界面,上面代码详细的告诉你如何将代码提交到远程库: 

提交代码需要借用一个 git 工具,如何下载这里不再赘述,自行百度。如果想详细的了解git的使用,可以参考一下我之前的专栏:git专栏 ,详细操作如下:

生成本地仓库:具体步骤如下:

git init 生成工作区

git add . 提交到暂存区

git commit -m "news" 提交到版本区

推送到远程仓库:具体步骤如下:

git remote add origin git@github.com:ztK63LrD/Today-s- News.git   关联别名

git push -u origin main 推送分支

推送完成之后,刷新github页面就会将我们推送的代码呈现在页面上,如下:

因为我在写完项目之后再推送到远程仓库的,因为仅仅是个小案例,就不再创建其它子分支了,给出项目的源地址文件:GitHub - ztK63LrD/Today-s-News: 简单的新闻列表案例 ,可自行git clone 进行到本地进行测试,如果可以的话还请一键三联或者给项目点个小星星,您的支持就是我创作的最大动力。

uni-app技术分享| uni-app常见问题

1. 运行无法使用插件

  • 查看控制台提示是否存在以下提示, 请根据控制台提示操作

    [JS Framework] 当前运行的基座不包含原生插件[AR-RtcModule],请在manifest中配置该插件,重新制作包括该原生插件的自定义运行基座
    
  • 使用的是 标准运行基座

    • 需要制作自定义运行基座
    • 运行时选择自定义基座运行(HBuilder 默认标准运行基座)
  • 插件仅支持 APP;

2.场景使用

3.用户 uid 与自身业务结合

  • 用户 uid:
    • 必须为字符串
    • 标识用户,独一无二
    • 不能设置为中文
    • 长度在 64 字节以内的字符串,范围(26 个小写字母 a-z;26 个大写字母 A-Z;10 个数字 0-9;空格;"!", “#”, “$”, “%”, “&”, “(”, “)”, “+”, “-”, “:”, “;”, “<”, “=”, “.”, “>”, “?”, “@”, “[”, “]”, “^”, “*”, “”, “”, “|”, “~”, “,”;等)
    • 可使用自身业务 id,但必须符合用户 uid

4.频道房间 channelId 与自身业务结合

与 uid 需求一致;

5.token 相关

调试项目时建议暂不开启
appid 开启 token 校验时,加入频道时必须要填入

6.加入频道,设置 uid 或 channelId

加入房间前进行设置

rtcModule.joinChannel(
  		"token": 开启 token 校验时填入(必须字符串)|| '',
  		"channelId": 自行设置(必须字符串)|| '',
  		"uid": 自行设置(必须字符串)|| '',
  	, (res) => 
  		console.log('RTC joinChannel 方法调用', (res.code === 0 ? '成功' : '失败:') + res);
  	);

7.功能第一次有效,在次操作发生错误

  • 重复创建实例(多在调试阶段出现),多次调用 rtmModule.createInstance
    • 每次都要重启应用
    • 功能结束后要销毁对应实例

8.ios、Android 意外闪退

查看方法参数是否符合,如:
* rtcModule.joinChannel 的参数 uid 设置的不是字符串

9.无画面、无声音

  • 查看手机权限是否开启

  • 音视频页面必须是nvue页面

  • 本地视频渲染:

    <AR-CanvasView ref="location" style="flex: 1;" />
    
    • 必须要获取到视频容器
    • 调用对应方法
    this.$refs.location.setupLocalVideo(
    			"renderMode": 1,
    			"channelId": 同一个房间,
    			"uid": 用户 uid,
    			"mirrorMode": 0
    		, (res) => 
    			console.log('渲染视频', res);
    		);
    		// 本地预览
    this.$refs.location.startPreview((res) => 
    			console.log('本地预览', res);
    		)
    
  • 远端视频渲染:
    1.通过远端视频首帧回调 onFirstRemoteVideoDecoded
    2.然后显示远端视频容器

     <AR-CanvasView ref="remote" style="flex: 1;" />
    

    3.对应方法(必须要获取远端视频容器)

    this.$refs.remote.setupRemoteVideo(
      	"renderMode": 1,
      	"channelId": 同一个房间,
      	"uid":远端 uid,
      	"mirrorMode": 0
      , (res) => 
      	console.log('渲染远端视频', res);
      )
    

10.uniapp 在通信过程中获取对方的网络状态

插件仅能通过 anyRTC实时消息SDK插件 获取对应用户状态: 在线/不在线
如需获取更详细的网络状态:
uni.onNetworkStatusChange 获取网络
通过 实时消息SDK插件 ,向对方发送信息
对方收到后,在将网络信息返回给查询者

11.多人视频展示

每一位用户都有自己的视频容器
渲染视频时必须获取到对应容器

12.是否可转换多端

  • 使用插件仅支持App
  • 如需转成小程序,可使用 Web SDK进行转换(建议使用小程序对应的sdk)

以上是关于uni-app--》如何制作一个APP并使用?的主要内容,如果未能解决你的问题,请参考以下文章

如何使用 uni-app 30分钟快速开发即时通讯应用|开发者活动

使用uni-app制作支持小程序,H5及移动端app的个人简历

解决uni-app安卓无法关闭侧划退出页面问题

uni-app技术分享| uni-app常见问题

如何学习uni-app?

[每天进步一点点~] uni-app css 制作雷达扫描、波浪移动动画效果