Skip to content

集成第三方 JavaScript 框架

Wander Wang edited this page Aug 11, 2014 · 3 revisions

【此文章为草稿,欢迎开发者在开发者论坛中进行补充】

Egret 项目采用 TypeScript 语言编写,TypeScript 语言自身是 JavaScript 的超集, 自身的编译器中已经包括了对 HTML 对象的处理,也就是说,在 Egret 项目中,直接使用 document.getElementById() 这样的 JavaScript 浏览器API是不需要任何调整的,直接在代码里编写即可。

使用这种方法会使 Egret 在 Native方式运行时报错(因为 Native 环境中并没有 document 对象),但是如果开发者非常确认游戏只会在 HTML5平台发布,是可以这样调用的。

如果开发者有需求将 TypeScript 和一个第三方 JavaScript 库集成,会遇到一个编译问题,即编译器会报错,找不到 JavaScript 函数。这需要开发者编写一个 .d.ts 文件,包含 JavaScript 的函数名,并将其与项目一起编译。

Egret 编译器简化了这个过程,开发者只需要在 libs 文件夹中编写这个 .d.ts 文件,并声明需要调用的 JavaScript 函数即可,具体可以参考这个项目 Egret 微信分享扩展

举例,开发者手动引入的 JavaScript 中包括以下函数

$.get("myurl",function(result){})

开发者只需要在libs文件夹中编写这个.d.ts文件


module $ {
  
    export function get(url:string,callback:Function):void;
}