uni-app快速入门指南

一、快速了解uni-app

1.1、概述

uni-app是一个基于Vue.js框架的跨平台应用开发框架,可以用来开发同时运行在多个平台的应用,包括iOS、Android、Web、以及各种小程序平台(如微信小程序、支付宝小程序、百度小程等)。uni-app的特点是一套代码可以同时运行在多个平台上,开发者只需要编写一次代码,就可以生成多个平台的应。

 uni-app提供了一套完整的开发工具和组件库,开发者可以使用Vue.js的语法来开发应用,且通过uni-app提供的编译工具将代码编译成各个平台所需要的原生代码,从而实现跨平台的应开发。uni-app还提供了丰富的组件库和插件,可以帮助开发者更快速地构建应用。

1.2、特点 

跨更多平台

(2)、一套代码,多平台运行

(3)、运行体验好,性能高

(4)、开发生态、周边生态丰富(组件丰富)

(5)、通用技术栈,学习/开发成本低

二、uni-app基础知识及配置

2.1、基础知识

2.1.1 、开发规范

uni-app开发规范遵循以下原则:

(1)、页面文件遵循Vue单文件组件

(2)、组件标签规范类似于微信小程序规范。

(3)、接口能力(JS API)规范类似微信小程序规范,但需要将wx前缀改为uni。

(4)、数据绑定及事件处理同Vue.js规范,同时额外补充了uniapp本身的App及页面的生命周期的规范。

(5)、为了更好的兼容多端运行,建议使用Flex布局进行开发。

 2.1.2、uni-app文件目录结构

uni-app快速入门指南_第1张图片

2.2、 基础配置

2.2.1、全局配置

全局配置主要在page.json文件里进行配置,可以配置页面路径、窗口样式、导航显示、底部tabBar的显示等等。

属性 类型 必填 描述
globalStyle Object 设置默认页面的窗口表现
pages Object Array 设置页面路径及窗口表现
tabBar Object 设置底部 tab 的表现
condition Object 启动模式配置
easycom Object 组件自动引入规则
subPackages Object Array 分包加载配置
uniIdRouter Object

自动跳转相关配置,新增于HBuilderX 3.5.0 

 2.2.2、应用配置

应用配置主要在manifest.json文件里进行配置,用于指定应用的名称、图标、权限等。HBuilderX 创建的工程此文件在根目录,CLI 创建的工程此文件在 src 目录。

属性 类型 默认值 描述
name String 应用名称
appid String 新建 uni-app 项目时,DCloud 云端分配。 应用标识
description String 应用描述
versionName String 版本名称,例如:1.0.0。详见下方Tips说明
versionCode Number 版本号,例如:36

2.2.3、页面配置

页面配置主要配置页面的样式、标题、导航栏等等,主要在page.json文件中的pages节点进行页面的配置。注:页面配置的权重高于全局配置

属性 类型 默认值 描述
path String 配置页面路径
style Object 配置页面窗口表现,配置项参考下方 pageStyle
needLogin Boolean false 是否需要登录才可访问

三、uni-app的组件

Uni-app提供了丰富的组件库,以下是其中一些常用的组件:

3.1、视图容器组件

  • :类似于HTML中的
    ,用于包裹其他组件。
  • :滚动视图容器,用于展示超出容器尺寸的内容,并支持纵向和横向滚动。
  • :轮播组件,用于实现图片轮播效果。

3.2、基础内容组件

  • :文本内容组件,用于显示文本内容。
  • :图标组件,用于显示图标。

 3.3、表单组件

  • :输入框组件,用于用户输入文本。