---
title: Link XML フォーマットリファレンス
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ja-jp/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/xml-formatting
latest_url: https://docs.unity.com/ja-jp/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/xml-formatting.md
generated_at: 2026-11-16T14:07:09.602Z
locale: ja-jp
---

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

> サポートされている XML 要素と属性、およびその使用例など、 link.xml ファイルの形式を理解します。

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

## サポートされている XML 要素##supported-xml-elements

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

| **要素**                  | **説明**                                                |
| ----------------------- | ----------------------------------------------------- |
| `<linker></linker>`     | 他のすべての要素を囲む最も外側の要素として、すべての`link.xml`ファイルで使用する必要があります。 |
| `<assembly></assembly>` | アセンブリに固有のコード保存アノテーションを宣言します。                          |
| `<type></type>`         | 型に固有のコード保存アノテーションを宣言します。                              |
| `<field></field>`       | フィールドに固有のコード保存アノテーションを宣言します。                          |
| `<method></method>`     | メソッドに固有のコード保存アノテーションを宣言します。                           |
| `<property></property>` | プロパティに固有のコード保存アノテーションを宣言します。                          |
| `<event></event>`       | イベントに固有のコード保存アノテーションを宣言します。                           |

例えば、これらすべての要素の使用例は、[使用例](#usage-examples)を参照してください。

## サポートされている XML 属性##supported-xml-attributes

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

例えば、これらすべての属性の使用方法については、[使用例](#usage-examples)を参照してください。

## 使用例##usage-examples

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

### アセンブリのルートタイプを宣言するさまざまな方法##different-ways-to-declare-the-root-types-of-an-assembly

以下の例は、`link.xml`ファイルを使用してプロジェクトのアセンブリのルート型を宣言するさまざまな方法を示しています。

```lang-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>
```

### アセンブリ全体をルートとして宣言##declare-entire-assemblies-as-roots

以下の例は、アセンブリ全体を宣言する方法を示しています。

```lang-xml
<!--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"/>
```

### ネスト型またはジェネリック型の保持##preserve-nested-or-generic-types

以下の例は、ネスト型またはジェネリック型を保持する方法を示しています。

```lang-xml
<!--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"/>
```

### 欠落しているアセンブリの無視##ignore-a-missing-assembly

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

```lang-xml
<linker>
  <assembly fullname="Foo" ignoreIfMissing="1">
    <type name="TypeName"/>
  </assembly>
</linker>
```

### 参照されていないアセンブリを無視する##ignore-an-unreferenced-assembly

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

```lang-xml
<linker>
  <assembly fullname="Bar" ignoreIfUnreferenced="1">
    <type name="TypeName"/>
  </assembly>
</linker>
```

### WIndows ランタイムメタデータアアセンブリ##windows-runtime-metadata-assembly

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

```lang-xml
<linker>
  <assembly fullname="Windows" windowsruntime="true">
    <type name="TypeName"/>
 </assembly>
</linker>
```

### 特徴除外##feature-exclusions

`mscorlib.dll` に埋め込まれた`mscorlib.xml` ファイルはこの属性を使用しますが、必要に応じて任意の`link.xml` ファイルで使用できます。

**高**[ストリッピング レベル](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/configure.md)では、Unityリンカーは現在のビルドの設定に基づいて、サポートされていない機能の保存を除外します。

1. `remoting` — IL2CPP スクリプティングバックエンドをターゲットにする場合は除外されます。
2. `sre` — IL2CPP スクリプティングバックエンドをターゲットにする場合は除外されます。
3. `com`：COMをサポートしないプラットフォームをターゲットにする場合は除外されます。

例えば、以下の`link.xml`ファイルは、COM をサポートするプラットフォームで 1 つの型のメソッドと、すべてのプラットフォームで 1 つのメソッドを保持します。

```lang-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>
```

## 追加リソース##additional-resources

* [マネージコードストリッピングと Unity リンカー](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/unity-linker.md)
* [マネージコードストリッピングの設定](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/configure.md)
* [注釈を使用したコード保持](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/preserving.md)
* [Unity リンカーマーキングルールリファレンス](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/marking-rules.md)
* [IUnityLinkerProcessor.GenerateAdditionalLinkXmlFile](/engine/6000.0/script-reference/unityeditor/build/iunitylinkerprocessor/generateadditionallinkxmlfile.md)
