Egret社区

第三方库的配置

2018-11-27 10:39
871
本帖最后由 山猫 于 2018-11-27 10:52 编辑

最近在论坛上好多人都在问第三方库怎么使用,今天咱们就聊一聊第三方库的使用。
目前Egret的官方内置库,主要包括 ;
1. egret 必备的核心库
2. egret3d 引擎 3D 库,从引擎5.3.0增加的这个库
3. media 多媒体库
4. game 制作游戏会用到的库类,比如MovieClip,URLLoader 等
5. assetsmanager    资源加载,所有涉及资源载入的工作,都可以在这个模块完成
6. tween 动画缓动库,可以做一些简单的动画效果如:平移,旋转,缩放
7. dragonBones 龙骨动画库,用来制作一些复制的动画效果
8. socket 用来网络通讯库 websocket 库
9. eui  新增的UI库,使布局起来,更方便快捷

你需要哪个库,就配置哪个库,比如我想用game tween eui 这3个模 块,只需要把相对应的库勾选上假如你需要使用第三方库该怎么办了,接下来我讲一下第三方库的配置

第一种是使用以经写好的第三方库官网发布的,如physics ,mouse 等等

1. 在GitHub上下载完整的第三方库,解压后按照路径找到第三方库模块。
2. 将第三方库模块放到新建项目根目录的同级目录。
3. 修改egretProperties.json,modules数组里增加
   {"name":"第三方库名",  "path":"../第三方库名"}
4. 编译 egret   build。

第二种是使用自定义的第三方库的方法

1. 装备第三方库
   由于 js 与 ts 在语法结构上的差异,在 ts 中不能直接调用js 库的 API,所 以TypeScript 团队提供了一套虚构声明语法,可以把现有代码的 API 用头文件的形式描述出来,扩展名为 d.ts( d.ts 命名会提醒编译器这种文件 不需要编译)。这套虚构定义语法,让你不需要去实现函数体里的代码, 类似定义interface和抽象类。
   幸运的是目前,大多数流行的 js 类库已经由官方提供,或者由热心的社 区开发者提供了对应的 d.ts 文件。当然,如果没有,您也可以自己编 写。这里有篇教程讲得很详细,里边也包含一个庞大的 d.ts 库,以及管理这些库的方法: 使用JS类库。

   另外,由于一些流行的 js 库在快速更新,可能会有你找到的 d.ts 文件定 义与 js 库的版本不一致而导致其中的 API 并没有完全对应的问题。遇到 这种情况,要么寻找对应版本的 js 库,要么就需要您自己修改一下 d.ts 文件了。

   至于具体修改方法,在对照原 d.ts 的基础上,你可能还需要熟悉 ts 接口方法的语法,可以参考这里:  ts接口教程。   

2.创建第三方模块

当我们准备好了要用的第三方库,还需要把它编译成 egret 需要的模块结构。比如现在有一个名为 jszip 的 js 库,它包含3个文件   

    jszip.js
    jazip.d.ts
    jszip.min.js

注意:这是在引擎上的操作步骤;

第一步:打开命令行窗口,输入命令,创建项目

    egret create_lib jszip

创建完之后的样子


第二步:在jszip目录下创建src bin typings目录,然后将jazip.js  jszip.min.js拷贝到src目录下,jszip.d.ts拷贝到typings目录下。



第三步,修改package.json



第四步,修改tsconfig.json



第五步,执行下面的指令

    egret build jszip

执行完毕之后,你会发现在bin目录下生成了3个文件,这样就做成了 egret项目中可以使用的模块了。   



3.使用第三方模块

第一步,创建项目

第二部,修改项目中的egretProperties.json文件

    "modules":[{
        "name":"promise"
    },
    {
        "name":"jszip",
        "path":"../jszip"
    }]

这里需要注意的是,jszip需要放置在Egret项目目录的外面,跟项目同级。

    egret build

这时候,我们发现项目中的lib目录中加入了jszip模块   



通过这篇文档,你可以学会怎么配置第三方文档

分享到 :
0 人收藏

1 个回复

倒序浏览
dujunfeng  登堂入室 | 6 天前
还是没太明白,我只想把一个js文件,配置到egret项目中,不是外部引入的方式,怎么搞啊
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

小黑屋|京网文[2014]0791-191号|京ICP证150115号|Egret社区 ( 京ICP备14025619号

Powered by Discuz! X3.2 © 2001-2019 Comsenz Inc.

返回顶部