玩转 uniapp 全端开发

配套视频 www.bilibili.com/video/BV1iG…

uniapp 介绍

uni-app 是一个使用 Vue.js (opens new window)开发所有前端应用的框架，开发者编写一套代码，可发布到iOS、Android、Web（响应式）、以及各

种小程序（微信/支付宝/百度/头条/飞书/QQ/快手/钉钉/淘宝）、快应用等多个平台。

是目前全端开发框架的佼佼者

多端体验

uniapp 优势

uniapp 生态介绍

1. uview
2. uni ui
   1. 使用文档
   2. 完整示例
3. hbuilderX
4. 插件市场
5. uniCloud

uniapp项目创建

uniapp 项目开发方式分为两种

1. vue-cli （只开 h5端 或者 只开发 微信小程序端）
2. HBuilderX 可视化 （多端开发首选 只开发 手机APP）

vue-cli

创建项目

1. 全局安装vue-cli

   npm install -g @vue/cli@4
   

2. 创建项目 my-project 项目名称

   vue create -p dcloudio/uni-preset-vue my-project
   

3. 选择模版- 选择默认模版

   

4. 成功

   

运行项目

npm run dev:平台代号
npm run build:平台代号

HBuilderX

如果你要使用uiapp开发多端，那么就必须要选择和它配套的编辑工具了 HBuilderX 。考虑到后期要使用更多的 uniapp的功能，建议提前注册一个uniapp的开发账号。 注册

创建项目

1. 下载 HBuilderX

2. 新建项目

   

3. 选择项目

   

4. 创建成功

   

5. 编辑器中，敲入 u+代码 即可调出HBuilderX的代码提示

   

运行项目

第一次运行，可能需要安装插件，等待即可

uniapp 开发环境搭建

uniapp 是全端开发框架，假如我们想要开发全端，那么首先需要搭建好各个端对应的环境。以下拿比较典型的 微信小程序、H5 和 安卓App来演示。 发布环境的讲解在后续

微信小程序

下载开发者工具

下载地址

下载安装成功后，会在桌面上显示出来一个图标

注册微信小程序开发者账号

另外 想要开发一款微信小程序，必须要注册微信开发者账号，同时获取对应的appid。

获取appid

打开服务端口

在 HBuilderX 中运行项目

H5

如果使用内置的浏览器预览页面，它是自带跨域的。

同时每一个vue页面中的样式，也是默认自己加上 scoped 的。

运行H5比较简单，只需要电脑上安装好浏览器就行，或者使用 HBuilderX自带内置浏览器也可以

App

由于电脑操作系统限制，我们只演示 android。

分为两种:

1. 运行到模拟器
2. 运行到真机

运行到模拟器

安卓模拟器可以自由选择，这里我使用的是 Android studio 内置的模拟器

安装 android studio 模拟器步骤如下：

1. 下载 android studio

   

   2. 打开安装包，然后 勾选上 安装虚拟机

      

   3. 打开 Android Studio

      

   4. 

   5. 选择要安装的手机型号

      

   6. 选择安装对应的安卓系统版本 下载过程比较慢，因为系统镜像比较大

      

   7. 下载成功了，回到设备列表页面，运行起来

      

      ---

      

   8. 开机

      

   9. 成功

      

   10. 现在可以回到HBuilderX中来运行项目到模拟器里面了

       

   11. HBuilderX会自动检测你电脑上的模拟器或者真实安卓手机

       

   12. 成功

       

运行到真实手机

1. 准备一台正常的安卓手机，开启开发人员选项和允许USB调试

   

2. 连接数据线到电脑上 ，如果弹出什么菜单全部点击允许

3. 这个时候，重新回到 HBuilderX中，点击运行项目到 App上

   

   ---

   

4. 此时你的手机会弹出窗口，提示你安装软件，最后成功显示

   

App 调试 模拟器调试

1. 运行模拟器

2. 运行项目

3. 打开webview调试 该选项只能调试页面标签和样式，不能调试js

   

4. 点击调试

   

5. 此时会打开一个页面调试工具，开始调试

   

6. 模拟器上也会跟着发生变化

   

7. 此时可以开启 js调试

   

