angularjs sill 创建项目_AngularJS从构建项目开始

AngularJS体验式编程系列文章，将介绍如何用angularjs构建一个强大的web前端系统。angularjs是由Google团队开发的一款非常优秀web前端框架。在当前如此多的web框架下，angularjs能脱颖而出，从架构设计上就高人一等，双向数据绑定，依赖注入，指令，MVC，模板。Angular.js创新地把后台技术融入前端开发，扫去jQuery一度的光芒。用angularjs就像写后台代码，更规范，更结构化，更可控。

关于作者

张丹(Conan), 程序员Java,R,PHP,Javascript

weibo：@Conan_Z

email: bsspirit@gmail.com

转载请注明出处：

前言

随着AngularJS被越来越多的开发人员所了解，AngularJS的应用受到市场的好评。AngularJS是一种新型的以Javascript为基础的框架，以后台的编程思路影响着web前端的开发。在扎根细节之前，让我们先了解AngularJS项目构架。自顶向下的开始，就是不一样的开发。Angular体验式编程从此开始。

目录

AngularJS介绍

构建AngularJS项目(Yeoman，angular-seed)

AngularJS项目结构(Yeoman)

AngularJS必备基础

启动项目

1. AngularJS介绍

AngularJS是一个为动态WEB应用设计的结构框架。它能让你使用HTML作为模板语言，通过扩展HTML的语法，让你能更清楚、简洁地构建你的应用组件。它的创新点在于，利用 数据绑定 和 依赖注入，它使你不用再写大量的代码了。这些全都是通过浏览器端的Javascript实现，这也使得它能够完美地和任何服务器端技术结合。

AngularJS介绍，摘自：http://angularjs.cn/A00n

2. 构建AngularJS项目(Yeoman，angular-seed)

说到构建项目，目前我了解的有三种：

手工项目: 自己建目录，下载类库，写html,js,css，自己实现引用关系

angular-seed项目: 下载github的angular-seed，在别人的基础之上开发

Yeoman项目：通过Yeoman下载一个标准Yeoman项目，已经内置了grunt及各种工具包

1). 手工项目

构建手工项目是我们平时用的最多的一种方式了，适用于小型或demo项目。我不在解释，参照angularjs一步一步操作就行了。

2). angular-seed项目

一般把这个项目称为angular的“种子项目”，构建方法是去github下载项目源代码，基于已有项目结构再做开发。这种项目都融入了前人的经验，会以一种比较合理的结构，帮我们构建出项目的原型。适合于有一定规模项目开发，同时更适合geek的扩展。

下载演示一下构建过程

~ D:\workspace\javascript>git clone https://github.com/bsspirit/angular-seed.git

Cloning into 'angular-seed'...

remote: Counting objects: 1007, done.

remote: Compressing objects: 100% (497/497), done.

emote: Total 1007 (delta 521), reused 847 (delta 412)

Receiving objects: 100% (1007/1007), 6.30 MiB | 164 KiB/s, done.

Resolving deltas: 100% (521/521), done.

~ D:\workspace\javascript>cd angular-seed

~ D:\workspace\javascript\angular-seed>node scripts\web-server.js

Http Server running at http://localhost:8000/

打开浏览器：http://localhost:8000/app/index.html

通过阅读READMD.md，我们可以了解这个”种子项目”如何使用。

项目目录及介绍

## Directory Layout

app/ --> all of the files to be used in production

css/ --> css files

app.css --> default stylesheet

img/ --> image files

index.html --> app layout file (the main html template file of the app)

index-async.html --> just like index.html, but loads js files asynchronously

js/ --> javascript files

app.js --> application

controllers.js --> application controllers

directives.js --> application directives

filters.js --> custom angular filters

services.js --> custom angular services

lib/ --> angular and 3rd party javascript libraries

angular/

angular.js --> the latest angular js

angular.min.js --> the latest minified angular js

angular-*.js --> angular add-on modules

version.txt --> version number

partials/ --> angular view partials (partial html templates)

partial1.html

partial2.html

config/karma.conf.js --> config file for running unit tests with Karma

config/karma-e2e.conf.js --> config file for running e2e tests with Karma

scripts/ --> handy shell/js/ruby scripts

e2e-test.sh --> runs end-to-end tests with Karma (*nix)

e2e-test.bat --> runs end-to-end tests with Karma (windows)

test.bat --> autotests unit tests with Karma (windows)

test.sh --> autotests unit tests with Karma (*nix)

web-server.js --> simple development webserver based on node.js

test/ --> test source files and libraries

