Wie aktualisiere ich AngularJS auf Angular2+? Beispielhafte Einführung in das AngularJS-Upgrade

In diesem Artikel wird hauptsächlich das Upgrade von AngularJS von AngularJS auf AngularJS2+ vorgestellt.

Fassen Sie die letzten Monate zusammen. Wir haben Überstunden gemacht, um zwei Projekte zu aktualisieren Das Projekt verwendet UpgradeModule und das andere verwendet DowngradeModule. Erstellen Sie einen Datensatz wie folgt: (ng1->AngularJS; ng2+->Angular2+). Weitere Informationen finden Sie in der offiziellen Dokumentation: https://angular.io/guide/upgrade

Die Vor- und Nachteile sowie die Verwendungsmethoden von Typoskripten, die verwendet werden müssen, werden hier nicht beschrieben.

1. UpgradeModule: Dies ist die früheste von Angular veröffentlichte parallele Upgrade-Methode. Der Nachteil besteht darin, dass die Leistung relativ einfach ist. Erstellen Sie einfach zuerst eine Angular2+-App Fügen Sie den NG1-Controller hinzu. Wickeln Sie sie direkt in /service/directive usw. ein, damit sie direkt in der NG2+-Umgebung ausgeführt werden können.

Schritt für Schritt:

* Von ng2-App starten:

** ng-app aus index.html löschen;

** Haupt hinzufügen. ts:

import { NgModule } from '@angular/core';
import { UpgradeModule } from '@angular/upgrade/static';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
 
import { AppModule } from './app/app.module';
 
platformBrowserDynamic().bootstrapModule(AppModule).then(platformRef => {
    const upgrade = platformRef.injector.get(UpgradeModule) as UpgradeModule;
    upgrade.bootstrap(document.body, ['carepilot'], { strictDi: true });
});

** app.module.ts hinzufügen: Alle Module werden hier definiert

import { NgModule, forwardRef } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { UpgradeModule } from '@angular/upgrade/static';
 
@NgModule({
    imports: [
        BrowserModule,
        UpgradeModule
    ],
    bootstrap: []
})
 
export class AppModule {
    ngDoBootstrap() {}
}

** tsconfig.json hinzufügen: Definieren, wie ts->js kompiliert wird

{
    "compileOnSave": false,
    "compilerOptions": {
        "sourceMap": true,
        "declaration": false,
        "moduleResolution": "node",
        "emitDecoratorMetadata": true,
        "experimentalDecorators": true,
        "noImplicitAny": true,
        "target": "es5",
        "typeRoots": [
            "node_modules/@types"
        ],
        "lib": [
            "es2015",
            "dom"
        ]
    },
    "exclude": [
        "node_modules"
    ]
}

** systemjs.config.js: Verwenden Sie systemjs, um abhängige Module zu laden. Das allgemeine Beispiel besteht darin, systemJS zum Laden von Modulen zu verwenden. Sie müssen einige für ng2 erforderliche Bibliotheken laden (Hinweis: Die folgenden Zone.js usw. müssen mit Tools wie gulp in Ihr laufendes Verzeichnis kopiert werden)

/**
 * System configuration for Angular samples
 * Adjust as necessary for your application needs.
 */
(function (global) {
    System.config({
        paths: {
            'npm:': 'node_modules/'
        },
        map: {
            app: 'app',
            '@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/platform-browser/bundles/platform-browser.umd.js',
            '@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic/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/upgrade/static': 'npm:@angular/upgrade/bundles/upgrade-static.umd.js',
            '@angular/forms': 'npm:@angular/forms/bundles/forms.umd.js',
            'rxjs': 'npm:rxjs'
        },
        packages: {
            app: {
                defaultExtension: 'js'
            },
            rxjs: {
                defaultExtension: 'js',
                format: 'cjs'
            }
        }
    });
})(this);

Jetzt sollte dieser Hybrid die App in der Lage sein Der nächste Schritt besteht darin, die Controller einzeln zu aktualisieren und die Fallstricke nacheinander zu beseitigen.

Um es einfach auszudrücken: Controller->Komponente, Direktive -> , Service -> Service, Pipe/Filter -> Pipe;

* Beispiel: Aktualisieren Sie einen Controller auf eine Komponente (wenn Sie mehr sehen möchten, besuchen Sie die chinesische PHP-Website

AngularJS Entwicklungshandbuch

Lernen in der Mittelschule)

<script></script>
<script></script>
<script></script>
<script></script>

<!-- inject:js -->
<!-- endinject -->

