ドキュメント

Unity Engine

Unity Engine

Link XML フォーマットリファレンス

サポートされている XML 要素と属性、およびその使用例など、 link.xml ファイルの形式を理解します。
読み終わるまでの所要時間 14 分最終更新 6日前

このリファレンスでは、有効な XML 要素、属性、使用例など、
link.xml
ファイルの正しいフォーマットについて説明します。

サポートされている XML 要素

link.xml ファイルでは、以下の XML 要素がサポートされています。

要素

説明

<linker></linker>
他のすべての要素を囲む最も外側の要素として、すべての
link.xml
ファイルで使用する必要があります。
<assembly></assembly>
アセンブリに固有のコード保存アノテーションを宣言します。
<type></type>
型に固有のコード保存アノテーションを宣言します。
<field></field>
フィールドに固有のコード保存アノテーションを宣言します。
<method></method>
メソッドに固有のコード保存アノテーションを宣言します。
<property></property>
プロパティに固有のコード保存アノテーションを宣言します。
<event></event>
イベントに固有のコード保存アノテーションを宣言します。
例えば、これらすべての要素の使用例は、使用例を参照してください。

サポートされている XML 属性

属性

説明

accessors
<property>
要素に適用して、保持するプロパティのアクセサーメソッドを指定します。
feature
現在のビルドの設定に基づいてサポートされていない機能の保存を除外します。詳細と使用例については、特徴除外を参照してください。
fullname
親アアセンブリ名をプレフィックスとして含む名前でコード要素を識別します。
fullname
は、
name
だけがあいまいである可能性がある場合に使用します。
ignoreIfMissing
<assembly>
要素に適用して、すべてのプレイヤービルド中に存在しないアセンブリの保存を宣言します。例えば、使用例は、「 Ignore a missing アセンブリ 」を参照してください。
ignoreIfUnreferenced
<assembly>
要素に適用し、少なくとも 1 つのメンバーが別のアセンブリによって参照されている場合にのみ、アセンブリ内の Entities を保持します。例えば、使用例は、「 Ignore an unreferenced assembly 」を参照してください。
name
プレフィックスとして親アアセンブリを使用せずに、名前のみでコード要素を識別します。アセンブリ名が親 XML 要素ですでに
fullname
付きで指定されている場合は、子 XML 要素は
name
だけでコード要素を識別できます。
preserve
ストリッピングから保持するコード要素のレベルを指定します。
signature
シグネチャでコード要素を識別します。メソッドシグネチャは、戻り値の型、名前、およびパラメータで構成されます。フィールド、プロパティ、またはイベント シグネチャは、タイプと名前で構成されます。例えば、使用例を参照してください。
windowsruntime
WIndows ランタイムメタデータ (.winmd) アセンブリの保存を定義するときは常に、
link.xml
ファイルの
<assembly>
要素に追加する必要があります。例えば、使用例は WIndows ランタイムメタデータアセンブリ を参照してください。
例えば、これらすべての属性の使用方法については、使用例を参照してください。

使用例

以下の例は、サポートされている XML 要素と属性の有効使用法を示しています。

アセンブリのルートタイプを宣言するさまざまな方法

以下の例は、
link.xml
ファイルを使用してプロジェクトのアセンブリのルート型を宣言するさまざまな方法を示しています。
<linker> <!--Preserve types and members in an assembly--> <assembly fullname="AssemblyName"> <!--Preserve an entire type--> <type fullname="AssemblyName.TypeName" preserve="all"/> <!--No "preserve" attribute and no members specified means preserve all members--> <type fullname="AssemblyName.TypeName"/> <!--Preserve all fields on a type--> <type fullname="AssemblyName.TypeName" preserve="fields"/> <!--Preserve all methods on a type--> <type fullname="AssemblyName.TypeName" preserve="methods"/> <!--Preserve the type only--> <type fullname="AssemblyName.TypeName" preserve="nothing"/> <!--Preserving only specific members of a type--> <type fullname="AssemblyName.TypeName"> <!--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--> <!--プロパティ、そのバッキングフィールド (存在する場合) を保持します。 取得メソッドと設定メソッド --> <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> <!--ルート用にアセンブリを強制的に処理しますが、特に何も明示的に保持しません。アセンブリが参照されていない場合に便利です。--> <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<System.Int32> FieldName" /> <field signature="System.Collections.Generic.List`1<T> FieldName" /> <!--Preserve a method with generics in the signature--> <method signature="System.Void MethodName(System.Collections.Generic.List`1<System.Int32>)" /> <!--Preserve an event with generics in the signature--> eventName </type> <!--Preserve a nested type--> <type fullname="AssemblyName.H/Nested" preserve="all"/> <!--タイプが使用されている場合は、タイプのすべてのフィールドを保持します。 タイプが使用されない場合は削除されます。--> <type fullname="AssemblyName.I" preserve="fields" required="0"/> <!--型が使用されている場合は、型のすべてのメソッドを保持します。タイプが使用されない場合は削除されます。--> <type fullname="AssemblyName.J" preserve="methods" required="0"/> <!--Preserve all types in a namespace--> <type fullname="AssemblyName.SomeNamespace*" preserve="all"/> <!--Preserve all types with a common prefix in their name--> <type fullname="Prefix*" preserve="all"/>

欠落しているアセンブリの無視

すべてのプレイヤービルド中に存在しないアセンブリの保持を宣言する必要がある場合は、
<assembly>
要素で
ignoreIfMissing
属性を使用します。
<linker> <assembly fullname="Foo" ignoreIfMissing="1"> <type name="TypeName"/> </assembly></linker>

参照されていないアセンブリを無視する

<assembly>
要素で
ignoreIfUnreferenced
属性を使用すると、少なくとも 1 つの型が別のアセンブリで参照されている場合にのみ、アセンブリ内の Entities を保持できます。
<linker> <assembly fullname="Bar" ignoreIfUnreferenced="1"> <type name="TypeName"/> </assembly></linker>

WIndows ランタイムメタデータアアセンブリ

WIndows ランタイムメタデータ (.winmd) アセンブリの保存を定義するときは、必ず
<assembly>
要素に
windowsruntime
属性を使用する必要があります。
<linker> <assembly fullname="Windows" windowsruntime="true"> <type name="TypeName"/> </assembly></linker>

特徴除外

mscorlib.dll
に埋め込まれた
mscorlib.xml
ファイルはこの属性を使用しますが、必要に応じて任意の
link.xml
ファイルで使用できます。
高ストリッピング レベルでは、Unityリンカーは現在のビルドの設定に基づいて、サポートされていない機能の保存を除外します。
  1. remoting
    — IL2CPP スクリプティングバックエンドをターゲットにする場合は除外されます。
  2. sre
    — IL2CPP スクリプティングバックエンドをターゲットにする場合は除外されます。
  3. com
    :COMをサポートしないプラットフォームをターゲットにする場合は除外されます。
例えば、以下の
link.xml
ファイルは、COM をサポートするプラットフォームで 1 つの型のメソッドと、すべてのプラットフォームで 1 つのメソッドを保持します。
<linker> <assembly fullname="Foo"> <type fullname="Type1"> <!--Preserve FeatureOne on platforms that support COM--> <method signature="System.Void FeatureOne()" feature="com"/> <!--Preserve FeatureTwo on all platforms--> <method signature="System.Void FeatureTwo()"/> </type> </assembly></linker>

追加リソース