IL2CPP 概述

IL2CPP（Intermediate Language To C++）脚本后端是 Mono 后端的替代方案。IL2CPP 为更广泛平台上的应用程序提供更好的支持。IL2CPP 后端将 MSIL（Microsoft 中间语言）代码（例如，脚本中的 C# 代码）转换为 C++ 代码，然后使用 C++ 代码为所选平台创建原生二进制文件（例如，.exe、.apk 或 .xap）。

这种编译方式称为提前 (AOT) 编译，即 Unity 在构建本地二进制文件时，针对目标平台专门编译代码。Mono 后端在运行时使用一种称为即时编译 (JIT) 的技术来编译代码。

在此页面上：

• 使用 IL2CPP 来构建项目
• IL2CPP 的工作原理
• 优化 IL2CPP 构建时间
• 使用 IL2CppSetOption 来启用运行时检查

某些平台不支持 AOT 编译，因此__ IL2CPP__ 后端并非适用于所有平台。其他平台支持 AOT 和 IL2CPP，但不允许 JIT 编译，因此无法支持 Mono 后端。当平台可以同时支持两个后端时，默认为 Mono。有关更多信息，请参阅脚本限制。

IL2CPP 可以提高各种平台的性能，但在构建的应用程序中包含机器代码的需求会增加构建时间和最终构建的应用程序的大小。有关更多信息，请参阅 IL2CPP 的工作原理和博客系列IL2CPP 内部简介。

IL2CPP 支持使用与 Mono 脚本后端相同的方式调试托管代码。想了解更多相关信息，请参阅在 Unity 中调试 C# 代码。

使用 IL2CPP 来构建项目

要使用 IL2CPP 构建项目，需要在 Unity 安装过程中安装后端。首次安装 Unity 版本时，可以选择 IL2CPP 作为可选模块，也可以通过 Unity Hub 将 IL2CPP 支持添加到现有安装中。有关更多信息，请参阅安装 Unity Hub 以及将模块添加到 Unity 编辑器。

IL2CPP 还需要目标平台原生的一些系统来生成 C++ 代码。这意味着要在特定平台上使用 IL2CPP，需要在该平台上构建应用程序。例如，要将 IL2CPP 与 MacOS 结合使用并作为构建目标，需要在使用 MacOS 的机器上构建应用程序。有关桌面平台的系统要求（包括各个平台的 IL2CPP 要求）的更多信息，请参阅 Unity 系统要求的 Desktop 部分。

您可以通过以下两种方法的其中一种来更改 Unity 用于构建应用程序的脚本后端：

• 通过编辑器中的播放器设置 (Player Settings) 菜单。执行以下步骤可通过播放器设置 (Player Settings) 菜单更改脚本后端：

  1. 转到编辑 (Edit) > 项目设置 (Project Settings)。
  2. 单击播放器设置 (Player Settings) 按钮可在 Inspector 中打开当前平台的播放器 (Player) 设置。
  3. 导航到其他设置 (Other Settings) 子菜单下的配置 (Configuration) 部分标题。
  4. 单击脚本后端 (Scripting Backend) 下拉菜单，然后选择 IL2CPP。

  还可以从构建配置文件 (Build Profiles) 窗口打开播放器设置 (Player Settings) 菜单；转到文件 (File) > 构建配置文件 (Build Profiles)，然后单击播放器设置 (Player Settings) 选项卡。

• 通过编辑器脚本 API。使用 PlayerSettings.SetScriptingBackend 属性可更改 Unity 使用的脚本后端。

要开始构建过程，请打开构建配置文件 (Build Profiles) 窗口并单击构建 (Build) 按钮。Unity 随后将 C# 代码和程序集转换为 C++，最后为目标平台生成二进制文件。

IL2CPP 的工作原理

使用 IL2CPP 开始构建时，Unity 会自动执行以下步骤：

1. Roslyn C# 编译器将应用程序的 C# 代码和所有必需的包代码编译为 .NET DLL（托管程序集）。
2. Unity 应用托管字节码剥离。此步骤可显著减小构建的应用程序大小。
3. IL2CPP 后端将所有托管程序集转换为标准 C++ 代码。
4. C++ 编译器使用本机平台编译器编译生成的 C++ 代码和 IL2CPP 的运行时部分。
5. Unity 创建可执行文件或 DLL，具体取决于目标平台。