<script>
System.import(&#39;main.js&#39;)
.then(null, console.error.bind(console));
</script>

* Da der größte Teil des Programms immer noch ng1-Code ist, müssen Sie zuerst das ng2+-Modul herunterstufen, um die Kommunikation von ng1- und ng2+-Dingen zu ermöglichen:

import {
    Component,
    Inject
} from '@angular/core';
import { Broadcaster } from '../../services/broadcaster';
 
@Component({
    selector: 'about',
    templateUrl: './about.component.html'
})
export class AboutComponent {
 
    constructor(private broadcaster: Broadcaster) {
    }
 
    print(): void {
        this.broadcaster.broadcast('printContents', 'printable');
    }
}

Konfigurationsrouting in .js aktualisieren (vorausgesetzt, UI-State wird verwendet):

angular.module('interestApp')

.directive('pinControls',

upgradeAdapter.downgradeNg2Component(PinControlsComponent));

* Das gleiche Problem, nachdem einige Controller aktualisiert wurden, müssen sie sich derzeit auf einige frühere Dienste verlassen Der Dienst von ng1 muss vorübergehend auf ng2+ aktualisiert werden. Während des Upgrade-Vorgangs ist dies nur für die Verwendung von UI-Route erforderlich Die Definition der entsprechenden Bibliothek finden Sie hier http://definitelytyped.org/docs/angular-ui- -angular-ui-router/modules/ng.html

* Nach dem Upgrade sind $ die umständlichsten Dinge In ng1 ist der globale Rootscope sehr komfortabel zu verwenden, in ng2+ ist er jedoch aufgehoben. Jetzt müssen Sie selbst einen Dienst definieren, um den vorherigen Rootscope zu ersetzen. Die aktuelle Komponente kann den Bereich nicht direkt mit =, > verwenden ; um den Wert zu binden, müssen Sie @input und @output verwenden, was dem vorherigen =,> Wertübergabeprozess entspricht. Natürlich können Sie auch weiterhin die aktualisierte Version von ui-route verwenden @ui-route; werden nicht gewartet und niemand hat auf ng2+ aktualisiert, finden Sie Alternativen oder schreiben Sie selbst eine

), schließlich wurde alles in ng1 aktualisiert, es ist Zeit. Die Legacy- und Support-Programme von ng1 wurden gelöscht und in ein vollständiges ng2+-Programm umgewandelt.

** Upgrademodule löschen:

