新闻| 文章| 资讯| 行情| 企业| wap手机版| article文章| 首页|会员中心|保存桌面|手机浏览
普通会员

易达信息科技

企业列表
新闻列表
推荐企业新闻
联系方式
  • 联系人:依依
友情链接
  • 暂无链接
首页 > 新闻中心 > uni-app小程序手把手项目实战
新闻中心
uni-app小程序手把手项目实战
发布时间:2024-12-13        浏览次数:7        返回列表

小程序的开发选型,推荐这篇文章小程序开发:用原生还是选框架

uni-app小程序手把手项目实战

选型之类过多的话语就不说了,个人还是比较推荐uni-app,要么就原生。

废话不多说,开干。

网址: 微信注册,根据指引填写信息

PS:开发选型的时候一定要注意主体账号信息的分类,简单解释就是这个小程序是要干嘛的,定位要精准,小程序的上线目前越来越严格,并不是所有小程序都能过审的。比如,人脸授权这种功能,你就很难过审...如果有这个功能,我劝你放弃,走APP。

登录后找到设置模块,在这里你可以设置一些小程序的主题信息,比较重要的就是这个,唯一的,相当于微信小程序的敲门砖

当项目是多人协作的时候,你可以添加多个开发者账号

这里用的是,当然的也是要安装的,微信开发者工具呢建议还是安装最新版的,原因当然是最新版的会不断加入很多新特性。的开发也必须安装工具,这个是捆绑的,没得选择。虽然有很多人吐槽这个,号称傻瓜式的编程工具。好吧,要用,你必须得装!!!

工具安装:

微信开发者工具

HBuilderX

至此,所有的准备工作都OK了,接下来直接进入项目开发了。

Tips:

目录下的 文件不会被编译,如果里面有 es6 的代码,不经过转换直接运行,在手机设备上会报错。

、 等资源同样不要放在 static 目录下,建议这些公用的资源放在 目录下。

之前的模板内容太多了,项目重新开启前还是重新建一个空的模板吧,新建项目的时候依然选择uni-app项目+默认模板

1.配置AppID

2.运行项目

为了方便开发,可以安装一个内置的终端,可以不用额外打开终端

3.搭建目录框架

因为使用默认模板,所以项目结构很干净。接下来先把目录框架搞定,当然你也可以按照自己的个人习惯和喜好自由设置

因为之前安装了内置终端,所以直接打开终端,会默认打开你所在的项目的根路径,直接在根路径下命令行创建目录文件


4.微信路由 准确的来说小程序也是单页面的形式。在小程序中,路由是不用自己定义的。路由全部交给框架统一管理,开发者需要在里配置每个路由页面的路径及页面样式,不支持 ,如图,属性值的数组内容即为路由路劲

5.状态管理

首先, 内置了 。但是是不支持持久化存储的,所以需要结合第三方来一起协作。

默认的模板项目首先是没有模块依赖的,也就是说你没法进行一些第三方的扩展,所以为了让你的项目更加的灵活性,你需要执行以下命令来搭配一些第三方来更随心所欲的开发项目

里面的结构也展示一下吧

最后,在里面引用

至此,含两个选项的无数据交互的小程序ui结构就搭好了。

6.封装

因为需要调用服务端的登录口子,所以我们优先把请求接口的模块给添加进来吧。

配置,和可以从微信官方开发模块获取到

封装接口请求

到此Api请求的模块就封装好了,现在开始做接口请求必须携带的秘钥

因为小程序肯定会频繁的切换后台或者直接切回首页面,结合小程序的生命周期等,在首页的主入口一般都会调一次登录口子,获取秘钥

的接口定义,按照如下标准直接定义即可

上面还应用了的状态管理,所以你还要到下的 做好状态管理,主要还是的日常操作。一般来说同步存储只要放里面定义即可,主要还是看个人习惯吧


授权登录是一大重点,在项目刚开始开发的时候尤其要注意。小程序目前已有官方规定明确禁止新用户初次打开小程序就唤起授权登录获取用户信息的弹框,也就是说,如果你不当回事的话,即使开发完毕发布,微信官方团队也会直接咔嚓回。那个时候再改,代价就太大了

所以呢,目前采用的是静默授权登录的方式。什么是静默授权呢,就是新用户进入你的小程序后,他可以无障碍的访问你的小程序,当他需要分享、进详情页、交互动作、点赞、购买...需要深一层次体验我们的小程序的时候,这个时候唤起授权弹窗让用户授权之后再继续下一步是合理的。

接下来是授权登录的实现。暂时把它放在的头像区域吧

1.找到-->页面

在搭建的工程中,项目默认引用预处理,虽然不用安装第三方依赖,都是内置的,但是想要让项目正常运行,还是要安装编译时的对应工具,否则会报错

工具--->插件安装

然后安装对应的依赖即可,再重新运行项目

为了统一处理,还是抽离一个公共组件,存放在->->。