e2e/ -->

runner.html --> end-to-end test runner (open in your browser to run)

scenarios.js --> end-to-end specs

lib/

angular/ --> angular testing libraries

angular-mocks.js --> mocks that replace certain angular services in tests

angular-scenario.js --> angular's scenario (end-to-end) test runner library

version.txt --> version file

unit/ --> unit level specs/tests

controllersSpec.js --> specs for controllers

directivessSpec.js --> specs for directives

filtersSpec.js --> specs for filters

servicesSpec.js --> specs for services

启动server

node scripts/web-server.js

单元测试(Unit test)：karma + jasmine

端到端测试(End to End test)：karma + jasmine + webserver

我们大概了解了“种子工程”的全貌，这样子心理有数了，就可以开始我们的项目开发了。

对于更高要求的开发者来说，“种子工程”的基础是不够。

1. karam，jasmine都需要手动安装

2. 没有代码自动化(自动增加controller…)

3. 没有实现构建自动化(自动打包，自动压缩js…)

……

一个大型项目构成是方方面面的，接下来我们通过标准化的Yeoman来构建一个企业级应用的项目基础。

3). Yeoman项目

yeoman是一个标准化的项目开发工作流工具，详细使用介绍请参考：Yeoman自动构建js项目

通过yeoman也构建项目

~ D:\workspace\javascript>mkdir nodejs-angular

~ D:\workspace\javascript>cd nodejs-angular

~ D:\workspace\javascript>npm install -g generator-angular

# 创建项目

~ D:\workspace\javascript\nodejs-angular>yo angular

[?] Would you like to include Twitter Bootstrap? Yes

[?] Would you like to use the SCSS version of Twitter Bootstrap with the Compass CSS Authoring Framework? No

[?] Which modules would you like to include? angular-resource.js, angular-cookies.js, angular-sanitize.js

create app/styles/bootstrap.css

create app/styles/main.css

create app\index.html

create bower.json

create package.json

create Gruntfile.js

invoke angular:common:D:\toolkit\nodejs\node_modules\generator-angular\app\index.js

create .bowerrc

create .editorconfig

create .gitattributes

create .jshintrc

create app\.buildignore

create app\.htaccess

create app\404.html

create app\favicon.ico

create app\robots.txt

create app\views\main.html

create test\.jshintrc

create test\runner.html

create .gitignore

invoke angular:main:D:\toolkit\nodejs\node_modules\generator-angular\app\index.js

create app\scripts\app.js

invoke angular:controller:D:\toolkit\nodejs\node_modules\generator-angular\app\index.js

create app\scripts\controllers\main.js

create test\spec\controllers\main.js

invoke karma:app

create karma.conf.js

create karma-e2e.conf.js

create .travis.yml

I'm all done. Running bower install & npm install for you to install the required dependencies. If this fails, try runni

ng the command yourself.

输入yo angular后，会提示我们要不要使用bootstrap;要不要用SCSS生成CSS;要不要include试angular的资源文件。我们选择完以后，会列出生成的项目文件，这个命令执行要2分钟左右，会自动下载很多的依赖包。

3. AngularJS项目结构(Yeoman)

更直观地看到目录结构

.tmp：临时目录

app:开发的源代码的目录

dist:生成用于发布的项目

node_modules:nodejs依赖包

test:测试文件的目录

.bowerrc:bower属性

.editooconfig:对开发工具的属性配置

.gitattributes:git属性的配置

.gitignore:git管理文件的配置

.jshintr:JSHint配置

.travis.yml:travis-ci持续集成的配置

bower.json:bower依赖管理

Gruntfile.js:grunt开发过程管理

karma.conf.js:karma自动化测试

karma-e2e.conf.js:karma端到端自动化测试

package.json:项目依赖文件

4. AngularJS必备基础

从上面的目录结构，我们可以看出AngularJS对哪些东西是需要的。

git, yeoman, bower, grunt, karma …

所以，不要着急上手，先把基础工具都掌握，请参考系列文章：从零开始nodejs系列文章：成为高手 – 进阶篇

基础知识掌握多少，注定我们能开发多大规模的项目。

5. 启动项目

我们下载这个工程后，发现没有任何的文档。启动项目应该如何操作呢？

从刚才分析目录及文件结构，我们知道了这个项目是基于grunt构建的，那么一切的操作都会源于Gruntfile.js。grunt的详细介绍，请参考：grunt让Nodejs规范起来

打开Gruntfile.js，直接定位到grunt.registerTask()

