|
|
@@ -0,0 +1,81 @@
|
|
|
+# 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://192.168.2.241:3000/wanghai/pbs_web.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 |
|
|
|
+
|
|
|
+# 开发人员
|
|
|
+
|
|
|
+王海、李顺、朱博宇、黄伟航...
|
|
|
+
|
