目录

一、介绍

二、环境搭建（hello world）

2.1 下载HBuilderX

2.2 下载微信开发者工具

2.3 创建uniapp项目

2.4 在浏览器运行

2.5 在微信开发者工具运行

2.6 在手机上运行

三、项目基本目录结构

四、开发规范概述

五、全局配置文件（pages.json）

5.1 globalStyle（全局样式）

导航栏：背景颜色、标题颜色、标题文本

导航栏：开启下拉刷新、下拉背景、下拉样式

5.2 pages（页面路由）

5.3 tabBar

5.4 condition （开发启动模式）

六、创建新页面和页面的配置

七、配置tabBar

7.1 基本设置

7.2 个性化设置

八、组件

8.1 text 

8.2 icon

icon

字体图标

九、页面样式与布局

9.1 尺寸单位

9.2 样式导入

 9.3 选择器

9.4 全局样式与局部样式

9.5 使用sass

十、Vue基本语法复习

十一、uniapp的生命周期

应用的生命周期

页面的生命周期

十二、下拉刷新

十三、上拉加载

十四、网络请求

14.1 uni.request(OBJECT)

14.2 二次封装请求对象

十五、数据缓存

15.1 uni.setStorage(OBJECT)

15.2 uni.getStorage(OBJECT)

15.3 uni.removeStorage(OBJECT)

15.4 uni.setStorageSync(KEY,DATA)

15.5 uni.getStorageSync(KEY)

15.6 uni.removeStorageSync(KEY)

十六、图片的上传和预览

16.1 上传

一、介绍

如果是刚入门小程序的，又或者刚听到这个名词的人，可能跟我之前一样，带着诸多的疑惑。比如：

什么是uniapp？它和原生微信小程序有什么异同之处？

为什么推荐uniapp开发？

这里一句话两句话解释了可能还是云里雾里的。我的建议是看看下面这个视频，个人觉得讲的很清楚明白。

开发微信小程序使用原生开发还是uniapp开发，详细介绍原生小程序与uni-app开发的优缺点_哔哩哔哩_bilibili

----------------------------------------------------------------------------------------------------------------------

 ps：博客中的动图在切换时可能会有残影，并非真实存在，请注意识别。

如果对你有帮助，辛苦点个赞👍呗，反正又不花钱~😁

----------------------------------------------------------------------------------------------------------------------

二、环境搭建（hello world）

2.1 下载HBuilderX

HBuilderX-高效极客技巧

当然你可以选择其他IDE，但是官网推荐HBuilderX，天然整合uniapp。

2.2 下载微信开发者工具

我们要最终打包成微信小程序就必须在微信开发者工具去预览，那么需要下载微信开发者工具了。

微信开发者工具下载地址与更新日志 | 微信开放文档

2.3 创建uniapp项目

HBuilderX下载下来后，直接双击运行HBuilderX.exe文件即可，它是免安装的。

然后我们新建一个uniapp项目，按照下图操作即可。

然后它会默认生成项目的基本结构。

2.4 在浏览器运行

然后第一次运行时，控制台会提示自动去下载相关的插件，下载完成后需要你再次重新运行。

2.5 在微信开发者工具运行

然后启动测试一下，发现失败了。经过检查它报错的这两项，也没问题啊。

那么问题可能是出在微信开发者，我们需要进入微信开发者工具->设置->安全，然后把服务的端口号打开。

接着重新运行即可。

2.6 在手机上运行

安卓、ios同理，不过需要用数据线连接上。

操作类似，感兴趣的可以去试试，这里不再演示了。不过要注意的是ios端麻烦点，好像现在不支持直接运行了。

三、项目基本目录结构

四、开发规范概述

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

• 页面文件遵循Vue单文件组件规范

• 组件标签靠近小程序规范，详细见uni-app组件规范

• 接口能力（js api）靠近微信小程序规范，但需将前缀wx替换为uni，详见uni-app接口规范

• 数据绑定及事件处理同Vue.js规范，同时补充了App以及页面的生命周期

• 为兼容多端运行，建议使用flex布局进行开发

五、全局配置文件（pages.json）

pages.json 文件用来对 uni-app 进行全局配置，决定页面文件的路径、窗口样式、原生的导航栏、底部的原生tabbar 等。

5.1 globalStyle（全局样式）

用于设置应用的状态栏、导航条、标题、窗口背景色等。

ps：以下我都只列举了个人认为比较常见的属性，如果有需要强烈建议去官网看，最全。

导航栏：背景颜色、标题颜色、标题文本

演示

注意：如果你没有修改完全成功，或者都不生效，可能是设置了页面的配置样式导致的，它会覆盖掉全局样式配置中相同属性的样式。这是因为页面配置优先级高于全局配置。我们删除掉页面配置样式即可。