8. 此时会弹出一个新的窗口 我们可以在这里进行调试

   

App 真机调试

调试方式和 调试模拟器类似。直接操作即可

uniapp 项目结构介绍

uniapp.dcloud.net.cn/tutorial/pr…

┌─uniCloud              云空间目录，阿里云为uniCloud-aliyun,腾讯云为uniCloud-tcb 
│─components            符合vue组件规范的uni-app组件目录
│  └─comp-a.vue         可复用的a组件
├─hybrid                App端存放本地html文件的目录
├─platforms             存放各平台专用页面的目录
├─pages                 业务页面文件存放的目录
│  ├─index
│  │  └─index.vue       index页面
│  └─list
│     └─list.vue        list页面
├─static                存放应用引用的本地静态资源（如图片、视频等）的目录，注意：静态资源只能存放于此
├─uni_modules           存放[uni_module](/uni_modules)。
├─wxcomponents          存放小程序组件的目录
├─nativeplugins         App原生插件 详见
├─unpackage             非工程代码，一般存放运行或发行的编译结果
├─main.js               Vue初始化入口文件
├─App.vue               应用配置，用来配置App全局样式以及监听 应用生命周期
├─manifest.json         配置应用名称、appid、logo、版本等打包信息
├─pages.json            配置页面路由、导航条、选项卡等页面类信息
└─uni.scss              这里是uni-app内置的常用样式变量

uniapp 开发规范介绍

为了实现多端兼容，综合考虑编译速度、运行性能等因素，uni-app 约定了如下开发规范

页面和组件文件遵循vue的规范

1. 比如 新建页面 goods.vue
2. 比如 新建组件 it-item.vue

内置标签使用小程序的规范

<view>小程序中的块级标签</view>

数据绑定和事件处理使用vue的规范

<template>
	<view>
		<view class="item" v-for="item in list" :key="item" @click="handleClick(item)">{{item}}</view>
	</view>
</template>
<script>
	export default {
		data(){
			return {
				list:['a','b','c']
			}
		},
		methods:{
			handleClick(letter){
				console.log(letter)
			}
		}
	}
</script>

能力接口API 使用 微信小程序的规范

比如弹出显示框，发送网络请求等

wx.showToast({
  title: '成功',
  icon: 'success',
  duration: 2000
})

wx.request({
  url: 'example.php', //仅为示例，并非真实的接口地址
  data: {
    x: '',
    y: ''
  },
  header: {
    'content-type': 'application/json' // 默认值
  },
  success (res) {
    console.log(res.data)
  }
})

考虑到跨端，我们将会使用 uniapp 统一封装的API。简称 uni api

uniapp 生命周期

uniapp中，生命周期分类三大类

1. 应用生命周期 小程序规范
2. 页面生命周期 小程序规范
3. 组件生命周期 vue规范

应用生命周期 App.vue

页面生命周期

组件生命周期

响应式单位 rpx

uniapp.dcloud.net.cn/tutorial/sy…

相对长度单位，功能类似于web端的 rem 和 vw，小程序首先推出，uniapp也是直接支持。一种根据屏幕宽度自适应的动态单位。以 750 宽的屏幕为基准，750rpx 恰好为屏幕宽度。

其中uniapp做了以下设置，

1. 默认的设计稿宽度为 375px 因此存在 1px = 2rpx
2. 默认 rpx支持最大宽度为 960px,超出则 按照 设计稿宽度 375px 来设置

scoped

1. vue开发的h5，单页面应用程序，每一个vue文件如果直接使用 class，多个文件的样式 冲突
2. 微信小程序 真正 多页面应用程序 物理隔离，页面中使用 class，不会相互影响
3. uniapp做了一个设置，写vue代码，不需要主动加上 scoped，打包成h5端的时候自动添加上去，打包成 微信小程序端 不需要添加 scoped。

uniapp 多端开发

条件编译

条件编译是用特殊的注释作为标记，在编译时根据这些特殊的注释，将注释里面的代码编译到不同平台。

**写法：**以 #ifdef 或 #ifndef 加 %PLATFORM% 开头，以 #endif 结尾。

