uni-app - 通用项目框架搭建及项目结构调整

demo 地址: https://github.com/iotjin/jh-uniapp-demo

本地数据存储:uni-app - 网络请求和数据存储工具类
自定义navbar:uni-app - 基于uView的base-navbar实现
全局常量和变量设置:uni-app - 全局常量和变量
scss的配置及使用:uni-app - 使用scss动态配置宫格布局

在这里插入图片描述
uni-app官网
uni-app插件市场
uni-app论坛
HBuilderX下载地址

官网介绍:

uni-app 是一个使用 Vue.js 开发所有前端应用的框架,开发者编写一套代码,可发布到iOS、Android、Web(响应式)、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉/淘宝)、快应用等多个平台。

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

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

博主觉得uni-app 较适合有多端开发需求或者支持多个小程序的项目,了解h5和Vue即可快速上手,懂小程序更佳,基本可以直接上手。推荐使用官方编译器HBuilderX进行开发。
如果要支持多端尽量选择多端兼容较好的插件,否则之后会遇坑不断
本项目使用的通用插件:uni-uiuView UI
小程序端用的vant weapp

uni-app的页面结构、数据绑定及事件处理类似vue,只不过标签由div换成了view
组件、生命周期、api调用方法类似小程序
组件内部生命周期同vue
一些vue的方法在移动端可能不支持

1、项目结构

├── common
│   ├── configs
│   ├── libs
│   ├── style
│   └── utils
├── components
├── dataManager
│   └── userDataManager.js
├── http
│   ├── apiConfig.js
│   └── httpUtils.js
├── hybrid
│   └── html
├── node_modules
│   └── uview-ui
├── pages
│   ├── index
│   ├── login
│   ├── module1
│   ├── module2
│   ├── module3
│   └── module4
├── platforms
│   └── app-plus
├── static
│   ├── fonts
│   ├── images
├── uni_modules
├── unpackage
├── wxcomponents
│   └── vant
├── App.vue
├── main.js
├── manifest.json
├── package-lock.json
├── package.json
├── pages.json
├── uni.scss

2、创建uni-app项目

在点击工具栏里的文件 -> 新建 -> 项目


在这里插入图片描述

生成一个包含 uni ui的项目模板,下图是默认的项目结构

在这里插入图片描述

然后1、项目结构进行扩充

3、安装uView UI

3.1、安装

进入uView UI 官网>npm安装,按文档操作

在这里插入图片描述

// 如果您的项目是HX创建的,根目录又没有package.json文件的话,请先执行如下命令:
// npm init -y

// 安装
npm install uview-ui

// 更新
npm update uview-ui
3.2、npm配置

进入uView UI 官网>npm配置,按文档操作

在这里插入图片描述

关于配置easycom组件模式,要注意npm和下载安装的配置不一样

    "easycom": {
        // npm方式安装的配置
        "^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
        // 下载安装方式配置
        // "^u-(.*)": "@/uview-ui/components/u-$1/u-$1.vue",
    },
在这里插入图片描述

4、项目结构调整

然后按照1、项目结构扩充项目结构
其中一级目录下的componentshybridplatformsstaticuni_modules
unpackagewxcomponents文件夹都有特殊意义,尽量不要改文件名称

5、新建页面

pages>module1文件夹右键>新建页面,依次创建主页面

在这里插入图片描述

6、pages.json配置

pages.json 文件介绍

pages.json 文件用来对 uni-app 进行全局配置,决定页面文件的路径、窗口样式、原生的导航栏、底部的原生tabbar 等。
它类似微信小程序中app.json的页面管理部分。注意定位权限申请等原属于app.json的内容,在uni-app中是在manifest中配置。

6.1、导航条设置

可在pages.json设置导航条名称,也可动态设置

在这里插入图片描述

6.2、tabbar设置

主要通过pagePath和页面进行绑定

在这里插入图片描述

7、登录页

添加一个登录页,会有一个默认的导航条,在page把导航条背景色改成白色即可
APP启动之后,先判断是否登录,本项目通过判断本地是否存有用户信息,有的话跳转到主页面,没有跳转到登录页

本地数据存储可看:uni-app - 网络请求和数据存储工具类
自定义navbar可看:uni-app - 基于uView的base-navbar实现
全局常量和变量设置可看:uni-app - 全局常量和变量

在这里插入图片描述

至此,一个通用项目框架搭建结束

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,053评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,527评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,779评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,685评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,699评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,609评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,989评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,654评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,890评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,634评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,716评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,394评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,976评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,950评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,191评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,849评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,458评论 2 342

推荐阅读更多精彩内容