了解uni-app只需这一篇就足够了

Posted David凉宸

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了了解uni-app只需这一篇就足够了相关的知识，希望对你有一定的参考价值。

什么是uni-app

介绍

uni-app是一个使用 Vue.js 开发所有前端应用的框架，开发者编写一套代码，可发布到ios、android、Web（响应式）、以及各种小程序（微信/支付宝/百度/头条/QQ/钉钉/淘宝）、快应用等多个平台
在这里插入图片描述
uni-app在手，做啥都不愁，即使不跨端，uni-app也是更好的小程序开发框架（详见）、更好的App跨平台框架、更方便的H5开发框架。不管领导安排什么样的项目，你都可以快速交付，不需要转换开发思维、不需要更改开发习惯

只要你有Vue和小程序的开发经验，即可快速上手

一套代码可以编译到10个平台
在这里插入图片描述

为什么选择uniapp

uni-app在开发者数量、案例、跨端抹平度、扩展灵活性、性能体验、周边生态、学习成本、开发成本等8大关键指标上拥有更强的优势
在这里插入图片描述

uni-app 功能框架

在这里插入图片描述

一套代码运行

在这里插入图片描述
在这里插入图片描述

uni-app作品

在这里插入图片描述
更多作品点击这里

uni-app规模

在这里插入图片描述

快速上手uni-app

uni-app支持通过 可视化界面、vue-cli命令行 两种方式快速创建项目

可视化的方式比较简单，HBuilderX内置相关环境，开箱即用，无需配置nodejs

开始之前，开发者需先下载安装如下工具：
HBuilderX：下载地址

下载与安装步骤

HBuilderX是通用的前端开发工具，但为uni-app做了特别强化
下载App开发版，可开箱即用；如下载标准版，在运行或发行uni-app时，会提示安装uni-app插件，插件下载完成后方可使用
如使用cli方式创建项目，可直接下载标准版，因为uni-app编译插件被安装到项目下了

使用HBuilderX初始化项目

点击工具栏里的文件 -> 新建 -> 项目
在这里插入图片描述
在这里插入图片描述
如果有需要可以选择其他模板，然后他会自动去官网下载对应的模板
在这里插入图片描述
在这里插入图片描述
这就证明创建成功可以使用了

使用HBuilderX运行项目

浏览器运行：进入hello-uniapp项目，点击工具栏的运行 -> 运行到浏览器 -> 选择浏览器，即可在浏览器里面体验uni-app 的 H5 版
在这里插入图片描述

真机运行：连接手机，开启USB调试，进入hello-uniapp项目，点击工具栏的运行 -> 真机运行 -> 选择运行的设备，即可在该设备里面体验uni-app
在这里插入图片描述
若手机无法识别，请点击菜单运行-运行到手机或模拟器-真机运行常见故障排查指南

在微信开发者工具里运行：进入hello-uniapp项目，点击工具栏的运行 -> 运行到小程序模拟器 -> 微信开发者工具，即可在微信开发者工具里面体验uni-app
在这里插入图片描述

其他启动方式都雷同的，只是平台不同，自己选择即可

如果是第一次，可能会运行不成功（大多数不需要自己配置）
在这里插入图片描述
在这里插入图片描述

在这里面可以配置对应的目录

使用HBuilderX打包项目

原生App

在HBuilderX工具栏，点击发行，选择原生app-云端打包
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
打包具体步骤

可以打包安卓和IOS，但是IOS需要证书哦

H5

在 manifest.json 的可视化界面，进行如下配置（发行在网站根目录可不配置应用基本路径）
在这里插入图片描述

在这里插入图片描述
在这里插入图片描述

小程序

以微信小程序为例：
申请AppID 教程

HBuilderX中顶部菜单依次点击 “发行” => “小程序-微信”，输入小程序名称和appid点击发行即可在 unpackage/dist/build/mp-weixin 生成微信小程序项目代码
在这里插入图片描述
在这里插入图片描述
在微信小程序开发者工具中，导入生成的微信小程序项目，测试项目代码运行正常后，点击“上传”按钮，之后按照 “提交审核” => “发布” 小程序标准流程，逐步操作即可，详细查看

使用Vue-cli创建项目

环境安装

全局安装vue-cli

npm install -g @vue/cli

创建uni-app

使用正式版（对应HBuilderX最新正式版）

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

使用alpha版（对应HBuilderX最新alpha版）

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

此时，会提示选择项目模板，初次体验建议选择 hello uni-app 项目模板
在这里插入图片描述
选择自定义模板时，需要填写 uni-app 模板地址，这个地址其实就是托管在云端的仓库地址。以 GitHub 为例，地址格式为 userName/repositoryName，如 dcloudio/uni-template-picture 就是下载图片模板

