运行时将组件或模块加载到angular2

时间:2017-04-26 09:27:30

标签: angular webpack systemjs

我有一个使用Typescript构建并与webpack捆绑在一起的角度应用程序。这里没什么不寻常的。 我想要做的是在运行时允许插件,这意味着捆绑包外的组件和/或模块也应该能够在应用程序中注册。 到目前为止,我已经尝试在index.html中包含另一个webpack包,并使用implict数组将所述模块/组件推入其中,并在我的模块中导入这些。

请参阅导入使用implict变量。这适用于bundle中的模块,但另一个bundle中的模块不起作用。

@NgModule({
  imports: window["app"].modulesImport,
  declarations: [
      DYNAMIC_DIRECTIVES,
      PropertyFilterPipe,
      PropertyDataTypeFilterPipe,
      LanguageFilterPipe,      
      PropertyNameBlackListPipe      
  ],
  exports: [
      DYNAMIC_DIRECTIVES,
      CommonModule,
      FormsModule,
      HttpModule
  ]
})
export class PartsModule {

    static forRoot()
    {
        return {
            ngModule: PartsModule,
            providers: [ ], // not used here, but if singleton needed
        };
    }
}

我也尝试使用es5代码创建模块和组件,如下所示,并将同样的东西推送到我的模块数组:

var HelloWorldComponent = function () {

};

HelloWorldComponent.annotations = [
    new ng.core.Component({
        selector: 'hello-world',
        template: '<h1>Hello World!</h1>',
    })
];

window["app"].componentsLazyImport.push(HelloWorldComponent);

两种方法都会导致以下错误:

