# AppX

基于 Require、JQuery、Lodash、Typescript、Gulp等构建的模块化 Web App 框架。
具有：自动化、模块化、懒加载、高兼容性 以及 基于 Typescript 的智能提示等特性。

# 技术栈

- [Node.js](https://nodejs.org/en/) --- 基础开发环境
- [NPM](https://www.npmjs.cn/) --- Node包管理器
- [Bootstrap](http://www.bootcss.com/) --- 前端样式框架
- [EChart](http://echarts.baidu.com/) --- 图表展示框架
- [Git](https://git-scm.com/) --- 版本控制以及协作开发
- [Sass](https://www.sass.hk/) --- CSS 扩展
- [Javascript](https://en.wikipedia.org/wiki/JavaScript) --- 主要开发语言
- [Typescript](https://www.tslang.cn/) --- Javascript 扩展
- [Gulp](http://gulpjs.com/) --- 自动化工作
- [cesiumjs](https://cesiumjs.org) --- SuperMap iClient3D for WebGL 是基于此框架开发出来的 
- [SuperMap iClient3D for WebGL](http://support.supermap.com.cn:8090/webgl/WebGL_API/webgl_chm.html) --- 基于此API做二次开发
- [JQuery](http://jquery.com/) --- 杰出的 Javascript 库
- [Require](https://requirejs.org/) --- 模块化js工具
- [Lodash](https://lodash.com/) --- Javascript 函数库
- [Bower](https://bower.io/) --- Javascript 包管理器
- [Vue](https://cn.vuejs.org/) --- 渐进式JavaScript 框架

# 环境要求

| 应用名        | 版本号    | 查看版本      |
| ------------- |:-------- | :----------- |
| Node.js       | v10.19.0 | > node -v     |
| npm           | v6.13.4  | > npm -v      |
| Gulp          | v3.9.1   | > gulp -v     |
| Typescript    | v4.0.2   | > tsc -v      |
| Typings       | v2.1.1   | > typings -v  |

**建议使用IDE** ***[Visual Studio Code](https://code.visualstudio.com)***。

# 使用方法

```bash
git clone -b dev http://feb3d9ac8673.ngrok.io/lishun/sxgk_gis.git
cd AppX
npm install
npm start
```
*注：* 1.国内因为 GFW 的原因 `npm install` 可能会失败（安装 Sass 失败）。
如果失败，请用一下命令替换上方的 `npm install`, 其他命令不变。[CNPM](http://npm.taobao.org/)
```bash
npm install cnpm
cnpm install
```
*注：* 2.请在dev分支下建立自己的分支进行开发,并定期合并到dev分支。
1、本地从当前所在分支(dev分支)上创建一个新分支： 
git checkout -b 新分支名 
2、拉取远程某个分支到本地: 
git checkout -b 本地分支名 origin/远程分支名

3、功能开发完成后合并到父分支
（1）暂存自己修改的
（2）git checkout 父分支名 --切换到父分支
（3）git pull --拉取别人最新代码
（4）git merge --no-ff 合并分支名 --将自己分支合并到父分支
（5）git push --上传父分支
（6）如果有新代码，则需要删除本地分支，重新建本地分支
 git branch -d <BranchName>

# IIS部署注意MIME必须有如下配置项

| 文件扩展名     | MIME类型                   |
| ------------- |:--------                   |
| .json         | application/x-javascript   |
| .wsv          | application/octet-stream   |
| .wasm         | application/wasm           |
| .woff         | application/font-woff      |
| .woff2        | application/font-woff2     |
| .terrain      | application/vnd.quantized-mesh |
| .s3m          | audio/x-mod                |
 
# 开发人员

王海、李顺、朱博宇、黄伟航...