uni-app框架、微信小程序项目
uni-app 是一个使用 Vue.js 开发所有前端应用的框架,开发者编写一套代码,可发布到iOS、Android、Web(响应式:h5)、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉/淘宝)、快应用等多个平台。 uni-app 在手,做啥都不愁。即使不跨端, uni-app 也是更好的小程序开发框架
一、微信小程序项目发布
1.确定项目中没有bug,不能是demo; 2.查看项目包大小; 3.填写小程序基本信息,比如名称 头像 介绍 服务类目 4.注意配置域名白名单(微信公众平台----->开发----->开发管理----->服务器域名---->request地址); 5.如果项目是使用的云开发,注意切换云环境id 本地环境dev 线上环境pro 6.通过微信开发者工具提交即可; • 6.1开发版本:只能被项目成员访问 • 6.2审核版本:需要微信团队审核 1-7 人工审核 • 6.3线上版本:可以退回 暂停服务
二、框架概述
1.uni-app概述
Dcloud
地址:DCloud - HBuilder、HBuilderX、uni-app、uniapp、5+、5plus、mui、wap2app、流应用、HTML5、小程序开发、跨平台App、多端框架
Dcloud是uniapp框架开创者
Dcloud:国内领先的开发者服务公司,W3C会员,HTML5中国产业联盟发起单位。
提供了很多服务开发者的工具,比如
HBuilderX======》开发者工具(微信开发者工具)
uniapp======>开发框架(微信小程序原生框架)
uniapp起源
uni-app
是一个使用 Vue.js 开发所有前端应用的框架,开发者编写一套代码,可发布到iOS、Android、Web(响应式:h5)、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉/淘宝)、快应用等多个平台。uni-app
在手,做啥都不愁。即使不跨端,uni-app
也是更好的小程序开发框架
很多人以为小程序是微信先推出的,其实,DCloud才是这个行业的开创者。
DCloud于2012年开始研发小程序技术,并加入W3C和HTML5中国产业联盟,推出了HBuilder开发工具,为后续产业化做准备。
2015年,DCloud正式商用了自己的小程序,产品名为“流应用”
在2015年9月,DCloud推进微信团队开展小程序业务
微信团队经过分析,于2016年初决定上线小程序业务,但其没有接入联盟标准,而是订制了自己的标准。
造成混乱的局面非DCloud所愿。于是我们决定开发一个免费开源的框架。
既然各巨头无法在标准上达成一致,那么就通过这个框架为开发者抹平各平台差异。
2.为什么要学习uni-app?
vue语法+微信小程序语法 多端移动端项目
1.uni-app是一套可以适用多端的开源框架,一套代码可以同时生成原生app端、小程序端和h5端等13大平台。 2.uni-app对前端开发人员比较友好,学习成本比较低,首先uni-app是基于vue.js的。其次封装的组件和微信小程序的组件语法一致,所以对于现在的主流前端人员来说学习几乎0成本 3.uni-app拓展能力强,封装了H5+,支持nvue,也支持原生Android,ios开发。可以将原有的移动应用和H5应用改成uni-app应用。
3.其他多端框架
美团的:mpvue(vue) WePY 是一款让小程序支持组件化开发的框架,通过预编译的手段让开发者可以选择自己喜欢的风格去开发小程序。(vue) Taro 是由京东 - 凹凸实验室打造的一套遵循 React 语法规范的多端统一开发框架(react) react-native(facebook:2015年) 多端开发框架(android ios)(react)
三、项目创建
项目创建有两种方式,第一种是通过HBuliderx工具,另一种是使用vue-cli架手架,建议使用工具方式创建和管理uniapp项目
1.HBuilderX工具创建(推荐)
1.1下载工具
地址:https://www.dcloud.io/hbuilderx.htmlhttps://www.dcloud.io/hbuilderx.html
下载完后直接安装即可;
注意如果安装无法启动参考一下连接说明:
地址:HBuilderX 文档https://hx.dcloud.net.cn/
设置自动保存
此工具没有自动保存设置功能,正常需要写完代码后按住 ctrl+s 键保存,可以在插件市场安装自动保存插件
插件安装地址:自动保存 - DCloud 插件市场
1.2注册Dcloud开发者账号
地址:DCloud开发者中心
就等同于注册我们微信公众平台小程序账号,方便后期管理和发行我们创建的应用
注册成功后登录进去Dcloud提示我们通过邮箱进行验证,点击获取激活邮件,如果激活邮件无法点击尝试更换浏览器。
1.3账号登录HBuilderx工具
最后用注册的Dcloud账号登录HBuilderx工具如下:这样我们通过工具创建的项目就会使被Dcloud后台进行管理
1.4创建项目流程
我们可以点击HBuilderX工具中的文件创建,也可以在工具的左侧栏空白处右键创建;
1.5运行项目
我们开发项目主要是使用vue语法和微信小程序语法,所以最终是由HBuilderX工具帮助我们编译成能够运行在不同的平台下的代码包。记住,我们需要在HBuilderX工具中开发业务逻辑,效果需要在各个终端平台对应的开发者工具中进行查看。
1.5.1运行到h5
我们只需要选中该项目中的页面文件后点击工具栏的运行即可,选择相应的终端平台;
1.直接运行到系统自带浏览器
h5端本地运行不会生成本地代码包,和vue一样是跑在内存中;
2.运行到HBuilderx内置模拟器
第一次运行需要下载,根据提示连接直接下载即可;
注意:不会复现跨域问题,模拟器已经内部解决;
1.5.2运行到小程序端
我们在HBuilderX里面开发,在小程序开发者工具里面就可看到实时的效果。
下面以运行到微信小程序为例,步骤如下:
1.配置ide路径
首先在HBuilderx工具中配置微信小程序开发者工具的安装路径,
2.开启小程序工具的端口号
开启微信开发者工具端口号
3.配置appId
打开项目中manifest.json文件,选择微信小程序配置,填写小程序的appid,如下所示:
4.开始运行
运行成功会生成编译后的微信小程序代码包,位置如下所示:
注意:
若HBuilderX不能正常启动微信开发者工具,需要开发者手动启动,然后将uni-app生成小程序工程的路径(mp-weixin)拷贝到微信开发者工具里面
2.vue-cli脚手架创建(了解)
步骤
2.1创建项目
注意前提:首先安装脚手架(安装过就不需要重复安装)
vue create -p dcloudio/uni-preset-vue my-project
2.2运行项目
注意项目创建完毕后,首先进入到项目根目录下执行 npm run serve ,此刻编译的是h5端项目,如果需要编译其他终端,停止此服务,执行以下npm run dev +平台码 运行即可
npm run dev: %PLATFORM%
PLATFORM:平台的意思
例如运行到微信小程序端:
npm run dev:mp-weixin
2.3发行项目
npm run build:%PLATFORM%
例如运行到h5端
npm run build:h5
2.4平台对照码
3.二者创建项目区别
三、工程目录结构
四、创建页面
五、工程配置pages.json
全局配置 和 页面配置
1globalStyle全局外观配置
文件位置:pages.json文件
globalStyle<====>window,同原生微信小程序全局配置中的window选项用于设置应用的状态栏、导航条、标题、窗口背景色等。
// 等同于微信小程序中的window配置项 "globalStyle": { "navigationBarTextStyle": "white", "navigationBarTitleText": "app", "navigationBarBackgroundColor": "#f00", "backgroundColor": "#F8F8F8", "enablePullDownRefresh":true, "navigationStyle":"default" },
2页面配置
文件位置:pages.json文件
pages-------->{ path:'路径',style:window },用于设置页面的路由、状态栏、导航条、标题、窗口背景色等。
// 页面配置项 "pages": [ //pages数组中第一项表示应用启动页,参考:https://uniapp.dcloud.io/collocation/pages { //页面路由 "path": "pages/index/index", // 页面的window配置项 "style": { "navigationBarTitleText": "uni-app", "enablePullDownRefresh":false } } ,{ "path" : "pages/ceshi/ceshi", "style" : { "navigationBarTitleText": "", "enablePullDownRefresh": false } } ],
3配置tabBar
文件位置:pages.json文件
// 配置tabbar "tabBar":{ "selectedColor":"#ff053f", "list":[ { "pagePath":"pages/index/index", "text":"首页", "iconPath":"static/images/icon/index.png", "selectedIconPath":"static/images/icon/indexFull.png" },{ "pagePath":"pages/ceshi/ceshi", "text":"我的", "iconPath":"static/images/icon/my.png", "selectedIconPath":"static/images/icon/myFull.png" } ] }
七、uniapp基础语法
uniapp语法:vue语法(数据绑定 列表渲染 条件渲染 事件绑定等) + 微信小程序语法( 组件 api 生命周期 页面事件函数等)
1数据绑定
使用vue语法 标签属性绑定: v-bind | : 标签内容绑定:{{}}
2条件渲染
使用vue语法 v-if v-else-if v-else
第四节
3列表渲染
使用vue语法 v-for :key
注意事项:
1.在H5平台 使用 v-for 循环整数时和其他平台存在差异,如 v-for="(item, index) in 10"
中,在H5平台 item 从 1 开始,其他平台 item 从 0 开始,可使用第二个参数 index 来保持一致。
2.在非H5平台 循环对象时不支持第三个参数,如 v-for="(value, name, index) in object"
中,index 参数是不支持的。
4事件绑定
使用vue语法, v-on | @ 不能使用微信小程序中bind或者是catch绑定事件 ,但是可以使用微信小程序事件类型 比如:@tap
5计算属性
computed 语法同vue
6静态资源引入使用
模板: <!-- 绝对路径,/static指根目录下的static目录,在cli项目中/static指src目录下的static目录 --> <!-- @指向项目根目录,在cli项目中@指向src目录 --> <image class="logo" src="/static/logo.png"></image> <image class="logo" src="@/static/logo.png"></image> <!-- 相对路径 --> <image class="logo" src="../../static/logo.png"></image> js: // 绝对路径,@指向项目根目录,在cli项目中@指向src目录 import add from '@/common/add.js' // 相对路径 import add from '../../common/add.js' 注意:js文件不支持使用/开头的方式引入 css: /* 绝对路径 */ @指向项目根目录,在cli项目中@指向src目录 @import url('/common/uni.css'); @import url('@/common/uni.css'); /* 相对路径 */ @import url('../../common/uni.css'); //也支持微信小程序语法 @import '相对路径';
7样式配置
1.uni-app 支持的通用 css 单位包括 px、rpx。多端开发建议使用rpx; 2.px转rpx工具自动转换设置 工具栏-设置-编辑器设置--开启px转换rpx选项,根据实际设计稿宽度,设置转换比例 3.uniapp中支持scss/sass使用 工具-插件安装-scss/sass编译插件安装。 4.uniapp中支持less使用 工具-插件安装-less编译插件安装
配置单位转换:
less/scss安装:
八、生命周期
uniapp中完全支持vue(组件生命周期)和小程序的生命周期函数(应用生命周期和页面生命周期),uniapp生命周期包括:应用生命周期、页面生命周期和组件生命周期。 1.在app.vue中可以使用小程序的应用级别的生命周期函数; 2.在页面组件(pages目录)可以使用小程序的页面生命周期和vue的组件生命周期函数; 3.在components目录中的组件中只能使用vue的生命周期函数不能使用小程序的页面生命周期函数;
九、组件通信
1.单文件组件
根目录下创建components目录,右键选择创建组件。
2父传子
属性传递:props
3子传父
事件传递: this.$emit('事件名称','数据') <sonComp name='李四' @channel='getSon'></sonComp> // 监听子传父 getSon(msg){ console.log(msg); } // 子传父 sendParent(){ this.$emit('channel',{name:'我叫张三'}) }
4兄弟之间组件传值
中央事件总线 $emit() $on() 新建utils/bus.js文件: import Vue from 'vue'; export default new Vue(); // son sendBrother(){ BUS.$emit('brother','我是你的兄弟') }, //brother mounted(){ // 监听son传值 BUS.$on('bro',(info)=>{ console.log(info) }) },
5uni-app页面通讯
uniapp页面通讯语法用于兄弟组件传值,本质是对vue中 $emit $on $once $off 等语法的封装
如果项目中使用vue原生语法就不再建议在使用uniapp,两者选择一种即可
地址:
uni-app官网https://uniapp.dcloud.io/collocation/frame/communication
uni.$emit()触发全局的自定事件,附加参数都会传给监听器回调。 uni.$on()监听全局的自定义事件。事件可以由 uni.$emit 触发,回调函数会接收所有传入事件触发函数的额外参数。 uni.$once()全局只监听一次 uni.$off()移除监听事件 //son sendBrotheruni(){ uni.$emit('sendBrotheruni','我是你的兄弟uniapp') }, //brother uni.$on('brouni',(info)=>{ console.log(info) }) destroyed(){ // 移除监听 防止内存泄露 uni.$off('brouni') }
十、全局变量
1公用模块(模块化)
定义一个专用的模块,用来组织和管理这些全局的变量,在需要的页面引入。这种方式维护起来比较方便,但是缺点就是每次都需要引入。
使用ES6 commonjs 语法规范
2挂载 Vue.prototype
将一些使用频率较高的常量或者方法,直接扩展到 Vue.prototype 上,每个 Vue 对象都会“继承”下来。
这种方式,只需要在 main.js 中定义好即可在每个页面中直接调用。
可以将上面定义的地址直接挂载到vue原型链上:
3globalData
uni-app 引入了globalData概念,并且在包括H5、App等平台都实现了。
globalData是一种比较简单的全局变量使用方式。修改后全局可以同步变化
微信小程序语法 globalData在app.vue文件 js部分中定义
4本地缓存
语法同微信小程序 将wx开头替换成uni开头 存储数据 获取数据 根据key删除数据 清除所有缓存数据 获取当前缓存信息
5Vuex
Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化,一般用于大型项目开发。uniapp中内置vuex无需安装
新建store/index.js文件 // 引入vue vuex use new export import Vue from 'vue'; import Vuex from 'vuex'; Vue.use(Vuex); export default new Vuex.Store({ state:{ age:20 }, mutations:{ change(state){ state.age+=10; } } }) 在main.js挂载 // 引入vuex 挂载到原型链 import store from '@/store/index.js'; Vue.prototype.$store = store;
更多推荐
所有评论(0)