# jecloud-app-demo

**Repository Path**: huangjunfa/jecloud-app-demo

## Basic Information

- **Project Name**: jecloud-app-demo
- **Description**: App微应用项目案例
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-05-09
- **Last Updated**: 2024-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 移动端骨架项目

## 项目介绍
移动端骨架项目是JECloud移动端所有微应用项目的项目模板，通过骨架项目可以快速的创建和开发JECloud移动端微应用，他包含通用的应用架构，工具类，主子通讯等模块，骨架项目只支持H5端的微应用。

## 项目目录

```bash

│  .commitlintrc.js     # Git 提交校验配置文件
│  .editorconfig        # 编辑器配置文件
│  .env                 # 公共环境配置文件
│  .env.development     # 开发环境配置文件
│  .env.production      # 生产环境配置文件
│  .eslintignore        # eslint 忽略校验配置文件
│  .eslintrc.js         # eslint 校验配置文件
│  .gitattributes       # Git 配置文件，设置行末字符为LF
│  .gitignore           # Git 忽略提交配置文件
│  .prettierrc.js       # 代码格式化配置文件
│  CHANGELOG.md         # Git 提交记录
│  package.json         # 项目配置
│  README.md            # 说明文档
├─.vscode               # vscode 项目配置目录，不建议私自修改
├─build                 # 项目构建目录
└─src                   # uniapp 源码目录
  ├─api                 # 应用接口
  ├─app                 # 应用入口，可自定义修改
  ├─assets              # 资源目录
  ├─components          # 组件
  ├─helper              # 工具类
  ├─hooks               # 钩子函数类
  ├─locale              # 系统界别的国际化，需要在本目录设置，如page.json里的页面标题国际化
  ├─model               # 实体类
  ├─pages               # 页面
  ├─service             # 系统目录，禁止修改，防止无法同步最新代码
  ├─static              # 静态资源
  ├─store               # 状态管理
  ├─App.vue             # uni-app主组件，禁止修改，防止无法同步最新代码
  ├─main.js             # uni-app入口文件，禁止修改，防止无法同步最新代码
  ├─manifest.json       # uni-app应用配置文件
  ├─pages.json          # uni-app页面路由
  └─uni.scss            # uni-app预置scss变量
```


## 开发环境
### node
`v 14.18.3`

### npm 
`v 6.14.15`

### JECloud npm私服地址
http://verdaccio.jecloud.net/

## 基础库项目部署
本地项目调试之前，需要先把 [PC基础库项目](https://gitee.com/ketr/jecloud-pc-libs.git) 和 `App基础库项目（购买后获得）` 部署完成。
```bash
# 全局安装 yalc，lerna
npm i yalc lerna@^6.0.0 -g

# 下载PC项目
git clone https://gitee.com/ketr/jecloud-pc-libs.git
# 下载App项目（购买后可以获取项目地址）
git clone https://xxx/jecloud-app-libs.git

# 进入对应项目目录，依次执行以下命令
# 安装依赖
npm run setup

# 发布基础库
npm run yalc:publish

```

## 项目命令

### 安装依赖
```bash
# 非源码用户，不需要部署基础库项目，直接安装npm包依赖
npm run setup:lib

# 源码用户，开发调试用户，请部署本地基础库项目后，再安装依赖
npm run setup
```

### 启动服务
```bash
npm run dev
```

### 代码构建
```bash
npm run build
```
### Git代码提交
项目增加了Git提交规范，强烈建议使用 `commitizen`（格式化commit message的工具）来进行Git提交操作，请使用下面命令

```bash
npm run commit
```

### 生成Git提交记录

```bash
# 先开启合并策略，防止骨架项目与插件项目的CHANGELOG.md文件冲突
# git config --global merge.ours.driver true
npm run changelog
```


## JECloud主目录
[JECloud 微服务架构低代码平台（点击了解更多）](https://gitee.com/ketr/jecloud.git)