白鹭使用第三方扩展库

引入第三方库

第三方库需要编译成 egret 需要的模块结构。包含*.js、*.d.ts、*.min.js。

1、有现成的，直接使用；

2、只有源文件，生成方法：

1. ① 创建一个egret第三方库的项目文件，在命令行中输入

   egret create_lib sdk

   执行完成之后可以看到新建了一个 sr5220 文件夹，文件夹内有两个文件 package.json tsconfig.json。

2. ② 在 sdk 文件夹内创建src bin typings 目录。

   ③ 根据 TypeScript / JavaScript 不同类型的类库，有两种情况：

   TypeScript库

   直接将ts文件放到src目录下。

   修改tsconfig.json文件：

1.  {

2.    "compilerOptions": {

3.        "target": "es5",

4.        "noImplicitAny": false,

5.        "sourceMap": false,

7.        // 是否生成.d.ts文件。 如果是typescript库设置为true，如果是javascript库设置为false

8.        "declaration": true,  

10.        "outFile": "bin/demo/demo.js",  // 生成的库文件的路径

11.    },

12.    "include": ["src"]

13. }

1. JavaScript库

   将js文件放到src目录下，将对于的 .d.ts 文件放到typings目录下。

   修改tsconfig.json文件：

1.  {

2.      "compilerOptions": {

3.          "target": "es5",

4.          "noImplicitAny": false,

5.          "sourceMap": false,

7.          // 是否生成.d.ts文件。 如果是typescript库设置为true，如果是javascript库设置为false

8.          "declaration": false,  

10.          "outFile": "bin/demo/demo.js",  // 生成的库文件的路径

12.          // 是否允许编译js文件。 如果是typescript库设置为false，如果是javascript库设置为true

13.          "allowJs": true  

14.      },

15.      "include": ["src"]

16.   }

1. 修改package.json 文件：

2.         {

1.       "name": "jszip",

2.       "compilerVersion": "5.2.7",

4.       // 新增一个字段

5.       "typings": "typings/demo.d.ts"

6.   }

3. ④ 执行命令

   egret build sdk

   会根据 tsconfig.json中的 outFile字段生成库文件，压缩文件以及 .d.ts 文件。

   bin 目录中生成的sdk文件夹就是我们可以使用的第三方库文件夹。

4. 注意：以后每次修改第三方库源代码后，都需要重新生成，保证min.js对得上
   

使用第三方库

1. 1、将上面生成的三个文件的目录复制到项目libs目录中（不可以放到modules内）。

2. 
   

3. 2、编辑egretProperties.json文件：

   在modules新增一个字段

   {
        "name": "sdk",  // 第三方库的name
        "path": "./libs/sdk"  // 路径
   }

       3、编译引擎

 egret build

        4、执行之后，就可以在当前项目中使用的引入的第三方库了。

参考资料：http://developer.egret.com/cn/github/egret-docs/extension/threes/instructions/index.html