• #ifdef：if defined 仅在某平台存在
• #ifndef：if not defined 除了某平台均存在
• %PLATFORM%：平台名称

标签中

<!-- #ifdef %PLATFORM% -->
平台特有的组件
<!-- #endif -->

js中

// #ifdef %PLATFORM%
平台特有的API实现
// #endif

css中

/* #ifdef %PLATFORM% */
平台特有样式
/* #endif */

%PLATFORM% 可取值如下：

支持的文件

• .vue
• .js
• .css
• pages.json
• 各预编译语言文件，如：.scss、.less、.stylus、.ts、.pug

static 目录的条件编译

在不同平台，引用的静态资源可能也存在差异，通过 static 的的条件编译可以解决此问题，static 目录下新建不同平台的专有目录（目录名称同 %PLATFORM% 值域,但字母均为小写），专有目录下的静态资源只有在特定平台才会编译进去。

如以下目录结构，a.png 只有在微信小程序平台才会编译进去，b.png 在所有平台都会被编译。

┌─static                
│  ├─mp-weixin
│  │  └─a.png     
│  └─b.png
├─main.js        
├─App.vue      
├─manifest.json 
└─pages.json 

整体目录条件编译

如果想把各平台的页面文件更彻底的分开，也可以在uni-app项目根目录创建platforms目录，然后在下面进一步创建app-plus、mp-weixin等子目录，存放不同平台的文件。

注意

• platforms目录下只支持放置页面文件（即页面vue文件），如果需要对其他资源条件编译建议使用static 目录的条件编译(opens new window)

flex布局

尽量使用flex布局，因为全平台都支持

尺寸单位

1. uniapp通用单位 px , rpx
2. vue页面中支持 rem 、vh、vw
3. nvue 不支持 百分比单位

css变量

背景图片

• 支持 base64 格式图片。

• 支持网络路径图片。

• 小程序不支持在 css 中使用本地文件。需以 base64 方式方可使用。

• 使用本地路径背景图片需注意：

  1. 为方便开发者，在背景图片小于 40kb 时，uni-app 编译到不支持本地背景图的平台时，会自动将其转化为 base64 格式；
  2. 本地背景图片的引用路径推荐使用以 ~@ 开头的绝对路径。

  .test2 {
  	background-image: url('~@/static/logo.png');
  }
  

uview & uni ui

uview 和 uni ui 都是 和uniapp配套的全端UI框架，可以单独使用，也可以共同使用

1. uview ui 1.x

   

2. uview ui 2.x

   

3. uni ui

   

uview ui

由于目前 uview 2.x 版本的坑不少，因此我们拿比较稳定的 uview 1.8.6 来演示

另外，uview ui 的引入方式分为两种，主要是取决于你的项目是如何创建的：

1. vue-cli
2. HBuilderX

uview ui + vue-cli

1. 安装依赖

   npm i uview-ui@1.8.4 sass
   

2. 在 src/main.js 文件中 全局引入 js库

   import uView from "uview-ui";
   Vue.use(uView);
   

3. 在 uni.scss 中 引入 uview 的 sass 主题库

   @import "uview-ui/theme.scss";
   

4. 在 App.vue 中 引入 uview 的 sass 主题库

   <style lang="scss">
   @import "uview-ui/index.scss";
   </style>
   

5. pages.json 中 配置 easycom

   {
   	"easycom": {
   		"^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
   	},
   	
   	// 此为本身已有的内容
   	"pages": [
   		// ......
   	]
   }
   

6. 在 页面中 使用 uview的按钮

   <u-button >默认按钮</u-button>
   <u-button type="primary">主要按钮</u-button>
   <u-button type="success">成功按钮</u-button>
   <u-button type="info">信息按钮</u-button>
   <u-button type="warning">警告按钮</u-button>
   <u-button type="error">危险按钮</u-button>
   

7. 成功

   

uview ui + HBuilderX

1. 打开 插件市场，找到 uview 1.x 地址

2. 点击导入插件

   

3. 导入成功，可以看到目录下多了 components 文件夹

   

4. 接着在 uni.scss 中导入 uview的主题样式文件 theme.scss

   @import './theme.scss';
   

