Link XML フォーマットリファレンス
サポートされている XML 要素と属性、およびその使用例など、 link.xml ファイルの形式を理解します。
読み終わるまでの所要時間 14 分最終更新 6日前
このリファレンスでは、有効な XML 要素、属性、使用例など、ファイルの正しいフォーマットについて説明します。
link.xmlサポートされている XML 要素
link.xml ファイルでは、以下の XML 要素がサポートされています。
要素 | 説明 |
|---|---|
| 他のすべての要素を囲む最も外側の要素として、すべての |
| アセンブリに固有のコード保存アノテーションを宣言します。 |
| 型に固有のコード保存アノテーションを宣言します。 |
| フィールドに固有のコード保存アノテーションを宣言します。 |
| メソッドに固有のコード保存アノテーションを宣言します。 |
| プロパティに固有のコード保存アノテーションを宣言します。 |
| イベントに固有のコード保存アノテーションを宣言します。 |
例えば、これらすべての要素の使用例は、使用例を参照してください。
サポートされている XML 属性
属性 | 説明 |
|---|---|
| |
| 現在のビルドの設定に基づいてサポートされていない機能の保存を除外します。詳細と使用例については、特徴除外を参照してください。 |
| 親アアセンブリ名をプレフィックスとして含む名前でコード要素を識別します。 |
| |
| |
| プレフィックスとして親アアセンブリを使用せずに、名前のみでコード要素を識別します。アセンブリ名が親 XML 要素ですでに |
| ストリッピングから保持するコード要素のレベルを指定します。 |
| シグネチャでコード要素を識別します。メソッドシグネチャは、戻り値の型、名前、およびパラメータで構成されます。フィールド、プロパティ、またはイベント シグネチャは、タイプと名前で構成されます。例えば、使用例を参照してください。 |
| WIndows ランタイムメタデータ (.winmd) アセンブリの保存を定義するときは常に、 |
例えば、これらすべての属性の使用方法については、使用例を参照してください。
使用例
以下の例は、サポートされている 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<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.dllmscorlib.xmllink.xml高ストリッピング レベルでは、Unityリンカーは現在のビルドの設定に基づいて、サポートされていない機能の保存を除外します。
- — IL2CPP スクリプティングバックエンドをターゲットにする場合は除外されます。
remoting - — IL2CPP スクリプティングバックエンドをターゲットにする場合は除外されます。
sre - :COMをサポートしないプラットフォームをターゲットにする場合は除外されます。
com
例えば、以下のファイルは、COM をサポートするプラットフォームで 1 つの型のメソッドと、すべてのプラットフォームで 1 つのメソッドを保持します。
link.xml<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>