导航栏：开启下拉刷新、下拉背景、下拉样式

演示

5.2 pages（页面路由）

uni-app 通过 pages 节点配置应用由哪些页面组成，pages 节点接收一个数组，数组每个项都是一个对象，其属性值如下： 

Tips：

• pages节点的第一项为应用入口页（即首页）

• 应用中新增/减少页面，都需要对 pages 数组进行修改

• 文件名不需要写后缀，框架会自动寻找路径下的页面资源

例如项目创建时默认生成的：

如果不清楚，我将在第六章创建新页面和页面的配置中演示它的使用。

5.3 tabBar

如果应用是一个多 tab 应用，可以通过 tabBar 配置项指定一级导航栏，以及 tab 切换时显示的对应页。

具体请见第七章！

5.4 condition （开发启动模式）

启动模式配置，仅开发期间生效，用于模拟直达页面的场景，如：小程序转发后，用户点击所打开的页面。

属性说明：

list说明：

注意： 在 App 里真机运行可直接打开配置的页面，微信开发者工具里需要手动改变编译模式。

演示

再创建一个测试页测试一下

配置condition条件：

六、创建新页面和页面的配置

可以直接新建页面，也可以先创建目录，再创建文件。

然后去pages.json文件中设置页面路径，同时也可以配置一下页面样式。

完成，我们先通过浏览器打开看看，输入该路径即可看到刚刚创建的页面。

而且发现它成功覆盖了全局样式的导航栏标题文字。

七、配置tabBar

7.1 基本设置

Tips

• 当设置 position 为 top 时，将不会显示 icon

• tabBar 中的 list 是一个数组，只能配置最少2个、最多5个 tab，tab 按数组的顺序排序。

• tabbar 切换第一次加载时可能渲染不及时，可以在每个tabbar页面的onLoad生命周期里先弹出一个等待雪花（hello uni-app使用了此方式）

• tabbar 的页面展现过一次后就保留在内存中，再次切换 tabbar 页面，只会触发每个页面的onShow，不会再触发onLoad。

• 顶部的 tabbar 目前仅微信小程序上支持。需要用到顶部选项卡的话，不建议使用 tabbar 的顶部设置，而是自己做顶部选项卡，可参考 hello uni-app->模板->顶部选项卡。

list属性的属性值如下

演示

7.2 个性化设置

我们看到很多小程序，它的底部导航栏很多都有哪种中间图标突起的，例如这样：

它是怎么做到的呢？

其实也是tabbar里面的配置项，midButton属性，和list属性评级即可。

midButton 属性说明

具体代码如下： 

它有个特点，就是目前只支持app、H5，也就是说小程序这些是无法展示的。

且midButton没有pagePath，需监听点击事件，自行处理点击后的行为逻辑。

具体可查阅官网：pages.json 页面路由 | uni-app官网

如果我们希望小程序端也有这个功能怎么办呢？其实可以自定义tabbar，把原生的tabbar隐藏掉。

具体实现这里就不写了，稍微有些复杂。感兴趣后面自己再搜索相关方法。官网也有相关介绍：pages.json 页面路由 | uni-app官网

当然你也可以去uniapp插件市场搜索人家弄好的插件，这样更简单一点，跟着要求一步一步调整即可。

后续有时间，我也会专门补充如何自定义设置tabbar。

八、组件

• 组件是视图层的基本组成单元。

• 组件是一个单独且可复用的功能模块的封装。

直白讲，就是标签。uniapp中除了可以使用html提供的默认标签外，uniapp还封装了一些组件可以使用。

8.1 text 

文本组件。用于包裹文本内容。

属性说明

space 值说明

8.2 icon

icon

图标

属性说明

各平台 type 有效值说明：

演示

 由于 icon 组件各端表现存在差异，可以通过使用 字体图标 的方式来弥补各端差异。

字体图标

另外，uniapp默认提供的图标就这些，如果希望使用个性化的图标，那么就可以使用字体图标。

uniapp 支持使用字体图标，使用方式与普通 web 项目相同，需要注意以下几点：

• 支持 base64 格式字体图标。

• 支持网络路径字体图标。

• 小程序不支持在 css 中使用本地文件，包括本地的背景图和字体文件。需以 base64 方式方可使用。

• 网络路径必须加协议头 https。

• 从 http://www.iconfont.cn 上拷贝的代码，默认是没加协议头的。

• 从 http://www.iconfont.cn 上下载的字体文件，都是同名字体（字体名都叫 iconfont，安装字体文件时可以看到），在 nvue 内使用时需要注意，此字体名重复可能会显示不正常，可以使用工具修改。

