マネージコードストリッピング

マネージコードストリッピングの設定

1. Edit > Project Settings > Player に移動します。
2. Other Settings で、Optimization に移動します。
3. Managed Stripping Level プロパティを任意の値に設定します。

[Preserve]

アノテーションを用いたコードの保存

• ルートアノテーションは、コードの一部をルートとして識別します。Unity リンカーは、ルートとしてマークされたコードを削除しません。ルートアノテーションの使用はそれほど複雑ではありませんが、Unity リンカーが取り除くべきコードを残してしまう可能性もあります。
• 依存関係アノテーションは、コード要素間の関係を定義します。依存関係アノテーションを使用すると、ルートアノテーションと比較して、コードを残し過ぎないようにできます。

ルートアノテーション

• Preserve 属性: 個々の型をルートとしてアノテーションを付け、それらを保持します。
• Link.xml: アセンブリと、そのアセンブリ内のすべての型や他のコードエンティティをルートとしてアノテーションを付け、保持します。

Preserve 属性でルートにアノテーションを加える

[Preserve]

[Preserve]

• アセンブリ: アセンブリで使用され、定義されるすべての型を保持します。

  [Preserve]

  属性をアセンブリに割り当てるには、アセンブリに含まれる任意の C# ファイルの名前空間宣言の前に属性宣言を配置します。
• 型: クラスまたは型とそのデフォルトのコンストラクターを保持します。
• メソッド: メソッド、メソッドを宣言した型、メソッドが返す型、すべての引数の型を保持します。
• プロパティ: プロパティ、プロパティを宣言する型、プロパティ値の型、プロパティ値を取得/設定するメソッドを保持します。
• フィールド: フィールド、フィールド型、フィールドを宣言する型を保持します。
• イベント: イベント、イベントを宣言した型、型、イベントが返す型、

  [add]

  アクセサー、

  [remove]

  アクセサーを保持します。
• デリゲート: デリゲート型とデリゲートが呼び出すすべてのメソッドを保持します。

[Preserve]

[Preserve]

class Foo{    [Preserve]    public void PreservedMethod(){}}

Link XML ファイルによるルーツのアノテーション

Assets

Assets

<linker>

<linker>  <!--Preserve types and members in an assembly-->  <assembly fullname="AssemblyName">    <!--Preserve an entire type-->    <type fullname="AssemblyName.MethodName" preserve="all"/>    <!--No "preserve" attribute and no members specified means preserve all members-->    <type fullname="AssemblyName.MethodName"/>    <!--Preserve all fields on a type-->    <type fullname="AssemblyName.MethodName" preserve="fields"/>    <!--Preserve all fields on a type-->    <type fullname="AssemblyName.MethodName" preserve="methods"/>    <!--Preserve the type only-->    <type fullname="AssemblyName.MethodName" preserve="nothing"/>    <!--Preserving only specific members of a type-->    <type fullname="AssemblyName.MethodName">              <!--Fields-->      <field signature="System.Int32 FieldName" />      <!--Preserve a field by name rather than signature-->      <field name="FieldName" />            <!--Methods-->      <method signature="System.Void MethodName()" />      <!--Preserve a method with parameters-->      <method signature="System.Void MethodName(System.Int32,System.String)" />      <!--Preserve a method by name rather than signature-->      <method name="MethodName" />      <!--Properties-->      <!--Preserve a property, its backing field (if present),           getter, and setter methods-->      <property signature="System.Int32 PropertyName" />      <property signature="System.Int32 PropertyName" accessors="all" />      <!--Preserve a property, its backing field (if present), and getter method-->      <property signature="System.Int32 PropertyName" accessors="get" />      <!--Preserve a property, its backing field (if present), and setter method-->      <property signature="System.Int32 PropertyName" accessors="set" />      <!--Preserve a property by name rather than signature-->      <property name="PropertyName" />      <!--Events-->      <!--Preserve an event, its backing field (if present), add, and remove methods-->      <event signature="System.EventHandler EventName" />      <!--Preserve an event by name rather than signature-->      <event name="EventName" />    </type>  </assembly></linker>