grunt.registerTask('server', function (target) {

if (target === 'dist') {

return grunt.task.run(['build', 'open', 'connect:dist:keepalive']);

}

grunt.task.run([

'clean:server',

'concurrent:server',

'autoprefixer',

'connect:livereload',

'open',

'watch'

]);

});

grunt.registerTask('test', [

'clean:server',

'concurrent:test',

'autoprefixer',

'connect:test',

'karma'

]);

grunt.registerTask('build', [

'clean:dist',

'useminPrepare',

'concurrent:dist',

'autoprefixer',

'concat',

'copy:dist',

'cdnify',

'ngmin',

'cssmin',

'uglify',

'rev',

'usemin'

]);

grunt.registerTask('default', [

'jshint',

'test',

'build'

]);

这里定义了4个任务：server，test，build, default。

从名字看就能猜出对应该的功能。

启动server

~ D:\workspace\javascript\nodejs-angular>grunt server

Running "server" task

Running "clean:server" (clean) task

Cleaning .tmp...OK

Running "concurrent:server" (concurrent) task

Running "coffee:dist" (coffee) task

Running "copy:styles" (copy) task

Running "autoprefixer:dist" (autoprefixer) task

File ".tmp/styles/bootstrap.css" created.

File ".tmp/styles/main.css" created.

Running "connect:livereload" (connect) task

Started connect web server on localhost:9000.

Running "open:server" (open) task

Running "watch" task

Waiting...

浏览器被自动打开：http://localhost:9000/#/

执行default任务，生成用于部署的目录dist

~ D:\workspace\javascript\nodejs-angular>grunt --force

Running "jshint:all" (jshint) task

>> 3 files lint free.

Warning: Task "karma" not found. Used --force, continuing.

Running "clean:dist" (clean) task

Cleaning .tmp...OK

Cleaning dist/.htaccess...OK

Cleaning dist/404.html...OK

Cleaning dist/bower_components...OK

Cleaning dist/favicon.ico...OK

Cleaning dist/index.html...OK

Cleaning dist/robots.txt...OK

Cleaning dist/scripts...OK

Cleaning dist/styles...OK

Cleaning dist/views...OK

Running "useminPrepare:html" (useminPrepare) task

Going through app/index.html to update the config

Looking for build script HTML comment blocks

Found a block:

Updating config with the following assets:

- .tmp\styles\bootstrap.css

- .tmp\styles\main.css

Found a block:

Updating config with the following assets:

- app\bower_components\bootstrap-sass\js\bootstrap-affix.js

- app\bower_components\bootstrap-sass\js\bootstrap-alert.js

- app\bower_components\bootstrap-sass\js\bootstrap-dropdown.js

- app\bower_components\bootstrap-sass\js\bootstrap-tooltip.js

- app\bower_components\bootstrap-sass\js\bootstrap-modal.js

- app\bower_components\bootstrap-sass\js\bootstrap-transition.js

- app\bower_components\bootstrap-sass\js\bootstrap-button.js

- app\bower_components\bootstrap-sass\js\bootstrap-popover.js

- app\bower_components\bootstrap-sass\js\bootstrap-typeahead.js

- app\bower_components\bootstrap-sass\js\bootstrap-carousel.js

- app\bower_components\bootstrap-sass\js\bootstrap-scrollspy.js

- app\bower_components\bootstrap-sass\js\bootstrap-collapse.js

- app\bower_components\bootstrap-sass\js\bootstrap-tab.js

Found a block:

Updating config with the following assets:

- app\bower_components\angular-resource\angular-resource.js

- app\bower_components\angular-cookies\angular-cookies.js

- app\bower_components\angular-sanitize\angular-sanitize.js

Found a block:

Updating config with the following assets:

- {.tmp,app}\scripts\app.js

- {.tmp,app}\scripts\controllers\main.js

Configuration is now:

cssmin:

{ 'dist\\styles\\main.css': 'dist\\styles\\main.css' }

concat:

{ 'dist\\styles\\main.css':

[ '.tmp\\styles\\bootstrap.css',

'.tmp\\styles\\main.css' ],

'dist\\scripts\\plugins.js':

[ 'app\\bower_components\\bootstrap-sass\\js\\bootstrap-affix.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-alert.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-dropdown.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-tooltip.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-modal.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-transition.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-button.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-popover.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-typeahead.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-carousel.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-scrollspy.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-collapse.js',

'app\\bower_components\\bootstrap-sass\\js\\bootstrap-tab.js' ],

'dist\\scripts\\modules.js':

[ 'app\\bower_components\\angular-resource\\angular-resource.js',

'app\\bower_components\\angular-cookies\\angular-cookies.js',

'app\\bower_components\\angular-sanitize\\angular-sanitize.js' ],

'dist\\scripts\\scripts.js':

[ '{.tmp,app}\\scripts\\app.js',

'{.tmp,app}\\scripts\\controllers\\main.js' ] }

