将一个typescript库绑定到一个.js文件和一个.d.ts

Bundle a typescript library to one .js file and one .d.ts

本文关键字:一个 文件 ts js typescript 绑定      更新时间:2023-09-26

我正在开发一个库,以便使用TypeScript在网络浏览器中使用。

我正在使用"系统"作为模块编写单独的打字脚本文件,例如,这是主文件:

/// <reference path="../typings/tsd.d.ts" />
/// <reference path="./typings/simple-html-tokenizer/simple-html-tokenizer" />
export * from "./Decorators/Component";
export * from "./Decorators/Directive";
export * from "./Decorators/Inject";
export * from "./Decorators/Injectable";
export * from "./Events/EventEmitter";
export * from "./Core/Bootstrap";
export * from "./Decorators/Output";
export * from "./Decorators/Input";
export {OnChanges, OnInit, OnDestroy} from "./Core/LifeCycle/LifeCycleHooks";

这是第一个模块:

import {serviceNormalize} from "../Utils/AngularHelpers";
export interface IComponentMetadata {
    template?: string;
    templateUrl?: string;
    selector?: string;
    directives?: Function[];
    outputs?: string[];
    inputs?: string[];
    styles?: string[];
    providers?: (Function|string)[];
}
/**
 * Register metadata into class to be used by bootstrap.
 */
export function Component(componentMetadata: IComponentMetadata) {
    return (target: any) => {
        /// ...
        /// ...
        /// ...
        return target;
    }
}

好吧,我使用gulp-typescript构建它,我将它转换为es5,并为每个.ts文件创建一个.js和一个.d.ts文件。到目前为止,我有一个npm包,我可以使用其他npm项目中的项目。但是

我也想从网络浏览器中使用它。我想把所有的.js文件捆绑在一起,并使用这种方式:

<script src="~/Scripts/Ng2Emulation-bundle.js"></script>

我使用dts捆绑包生成了一个.d.ts文件,并尝试从两种方式捆绑.js文件:

  1. 使用concat:

    gulp.src('dist/js/src/**/*.js') .pipe(concat('Ng2Emulation-bundle.js')) .pipe(gulp.dest('dist/release'));

  2. 使用tsify:

    browserify() .add('src/ng2emulation.ts') .plugin(tsify, { noImplicitAny: false }) .bundle() .on('error', function (error) { console.error(error.toString()); }) .pipe(gulp.dest("Ng2Emulation-bundle.js"));

有两种方法可以创建捆绑包,但当我尝试从浏览器中使用它时,它会尝试加载每个模块,会出现以下错误:

GET http://localhost:55411/Utils/AngularHelpers.js 404 (Not Found)D @ system.js:4(anonymous function) @ system.js:4(anonymous function) @ system.js:4V @ system.js:5t.metadata.deps @ system.js:5r @ system.js:5n @ system.js:5r @ system.js:5(anonymous function) @ system.js:5(anonymous function) @ system.js:4
system.js:4 GET http://localhost:55411/Templates/HttpInterceptor.js 404 (Not Found)D @ system.js:4(anonymous function) @ system.js:4(anonymous function) @ system.js:4V @ system.js:5t.metadata.deps @ system.js:5r @ system.js:5n @ system.js:5r @ system.js:5(anonymous function) @ system.js:5(anonymous function) @ system.js:4
system.js:4 GET http://localhost:55411/Directives/NgProperty.js 404 (Not Found)D @ system.js:4(anonymous function) @ system.js:4(anonymous function) @ system.js:4V @ system.js:5t.metadata.deps @ system.js:5r @ system.js:5n @ system.js:5r @ system.js:5(anonymous function) @ system.js:5(anonymous function) @ system.js:4
system.js:4 GET http://localhost:55411/Templates/HtmlParser/Parser.js 404 (Not Found)

我使用的是Visual Studio 2013,一个MVC ASP.NET应用程序。我的主html(_layout.cs.html)是这样的:

<!DOCTYPE html>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
    <link href="~/node_modules/angular-material/angular-material.css" rel="stylesheet"/>
    <script src="~/Scripts/jquery-2.2.0.js"></script>
    <script src="~/Scripts/angular.js"></script>
    <script src="~/Scripts/angular-aria.js"></script>
    <script src="~/Scripts/angular-animate.js"></script>
    <script src="~/Scripts/angular-messages.js"></script>
    <script src="~/node_modules/angular-material/angular-material.js"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.15/system.js"></script>
    <script type="text/javascript">
        // set our baseURL reference path
        System.config({
            baseURL: '/TypeScript',
            map: {
                "HTML5Tokenizer": "/Scripts/simple-html-tokenizer.js",
                "Ng2Emulation": "/Scripts/Ng2Emulation-es5.js"
            }
        });
        System.defaultJSExtensions = true;
        System.import('App/Boot');
    </script>
</head>
<body>
    @RenderBody()
    @RenderSection("scripts", required: false)
</body>
</html>

这是我的App/Boot.ts:

import {bootstrap, Component} from "Ng2Emulation";
@Component({
    selector: "my-app",
    template: "<h1>My First Angular 2 App</h1>"
})
export class AppComponent { }
bootstrap(AppComponent);

我试图通过:<script src="~/Scripts/Ng2Emulation-bundle.js"></script>加载捆绑包,并从system.config中删除Ng2Emulation映射,但我运气不好:(

我认为在捆绑包创建过程中或后面的模块中有一些我不理解的地方。。。

如何捆绑?我该怎么做?

是的,经过深入搜索,我找到了一种方法。我找到了systemjs构建器项目。我在我的gull文件中写了一个任务,这样:

gulp.task("system-builder", function () {
    var builder = new Builder('dist/js/src');
    builder.config({
        meta: {
            'HTML5Tokenizer.js': { // HTML5Tokenizer is a external módule
                build: false       // Not to include in a bundle.
            }
        },
        defaultJSExtensions: true
    });
    builder
        .bundle('Ng2Emulation.js', 'dist/release/Ng2Emulation-bundle.js')
        .then(function () {
            console.log('Build complete');
        })
        .catch(function (err) {
            console.log('Build error');
            console.log(err);
        });
});

我在查看Angular2 gull文件时发现:D现在我可以使用html script标签包含该文件,我的html如下所示:

<script src="~/Scripts/simple-html-tokenizer.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.15/system.src.js"></script>
<script type="text/javascript">
    // set our baseURL reference path
    System.config({
        baseURL: '/TypeScript',
        map: {
            "HTML5Tokenizer": "/Scripts/simple-html-tokenizer.js"
        }
    });
    System.defaultJSExtensions = true;
</script>
<script src="~/Scripts/Ng2Emulation-es5.js"></script>
<script type="text/javascript">
    System.import('App/Boot');
</script>

它就像一个符咒。

不过,如果有人知道其他方法,我很想知道。我不明白什么mudule系统更好,当使用其中一个或另一个时。。。