要调取用户的授权登录,必须调用微信自带的控件才行,包括后面的功能模块也一样。必须要用到它里面自带的属性。

引用微信自带的当然会有很多丑陋的问题,比如样式,所以这里还是要重置下样式

2.引用上面的封装授权按钮

这里说一个小技巧,在项目中引用第三方UI框架时,肯定会涉及到修改样式的问题。由于我们在Vue文件中加入了属性,就是为了防止页面之间的样式污染,所以你想要修改样式的话,有两种方式,第一种是新起一个,不加,然后严格遵循命名模式修改样式,尽量避免样式污染其它页面。第二种就是引用的,如

至此静默授权的组件封装和功能都实现完毕了。还是要再强调一遍,目前开发的小程序必须采用静默授权登录的方式,否则你很大概率会被拒...

--- 补充说明 ---

很多小伙伴可能在这里会有疑问,入口不是有调用过这个登录口子获取了吗。为什么授权之后还要再调用一遍。原因很简单,静默授权的原则就是新用户初次进来之后,必须无障碍的浏览你的小程序,也就是说刚开始在页面只能获取信息,因为小程序内页的接口大都是要把放在头去请求服务端才能拿到数据,而另外的、这两个参数是只有你想获取真实的用户信息才能带上,也就是说服务端必须把这两个参数设为非必传。

只有他想进入你的小程序的二级页面,或者首页有点赞、拍照、评论、分享...这一类你想拿到他的个人信息时,再调用这个封装的授权按钮组件让用户授权,然后再调用一遍接口,再带上、这两个非必传的参数,用户确认授权后,就能获取到真实的用户个人信息了。

请注意!!!

讲真,微信授权获取用户信息这块是必不可少的,不获取用户信息那开发小程序的意义何在。但是很多产品在定性小程序的时候,就想着一进小程序就让用户授权,这种需求直接拒绝就行,不要任何拖泥带水操作。因为上不了是注定的。或者他们想着委婉点,让你在切换上加个授权,uni-app是没有路由的概念的,因此想要引用vue-router的钩子函数去拦截路由是行不通的,但倒不是不能实现,可以自己手写一套,但是花这么大代价有意义吗?何况所谓的静默授权的初衷,就是要让用户首次进入无障碍的使用小程序,无障碍的意义并不是说就只给看个首页,然后切换个tabbar就要授权了?!那估计也是大概率被拒的多。

又或者他们想我不放在tabbar的切换时加入授权,我切换后在页面里面加,即从切到页面时,直接一张+,只有你授权了才能看我的页面的所有内容。讲真,真的都好鸡肋,跟上面tabbar切换授权有区别吗???

最后,静默授权这块怼不过产品的,就让产品多去玩玩看看大厂是怎么做的。比如小米、苏宁等等等等...祝你成功!

为了让这个项目不至于这么空壳,计划加入一些常用的功能,比如记录列表上拉加载,下拉刷新、轮播图、分享、开屏广告页、在线客服引入...

1.上拉加载、下拉刷新

入口就是在个人中心的

首先加页面路由,在目录下新增一个页面,然后在项目根目录下的挂载上,如果要新开页面的话,都要在这个目录下注册页面

如动态图所示,这里还抽了一个选项卡的小组件。直接开箱即用就行。

上拉加载下拉刷新在官网上其实是有介绍的。这里单独取出来是因因为接口都配置好了,只要替换成你项目中的服务端数据和修改下样式即可,功能是已经实现了的。代码就不全贴了,直接大致介绍下功能点吧

上拉加载下拉刷新这功能大致分两种情况,第一种是整个页面的上拉下拉,这种实现比较简单,首先当然是要在项目根目录下的声明页面的可加载属性

然后主要实现两个方法功能

是否加载完毕可以在服务端接口返回数据中对对象做处理,对应的业务在代码中都有实现好,因为接口无法正常调用,所以你要使用的话,需要替换成你自己联调的接口。

2.联系客服

小程序要做好的话,那细节之处肯定是必不可少的。比如客服功能的引入,实时根据用户的反馈完善或者修复问题

小程序中不需要你额外接入在线聊天工具,当然,如果你想体验性做得好点,那可以多投入些精力做好实施聊天这一大模块。这里简单介绍一下用小程序自带的反馈聊天模块

首先,还是得应用微信自带的,指定的值为

在小程序中,开发者可以登录 ,进入菜单“客服反馈”页面获取反馈内容

3.分享

说完联系客服顺便说下分享吧,都是同样的套路,同样是应用微信自带的,指定的值为,然后在属性上指明你要分享的内容

分享出去的携带的参数提取的方式是利用小程序的生命周期函数

4.轮播图+跳转第三方url

同样封装成一个工具库,工具类就不多说了,引用的是系统自带的swiper组件

这里介绍一下跳转第三方url页吧,包括在UI搭建阶段轮播图引用其它外域链接的图片url,这两个其实算是一类问题。

