uni-app介绍(官网)
uni-app
是一个使用Vue.js
开发所有前端应用的框架,开发者编写一套代码,可发布到iOS
、Android
、H5
、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉)等多个平台。
即使不跨端,uni-app
同时也是更好的小程序开发框架。
开发工具(HBuilderX)
HBuilderX 官方下载网址:https://www.dcloud.io/hbuilderx.html
HBuilderX 提供了一些插件,可直接下载安装,具体如下图: 工具 > 插件安装
项目结构
首先我们通过 HBuilderx > 文件 > 项目,选择 uni-app项目,模板我选择的是默认模板,当然你也可以选择其他模板,接着确认创建,如果你选择的是默认模板,此时你的文件夹应该如下图:
接着我根据自己的项目需求,以及为了与vue
的pc
项目结构保持一下,分别添加如下文件夹:
主要文件介绍:
api
文件夹中存放的是各个页面的请求路径,引入request.service.js
暴露出来的api
,colorui
使用了color-ui
样式,个人认为样式非常好看,非常感谢!common
存放全局通用的js方法components
存放全局组件,包括uni-ui
以及自己封装的组件pages
主要页面, 其中pages
文件夹中index
文件中可布局底部的tab
页面,通过v-if
判断显示不同的tab页services
通用的服务文件(我不知道这种描述是否准确,原来用的Angular4
,Angular
中服务概念对我有一定的影响)static
静态文件,我主要用来放图片auth.service.js
通过使用uni.setStorageSync
简单封装了一些保存用户的token
方法config.service.js
保存全局的变量 例如:apiUrl
请求接口的IP
,storage_key
是token
的键值,全局引用的变量都可定义在这个文件内,后期如果需要改动,只需要修改这个文件中对用的值request.service.js
使用Promise
对uni.request
进行封装,将get
、post
、delete
请求方式暴露出来,在api
文件夹中引用这个文件即可使用get
、post
、delete
方法
unpackage
(在小程序模拟器运行的文件)App
应用配置,用来配置App全局样式以及监听
如何自定义底部tab导航栏
本人项目中需要根据不同的角色显示不同的地图tab页,那么原来在pages.json设置的tab页,不够灵活,也不好扩展,因此自定义tab页,具体如下:
1)在pages文件夹中,新建一个index文件夹并创建一个index.vue页面,在这个页面可布局底部tab,根据点击不同的tab显示对应的tab页,如图:
注意:
2)如果每个tab点击是切换不同的view,这个就相当于首页应用了,当页面比较复杂时,切换过程存在卡顿。所以使用自定义的tabbar就尽量避免太多复杂的页面。
3)当然原生tabbar虽然体验好,但自定义性不足,这个需要开发者根据字节的需求来平衡选择。
如何使用colorui
ColorUI是一个css库!在你引入样式后根据class来调用组件
1)下载源码解压获得/Colorui-UniApp文件夹,复制目录下的/colorui文件夹到你的项目根目录
2)App.vue引入关键css、main.css、icon.css
<style>
@import "colorui/main.css";
@import "colorui/icon.css";
@import "app.css"; /* 你的项目css */
....
</style>
此时你可以使用colorUI提供的css样式了,
因为colorUI的文档说明正在完善中,具体样式对应的类名可能不清楚,那么你可将color-ui下载下来,使用HBuilderX
运行在浏览器中,打开调试工具,找到对应的节点即可获取对应的类名,(当然你也可能会有其他好的方法)。
使用colorui自定义导航栏
pages.json
配置取消系统导航栏
"globalStyle": {
"navigationStyle": "custom"
},
App.vue
获得系统信息
onLaunch: function() {
uni.getSystemInfo({
success: function(e) {
// #ifndef MP
Vue.prototype.StatusBar = e.statusBarHeight;
if (e.platform == \'android\') {
Vue.prototype.CustomBar = e.statusBarHeight + 50;
} else {
Vue.prototype.CustomBar = e.statusBarHeight + 45;
};
// #endif
// #ifdef MP-WEIXIN (微信小程序)
Vue.prototype.StatusBar = e.statusBarHeight;
let custom = wx.getMenuButtonBoundingClientRect();
Vue.prototype.Custom = custom;
Vue.prototype.CustomBar = custom.bottom + custom.top - e.statusBarHeight;
// #endif
// #ifdef MP-ALIPAY
Vue.prototype.StatusBar = e.statusBarHeight;
Vue.prototype.CustomBar = e.statusBarHeight + e.titleBarHeight;
// #endif
}
})
},
- 在
main.js
引入cu-custom
组件
import cuCustom from \'./colorui/components/cu-custom.vue\'
Vue.component(\'cu-custom\',cuCustom)
- 在需要的页面可以直接使用了,如下:
<cu-custom bgColor="bg-gradual-blue" :isBack="true">
<block slot="backText">返回</block>
<block slot="content">导航栏</block>
</cu-custom>
跨端兼容(如何你只是开发小程序,就不需要考虑)
根据平台特性,uni-app
提供了条件编译手段,在一个工程里优雅的完成了平台个性化实现。
<view class="content">
<! -- #ifdef APP-PLUS -->
<view>仅出现在 5+App 平台下的代码</view>
<! -- #endif -->
<! -- #ifndef H5 -->
<view>除了 H5 平台,其它平台均存在的代码</view>
<! -- #endif -->
<! -- #ifdef H5 || MP-WEIXIN -->
<view>仅在 H5 平台或微信小程序平台存在的代码</view>
<! -- #endif -->
</view>
发布微信小程序
-
服务器域名必须是
https
合法域名 -
进入开发页面
开发
>开发设置
,设置服务器域名, 如图
服务器域名
-
发布小程序之前需要配置
appid
,应用名称、logo,可登录微信公众平台进入设置页,设置小程序的基本信息 -
使用
HBuilderx
找到发行
>小程序-微信
,点击后稍等片刻会启动微信开发工具,点击微信开发工具上传
,填写上传信息即可,此时上传到微信公共平台是体验版,需要在版本管理
>提交审核
,等待后台审核,审核完成后,小程序也就上线成功了,如图:
总结
本文主要介绍了使用uni-app框架开发微信小程序,自己对默认模板的补充,包括封装request
接口,引用color-ui
,动态设置底部tab
页,还有通过color-ui
提供的导航栏组件,自定义导航栏。本人才疏学浅,表达能力有限,书写过程如有错误欢迎指正,也请点赞评论鼓励(ps: 内心怕怕的)
关于uni-app
更多信息可参考官方文档 https://uniapp.dcloud.io
请发表评论