<!--Preserve an entire assembly-->  <assembly fullname="AssemblyName" preserve="all"/>  <!--No "preserve" attribute and no types specified means preserve all-->  <assembly fullname="AssemblyName"/>  <!--Fully qualified assembly name-->  <assembly fullname="AssemblyName, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null">    <type fullname="AssemblyName.Foo" preserve="all"/>  </assembly>  <!--Force an assembly to be processed for roots but don’t explicitly preserve anything in particular. Useful when the assembly isn't referenced.-->  <assembly fullname="AssemblyName" preserve="nothing"/>

<!--Examples with generics-->    <type fullname="AssemblyName.G`1">      <!--Preserve a field with generics in the signature-->      <field signature="System.Collections.Generic.List`1&lt;System.Int32&gt; FieldName" />      <field signature="System.Collections.Generic.List`1&lt;T&gt; FieldName" />      <!--Preserve a method with generics in the signature-->      <method signature="System.Void MethodName(System.Collections.Generic.List`1&lt;System.Int32&gt;)" />      <!--Preserve an event with generics in the signature-->      <event signature="System.EventHandler`1&lt;System.EventArgs&gt; EventName" />    </type>    <!--Preserve a nested type-->    <type fullname="AssemblyName.H/Nested" preserve="all"/>    <!--Preserve all fields of a type if the type is used.  If the type isn't used, it will be removed-->    <type fullname="AssemblyName.I" preserve="fields" required="0"/>    <!--Preserve all methods of a type if the type is used. If the type isn't used, it will be removed-->    <type fullname="AssemblyName.J" preserve="methods" required="0"/>    <!--Preserve all types in a namespace-->    <type fullname="AssemblyName.SomeNamespace*" />    <!--Preserve all types with a common prefix in their name-->    <type fullname="Prefix*" />

付加的な Assembly XML 属性

<assembly>

• ignoreIfMissing

  : すべてのプレイヤービルド中に存在しないアセンブリの保持を宣言する必要がある場合に、この属性を使用します。

<linker>  <assembly fullname="Foo" ignoreIfMissing="1">    <type name="TypeName"/>  </assembly></linker>

• ignoreIfUnreferenced:

  そのアセンブリが別のアセンブリによって参照されている場合にのみ、アセンブリのエンティティを保持したい場合があります。この属性を使用すると、アセンブリ内で少なくとも 1 つの型が参照されている場合のみ、アセンブリ内のエンティティを保持します。

<linker>  <assembly fullname="Bar" ignoreIfUnreferenced="1">    <type name="TypeName"/>  </assembly></linker>

• windowsruntime:

  Windows Runtime Metadata (.winmd) アセンブリの保持を定義する場合は、link.xml ファイルの

  <assembly>

  要素に

  windowsruntime

  属性を加える必要があります。

<linker>  <assembly fullname="Windows" windowsruntime="true">    <type name="TypeName"/> </assembly></linker>

依存関係アノテーション

• アノテーション属性: この属性は、Unity リンカーに特定のコードパターン (注釈された型から派生する型など) を保持するよう指示します。
• AlwaysLinkAssemblyAttribute: この属性を使用すると、プロジェクト内の他のアセンブリから参照されていない場合でもアセンブリを処理するよう Unity リンカーに指示できます。

アノテーションの属性

[Preserve]

• RequireImplementorsAttribute: このインターフェースを実装するすべての型を依存関係としてマークします。
• RequireDerivedAttribute: この型から派生するすべての型を依存関係としてマークします。
• RequiredInterfaceAttribute: 型のインターフェース実装を依存関係としてマークします。
• RequiredMemberAttribute: 型のすべてのメンバーを依存関係としてマークします。
• RequireAttributeUsagesAttribute: カスタム属性を依存関係としてマークします。

AlwaysLinkAssembly 属性

[assembly: UnityEngine.Scripting.AlwaysLinkAssembly]

[RuntimeInitializeOnLoadMethod]

[assembly: AlwaysLinkAssembly]

追加リソース

• Unity リンカー