Angular 2 - Configuración avanzada

En este capítulo, veremos los otros archivos de configuración que forman parte del proyecto Angular 2.

tsconfig.json

Este archivo se usa para brindar las opciones sobre TypeScript que se usan para el proyecto Angular JS.

{ 
   "compilerOptions": {
      "target": "es5",
      "module": "commonjs",
      "moduleResolution": "node",
      "sourceMap": true,
      "emitDecoratorMetadata": true,
      "experimentalDecorators": true,
      "lib": [ "es2015", "dom" ],
      "noImplicitAny": true,
      "suppressImplicitAnyIndexErrors": true
   }
}

A continuación se presentan algunos puntos clave a tener en cuenta sobre el código anterior.

  • El objetivo de la compilación es es5 y eso se debe a que la mayoría de los navegadores solo pueden comprender el mecanografiado de ES5.

  • La opción sourceMap se utiliza para generar archivos de mapas, que son útiles al depurar. Por lo tanto, durante el desarrollo es bueno mantener esta opción como verdadera.

  • Los "emitDecoratorMetadata": true y "experimentalDecorators": true son necesarios para los decoradores de Angular JS. Si no está en su lugar, la aplicación Angular JS no se compilará.

package.json

Este archivo contiene información sobre el proyecto Angular 2. A continuación se muestran las configuraciones típicas del archivo.

{
   "name": "angular-quickstart",
   "version": "1.0.0",
   "description": "QuickStart package.json from the documentation,
      supplemented with testing support",
   
   "scripts": {
      "build": "tsc -p src/",
      "build:watch": "tsc -p src/ -w",
      "build:e2e": "tsc -p e2e/",
      "serve": "lite-server -c=bs-config.json",
      "serve:e2e": "lite-server -c=bs-config.e2e.json",
      "prestart": "npm run build",
      "start": "concurrently \"npm run build:watch\" \"npm run serve\"",
      "pree2e": "npm run build:e2e",
      "e2e": "concurrently \"npm run serve:e2e\" \"npm run protractor\" 
         --killothers --success first",
      "preprotractor": "webdriver-manager update",
      "protractor": "protractor protractor.config.js",
      "pretest": "npm run build",
      "test": "concurrently \"npm run build:watch\" \"karma start karma.conf.js\"",
      "pretest:once": "npm run build",
      "test:once": "karma start karma.conf.js --single-run",
      "lint": "tslint ./src/**/*.ts -t verbose"
   },

   "keywords": [],
   "author": "",
   "license": "MIT",
   "dependencies": {
      "@angular/common": "~2.4.0",
      "@angular/compiler": "~2.4.0",
      "@angular/core": "~2.4.0",
      "@angular/forms": "~2.4.0",
      "@angular/http": "~2.4.0",
      "@angular/platform-browser": "~2.4.0",
      "@angular/platform-browser-dynamic": "~2.4.0",
      "@angular/router": "~3.4.0",
      "angular-in-memory-web-api": "~0.2.4",
      "systemjs": "0.19.40",
      "core-js": "^2.4.1",
      "rxjs": "5.0.1",
      "zone.js": "^0.7.4"
   },

   "devDependencies": {
      "concurrently": "^3.2.0",
      "lite-server": "^2.2.2",
      "typescript": "~2.0.10",
      "canonical-path": "0.0.2",
      "tslint": "^3.15.1",
      "lodash": "^4.16.4",
      "jasmine-core": "~2.4.1",
      "karma": "^1.3.0",
      "karma-chrome-launcher": "^2.0.0",
      "karma-cli": "^1.0.1",
      "karma-jasmine": "^1.0.2",
      "karma-jasmine-html-reporter": "^0.2.2",
      "protractor": "~4.0.14",
      "rimraf": "^2.5.4",
      "@types/node": "^6.0.46",
      "@types/jasmine": "2.5.36"
   },
   "repository": {}
}

Algunos puntos clave a tener en cuenta sobre el código anterior:

  • Hay dos tipos de dependencias, primero son las dependencias y luego están las dependencias de desarrollo. Los de desarrollo son necesarios durante el proceso de desarrollo y los demás son necesarios para ejecutar la aplicación.

  • El comando "build: watch": "tsc -p src / -w" se utiliza para compilar el texto mecanografiado en segundo plano buscando cambios en los archivos mecanografiados.

systemjs.config.json

Este archivo contiene los archivos del sistema necesarios para la aplicación Angular JS. Esto carga todos los archivos de secuencia de comandos necesarios sin la necesidad de agregar una etiqueta de secuencia de comandos a las páginas html. Los archivos típicos tendrán el siguiente código.

/** 
 * System configuration for Angular samples 
 * Adjust as necessary for your application needs. 
*/ 
(function (global) { 
   System.config ({ 
      paths: { 
         // paths serve as alias 
         'npm:': 'node_modules/' 
      }, 
      
      // map tells the System loader where to look for things 
      map: { 
         // our app is within the app folder 
         app: 'app',  
         
         // angular bundles 
         '@angular/core': 'npm:@angular/core/bundles/core.umd.js', 
         '@angular/common': 'npm:@angular/common/bundles/common.umd.js', 
         '@angular/compiler': 'npm:@angular/compiler/bundles/compiler.umd.js', 
         '@angular/platform-browser': 'npm:@angular/platformbrowser/bundles/platform-browser.umd.js', 
         '@angular/platform-browser-dynamic': 
            'npm:@angular/platform-browserdynamic/bundles/platform-browser-dynamic.umd.js', 
         '@angular/http': 'npm:@angular/http/bundles/http.umd.js', 
         '@angular/router': 'npm:@angular/router/bundles/router.umd.js', 
         '@angular/forms': 'npm:@angular/forms/bundles/forms.umd.js',  
         
         // other libraries 
         'rxjs':  'npm:rxjs', 
         'angular-in-memory-web-api': 
            'npm:angular-in-memory-web-api/bundles/inmemory-web-api.umd.js' 
      }, 
     
      // packages tells the System loader how to load when no filename 
         and/or no extension 
      packages: { 
         app: { 
            defaultExtension: 'js' 
         }, 
         
         rxjs: { 
            defaultExtension: 'js' 
         } 
      } 
   
   }); 
})(this);

Algunos puntos clave a tener en cuenta sobre el código anterior:

  • 'npm:': 'node_modules /' indica la ubicación en nuestro proyecto donde se encuentran todos los módulos npm.

  • El mapeo de la aplicación: 'aplicación' indica la carpeta donde se cargan todos los archivos de nuestras aplicaciones.