里面,是明确禁止没有在加入合法域名时,加入任何的外域链接都为非法链接,也就是说,即使是联调的服务端接口,也得把合法域名加进微信的,包括使用微信拍照或者上传图片都必须额外加上这个合法域名名单,图片信息才能正常显示,接口才能正常引用。配置详情如下

配置路径

配置好后,当你的轮播图对应的是后台的详情地址或者是微信公众号的内容时,才能够正确跳转到对应的路径中。唯一要注意的是,在本地微信开发者工具是无法测试这一功能的,最好用真机测试,否则还是要务必保证你的合法域名都在微信后台添加上了,并且本地设置也去除了合法域名的校检

如上代码所示,详情页跳转第三方url,你必须得新开一个页面作为第三方路劲承载的容器,当然,别忘了路由注册。这里,你要跳转的最好,然后在文件中,利用微信自带的,即可进行第三方页面的跳转,再次强调一遍,跳转第三方最好用真机做测试。

这样,轮播图功能就搞定了

扩展功能就先做这些吧,后续有时间再加一下上去...

现在很多大流量的APP在首次打开时会有一个3~7S不等的小广告,当然,做得有好点你可以让他随时都能跳过。小程序里面也有广告页这样的概念,接下来就让我们来实现一下吧

首先是广告页的入口构思,广告页放哪个位置合适呢?是放首页作为弹窗出现???还是作为小程序主入口出现???因为广告页不可能每次打开小程序都出现一次广告,那用户肯定十分反感,过度挑战用户的耐心,肯定难逃被用户卸载的下场...一般合理一点的需求就是每天的第一次打开时,加入一个3~7S不等的小广告。接下来我们来实现一下作为主入口出现的小广告。

首先,在注册页面路由,这里务必要注意一点,pages数组中第一项表示应用启动页,参考:uniapp.dcloud.io/collocation…

广告页无非就是一个定时器,然后加一张海报或者由后台动态配置图片内容。这里提几个小点应该注意的地方,广告页肯定分打开的时机,也就是说你得判断好广告页按规定时间展示,不能每次打开都有广告页的出现。这里可以让服务端传给你一个参数。

计数器结束后,可以立即跳转到小程序首页,并且终止定时器

广告页功能的最后,打测试包或者正式包的时候一定要记得修改主入口页信息!!!否则上线后会一片空白,等广告页定时器结束之后才到主页

消息推送是必不可少的一大模块,但是推送的这个度还是要把控好,太频繁了自然就会引起反感,那离被卸载就不远了。 消息推送的功能已经加在首页里,功能介绍的软文在另一篇博文里可以浏览。

传送门:uni-app小程序消息推送

打开微信开发者工具,在工具栏找到上传,填写版本号,发布。测试版本号可以随意填写,不过建议还是规范一点写比较好

上传成功之后,可以打开微信开发者管理后台,现在可以看到开发者的版本

然后指定小程序的主入口页,主要参照属性值的第一项的值

然后,就可以作为体验版本提交了。

测试版本和正式版本还是有差距的。正式版本中,因为小程序发版限制在2M以内,所以有几点务必要引起注意

  • 图片用,不要用本地图片加载,图片内容太大
  • 确认涉及到这些功能点的域名信息在中有配置
  • 使用iconFont替代纯色小图标
  • 尽量不要引用第三方字体
  • 雪碧图
  • ... ...

发布上线。

测试发版只要在开发者工具中直接打包上线即可,没有这么多的条条框框。但是正式版发版就不一样了,就最关键的一点,开发版和正式版的服务端域名肯定不一样吧?!所以,为了避免每次发版手动频繁修改配置接口,造成哪次不小心把测试版的发线上去,最好做个区分,把开发环境和正式环境区分开来。发正式版本的时候打正式环境的包

主要配置呢就是在根目录新建个文件,区分开发和正式版就是自带的属性值

然后打正式包的时候,选择开发工具工具栏

然后检查,确认无误点击发行,会再在微信开发者工具里开一个窗口,运行同样的小程序。区别只是域名地址不一样了,开发版本是本地ip,发行后的服务域名是正式的线上地址。以防万一,可以打开微信开发者工具栏的工具面板查看一下域名是否正确

确认无误后再重复测试版本发版即可

至此,小程序的开发到上线就全部完成了。

还是回归到框架的选型来讲讲,选用开发小程序,打包上传后,代码竟惊人的被压缩到了。相对比就重了不少,有大。

当时并行做的是两个小程序,基于和基于,结果是因为前期问题不断,导致发版被拒次数增多,最后都修复完全正式上线之后,再更新迭代,审核的时间依然长的很。但是做的小程序就没这个问题了,前期的几版发版比较顺利的话,后期再更新迭代,那速度真是嗖嗖的,普遍都是在一个工作日内。等信用(通过率)累计到了一定程度,会直接上微信审核的单,开启的通道,真香~

好了,基于的小程序开发到此结束了,喜欢的话请多赐个赞!!!吧。

hello-uni-app

手把手带你搭建React16+Router+Redux-saga+Antd后台管理系统