本文档对EgretConversion工具做个大概介绍,通过本文档可以总览工具的所有功能特征,每个功能的具体用法在之后相应的文档中做详细解释。
菜单->文件
新建转换项目:这是EgretConversion的入口,所有的转换项目都要从这里创建。点击将弹出”新建转换项目“面板,填入项目名称、项目路径、项目类型、输出路径等几项参数。确定后将创建一个转换项目。
导入转换项目:导入一个之前已经创建好的转换项目。点击将弹出”导入项目“面板,选择或输入转换项目目录即可导入已存在的转换项目。
菜单->帮助
欢迎界面:点击后标签页跳转到欢迎页
官网:点击在浏览器中打开Egret官网页面。
文档中心:点击在浏览器中打开EDN中心。
官方论坛:点击在浏览器中打开官方论坛。
使用手册:点击在浏览器中打开EgretConversion文档页面。
提交bug:点击弹出”问题反馈“面板,可直接在这里提交遇到的bug,或者给工具的开发团队提任何建议等反馈。并可上传附件。
关于EgretConversion:点击打开关于面板,主要用于查看当前EgretConversion版本号。
1:"新建转换项目"按钮,功能同菜单->文件->新建转换项目。
2:"导入转换项目"按钮,功能同菜单->文件->导入转换项目。
3:"转换"按钮,点击将开始转换Flash的项目到Egret的项目,转换过程在日志区中会有相关提示。详见后续文档。
4:"编译"按钮,点击将编译转换后的Egret项目,编译过程在日志区有相关提示,编译错误会直接显示在日志区。详见后续文档。
5:"运行"按钮,如果编译通过,点击将直接运行egret的项目。详见后续文档。
6:"停止运行"按钮,如果转换后的项目正在运行,点击可关闭egret内部服务器,再刷新浏览器页面项目就无法运行了。参考运行项目。
7:"SWF转换工具"按钮,点击打开转换swf面板,拖入swf文件即可单独转换为egret项目的资源。这部分在后面的文档中做详细解释。
8:"问题反馈"按钮,功能同菜单->帮助->提交Bug。
项目工作区位于界面左侧,这里列出了之前创建的转换项目。点选某个项目,在工具中所做的操作都是针对该项目。左键选择项目,右键可打开快捷菜单:
删除:删除选中的转换项目。会弹出删除确定面板:
同时删除包含:删除项目的同时删掉转换项目目录下的所有文件。
不删除内容:只删除项目在工作区的引用,不真实删项目文件。
项目属性:点击打开项目的属性配置界面:
浏览输出目录:点击直接打开转换项目目录。
新建转换项目:功能同菜单->文件->新建转换项目。
导入转换项目:功能同菜单->文件->导入转换项目。
标签页
1:转换步骤:转换项目时的工作区,详见下文。
2:转换信息:转换完项目后,代码文件与swf文件的转换情况报告在这里全部列出。
3:语法差异:在as3代码转换到ts代码后,typescript与actionscript不兼容语法都在这里列出,可以对照提示逐条修改。详见后续文档的语法差异部分。
4:API警告统计:转换过程中遇到的API或者不可转换的as3类在这里列出,详见后续文档如何手动修复此类警告信息。
5:欢迎界面:转换工具的欢迎页。有转换项目、导入项目等快捷方式,示例项目,相关教程链接等。
6:登陆:提供登陆和注册功能,登陆后可以特定身份提交bug反馈给官方。
日志区实时显示转换项目当前进度,log信息,提示信息等。
转换Flash项目:功能同工具栏->转换按钮
编译Egret项目:功能同工具栏->编译按钮
运行Egret项目:功能同工具栏->运行按钮
-
代码文件转换率:as3文件到ts文件转换情况,每个as3的文件都会被转换对应的ts文件,语法从actionscript3转换为typescript的语法。这里显示了文件转换个数。点击条目会切换到”转换信息“页面,在这里可看到具体的哪个文件转换成功了,哪个转换失败了。
-
API转换率:统计了Flash的API转换到Egret过程中,API成功转换的个数和比例,此数值越高越好。点击条目会切换到“API警告统计”标签页。见“API警告统计”说明。
-
类型识别率:统计了as3与ts在语法上类型转换一项上的个数统计与转换比例,此数值越高越好。点击条目会切换到“语法差异”。见“语法差异”说明。
-
swf文件转换率:swf文件被解析的个数统计。点击条目会切换到”转换信息“页面,在这里可看到具体的哪个文件转换成功了,哪个转换失败了。
-
总体评价:对上述几项数值做出的综合评估,大体反应当前项目转换到egret的比例。此项数值越高越好,但也不表明100%就表示完全转换成功,不到100%就是转换失败,具体情况需视项目而论。