IL2CPP 和 Mono 均提供了一些有用的选项；可通过脚本中的属性来控制这些选项。有关更多信息，请参阅依赖于平台的编译。

IL2CPP 使 Unity 能够为特定平台预编译代码。Unity 在此过程结束时生成的二进制文件已包含目标平台所需的机器代码，而 Mono 必须在运行时执行期间编译此机器代码。AOT 编译确实会增加构建时间，但也会提高与目标平台的兼容性并提高性能。

两个脚本后端都需要针对每个目标平台重新构建。例如，要同时支持 Android 和 iOS 平台，需要构建两次应用程序并生成两个二进制文件。

程序集剥离阶段有助于减小最终二进制文件的大小。Unity 会删除最终构建的应用程序不使用的任何字节码。

优化 IL2CPP 构建时间

使用 IL2CPP 时的项目构建时间可能明显长于使用 Mono 时的项目构建时间。但是，可以执行几项操作来减少构建时间。

将项目排除在反恶意软件扫描之外

在构建项目之前，可以从反恶意软件扫描中排除 Unity 项目文件夹和目标构建文件夹。

将项目和目标构建文件夹存储在固态硬盘 (SSD) 上

与传统硬盘驱动器 (HDD) 相比，固态硬盘 (SSD) 具有更快的读/写速度。将 IL 代码转换为 C++ 并对其进行编译的过程涉及大量的读/写操作，因此更快的存储设备可加快此过程。

在播放器设置 (Player Settings)中更改 IL2CPP 代码生成 (IL2CPP Code Generation) 选项

要更改 IL2CPP 生成代码的方式，请打开播放器设置 (Player Settings)并配置 IL2CPP 代码生成 (IL2CPP Code Generation) 选项。默认情况下，会启用更快运行时 (Faster runtime) 选项，这样将生成更多机器代码，从而减少 IL2CPP 在运行时的影响。为了减少构建时间，可将此选项设置为 Faster（较小）构建。此方法在二进制可执行文件中生成和包含的机器代码更少，因此可能会降低运行时性能，但也会显著减少构建时间和二进制文件大小。

使用 Il2CppSetOption 来启用运行时检查

使用 IL2CPP 脚本后端时，可以控制 il2cpp.exe 生成 C++ 代码的方式。可以使用 Il2CppSetOption 属性启用或禁用以下运行时检查：

要使用 Il2CppSetOption 属性：

1. 在安装了 Unity 版本的目录中，导航到 Windows 上的 Data\il2cpp 目录或 OS X 上的 Contents/Frameworks/il2cpp 目录。
2. 查找 Il2CppSetOptionAttribute.cs 源文件。
3. 将源文件复制到项目的 Assets 目录中。

以下示例描述了如何使用 Il2CppSetOption 属性：

[Il2CppSetOption(Option.NullChecks, false)]
public static string MethodWithNullChecksDisabled()
{
    var tmp = new object();
    return tmp.ToString();
}

可将 Il2CppSetOption 属性应用于程序集、类型、方法和属性。Unity 在最局部的作用域内使用该属性。

[Il2CppSetOption(Option.NullChecks, false)]
public class TypeWithNullChecksDisabled
{
    public static string AnyMethod()
    {
        // Unity doesn’t perform null checks in this method.
        var tmp = new object();
        return tmp.ToString();
    }

    [Il2CppSetOption(Option.NullChecks, true)]
    public static string MethodWithNullChecksEnabled()
    {
        // Unity performs null checks in this method.
        var tmp = new object();
        return tmp.ToString();
    }
}

public class SomeType
{
    [Il2CppSetOption(Option.NullChecks, false)]
    public string PropertyWithNullChecksDisabled
    {
        get
        {
            // Unity doesn’t perform null checks here.
            var tmp = new object();
            return tmp.ToString();
        }
        set
        {
            // Unity doesn’t perform null checks here.
            value.ToString();
        }
    }

    public string PropertyWithNullChecksDisabledOnGetterOnly
    {
        [Il2CppSetOption(Option.NullChecks, false)]
        get
        {
            // Unity doesn’t perform null checks here.
            var tmp = new object();
            return tmp.ToString();
        }
        set
        {
            // Unity performs null checks here.
            value.ToString();
        }
    }
}

其他资源

• 处理 IL2CPP 其他参数
• Linux IL2CPP 交叉编译器
• Windows 运行时支持
• 托管堆栈跟踪