背景
我需要在Typescript中为现有的Javascript包创建一个适配器。这需要为现有包创建定义文件,并编写一些构建在这些接口之上的类。我需要在多个项目中重用生成的Typescript包。
要创建此包,我正在使用C#类库项目,但没有定义C#类型,我只将它用于Typescript。 Typescript编译器设置为输出单个*.js
和*.d.ts
文件。
问题
编译时,我的*.ts
文件中定义的类可以在输出*.d.ts
文件中找到,但*.d.ts
文件中定义的任何接口都不会显示在输出中。我的类中的几个方法使用这些接口作为返回类型,所以当我尝试重用该包时,我得到一个“找不到名字'xxx'。”缺少接口的编译器错误。
部分代码:
以下是其中一个正在消失的界面:
declare module IS_Interface
{
export interface Iterable<T>
{
hasMoreElements(): boolean;
nextElement(): T;
}
}
此项目中的所有Typescript文件都在IS_Interface
模块中。声明文件以declare module IS_Interface
开头,* .ts文件以module IS_Interface
开头。
这是一个使用界面的类(它将显示在* .d.ts文件中):
module IS_Interface
{
export class IterableUtil
{
static ToArray<T>(iterable: Iterable<T>) : Array<T>
{
let result = new Array<T>();
while(iterable.hasMoreElements())
{
result.push(iterable.nextElement());
}
return result;
}
}
}
以下是我的编译器设置:
{PropertyGroup Condition="'$(Configuration)' == 'Debug'"}
{TypeScriptNoImplicitAny}True{/TypeScriptNoImplicitAny}
{TypeScriptOutFile}bin/debug/IS_Adapter.js{/TypeScriptOutFile}
{TypeScriptGeneratesDeclarations}True{/TypeScriptGeneratesDeclarations}
{TypeScriptNoEmitOnError}True{/TypeScriptNoEmitOnError}
{/PropertyGroup}
我的项目文件中的所有Typescript和声明文件都在“TypeScriptCompile Include”标记中。
问题
更新
@Martin - 我删除了模块声明。我对Typescript中的命名空间/模块解析感到困惑。模块主要是物理分组还是逻辑分组?它们都是两者兼而有之吗?我的大部分经验都是使用C#中的桌面/服务器编程,其中有一个明确的程序集与命名空间区别。
以下是一些简化的代码:
注意,在我的输出* .d.ts文件中,我仍然有我的import语句,但它是一个损坏的引用。
MyInterface.d.ts
:
export interface Iterable<T>
{
hasMoreElements(): boolean;
nextElement(): T;
}
MyConsumer.ts
:
import { Iterable } from "./MyInterface";
export class Thing
{
Name: string;
Thing: Iterable<number>;
}
我在生成的.d.ts
文件中仍然没有接口。
解决方法
这是我可怕的解决方法。它由预构建命令和作为构建后命令运行的exe
组成。它并不漂亮,但到目前为止似乎有效。
Prebuild :(只有这样我们才能在重建时将以前的版本与自身合并)
DEL "$(TargetDir)*.d.ts"
Postbuild:
"$(SolutionDir)\TypeScriptDefMerge\bin\Debug\TypeScriptDefMerge.exe" "$(ProjectDir) " "MyTargetFile.d.ts"
EXE:
using System;
using System.IO;
using System.Linq;
namespace TypeScriptDefMerge {
class Program {
// 1st argument must be the project directory path.
// 2nd argument must be the target file name.
static void Main(string[] args) {
Console.Write(args.Length);
Console.Read();
if (args == null) throw new ArgumentNullException("args");
if (args.Length != 2) throw new ArgumentException("Must have exactly 2 arugments.");
var projectDir = args[0];
var outputName = args[1];
//Source definition files must be in this subdirectory
//I use "\Internal" for my scripts and "\External" for 3rd-party scripts
var sourceDir = projectDir + "\\Scripts\\Internal";
//Output must be in this subdirectory
var outputDir = projectDir + "\\bin\\Debug";
var temp1 = outputDir + "\\TEMP1.d.ts";
var temp2 = outputDir + "\\TEMP2.d.ts";
File.Delete(temp1);
File.Delete(temp2);
//Create temp file holding contents of each source file
CreateMergedFile(temp1, GetDefinitionFiles(sourceDir));
//Create temp file holding the contents of the 1st temp file, and the normal output file
CreateMergedFile(temp2, GetDefinitionFiles(outputDir));
//Delete temporary files
foreach (var f in GetDefinitionFiles(outputDir).Where(x => x != temp2)) {
File.Delete(f);
}
//Rename final file
File.Move(temp2, outputDir + "\\" + outputName);
}
//Get all definition files in the given directory
static string[] GetDefinitionFiles(string directory) {
return Directory.EnumerateFiles(directory)
.Where(x => x.EndsWith(".d.ts"))
.ToArray();
}
//Concatenate all the given files to a new file at the given path.
static void CreateMergedFile(string outputPath, string[] sourcePaths) {
using (var temp = File.CreateText(outputPath)) {
foreach (var f in sourcePaths) {
temp.Write(File.ReadAllText(f));
temp.WriteLine();
}
}
}
}
}
说真的,必须有比这更好的东西。难道人们不希望重用接口吗?如果你能想出任何不那么笨重的话,请告诉我。
另请注意,这并不承认“从项目中排除”并且完全基于目录。