模板项目存放于 Github，由于国内网络环境问题，可能下载失败。针对此问题可以尝试如下措施：

更换网络重试，比如使用 4g 网络
在设备或路由器的网络设置中增加 DNS（如：8.8.8.8）
在设备中增加固定的 hosts（如：140.82.113.4 github.com）

修改依赖为指定版本

查看 HBuilderX 对应的 NPM 依赖版本: 打开 NPM版本记录，版本号 2.0.0- 后面是与 HBuilderX 对应的版本号且小版本不会超过9，比如 HBuilderX 2.7.5.20200518 对应的版本号 2.0.0-27520200518001，2.0.0-271420200618 对应的为 2.0.0-27920200618002。

批量修改 package.json 中 uni 相关依赖为指定的版本号（去掉版本号前面 ^）。

对于有变化的依赖进行增删，提示不存指定版本的依赖可以保留原始版本或者删除，运行时提示缺少的依赖自行安装

运行、发布uni-app

npm run dev:%PLATFORM%
npm run build:%PLATFORM%

在这里插入图片描述
可以自定义更多条件编译平台，比如钉钉小程序 参考地址

  • 目前使用npm run build:app-plus会在/dist/build/app-plus下生成app打包资源。如需制作wgt包，将app-plus中的文件压缩成zip（注意：不要包含app-plus目录），再重命名为${appid}.wgt， appid为manifest.json文件中的appid
  • dev 模式编译出的各平台代码存放于根目录下的 /dist/dev/目录，打开各平台开发工具选择对应平台目录即可进行预览（h5 平台不会在此目录，存在于缓存中）
  • build 模式编译出的各平台代码存放于根目录下的 /dist/build/ 目录，发布时选择此目录进行发布
  • ev 和 build 模式的区别
    dev 模式有 SourceMap 可以方便的进行断点调试
    build 模式会将代码进行压缩，体积更小更适合发布为正式版应用
    进行 环境判断 时，dev 模式 process.env.NODE_ENV 的值为 development，build 模式 process.env.NODE_ENV 的值为 production

使用cli创建项目和使用HBuilderX可视化界面创建项目区别

在这里插入图片描述

说明

开发规范

  • 页面文件遵循 Vue 单文件组件 (SFC) 规范
  • 组件标签靠近小程序规范，详见uni-app 组件规范
  • 接口能力（JS API）靠近微信小程序规范，但需将前缀 wx 替换为 uni，详见uni-app接口规范
  • 数据绑定及事件处理同 Vue.js 规范，同时补充了App及页面的生命周期
  • 为兼容多端运行，建议使用flex布局进行开发

目录结构


