egret-docs-master/Conversion/errorDeal
guofei 4fe0162b34 fist commit 2024-06-19 13:32:32 +08:00
..
README.md fist commit 2024-06-19 13:32:32 +08:00

README.md

一,工具基本功能报错

  • 无法新建转换项目

新建转换项目时工具没有反应进入假死状态。这种情况下可能与本地没有配置好egret环境有关参考准备与安装

  • 项目转换后编译报错

首先确定本机当前所用的Egret版本为EgretConversion所要求的版本。如果低于所需最低版本则要更新Egret准备与安装)。

  • 3000端口被占用无法运行项目

egret本机项目运行在3000端口上需要结束其他占用了3000端口的进程。参考“Getting Started”文档的“KILL3000端口”部分。

二,代码转换报错

  • 类型转换报错

ts中任意类型转换报错可在表达式前加强转一下。

使用'as'操作符做类型转换时如果要转为Class类型会有一个编译报错

“error TS2304: Cannot find name 'any'.”

例如从加载的swf中取链接类定义

var btnCls:Class = loaderInfo.applicationDomain.getDefinition("MyButton") as Class;

转换之后的TS代码为

var btnCls:any = <any>as3.As3As(loaderInfo.applicationDomain.getDefinition ("MyButton"),any);

这是因为ts中没有与Class对应的类类型需要手动修改如下

var cls:any = <any>loaderInfo.applicationDomain.getDefinition ("MyButton");
  • 类型转换报错error TS2345
private myFunc():void{
   var employees:Array<any>;
   var isManager:Function = function (element:any,index:number,arr:Array<any>):boolean
   {
      return true;
   }; 
   employees.filter(isManager);
}

编译时经常会报错: error TS2345: Argument of type 'Function' is not assignable to parameter of type '(value: any, index: number, array: any[]) => boolean'.

大部分情况下这是编译器的误报,可以忽略不管。也可以手动在右侧表达式前加强转,再次编译就不会报类型强转的错误。

  • 接口继承接口,类型判定需手动修改。

  • 判断一个对象是否实现了某接口,需手动修改。

  • 对于闭包,如果有嵌套的写法可能会转换失效,根据错误提示修改写法。

  • 对于出现的API警告有未实现的API请参考手册里“手动填充API”章节。

  • namespace引起的转换错误

暂时不支持命名空间的语法规则as3中的namespace在ts中被忽略在as3的namesapce中定义的变量和方法视为public属性。因此要防止同名变量的冲突例如在类MyClass.as中定义变量如下

public var nsvar1:int = 10;
ns1 var nsvar1:int = 30;//ns1是我定义的命名空间

在转换为ts代码之后为

public nsvar1:number = 10;
public nsvar1:number = 30;//这里会与类变量冲突

对于此冲突目前需要手动修改namespace写法在EgretConversion的后续版本中将会支持。

  • 子类父类同名属性同名方法冲突

as3代码中子类可以override父类的方法可以重新定义重名属性改变属性的访问域private/public/protected可以定义重名的static属性/方法。

对于同名的属性/方法EgretConversion在转换之后会重命名子类中的同名属性/方法,以与父类区分。

如以下基类与子类:

public class BaseCls
{
	public var myVar:int;
	public static var TYPE:String = "red";
	public function func():void{
	}
	public static function sfunc():void{
	}
}
public class ExtendCls extends BaseCls
{
	protected var myVar:int;//改变属性访问限制
	public static var TYPE:String = "red";//重定义static变量
	public override function func():void{//override函数
	}
	public static function sfunc():void{//重定义static函数
	}
}

看下转换后的ts代码

 class ExtendCls extends BaseCls {
	protected myVar_ExtendCls:number = 0;//重命名
	public static TYPE_static_ExtendCls:string;//重命名
	public func()	{
	}
	public static sfunc_static_ExtendCls()	{//重命名
	}
}
ExtendCls.TYPE_static_ExtendCls = "red";
  • get set方法在ts中不可调用super需要手动修改。

如果在as3中子类重写了get 或set方法转换后在ts端不会报错但是子类无法获取父类的 get/set方法了。

例如父类中有get & set方法

private _age:number = 0;
public get age():number{
 return this._age;
}
public set age(value:number){
 this._age = value;
}

子类中重写set

public override set age(value:number){
    ….
}

子类中将无法访问 age的get方法。

EgretConversion转换as3项目后会重命名get set方法的方法名。如

protected set age_ExtendCls(value:number)

三,资源转换报错

  • 转换过程中有swf文件无法转换卡死、闪退

在转换swf资源时如果卡在某个swf文件无法转换可能导致工具的崩溃、闪退、卡死等现象。一般是由于工具尚不支持的功能引起的。解决办法可暂时通过删除该swf以跳过转换该资源。并将有问题文件提交给官方。有下列情形的可按照相应的办法解决

a. avm1格式的swf需要在fla中重新发布为avm2格式。

b. 有视频等尚不支持的资源类型可以在fla中删除尚不支持的资源重新发布swf。

  • 转换过程死循环重复转同一个swf文件

使用SwfExporter工具单独转有问题的swf。或者重启EgretConversion继续转换。

  • swf有更改需要重新导出

已经转过的swf不会重新转换如果原swf文件有改动需删除已经转换出的资源文件夹在resource\swfres目录下。或者使用“swf转换工具”的功能拖入swf文件转换。

  • 文本都是白色

升级egret到2.0.3之后的版本。

  • 转换后动画播放不正确

是否用帧代码控制播放了比如加个stop()。目前转换项目会忽略帧代码。

其他错误联系官方团队。

论坛热帖 转换错误解决方案


EgretConversion联系方式

官方QQ群Egret Conversion VIP 249685517

官方论坛:http://bbs.egret.com/forum.php?mod=forumdisplay&fid=70