ncaught Error: Unexpected value 'ExtensionsModule' imported by the module 'PartsModule'. Please add a @NgModule annotation.
    at syntaxError (http://localhost:3002/dist/app.bundle.js:43864:34) [<root>]
    at http://localhost:3002/dist/app.bundle.js:56319:44 [<root>]
    at Array.forEach (native) [<root>]
    at CompileMetadataResolver.getNgModuleMetadata (http://localhost:3002/dist/app.bundle.js:56302:49) [<root>]
    at CompileMetadataResolver.getNgModuleSummary (http://localhost:3002/dist/app.bundle.js:56244:52) [<root>]
    at http://localhost:3002/dist/app.bundle.js:56317:72 [<root>]
    at Array.forEach (native) [<root>]
    at CompileMetadataResolver.getNgModuleMetadata (http://localhost:3002/dist/app.bundle.js:56302:49) [<root>]
    at CompileMetadataResolver.getNgModuleSummary (http://localhost:3002/dist/app.bundle.js:56244:52) [<root>]
    at http://localhost:3002/dist/app.bundle.js:56317:72 [<root>]
    at Array.forEach (native) [<root>]
    at CompileMetadataResolver.getNgModuleMetadata (http://localhost:3002/dist/app.bundle.js:56302:49) [<root>]
    at JitCompiler._loadModules (http://localhost:3002/dist/app.bundle.js:67404:64) [<root>]
    at JitCompiler._compileModuleAndComponents (http://localhost:3002/dist/app.bundle.js:67363:52) [<root>]

请注意,如果我尝试使用组件而不是模块,我会将它们放入声明中,这会导致组件的相应错误,我需要添加@tipe / @组件注释。

我觉得这应该是可行的,但我不知道我错过了什么。我正在使用angular@4.0.0

更新11/05/2017

所以我决定退后一步,从头开始。我没有使用 webpack ,而是决定尝试使用 SystemJS ,因为我在Angular中找到了一个核心组件。这次我使用以下组件和服务来插入组件:

typebuilder.ts

import { Component, ComponentFactory, NgModule, Input, Injectable, CompilerFactory } from '@angular/core';
import { JitCompiler } from '@angular/compiler';
import {platformBrowserDynamic} from "@angular/platform-browser-dynamic";

export interface IHaveDynamicData { 
    model: any;
}

@Injectable()
export class DynamicTypeBuilder {

    protected _compiler : any;
         // wee need Dynamic component builder
    constructor() {
        const compilerFactory : CompilerFactory = platformBrowserDynamic().injector.get(CompilerFactory);
        this._compiler = compilerFactory.createCompiler([]);
    }

  // this object is singleton - so we can use this as a cache
    private _cacheOfFactories: {[templateKey: string]: ComponentFactory<IHaveDynamicData>} = {};

    public createComponentFactoryFromType(type: any) : Promise<ComponentFactory<any>> {
        let module = this.createComponentModule(type);
            return new Promise((resolve) => {
            this._compiler
                .compileModuleAndAllComponentsAsync(module)
                .then((moduleWithFactories : any) =>
                {
                    let _ = window["_"];
                    let factory = _.find(moduleWithFactories.componentFactories, { componentType: type });
                    resolve(factory);
                });
        });
    }

    protected createComponentModule (componentType: any) {
        @NgModule({
        imports: [
        ],
        declarations: [
            componentType
        ],
        })
        class RuntimeComponentModule
        {
        }
        // a module for just this Type
        return RuntimeComponentModule;
    }
}

Dynamic.component.ts

import { Component, Input, ViewChild, ViewContainerRef, SimpleChanges, AfterViewInit, OnChanges, OnDestroy, ComponentFactory, ComponentRef } from "@angular/core";
import { DynamicTypeBuilder } from "../services/type.builder";

@Component({
    "template": '<h1>hello dynamic component <div #dynamicContentPlaceHolder></div></h1>',
    "selector": 'dynamic-component'
})
export class DynamicComponent implements AfterViewInit, OnChanges, OnDestroy {

    @Input() pathToComponentImport : string;

    @ViewChild('dynamicContentPlaceHolder', {read: ViewContainerRef}) 
    protected dynamicComponentTarget: ViewContainerRef;
    protected componentRef: ComponentRef<any>;

    constructor(private typeBuilder: DynamicTypeBuilder) 
    {

    }  

    protected refreshContent() : void {
        if (this.pathToComponentImport != null && this.pathToComponentImport.indexOf('#') != -1) {
          let [moduleName, exportName] = this.pathToComponentImport.split("#");
          window["System"].import(moduleName)
            .then((module: any) => module[exportName])
            .then((type: any) => {
                this.typeBuilder.createComponentFactoryFromType(type)
                .then((factory: ComponentFactory<any>) =>
                {
                    // Target will instantiate and inject component (we'll keep reference to it)
                    this.componentRef = this
                        .dynamicComponentTarget
                        .createComponent(factory);

                    // let's inject @Inputs to component instance
                    let component = this.componentRef.instance;

                    component.model = { text: 'hello world' };

                    //...
                });
            });
      }
    }

    ngOnDestroy(): void {
    }

    ngOnChanges(changes: SimpleChanges): void {
    }

    ngAfterViewInit(): void {
        this.refreshContent();
    }

}

现在我可以链接到这样的任何给定组件:

<dynamic-component pathToComponentImport="/app/views/components/component1/extremely.dynamic.component.js#ExtremelyDynamicComponent"></dynamic-component>

打字稿配置:

 {
  "compilerOptions": {
    "target": "es5",
    "module": "system",
    "moduleResolution": "node",
    "sourceMap": true,
    "emitDecoratorMetadata": true,
    "allowJs": true,
    "experimentalDecorators": true,
    "lib": [ "es2015", "dom" ],
    "noImplicitAny": true,
    "suppressImplicitAnyIndexErrors": true
  },
    "exclude": [
      "node_modules",
      "systemjs-angular-loader.js",
      "systemjs.config.extras.js",
      "systemjs.config.js"
  ]
}

高于我的打字稿配置。所以这很有效,但是我不确定我对使用SystemJS感到满意。我觉得这应该可以使用webpack,并且不确定它是否是TC编译webpack不理解的文件的方式...如果我尝试在webpack包中运行此代码,我仍然会得到缺少的装饰器异常。

祝你好运 的Morten

1 个答案:

答案 0 :(得分:3)

所以我正在努力寻找解决方案。最后我做到了。 这是否是一个hacky解决方案,而且我不知道更好的方式...... 现在,这就是我解决它的方式。但我希望未来或即将到来的是一个更现代化的解决方案。

此解决方案本质上是SystemJS和webpack的混合模型。在您的运行时中,您需要使用SystemJS来加载您的应用程序,并且您的Webpack包需要由SystemJS使用。要做到这一点,你需要一个webpack插件 使这成为可能。开箱即用systemJS和webpack不兼容,因为它们使用不同的模块定义。不过这个插件没有。

  1. 在您的核心应用和插件中,您需要为webpack安装名为
  2. 的扩展程序

    &#34; webpack-system-register&#34;。

    我有2.2pack的webpack和1.5.0的WSR。 1.1在webpack.config.js中,你需要添加WebPackSystemRegister作为core.plugins中的第一个元素,如下所示:

    config.plugins = [
      new WebpackSystemRegister({
        registerName: 'core-app', // optional name that SystemJS will know this bundle as. 
        systemjsDeps: [
        ]
      }) 
      //you can still use other plugins here as well
    ];
    

    由于SystemJS现在用于加载应用程序,因此您还需要一个systemjs配置。我看起来像这样。

    (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.min.js',
      '@angular/core': '/dist/fake-umd/angular.core.fake.umd.js',
      '@angular/common': '/dist/fake-umd/angular.common.fake.umd.js',
      '@angular/compiler': 'npm:@angular/compiler/bundles/compiler.umd.min.js',
      '@angular/platform-browser': '/dist/fake-umd/angular.platform.browser.fake.umd.js',
      '@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic/bundles/platform-browser-dynamic.umd.min.js',
      '@angular/http': '/dist/fake-umd/angular.http.fake.umd.js',
      '@angular/router': 'npm:@angular/router/bundles/router.umd.min.js',
      '@angular/forms': 'npm:@angular/forms/bundles/forms.umd.min.js',
      '@angular/platform-browser/animations': 'npm:@angular/platform-browser/bundles/platform-browser-animations.umd.min.js',
      '@angular/material': 'npm:@angular/material/bundles/material.umd.js',
      '@angular/animations/browser': 'npm:@angular/animations/bundles/animations-browser.umd.min.js',
      '@angular/animations': 'npm:@angular/animations/bundles/animations.umd.min.js',
      'angular2-grid/main': 'npm:angular2-grid/bundles/NgGrid.umd.min.js',      
      '@ng-bootstrap/ng-bootstrap': 'npm:@ng-bootstrap/ng-bootstrap/bundles/ng-bootstrap.js',            
      // other libraries
      'angular-in-memory-web-api': 'npm:angular-in-memory-web-api/bundles/in-memory-web-api.umd.js', 
      "rxjs": "npm:rxjs",          
    
    
    },
    // packages tells the System loader how to load when no filename and/or no extension
    packages: {
      app: {
        defaultExtension: 'js',
        meta: {
          './*.html': {
            defaultExension: false,
          },
          './*.js': {
            loader: '/dist/configuration/systemjs-angular-loader.js'
          },
        }
      },
      rxjs: {
        defaultExtension: 'js'
      },
    },
      });
     })(this);
    

    我将在回答中回到map元素,描述为什么角度在那里以及它是如何完成的。 在index.html中,您需要将您的引用类似于:

    <script src="node_modules/systemjs/dist/system.src.js"></script> //system
    <script src="node_modules/reflect-metadata/reflect.js"></script>
    <script src="/dist/configuration/systemjs.config.js"></script> // config for system js
    <script src="/node_modules/zone.js/dist/zone.js"></script>
    <script src="/dist/declarations.js"></script> // global defined variables
    <script src="/dist/app.bundle.js"></script> //core app
    <script src="/dist/extensions.bundle.js"></script> //extensions app
    

    现在,这允许我们按照自己的意愿运行所有内容。然而,这有点扭曲,这就是你仍然遇到原始帖子中描述的异常。 要解决这个问题(我仍然不知道为什么会这样),我们需要在插件源代码中做一个使用webpack和webpack-system-register创建的技巧:

    plugins: [
      new WebpackSystemRegister({
          registerName: 'extension-module', // optional name that SystemJS will know this bundle as. 
          systemjsDeps: [
            /^@angular/,
            /^rx/
          ]
      })
    

    上面的代码使用webpack系统寄存器从扩展束中排除Angular和RxJs模块。将要发生的是systemJS在导入模块时将遇到angular和RxJs。它们被省略了,因此System将尝试使用System.config.js的映射配置加载它们。现在来到这里有趣的部分。:

    在核心应用程序中,在webpack中我导入所有角度模块并在公共变量中公开它们。这可以在你的应用中的任何地方完成,我已经在main.ts中完成了。示例如下:

    lux.bootstrapModule = function(module, requireName, propertyNameToUse) {
        window["lux"].angularModules.modules[propertyNameToUse] = module;
        window["lux"].angularModules.map[requireName] = module;
    }
    
    import * as angularCore from '@angular/core';
    window["lux"].bootstrapModule(angularCore, '@angular/core', 'core');
    platformBrowserDynamic().bootstrapModule(AppModule);
    

    在我们的systemjs配置中,我们创建了一个这样的地图,让systemjs知道在哪里加载我们的依赖(它们被排除在extenion包中,如上所述):

    '@angular/core': '/dist/fake-umd/angular.core.fake.umd.js',
    '@angular/common': '/dist/fake-umd/angular.common.fake.umd.js',
    

    因此,每当systemjs在角度核心或角度共同点上时,就会告诉它从我定义的假umd束中加载它。它们看起来像这样:

    (function (root, factory) {
        if (typeof define === 'function' && define.amd) {
            // AMD
            define([], factory);
        } else if (typeof exports === 'object') {
            // Node, CommonJS-like
            module.exports = factory();
        }
    }(this, function () {
    
        //    exposed public method
        return window["lux"].angularModules.modules.core;
    }));
    

    最后,使用运行时编译器,我现在可以使用外部加载的模块:

    因此,现在可以在Angular中使用系统来导入和编译模块。这只需要每个模块发生一次。不幸的是,这可以防止你遗漏那些非常繁重的运行时编译器。

    我有一个服务可以加载模块并返回工厂,最终使你能够在核心的转换时间内知道知道的延迟加载模块。这对于商业平台,CMS,CRM系统等软件供应商来说非常有用,或者其他开发人员在没有源代码的情况下为这类系统创建插件的情况。

    window["System"].import(moduleName) //module name is defined in the webpack-system-register "registerName"
                .then((module: any) => module[exportName])
                .then((type: any) => {
                    let module = this.createComponentModuleWithModule(type);
                    this._compiler.compileModuleAndAllComponentsAsync(module).then((moduleWithFactories: any) => {
                        const moduleRef = moduleWithFactories.ngModuleFactory.create(this.injector);
    
                        for (let factory of moduleWithFactories.componentFactories) {
    
                            if (factory.selector == 'dynamic-component') { //all extension modules will have a factory for this. Doesn't need to go into the cache as not used.
                                continue;
                            }
    
                            var factoryToCache = {
                                template: null,
                                injector: moduleRef.injector,
                                selector: factory.selector,
                                isExternalModule: true,
                                factory: factory,
                                moduleRef: moduleRef,
                                moduleName: moduleName,
                                exportName: exportName
                            }
    
                            if (factory.selector in this._cacheOfComponentFactories) {
                                var existingFactory = this._cacheOfComponentFactories[factory.selector]
                                console.error(`Two different factories conflicts in selector:`, factoryToCache, existingFactory)
                                throw `factory already exists. Did the two modules '${moduleName}-${exportName}' and '${existingFactory.moduleName}-${existingFactory.exportName}' share a component selector?: ${factory.selector}`;
                            }
    
                            if (factory.selector.indexOf(factoryToCache.exportName) == -1) {
                                console.warn(`best practice for extension modules is to prefix selectors with exportname to avoid conflicts. Consider using: ${factoryToCache.exportName}-${factory.selector} as a selector for your component instead of ${factory.selector}`);
                            }
    
                            this._cacheOfComponentFactories[factory.selector] = factoryToCache;
                        }
                    })
                    resolve();
                })
    

    总结一下:

    1. 在您的核心应用和扩展模块中安装webpack-system-register
    2. 在您的扩展程序包中排除角度依赖关系
    3. 核心应用程序中的
    4. 在全局变量中公开角度依赖关系
    5. 通过返回公开的依赖项
    6. 为每个依赖项创建一个假束
    7. 在你的systemjs map中,添加要在假js包中加载的依赖项
    8. Angular中的运行时编译器现在可用于加载使用webpack-system-register
    9. 加载webpack的模块