Unity IUnityLinkerProcessor
Unity IUnityLinkerProcessor 是 Unity 引擎中的一个接口,它容许开发者在 Unity 我的项目构建时对代码进行链接解决。这个接口能够用来优化我的项目构建大小,缩小不必要的代码和资源,进步我的项目的性能和加载速度。
接口定义
IUnityLinkerProcessor 接口定义如下:
namespace UnityEditor.Build.IPA
{
public interface IUnityLinkerProcessor
{void OnBeforeRun(LinkXml linkXml);
void OnProcessAssembly(string inputFile, string[] searchDirs, string outputFile);
}
}
其中,OnBeforeRun 办法在 Unity 构建我的项目之前被调用,能够用来解决 Link.xml 文件。OnProcessAssembly 办法在 Unity 构建我的项目时被调用,能够用来解决每个输出程序集。
Link.xml 文件
Link.xml 文件是 Unity 我的项目中的一个 XML 文件,用于指定须要保留的程序集、类型和成员。Link.xml 文件的格局如下:
<linker>
<assembly fullname="AssemblyName">
<type fullname="TypeName" preserve="method" />
</assembly>
</linker>
其中,assembly 元素指定须要保留的程序集,fullname 属性指定程序集的残缺名称。type 元素指定须要保留的类型,fullname 属性指定类型的残缺名称,preserve 属性指定须要保留的成员类型,能够是 method、field、property、event 等。
应用例子
上面给出三个应用例子,别离演示如何应用 IUnityLinkerProcessor 接口来优化 Unity 我的项目的构建大小。
例子 1:保留指定程序集
在 Link.xml 文件中指定须要保留的程序集,其余程序集将被删除。
<linker>
<assembly fullname="Assembly-CSharp" />
</linker>
在 IUnityLinkerProcessor 接口的 OnBeforeRun 办法中读取 Link.xml 文件,将须要保留的程序集增加到 LinkerOptions 中。
public void OnBeforeRun(LinkXml linkXml)
{foreach (var assembly in linkXml.Assemblies)
{if (assembly.Fullname == "Assembly-CSharp")
{LinkerOptions.LinkAssemblies.Add(assembly.Fullname);
}
}
}
例子 2:保留指定类型和成员
在 Link.xml 文件中指定须要保留的类型和成员,其余类型和成员将被删除。
<linker>
<assembly fullname="Assembly-CSharp">
<type fullnameMyClass">
<method signature="System.Void MyMethod()" />
</type>
</assembly>
</linker>
在 IUnityLinkerProcessor 接口的 OnBeforeRun 办法中读取 Link.xml 文件,须要保留的类型和成员增加到 LinkerOptions 中。
public void OnBeforeRun(LinkXml linkXml)
{foreach (var assembly in linkXml.Assemblies)
{if (assembly.Fullname == "Assembly-CSharp")
{foreach (var type in assembly.Types)
{if (type.Fullname == "MyClass")
{foreach (var method in type.Methods)
{if (method.Signature == "System.Void MyMethod()")
{LinkerOptions.LinkType(type.Fullname);
LinkerOptions.LinkMethod(method.Signature);
}
}
}
}
}
}
}
例子 3:删除指定程序集
在 Link.xml 文件中指定须要删除的程序集,其余程序集将被保留。
<linker>
<assembly fullname="Assembly-CSharp" remove="true" />
</linker>
在 IUnityLinkerProcessor 接口的 OnBeforeRun 办法中读取 Link.xml 文件,将须要删除的程序集增加到 LinkerOptions 中。
public void OnBeforeRun(LinkXml linkXml)
{foreach (var assembly in linkXml.Assemblies)
{if (assembly.Remove)
{LinkerOptions.DontLinkAssemblies.Add(assembly.Fullname);
}
}
}
总结
通过应用 Unity IUnityLinkerProcessor 接口和 Link.xml 文件,开发者能够对 Unity 我的项目进行链接解决,优化我的项目的构建大小,缩小不必要的代码和资源,进步我的项目的性能和加载速度。在理论开发中能够依据我的项目的需要,灵便应用 Link.xml 文件和 IUnityLinkProcessor 接口,实现最佳的优化成果。
本文由博客一文多发平台 OpenWrite 公布!