.state('add', {

template: "<add-pin></add-pin>",

url: '/add'

** Alle Upgrademodule und Downgrademodule löschen;
** Fügen Sie eine App-Komponente hinzu, um die ursprüngliche Route zu laden: (Hier Es wird davon ausgegangen, dass Sie ng2+Standardroute verwenden. Wenn Sie weiterhin ui-route verwenden, verwenden Sie weiterhin ui-view.)

const AppRouting: Routes = [
    { path: 'app', component: DashboardComponent, canLoad: [AuthGuard], canActivate: [AuthGuard], data: { pageTitle: 'Dashboard' }];

* Es war sofort erfolgreich und wurde schließlich mit angle-cli verwendet Verwalten Sie den Kompilierungsprozess und das Laden von Modulen. Dies ist eine gute Sache (obwohl es einige unbefriedigende Aspekte gibt, z. B. dass die Veröffentlichung JIT nicht unterstützt usw.

)

Jetzt brauchen Sie nur noch npm (manche Leute verwenden Garn) und die Laube kann abgelegt werden.

Systemjs kann sich auch verbeugen;
Gulp oder Grunzen muss zu diesem Zeitpunkt im Detail analysiert werden. Wenn der Server komplizierter ist, wird empfohlen, ihn beizubehalten und zum Starten des Servers zu verwenden um den Client-Code zu verwalten und den Dienst zu verwalten, wenn npm dev ausführt.
Natürlich sind alle Upgrades abgeschlossen Unzufriedenheit. Lassen Sie uns auf die spezifische Situation eingehen. Diese Methode kann verwendet werden, wenn das Projekt vergleichsweise klein ist. Es gibt viele Beispiele online und kann schnell aktualisiert werden. Wenn das Projekt relativ groß ist und das Upgrade mehrere Monate dauert, sollte die folgende Downgrade-Methode verwendet werden.

• 2. Downgrade: Die offizielle Einführung ist für Leute, die es zum ersten Mal versuchen, sehr schwer zu verstehen.

  原理：downgrade是不改变原来的ng1程序，新建一个ng2+程序，然后把这个程序做成一个模块，直接注入到ng1里头，这样会避免一些额外的change事件，从而避免了不必要的消息循环，这样来提升性能。

  用下面的5步升级到ng2+:

  第一步：写一个新的ng2+程序，然后注入到ng1里头：

  main.ts: (XXXXXX替换成你的ng1的app的名字就行了）
  

  import { NgModule, forwardRef, StaticProvider } from '@angular/core';
  import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  import { AppModule } from './app/app.module';
  import { downgradeModule, downgradeComponent, setAngularLib } from '@angular/upgrade/static';
   
  declare const angular: any;
  declare const window: any;
  const bootstrapFn = (extraProviders: StaticProvider[]) => {
      const platformRef = platformBrowserDynamic(extraProviders);
      return platformRef.bootstrapModule(AppModule);
  };
   
  const downgradedModule = downgradeModule(bootstrapFn);
   
  angular.module('XXXXXX.ng2', [
      downgradedModule
  ]);
  angular.module('XXXXXX.ng2').directive('template', downgradeComponent({ component: template}));

  * app.js (就这里麻烦，试了一天才试出来，这么注入，然后加载）
  

  (function() {
      angular.module('XXXXXXX', [
          // all the old modules
          'XXXXXXX.ng2'
      ]);
      // eslint-disable-next-line
      if (window.ignoreNg2ForTest) {
          // temporary not load ng2 module in karma test
          fetchData().then(bootstrapApplication);
      } else {
          // normal hybrid entrance
          loadMain().then(fetchData).then(bootstrapApplication);
      }
   
   
      function loadMain() {
          return System.import('main');   // load main.ts
      }
   
      function fetchData() {
          // old logic
      }
   
      function bootstrapApplication() {
          angular.element(document).ready(function() {
              angular.bootstrap(document, ['XXXXXXXX'], { strictDi: true }); // bootstrap app with ng1
          });
      }
   
  }());

  * 同样，在index.html里加入一些依赖（升级完都可以删）

  <script></script>
  <script></script>
  <script></script>
  <script></script>

  * 手动拷一些依赖到dest 文件夹：（我们用的gulp）

  pipes.builtAngularVendorScriptsDev = function() {
      return gulp.src([
          './node_modules/core-js/client/shim.min.js',
          ............
      ], {base: './node_modules'})
          .pipe(gulp.dest('dist.dev/node_modules'));
  };

  * JSPM: 不用这东西的话release 里头的客户端有近百M，会疯的，虽然这个东西也bug重重，临时用用还是可以的。用它以后release的客户端代码只有十几M，可以接受了。
  

  gulp.task('build-jspm-prod', ['hybrid-tsbuild'], function() {
      return jspm({
              config: './client/systemjs.config.js',
              bundleOptions: {
                  minify: true,
                  mangle: false
              },
              bundleSfx: true,
              bundles: [
                  { src: paths.tsOutput + '/*', dst: 'main.js' }
              ]
          }).pipe(gulp.dest('dist.prod'));
  });

  
  

  第二步：升级一个个的controller/service/pipe/directive等等，这个过程相当痛苦，原来代码的耦合，莫名其妙的event emit和不知道在哪儿的event handler。全局的rootscope遍地都是，牵一发动全身。自己解耦吧，没什么好办法。

  
  

  第三步：升级路由，这个虽然没有上一步那么煎熬，也很头疼，很多地方都要改，

  * 如果用route的话参见上面upgrademodule里的例子就好了；

  * 如果使用@ui-route的话，state现在需要这么定义：（abstract我还没有研究出来有什么用）

  export const registerState = {
      parent: 'app',
      name: 'register',
      url: '/register/{activationCode}',
      component: RegisterComponent,
      data: { pageTitle: 'Register' }
  };

  第四步：删除ng1的东西；

  第五步：使用angular-cli管理依赖：

  * 参照上面upgrademodule对应的步骤就好；

  * 这时候可以删除JSPM了，这东西和SystemJS都是定时炸弹，bug重重啊，目前angular-cli比较稳定；

  
  

  到这里，应该你的程序已经升级到了ng2+，目前是ng5，建议升级过程中把anglar相应的版本写死，这东西更新太快，你随着它升随时出现已有的包不兼容，很头疼，我们暂时定格在5.0。

  我是升级完了站着说话不腰疼，上面的东西只能帮有需要的朋友节约一点点时间，最大的时间消耗在升级controller和解耦的过程中。那里如果有什么问题可以在下面留言，能帮上的话尽量帮大家省省时间。
  

  
  

  
  

  备注一：替换规则。
  

  
  

  • ng-bind-html       [innerHTML]

  • ng-model             [(ngModel)]                                        // 这个和ng1的双向绑定基本一个意思
    

  • ng-class                [ngClass]

  • ng-disabled          [disabled]

  • ng-click                 (click)

  • ng-if                     *ngIf

  • ng-repeat           *ngFor                                              // E.g. *ngFor="let task of currentChecklist.open; let i = index;"

  • ng-show               *ngIf

  • ng-src                   [src]

  • ng-hide                 *ngIf

  • ng-submit            (ngSubmit)

  • ng-style                [ngStyle]

  备注二：可能遇到的问题
  

  • JS:

  • 消息处理：ng2+里没有了scope继承，所以自己定义全局的消息处理是必要的;

  • HTML模板:
    

  • Anweisungskonflikt: Es ist am besten, die definierten Namen zu trennen. Wenn es in ng1

  Dieser Artikel endet hier (wenn Sie mehr sehen möchten, besuchen Sie die chinesische PHP-Website AngularJS-Benutzerhandbuch). Wenn Sie Fragen haben, können Sie diese unten stellen. Hinterlassen Sie eine Nachricht mit einer Frage.

Das obige ist der detaillierte Inhalt vonWie aktualisiere ich AngularJS auf Angular2+? Beispielhafte Einführung in das AngularJS-Upgrade. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!