uglify:

{ dist: { files: { '/scripts/scripts.js': [ 'dist/scripts/scripts.js' ] } },

'dist\\scripts\\plugins.js': 'dist\\scripts\\plugins.js',

'dist\\scripts\\modules.js': 'dist\\scripts\\modules.js',

'dist\\scripts\\scripts.js': 'dist\\scripts\\scripts.js' }

requirejs:

{}

Running "concurrent:dist" (concurrent) task

Running "copy:styles" (copy) task

Running "imagemin:dist" (imagemin) task

Running "coffee:dist" (coffee) task

Running "htmlmin:dist" (htmlmin) task

Running "svgmin:dist" (svgmin) task

Running "autoprefixer:dist" (autoprefixer) task

File ".tmp/styles/bootstrap.css" created.

File ".tmp/styles/main.css" created.

Running "concat:dist\styles\main.css" (concat) task

File "dist\styles\main.css" created.

Running "concat:dist\scripts\plugins.js" (concat) task

File "dist\scripts\plugins.js" created.

Running "concat:dist\scripts\modules.js" (concat) task

File "dist\scripts\modules.js" created.

Running "concat:dist\scripts\scripts.js" (concat) task

File "dist\scripts\scripts.js" created.

Running "copy:dist" (copy) task

Created 63 directories, copied 367 files

Running "cdnify:dist" (cdnify) task

Going through dist/404.html, dist/index.html to update script refs

Running "ngmin:dist" (ngmin) task

ngminifying dist/scripts/modules.js, dist/scripts/plugins.js, dist/scripts/scripts.js

Running "cssmin:dist\styles\main.css" (cssmin) task

File dist\styles\main.css created.

Running "uglify:dist" (uglify) task

File "dist/scripts/scripts.js" created.

Running "uglify:dist\scripts\plugins.js" (uglify) task

File "dist\scripts\plugins.js" created.

Running "uglify:dist\scripts\modules.js" (uglify) task

File "dist\scripts\modules.js" created.

Running "uglify:dist\scripts\scripts.js" (uglify) task

File "dist\scripts\scripts.js" created.

Running "rev:dist" (rev) task

dist/scripts/modules.js >> 6b865daa.modules.js

dist/scripts/plugins.js >> 76c21dca.plugins.js

dist/scripts/scripts.js >> ff635307.scripts.js

dist/styles/main.css >> a5c01db0.main.css

Running "usemin:html" (usemin) task

Processing as HTML - dist/404.html

Update the HTML to reference our concat/min/revved script files

Update the HTML with the new css filenames

Update the HTML with the new img filenames

Update the HTML with data-main tags

Update the HTML with the data tags

Update the HTML with background imgs, case there is some inline style

Update the HTML with anchors images

Update the HTML with reference in input

Processing as HTML - dist/index.html

Update the HTML to reference our concat/min/revved script files

Update the HTML with the new img filenames

Update the HTML with data-main tags

Update the HTML with the data tags

Update the HTML with background imgs, case there is some inline style

Update the HTML with anchors images

Update the HTML with reference in input

Processing as HTML - dist/views/main.html

Update the HTML to reference our concat/min/revved script files

Update the HTML with the new css filenames

Update the HTML with the new img filenames

Update the HTML with data-main tags

Update the HTML with the data tags

Update the HTML with background imgs, case there is some inline style

Update the HTML with anchors images

Update the HTML with reference in input

Running "usemin:css" (usemin) task

Processing as CSS - dist/styles/a5c01db0.main.css

Update the CSS with new img filenames

Done, but with warnings.

Elapsed time

jshint:all 69ms

clean:dist 593ms

useminPrepare:html 49ms

concurrent:dist 2s

autoprefixer:dist 65ms

concat:dist\scripts\scripts.js 26ms

copy:dist 475ms

ngmin 21ms

ngmin:dist 210ms

uglify:dist 37ms

uglify:dist\scripts\plugins.js 252ms

uglify:dist\scripts\modules.js 76ms

usemin:html 313ms

usemin:css 82ms

Total 5s

有了工具的支持，开发效率就是事半功倍了，前提是你要知道如何善用这些工具！