FUSE-Angular前端框架项目初始化

作者：高天阳

邮箱：[e-mail]

更改历史

* 2017-11-21    高天阳    初始化文档
* 2017-12-2     高天阳    补充导航、工具栏配置
* 2017-12-23     高天阳    补充最佳实践

1 克隆、安装及启动

1.1 在项目中添加clone权限：

1.2 克隆项目至本地：

git clone [项目克隆地址]

code:
git clone git@115.28.80.125:haomo/wechatgame.git

1.3 切换开发分支：

git branch -a   // 查看分支
git checkout dev    // 切换至dev分支

1.4 服务启动说明：

npm install // 安装服务器插件(若安装过慢或丢包，请使用cnpm安装)
bower install // 安装依赖的插件

1.5 服务启动：

gulp serve // 启动项目

2 目录结构、文件功能介绍

2.1 目录结构：

wechatgame/src/app/main/wegame/     编写代码存放目录
wechatgame/src/app/navigation/      框架导航配置
wechatgame/src/app/toolbar/         框架工具栏配置
wechatgame/bower_components         插件依赖
wechatgame/node_modules             开发依赖

2.2 主要文件及功能

• 项目主体

index.route.js   配置起始页面
index.module.js   配置项目目录
wechatgame/src/app/main/wegame/sample.module.js    toolbar配置文件
wechatgame/src/app/main/wegame/customer/customer.module.js    路由配置文件
wechatgame/src/app/main/wegame/customer/XXX.html    具体页面文件
wechatgame/src/app/main/wegame/customer/XXX.js    具体页面路由文件

• 导航栏

wechatgame/src/app/navigation/  导航配置
wechatgame/src/app/navigation/navigation.module.js   导航路由配置
wechatgame/src/app/navigation/navigation.controller.js   工具栏控制器配置
wechatgame/src/app/navigation/XXX/layouts   框架导航页面不同样式布局方案

一般情况下 只会修改页面样式 此次还修改了控制器 增加了一个打开关闭判定

• 工具栏

wechatgame/src/app/toolbar/         工具栏配置
wechatgame/src/app/toolbar/toolbar.module.js   工具栏路由配置
wechatgame/src/app/toolbar/toolbar.controller.js   工具栏控制器配置
wechatgame/src/app/toolbar/XXX/layouts   工具栏页面不同样式布局方案

工具栏主要包括:LOGO、下拉列表、搜索、国际化、更多

修改了工具栏LOGO内容、登录用户姓名 注释了下拉栏多余内容、国际化、更多

2.3 安装restangular并注入

安装restangular插件

bower install --save restangular

在项目路由配置文件引入restangular

在模块路由引入restangular

在页面路由引入restangular

3 常见问题及处理

3.1 模块加载失败

• 报错提示：路由配置出现问题

• 处理方法：页面路由需配置为模块的路由

3.2 Sass安装失败报错

• 报错提示：项目无法启动,报错提示如下图

• 处理方法1：此问题需安装node-sass

npm install node-sass

解决方法链接

• 处理方法2：此问题需查看node版本(过高或过低均会影响Sass安装 建议node-6.X.X版本)

3.3 bower、gulp命令不是内部或外部可识别的命令

• npm安装bower、gulp成功，但bower install、gulp serve却提示命令不是内部或外部可识别的命令

• 处理方法：全局安装bower、gulp

npm install bower -g
npm install gulp -g

3.4 配置restangular失败

• 报错提示：

• 处理方法：模块路由也需要注入restangular

3.5 表格查询后出现空白效果(客户体验不好)

• 报错提示：

• 问题分析：

单页显示数据量过大 导致翻页后页面渲染位置不正确

• 处理方法：删除ms-scroll

4 最佳实践

4.1 service注入

在项目中创建service文件

在调用公共方法的controller注入service

在controller中调用service的方法

• 注意:此样例service中引入了locals因此需要在项目中声明locals

若不引人项目会报错

4.2 datepicker汉化

• 原组件样式：

• 修改后组件样式：

• 处理方法：

/**
 * 时间格式化
 * @param date
 */
$mdDateLocaleProvider.months = ['一月', '二月', '三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月'];
$mdDateLocaleProvider.shortMonths = $mdDateLocaleProvider.months;
$mdDateLocaleProvider.days = ['星期日','星期一', '星期二', '星期三','星期四','星期五','星期六'];
$mdDateLocaleProvider.shortDays = ['日','一', '二', '三','四','五','六'];
$mdDateLocaleProvider.monthHeaderFormatter = function(date) {
  return date.getFullYear() + ' ' + $mdDateLocaleProvider.shortMonths[date.getMonth()];
};
$mdDateLocaleProvider.formatDate = function(date) {
  return date? moment(date).format('YYYY-MM-DD') : '';
};

4.3 登录用户名密码存储于cookies

• 页面样式：

• cookies存储位置：

• 处理方法：

HTML：

JS：

• 核心代码

/**
 * 存储cookie
 */
if(vm.isRemember){
    vm.setCookie('user',vm.form.loginId,7); //保存帐号到cookie，有效期7天
    vm.setCookie('pwd',vm.form.password,7); //保存密码到cookie，有效期7天
}else{
    vm.setCookie('user',"",-1); //清除cookie
    vm.setCookie('pwd',"",-1); //清除cookie
}

5 其他常用命令提示

5.1 引入ui-grid组件，为解决打包部署后框架文字变为韩文问题，在部署脚本写了替换css的命令。

5.2 切换分支命令(开发分支：dev)

git checkout -b dev  
git branch --set-upstream dev remotes/origin/dev

5.3 安装插件：

• 查看插件是否存在于bower库

bower search [插件名称]

• 安装插件并存储于项目依赖

bower install [插件名称] --save

bower install [插件名称] -S

• 安装插件并存储于开发依赖

bower install [插件名称] --save-dev

bower install [插件名称] -D

5.4 打包项目：

gulp build 打包

6 代码结构

vm.setSearchParams  = function(resetFlag){
  var deferred = $q.deferred();

  $q.all([1, 2]).then(function(values){
    vm.search.filters = {
      'table': {
        'column': {
          'in': values[0]
        }
      }
    }
  }, function(err){

  });

  Restangular().then(function(res){
    deferred.resolve(res.data);
  }, function(err){
    deferred.reject();
  });

  return deferred.promise;
};

vm.search = function(){
  vm.setFilters().then(function(data){
    vm.process(data);
  }, function(err){
    console.log(err);
  });

  Restangular().then(function(res){
    vm.process(data);
  })
};

vm.process = function(data){

};

vm.item = {};

vm.loadItem = function(id){
  Restangular().then(function(res){
    vm.item = res.data;
  })
};

vm.clearBeforeUpdate = function(){

};

vm.updateItem = function(){
  vm.clearBeforeUpdate();
  Restangular().post()
};

vm.columnOnChange = function(value){

};