Unity Obfuscator 使用说明

一、Assembly - Settings

这个段落描述了在Unity中管理可混淆（obfuscate）程序集及其依赖项的设置。下面是对每个选项的翻译和使用说明：

1. 核心Unity程序集（Assembly-CSharp）

Obfuscate Assembly-CSharp: 开启

这是Unity的核心程序集，所有没有存储在程序集定义文件（assembly definition file）中的代码都会被存储在这里。大多数情况下，你会希望开启这个选项以混淆该程序集。

2. 插件程序集（Assembly-CSharp-firstpass）

Obfuscate Assembly-CSharp-firstpass: 关闭

这是第二个核心Unity程序集，其中存储了“Plugins”目录中的所有代码文件。大多数情况下，你也会希望混淆这个程序集。

3. 混淆 ‘Assets’ 目录中的程序集定义文件

Obfuscate Assembly Definition Files in ‘Assets’: 关闭

开启此选项将搜索“Assets”目录中的所有程序集定义文件，并混淆相应的程序集。

4. 混淆 ‘Packages’ 目录中的程序集定义文件

Obfuscate Assembly Definition Files in ‘Packages’: 关闭

开启此选项将搜索“Packages”目录中的程序集定义文件，并混淆相应的程序集。请注意，这里可能也包含Unity核心程序集，因此请小心使用此功能。这是一个测试功能。

5. 混淆外部预编译程序集

Obfuscate external assemblies:

在此处输入你想要混淆的外部预编译程序集的名称，例如“MvAssembly.dll”，或输入完整路径，例如“C:/[MyGame]/MyAssembly.dll”。

你可以使用“Add Line”来添加新的程序集路径，也可以使用“Remove Line”来移除现有的路径。

如果你在混淆过程中收到错误信息，比如“Assembly XYZ could not be resolved!”、“Assembly XYZ could not be found!”或类似的错误，可以通过以下方式解决：

找到该程序集的目录路径。通常，这些程序集可以在你的项目的“Assets”或“Packages”目录中找到。

如果例如一个名为“GameAnalytics”的程序集未被找到，并且它的位置是“Assets/GameAnalytics/Plugins/GameAnalytics.dll”，那么你可以将相对目录路径“Assets/GameAnalytics/Plugins”添加到下面的列表中。

如果问题依然存在，尝试添加完整路径，例如“D://[YourProject]/Assets/GameAnalytics/Plugins”。

二、Namespace - Settings

在这里插入图片描述

1. 混淆命名空间（Obfuscate Namespaces）

Obfuscate Namespaces: 开启

激活此设置将混淆命名空间。如果可能，混淆器将删除命名空间，从而增加混淆的深度。

2. 跳过特定命名空间

Skip following Namespaces:

在此处添加你希望跳过混淆的命名空间。混淆器会根据前缀来决定是否跳过某个命名空间。例如，如果你输入“Unity.StandardAssets”，那么该命名空间中的所有类都将被跳过混淆，且所有以“Unity.StandardAssets”开头的命名空间也会被跳过。

**注意：**不要输入空行！否则将会跳过所有命名空间，导致没有任何内容被混淆。

3. 反转命名空间跳过（Vice Versa Namespace Skipping）

Vice Versa Namespace Skipping: 关闭/未设置

启用此设置将反转命名空间跳过的逻辑。这样，只有在上面列表中输入的命名空间和类会被混淆，其他的将不会被混淆。

三、Class Obfuscation

在这里插入图片描述

1. 通过访问级别控制混淆（Obfuscation controlled through the accessibility）

Obfuscate:
- Internal: 开启
- Private: 开启
- Protected: 开启
- Public: 开启

这些选项控制不同访问级别的类是否被混淆。例如，Internal、Private、Protected 和 Public 修饰的类都将被混淆。

2. 子类混淆设置（Subclasses）

Obfuscate Abstract Classes: 关闭

激活此设置以混淆抽象类。

Obfuscate Generic Classes: 关闭

激活此设置以混淆泛型类。

Obfuscate Serializable Classes: 关闭

激活此设置以混淆标有 [Serializeable] 特性的类。

如果要混淆可序列化类，必须在“optional”选项卡中激活“Rename Mapping”设置。此选项会保存并加载原始类/方法/字段及其匹配的混淆名称的映射，因为 Unity 会通过名称存储可序列化类。

3. Unity 子类混淆（Unity Subclasses）

Obfuscate MonoBehaviour SubClasses: 关闭

激活此设置以混淆 MonoBehaviour 子类。这需要先激活命名空间混淆设置。

Obfuscate ‘Not Obfuscatable’ MonoBehaviour SubClasses: 关闭

激活此设置以混淆不能直接混淆的 MonoBehaviour 子类。这通常是因为 Unity 通过反射调用某些类。此情况下使用的技术称为“子类型随机化（subtype
Randomizer）”。类将通过创建大量随机类来混淆。这也需要激活命名空间混淆设置。

Obfuscate MonoBehaviour SubClasses in external Assemblies: 关闭

激活此设置以混淆你在程序集设置中指定的外部程序集中的 MonoBehaviour 子类。此设置将以“2018.2 之后”的方式混淆类。

Obfuscate ‘Not Obfuscatable’ MonoBehaviour SubClasses in external Assemblies: 关闭

激活此设置以混淆外部程序集中的不能直接混淆的 MonoBehaviour 子类。这种情况通常是因为 Unity 通过反射调用某些类。使用的技术同样是“子类型随机化”，需要激活命名空间混淆设置。

Obfuscate MonoBehaviour SubClasses in external Assemblies: 关闭

激活此设置以混淆外部程序集中的 MonoBehaviour 子类，这些程序集是在程序集设置中指定的。如果某些类无法直接混淆（例如，Unity通过反射调用这些类），你可以使用称为“子类型随机化（subtypeRandomizer）”的技术。这将通过创建大量随机类来混淆原始类。此功能需要先激活命名空间混淆设置。