• 使用本地路径图标字体需注意：

• 为方便开发者，在字体文件小于 40kb 时，uni-app 会自动将其转化为 base64 格式；

• 字体文件大于等于 40kb，仍转换为 base64 方式使用的话可能有性能问题，如开发者必须使用，则需自己将其转换为 base64 格式使用，或将其挪到服务器上，从网络地址引用；

• 字体文件的引用路径推荐使用以 ~@ 开头的绝对路径。

话不多说，我们直接演示

除了html页面其他都复制到项目中，按照如下步骤即可：

ok，这样就算配置完成了，我们就可以在页面中使用了。

然后我们打开下载下来的文件中的html页面，找到图标对应的字体样式进行使用，使用时去掉前面的  .  号。

字体图标的颜色、大小等，我们也可以通过css样式去改变。 

问题

有时候你会发现你完全按照我的步骤做的，结果在浏览器中可以使用，但是小程序中使用无法显示，且控制台还报错。这个时候要么换种资源，要么去调整一下使用https开头的网络资源。具体的问题具体解决就好了。

九、页面样式与布局

uni-app 的 css 与 web 的 css 基本一致。

uni-app 有 vue 页面和 nvue 页面。vue 页面是 webview 渲染的、app 端的 nvue 页面是原生渲染的。在 nvue 页面里样式比 web 会限制更多。

本文重点介绍 vue 页面的样式注意事项。

9.1 尺寸单位

uni-app 支持的通用 css 单位包括 px、rpx。

rpx即响应式px，一种根据屏幕宽度自适应的动态单位，以750宽的品目为基准，750rpx恰好为屏幕宽度，屏幕变宽，rpx实际显示效果会等比放大。

9.2 样式导入

使用@import语句可以导入外联样式表，@import后跟需要导入的外联样式表的相对路径，用 ; 表示语句结束。

 9.3 选择器

目前支持的选择器有：

注意：

• 在 uni-app 中不能使用 * 选择器。

• 微信小程序自定义组件中仅支持 class 选择器

• page 相当于 body 节点，例如：

