# uni-program

**Repository Path**: night_is_not_yet_ready/uni-program

## Basic Information

- **Project Name**: uni-program
- **Description**:  基于在uni同构框架的基础上搭建，面向H5、微信小程序、支付宝小程序等多端应用开发.
 已完成小程序分包,将路由,仓库,等都进行了模块化，开箱即用
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-12-03
- **Last Updated**: 2021-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 项目结构

 基于在[uni-app](https://uniapp.dcloud.io/)同构框架的基础上搭建，面向H5、微信小程序、支付宝小程序等多端应用开发.
 已完成小程序分包,将路由,仓库,等都进行了模块化

## 核心技术栈和工具库

1. 核心技术栈：基于ES2015+、Vue(及其生态系统)、Uni-app及其生态系统
2. 核心UI组件库：Uni-app内置组件、扩展组件、自有组件
3. Css预处理：Sass
4. 移动端调试工具：Eruda
5. 错误监控系统：Sentry(sentry.mobimedical.cn前端日志监控平台)  --暂未集成  
6. 项目包含eslint,vscode装上插件可以实现保存自动修复（Prettier - Code formatter，Vetur，stylelint，ESLint） 

## 相关链接

[uni-app](https://uniapp.dcloud.io/)
[uview](https://uviewui.com/)
[uni-simple-router](https://hhyang.cn/)


#### 安装
```bash
  
    npm install
```

#### 开发
```bash
    npm run serve    # 默认执行npm run dev:h5
```
or
```bash
    npm run dev:平台变量别名   # 平台变量别名请对照字典 
```

#### 编译
```bash
    npm run 环境变量别名:平台变量别名   # 环境变量别名和平台变量别名请对照字典 
```

#### PS:字典 

环境变量

|环境变量别名|说明|
|:----     |:-------              |
|dev	   |开发自测调试环境	       |
|test	   |线上测试环境	       |
|pre	   |线上预发布环境         |
|build	   |线上正式(生产)环境     |

平台变量

|平台变量别名|说明|
|:----        |:-------      |
|h5	          |移动端H5	     |
|mp-weixin	  |微信小程序	 |
|mp-alipay	  |支付宝小程序	 |


## 分支管理

开发时请严格遵守分支管理规范，具体分支约定如下：

```bash
# 固定分支
master              # 线上正式
pre                 # 线上预发布
test                # 线上测试环境
dev                 # 线上自测调试环境

# 开发
bug-x               # 处理Bug
feature-x           # 一次迭代
base-x              # 基础能力优化升级(一般涉及框架级)

# TIPS
固定分支不可直接用于开发
feature、bug、base都应该新建分支，且必须基于master分支创建
'x'命名必须符合语义化原则
```

## 发布与部署

整理中...

## 目录结构

开发者请遵守目录结构规范，把代码写在它舒服的位置;  
一般情况下，开发者只需要关注业务代码（src 目录下）

```bash
    ...
    ├─ node_modules             各种依赖
    │─ public                   存放静态资源,入口页面模板、logo等
    ├─ dist                     存放打包的项目文件
    │─ src
    │  ├─ components            符合vue组件规范的uni-app组件目录
    │  │  └─comp-a.vue          可复用的a组件
    │  ├─ hybrid                存放本地网页的目录，详见
    │  ├─ platforms             存放各平台专用页面的目录，详见
    │  ├─ pages                 业务页面文件存放的目录
    │  │  ├─ index
    │  │  │  └─index.vue        index页面
    │  │  └─list
    │  │     └─list.vue         list页面
    │  ├─ static                存放应用引用静态资源（如图片、视频等）的目录，注意：静态资源只能存放于此
    │  ├─ wxcomponents          存放小程序组件的目录，详见
    │  ├─ main.js               Vue初始化入口文件
    │  ├─ App.vue               应用配置，用来配置App全局样式以及监听
    │  ├─ manifest.json         配置应用名称、appid、logo、版本等打包信息
    │  └─ pages.json            配置页面路由、导航条、选项卡等页面类信息
    │─ package.json             模块基本信息 - 项目开发所需要的模块
    ├─ README.md                项目介绍
    

```

## 注意事项

### 小程序相关
1.小程序开发前置准备：微信需要加入开发者
2.小程序开发流程：小程序指令启动后，用微信开发者工具打开dist文件夹下dev-mp-weixin文件夹即可，页面会响应式编译，需要发布时，执行打包指令然后用小程序开发者工具切换到build-mp-weixin，然后提交代码，发布
3.小程序开发中可以不开启域名验证（右上角详情-本地设置-不效验合法域名），上线前需要配置所有域名（开发查看已有域名：右上角详情-项目配置）
4.小程序tab icon 只能用本地图片，建议尺寸81*81
6.小程序开发过程，不能页面嵌套过深（最多10层）