┌─uniCloud              云空间目录，阿里云为uniCloud-aliyun,腾讯云为uniCloud-tcb（[详见uniCloud](https://uniapp.dcloud.io/uniCloud/quickstart?id=%E7%9B%AE%E5%BD%95%E7%BB%93%E6%9E%84)）
│─components            符合vue组件规范的uni-app组件目录
│  └─comp-a.vue         可复用的a组件
├─hybrid                App端存放本地html文件的目录     ([详情](https://uniapp.dcloud.io/component/web-view))
├─platforms             存放各平台专用页面的目录	（[详情](https://uniapp.dcloud.io/platform?id=%E6%95%B4%E4%BD%93%E7%9B%AE%E5%BD%95%E6%9D%A1%E4%BB%B6%E7%BC%96%E8%AF%91)）
├─pages                 业务页面文件存放的目录
│  ├─index
│  │  └─index.vue       index页面
│  └─list
│     └─list.vue        list页面
├─static                存放应用引用的本地静态资源（如图片、视频等）的目录，注意：静态资源只能存放于此
├─uni_modules           存放[uni_module](/uni_modules)规范的插件。
├─wxcomponents          存放小程序组件的目录		（[详情](https://uniapp.dcloud.io/frame?id=%E5%B0%8F%E7%A8%8B%E5%BA%8F%E7%BB%84%E4%BB%B6%E6%94%AF%E6%8C%81)）
├─main.js               Vue初始化入口文件
├─App.vue               应用配置，用来配置App全局样式以及监听 [应用生命周期](https://uniapp.dcloud.io/collocation/frame/lifecycle?id=%E5%BA%94%E7%94%A8%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F)
├─manifest.json         配置应用名称、appid、logo、版本等打包信息  （[详情](https://uniapp.dcloud.io/collocation/manifest)）
└─pages.json            配置页面路由、导航条、选项卡等页面类信息 		（[详情](https://uniapp.dcloud.io/collocation/pages)）
  • 编译到任意平台时，static 目录下的文件均会被完整打包进去，且不会编译。非 static 目录下的文件（vue、js、css 等）只有被引用到才会被打包编译进去。
  • static 目录下的 js 文件不会被编译，如果里面有 es6 的代码，不经过转换直接运行，在手机设备上会报错。
  • css、less/scss 等资源不要放在 static 目录下，建议这些公用的资源放在自建的 common 目录下。
  • HbuilderX 1.9.0+ 支持在根目录创建 ext.json、sitemap.json 等小程序需要的文件

在这里插入图片描述

common :存放api的

components  :组件存放目录

pages  :所有的页面存放目录

static  :静态资源目录，例如图片等

unpackage  :就是打包目录，在这里有各个平台的打包文件

utils : 存放api

App.vue  :是我们的跟组件，所有页面都是在App.vue下进行切换的，是页面入口文件，可以调用应用的生命周期函数

main.js  :是我们的项目入口文件，主要作用是初始化vue实例并使用需要的插件

manifest.json : 文件是应用的配置文件，用于指定应用的名称、图标、权限等

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

uni.scss  :文件的用途是为了方便整体控制应用的风格。比如按钮颜色、边框风格，uni.scss文件里预置了一批scss变量预置

资源路径

模板内引入静态资源

template内引入静态资源，如image、video等标签的src属性时，可以使用相对路径或者绝对路径

<!-- 绝对路径，/static指根目录下的static目录，在cli项目中/static指src目录下的static目录 -->
<image class="logo" src="/static/logo.png"></image>
<image class="logo" src="@/static/logo.png"></image>
<!-- 相对路径 -->
<image class="logo" src="../../static/logo.png"></image>
  • @开头的绝对路径以及相对路径会经过base64转换规则校验
  • 引入的静态资源在非h5平台，均不转为base64。
  • H5平台，小于4kb的资源会被转换成base64，其余不转。
  • 自HBuilderX 2.6.6起template内支持@开头路径引入静态资源，旧版本不支持此方式
  • App平台自HBuilderX 2.6.9起template节点中引用静态资源文件时（如：图片），调整查找策略为【基于当前文件的路径搜索】，与其他平台保持一致
  • 支付宝小程序组件内 image 标签不可使用相对路径

js文件引入

js文件或script标签内（包括renderjs等）引入js文件时，可以使用相对路径和绝对路径

// 绝对路径，@指向项目根目录，在cli项目中@指向src目录
import add from '@/common/add.js'
// 相对路径
import add from '../../common/add.js'
  • js文件不支持使用/开头的方式引入

css引入静态资源

  • css文件或style标签内引入css文件时（scss、less文件同理），可以使用相对路径或绝对路径（HBuilderX 2.6.6）
/* 绝对路径 */
@import url('/common/uni.css');
@import url('@/common/uni.css');
/* 相对路径 */
@import url('../../common/uni.css');

自HBuilderX 2.6.6起支持绝对路径引入静态资源，旧版本不支持此方式

  • css文件或style标签内引用的图片路径可以使用相对路径也可以使用绝对路径，需要注意的是，有些小程序端css文件不允许引用本地文件
/* 绝对路径 */
background-image: url(/static/logo.png);
background-image: url(@/static/logo.png);
/* 相对路径 */
background-image: url(../../static/logo.png);
  • 引入字体图标请参考，字体图标
  • @开头的绝对路径以及相对路径会经过base64转换规则校验
  • 不支持本地图片的平台，小于40kb，一定会转base64。（共四个平台mp-weixin, mp-qq, mp-toutiao, app v2）
  • h5平台，小于4kb会转base64，超出4kb时不转。
  • 其余平台不会转base64

生命周期

uni-app 支持 onLaunch、onShow、onHide 等应用生命周期函数，详情请参考应用生命周期

uni-app 支持 onLoad、onShow、onReady 等生命周期函数，详情请参考页面生命周期

uni-app页面路由为框架统一管理，开发者需要在pages.json里配置每个路由页面的路径及页面样式。类似小程序在app.json中配置页面路由一样。所以 uni-app 的路由用法与 Vue Router 不同，如仍希望采用 Vue Router 方式管理路由，可在插件市场搜索 Vue-Router

在这里插入图片描述
配置、框架接口、框架、api看官方文档即可，通俗易懂

配置、框架接口

框架

API

使用云服务器

敬请期待后面的实战项目，我会分步给大家作解释，让大家更好的进入实战

以上是关于了解uni-app只需这一篇就足够了的主要内容，如果未能解决你的问题，请参考以下文章

MIX2 适配看这一篇就够了，18:9 只需一行代码

MIX2 适配看这一篇就够了，18:9 只需一行代码

入门学习uni-app只需这一篇即可

GraphQL入门有这一篇就足够了

Java多线程看这一篇就足够了

SV报文解析看看这一篇就足够了