reset

Author: mebiusashan

Conversion/ASCodeTool/56b1ac1e245c0.png

@@ -0,0 +1,19 @@
+“AS代码转换工具”可将as3件导出为egret项目ts代码。作为EgretConversion附属工具，可以在as3件有更改时，单独转换该as3件，而不用转换整个项目。
+
+**如何使用“AS代码转换工具”单独转换as3件？**
+
+ 点击工具栏的按钮“SWF转换工具”
+ 
+ ![](56b1ac1e245c0.png)
+ 
+ 打开AS代码转换面板：
+ 
+ ![](56b1ac1e2e299.png)
+ 
+具体操作：
+
+1. 直接把as3文件或文件夹拖到面板中
+
+2. 转换后的代码会在C:\Users\xxxx\Desktop\astemp中
+
+3. 可以直接把代码拷贝到egret项目中直接使用（错误自己还是需要改的）

Conversion/ASCodeTool/56b1ac1e2e299.png

@@ -0,0 +1,69 @@
+“SWF转换工具”可将swf文件导出为Egret项目可用的资源。作为Egret Conversion附属工具，可以在swf文件有更改时，单独转换该swf文件，而不用转换整个项目。要注意的是，“SWF转换工具”是为Egret定制的工具，转出的格式只能用于egret项目（需要三方库的支持），无法在其他h5项目中使用。
+
+## 一、如何使用“SWF转换工具”单独转换swf文件？
+
+点击工具栏的按钮“SWF转换工具”
+
+![](56b1ac0cbd1f8.jpg)
+
+打开SWFExporter面板：
+
+![](56b1ac0d06bb9.jpg)
+
+1：提示信息区
+
+2：swf文件的导出位置
+
+3：当前导出swf文件的进度信息
+
+4：正在导出的swf文件全路径
+
+以Flashbuilder项目为例：
+
+从Flash项目的bin-debug或源码目录下拖入一个或多个swf文件到面板中，也可拖入目录。转换时在面板底部显示有转换的进度，当转换完成将显示“complete!”。
+
+如果选择了一个转换项目，所有转换的swf都会生成资源到转换项目下的egret项目resource/swfres目录下。
+
+如果没有选择任何转换项目，所有转换的swf都会生成到桌面上resource/swfres下。
+
+## 二、怎样在 Egret 项目中使用生成的资源？
+
+把生成到resource/swfres路径下的资源文件夹拷贝到egret项目的相应位置(resource下)。然后可以像在flash中写as3代码一样加载swf文件。
+
+例如在as3中这样写：
+
+```
+var url:String = "123.swf";
+var urlRequest:URLRequest = new URLRequest(url);
+var loader:Loader = new Loader();
+loader.load(urlRequest, null);
+loader.contentLoaderInfo.addEventListener(Event.COMPLETE, onLoadComplete);
+```
+
+在egret项目中这样写：
+
+```
+var url:String = "123.swf";
+var urlRequest:egret.URLRequest = new egret.URLRequest(url);
+var loader:flash.Loader = new flash.Loader();
+loader.load(urlRequest,null);
+loader.contentLoaderInfo.addEventListener(egret.Event.COMPLETE,flash.bind(this.onLoadComplete,this),null);
+```
+
+可以看到egret项目的typescript代码直接加载了swf格式的文件。
+
+egret项目直接支持swf文件格式吗？答案是不支持。
+
+而使用Egret Conversion转换生成的egret项目支持swf。这是因为EgretConversion在底层封装了swf文件格式，在代码层模拟了这一功能，请看下文讲解。
+
+## 三、egret中是怎么实现载入swf的？
+
+在flash中可以直接加载swf格式的文件，然后从文件中取到各种资源，而egret是不支持swf文件格式的。Egret Conversion通过转换操作，将flash项目的as3语法翻译为egret项目的ts语法，将swf文件解析为可为egret项目识别的资源格式，通过底层的封装最终可在代码层直接加载swf。要注意的是，这种加载swf并不是真的load了一个.swf文件，而是在底层载入了经过转换后的图片等文件。
+
+## 四、支持swf资源的三方库
+
+Egret Conversion转换的swf资源可在任意egret项目中使用，通过导入一个开源的三方库。
+
+获得三方库：用EgretConversion转换任意一个flash项目（可以用示例项目），在生成的egret项目中，src/as3目录即是这个三方库文件。
+
+将三方库拷贝到自己的egret项目相应路径下。

Conversion/ASCodeTool/README.md

@@ -0,0 +1,47 @@
+转换Flash项目只是第一步，用EgretConversion转换完项目并按照提示修改错误的语法，以保证项目可以通过编译，然后才能运行项目 。这里提供一些技巧以便于您能快速调试自己的项目。
+
+1. 源项目只需转换一次，剩余的工作都在Egret项目端完成。
+
+2. 做好项目备份。
+
+EgretConversion不会修改源Flash项目的任何内容，但是每次转换操作会覆盖Egret项目的所有代码。因此如果在Egret端已经修复了很多错误，需要谨慎使用“转换按钮”。建议是转换过项目之后所有的改动在Egret端做，不要在Flash项目中继续修改as3代码。
+
+3. Egret项目开发工具可以使用Egret Wing或者Webstorm或者visual studio。wing的断点调试功能很方便。
+
+4. 在Chrome中调试Egret的程序，可以断点查看运行时变量值。
+
+5. 给Chrome安装Egret Inspector插件（从Egret下载器里下载），可以直观的看到显示对象的层级关系，并可动态修改所选目标的属性值以查看效果。查看当前帧率也在这里：
+
+![](56b1ac3f5904b.jpg)
+
+6. 修改舞台背景色。舞台背景默认是黑色。
+
+打开Egret项目launcher下的index.html文件，修改 background: #000000;字段
+
+7. 设置横竖屏，如上。修改 <meta name="screen-orientation" content="portrait"/>
+
+8. 以WebGL模式运行项目：（Filter等效果只有在WebGL模式下有效果）
+
+打开Egret项目下launcher下的egret_loader.js，修改var rendererType = 0;变量为1。
+
+9. 修改舞台默认大小。
+
+打开Egret项目下launcher下的egret_loader.js，修改egret.StageDelegate.getInstance().setDesignSize(600,600);
+
+10. 修改帧频
+
+打开Egret项目下launcher下的egret_loader.js，修改stage.frameRate = 10;
+
+要注意的是该值必须为可被60整除的数（10,15,20,30,60），否则在运行时会将60作为默认值。
+
+![](56b1ac402f21a.jpg)
+
+11. 更新老项目的库文件
+
+EgretConversion升级之后，库文件（as3目录下的类库）会有所更新。创建新的转换项目会使用最新的库文件，对于之前的转换项目，需要把最新的库文件拷贝到项目中替换旧文件。也可以在自动检测到库更新后点“更新配置”自动更新。
+
+![](56b1ac409fa73.jpg)
+
+12. 更新老项目的引擎版本
+
+本机升级Egret后，在命令行中cd到egret项目目录，执行egret upgrade升级项目，然后执行egret build -e编译项目。