<!-- 设置页面背景颜色，使用 scoped 会导致失效 -- >page {background-color: #ccc;}

9.4 全局样式与局部样式

定义在 App.vue 中的样式为全局样式，作用于每一个页面。在 pages 目录下 的 vue 文件中定义的样式为局部样式，只作用在对应的页面，并会覆盖 App.vue 中相同的选择器。

注意：

• App.vue 中通过 @import 语句可以导入外联样式，一样作用于每一个页面。

• nvue 页面暂不支持全局样式

9.5 使用sass

我们在项目根目录下，可以看到一个 uni-scss文件。

uni-scss 是 uni-ui提供的一套全局样式 ，通过一些简单的类名和sass变量，实现简单的页面布局操作，比如颜色、边距、圆角等。

那么如何使用sass呢？

首先安装sass插件

使用，记得在style标签中加上属性

十、Vue基本语法复习

uniapp是基于vue进行封装的框架。所以要像使用好它，必须会vue。如果你会vue，那么可以跳过这里不看，如果你不会，那么我会简单跟大家一起学习一下。

获取事件对象

如果v-on:中方法没有传参数，那么默认拿到的是事件对象

只需要在方法上传一个形参即可。

十一、uniapp的生命周期

应用的生命周期

App.vue/App.uvue | uni-app官网

生命周期的概念

一个对象从创建、运行、销毁的整个过程。

生命周期函数

在生命周期中每个阶段会伴随着函数的触发，这些函数被称为生命周期函数。

uni-app支持如下应用生命周期函数

页面的生命周期

页面简介 | uni-app官网

uni-app 支持如下页面生命周期函数：

我们最小化页面，然后打开

我们从tabBar切换，也是一样的道理。

十二、下拉刷新

 前面讲过下拉刷新的一种方式，是通过全局配置。

但是我们不推荐，我们希望那个页面有需要就开启，没有需要不要开启。

我们希望下拉刷新了触发一些事件

只需要通过onPullDownRefresh函数即可。在前面页面的生命周期函数中有列举过。

一旦刷新完成之后，我们就可以通过uni.stopPullDownRefresh();关闭

十三、上拉加载

我们发现还没有触底就开始说触底了，这是因为有默认的触底距离 。我们可以设置默认触底距离

然后再来测试一下就好了。这里不演示了。

触底之后，我们可以给他加载下一页数据。

十四、网络请求

uni.request(OBJECT) | uni-app官网

14.1 uni.request(OBJECT)

发起网络请求。

在各个小程序平台运行时，网络相关的 API 在使用前需要配置域名白名单。

OBJECT 参数说明

method 有效值

注意：method有效值必须大写，每个平台支持的method有效值不同，详细见下表。

success 返回参数说明

data 数据说明

最终发送给服务器的数据是 String 类型，如果传入的 data 不是 String 类型，会被转换成 String。转换规则如下：

• 对于 GET 方法，会将数据转换为 query string。例如 { name: 'name', age: 18 } 转换后的结果是 name=name&age=18。

• 对于 POST 方法且 header['content-type'] 为 application/json 的数据，会进行 JSON 序列化。

• 对于 POST 方法且 header['content-type'] 为 application/x-www-form-urlencoded 的数据，会将数据转换为 query string。

测试

我们先用springboot搞一个测试接口。

 接口没有问题，然后我们试一试

ok，搞定

我们发现一个问题，就是小程序内部运行机制与网页不同，小程序中的代码并不运行在浏览器中，因为小程序开发中，不存在数据的跨域请求限制。

所以我们不做跨域处理也可以访问。

问题 

如果微信开发者工具中，没有发送成功，可以试试如下方法。

14.2 二次封装请求对象

如果像上面那样，每次调用我都要去写请求的ip地址端口号，显得有些麻烦。

假如说ip地址或者端口号变了，那就得每一个请求都要逐一修改，这是很恐怖的！

所以，我们需要统一进行二次封装，对这些公共的参数统一进行设置或者修改。减少冗余，提高效率。

request.js

const BASE_URL = 'http://localhost:8000'export const myRequest = (options) => {return new Promise((resove,reject)=>{uni.request({url: BASE_URL + options.url,method: options.method || 'GET',data: options.data || {},success: (res) => {if(res.data.code != 1){return uni.showToast({title:'获取数据失败'})}resove(res)},fail: (err) => {uni.showToast({title:'请求接口失败'}),reject(err)}})})}

main.js

测试：编写页面调接口

这次我们换个接口试试

（哈哈，其实上面的那个接口是我年初写的，现在找不到代码了，自己重写😂）

我们尝试关闭接口，再次刷新页面发现页面显示：请求接口失败。ok，完全符合。 

又因为我们的请求是通过Promise返回的，所以我们可以异步的去调用方法。稍微修改一下，也能成功获取到。（记得重启后端项目哦😆）

十五、数据缓存

15.1 uni.setStorage(OBJECT)

将数据存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个异步接口。

OBJECT 参数说明

15.2 uni.getStorage(OBJECT)

从本地缓存中异步获取指定 key 对应的内容。

OBJECT 参数说明

success 返回参数说明

15.3 uni.removeStorage(OBJECT)

从本地缓存中异步移除指定 key。

OBJECT 参数说明

15.4 uni.setStorageSync(KEY,DATA)

将 data 存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个同步接口。

15.5 uni.getStorageSync(KEY)

从本地缓存中同步获取指定 key 对应的内容。

15.6 uni.removeStorageSync(KEY)

从本地缓存中同步移除指定 key。

十六、图片的上传和预览

16.1 上传

uni.chooseImage(OBJECT)

从本地相册选择图片或使用相机拍照。

App端如需要更丰富的相机拍照API（如直接调用前置摄像头），参考plus.camera

微信小程序从基础库 2.21.0 开始， wx.chooseImage 停止维护，请使用 uni.chooseMedia 代替。

OBJECT 参数说明

crop 参数说明

Tips

• count 值在 H5 平台的表现，基于浏览器本身的规范。目前测试的结果来看，只能限制单选/多选，并不能限制数量。并且，在实际的手机浏览器很少有能够支持多选的。

• sourceType 值在 H5 平台根据浏览器的不同而表现不同，一般不可限制仅使用相册，部分浏览器也无法限制是否使用相机。

• 可以通过用户授权API来判断用户是否给应用授予相册或摄像头的访问权限uni.authorize(OBJECT) | uni-app官网

• App端如需选择非媒体文件，可在插件市场搜索文件选择，其中Android端可以使用Native.js，无需原生插件，而iOS端需要原生插件。

• 选择照片大多为了上传，uni ui封装了更完善的uni-file-picker组件，文件选择、上传到uniCloud的免费存储和cdn中，一站式集成。强烈推荐使用。

注：文件的临时路径，在应用本次启动期间可以正常使用，如需持久保存，需在主动调用 uni.saveFile，在应用下次启动时才能访问得到。

success 返回参数说明

File 对象结构如下

 ok，这是简单的从本地获取图片到页面展示。但是真正的上传还没有完成。

这里我打算调用后端接口完成上传过程。

暂时写到这里，太累了。

如果这篇博客反响还不错的话，我会尽快完成跟新的 ，感谢大家的鼓励~