5. 在页面上添加测试代码

       <u-button >默认按钮</u-button>
       <u-button type="primary">主要按钮</u-button>
       <u-button type="success">成功按钮</u-button>
       <u-button type="info">信息按钮</u-button>
       <u-button type="warning">警告按钮</u-button>
       <u-button type="error">危险按钮</u-button>
   

6. 点击运行

   

7. 成功

   

uni ui

uni ui + vue-cli

1. 安装相关依赖

   如果 node 版本小于 16 ，sass-loader 请使用低于 @11.0.0 的版本

   如果 node 版本大于 16 ， sass-loader 建议使用 v8.x 版本

    npm i sass sass-loader@10.1.1  @dcloudio/uni-ui
   

2. 配置easycom

   在 pages.json 中进行配置

   {
   	"easycom": {
   		"autoscan": true,
   		"custom": {
   			// uni-ui 规则如下配置
   			"^uni-(.*)": "@dcloudio/uni-ui/lib/uni-$1/uni-$1.vue"
   		}
   	},
   	
   	// 其他内容
   	pages:[
   		// ...
   	]
   }
   

3. 组件中使用

   <uni-title title="上报统计数据"></uni-title>
   <uni-title type="h1" title="h1 一级标题 "></uni-title>
   <uni-title type="h1" title="h1 一级标题" color="#027fff"></uni-title>
   <uni-title type="h2" title="h2 居中" align="center"></uni-title>
   

uni ui + HBuilderX

1. 打开 uni ui 的对应的插件市场

2. 使用 HBuilderX 导入插件

   

3. 项目中会多 uni_modules 文件夹

   

4. 页面中导入代码

   <uni-title title="上报统计数据"></uni-title>
   <uni-title type="h1" title="h1 一级标题 "></uni-title>
   <uni-title type="h1" title="h1 一级标题" color="#027fff"></uni-title>
   <uni-title type="h2" title="h2 居中" align="center"></uni-title>
   

5. 观察效果

   

uniapp 发布到多端

H5

普通发布

项目开发完成后，可以在 HBuilderX中来 打包成 H5项目

1. 打包成H5

   

2. 填写信息

   

3. 此时，生成的h5项目会放在 unpackage\dist\build\h5

   

发布到uniapp的云环境

需要提前开通 uniCloud 的云服务

微信小程序

在HBuilderX中，想要发布微信小程序，有两种方式

普通发布

1. 点击发行微信小程序

   

2. 填写 appid

   

3. 此时会自动打开 微信开发者工具，然后点击上传即可

   

4. 然后填写 版本信息即可

   

5. 成功后，回到微信开发者后台，打开 管理 版本管理 手动点击 提交审核。等待审核

   

HBuilderX 发布

其实还可以利用 HBuilderX 直接发布，不用打开微信开发者工具

1. 首先登录你的微信开发者后台

2. 打开 开发管理 小程序代码上传密钥 重置

   

3. 下载 小程序代码上传密钥

   

4. 在企业开发中，记得要开启 IP白名单，降低风险

   

5. 选择上传密钥

   

6. 上传成功

   

App

在HBuilderX中发布App的方式分为两种

1. 本地离线打包
2. 云打包

云打包

云打包的意思是利用 dcloud提供的能力，将你本地代码上传到 dcloud 服务器上，在云上打包完成再下载回本地。

1. 打开 mainifest.json 设置 uniapp 应用标识 AppID 这个是uniapp应用的id，不是微信小程序的id

   

2. 设置 App 支持CPU类型

   App常用其他设置 支持CPU类型

   

3. 设置使用原生隐私正则提示框

   

4. 发行 – 原生App – 云打包

   

5. 填写相关信息

   

6. 打包成功

   

uniapp 其他资源

1. uniapp 常见问题汇总

2. uniapp 跨端注意事项汇总

3. 运行原理以及优化建议

4. 问答平台

5. uniapp github

6. uniapp 官方团队付费支持

7. uniapp优秀案例源码地址

   1. RF 微商城
   2. shopro商城
   3. Mall4j商城
   4. Lilishop 商城
   5. 有来商城

8. uniapp 官方交流QQ群