ドキュメント

Unity Engine

Unity Engine

アセンブリを条件付きで含める

スクリプトシンボルを使用して、アセンブリを条件付きでコンパイルに含める/除外します。
読み終わるまでの所要時間 10 分最終更新 6日前

プリプロセッサーシンボルを使用して、アセンブリをコンパイルし、アプリケーションのビルド (エディタの再生モードを含む) に含めるかどうかをコントロールできます。アセンブリ定義オプションの Define Constraints リストを使用して、使用するアセンブリに定義する必要があるシンボルを指定できます。
  1. アセンブリのプロパティを表示するには、アセンブリのアセンブリ定義を選択します。
    Inspector

    ?

  2. 「Define Constraints(制約の定義)」セクションで、「**+」**ボタンをクリックして、制約リストに新しいシンボルを追加します。
  3. シンボル名を入力します。
  4. Apply (適用) をクリックします。
制約の定義に使用できるスクリプトシンボルの詳細は、制約の定義 を参照してください。

Unity とプロジェクトパッケージのバージョンに基づくシンボルの定義

プロジェクトが特定のバージョンの Unity またはパッケージのどちらを使用しているかに応じて、アセンブリ内の異なるコードをコンパイルする必要がある場合は、バージョン定義リストにエントリーを追加できます。このリストでは、シンボルを定義するタイミングのルールを指定します。バージョン番号には、特定のバージョンまたはバージョン範囲を評価する論理式を指定できます。
シンボルを条件付きで定義するには、以下を行います。
  1. アセンブリのプロパティを Inspector で表示するには、アセンブリのアセンブリ定義アセットを選択します。
  2. Version Defines セクションで、+ ボタンをクリックしてリストにエントリーを追加します。
  3. プロパティを設定します。
    • If リソース:Unity、またはこのシンボルを定義するためにインストールする必要があるパッケージまたはモジュールを選択します。
    • version is:特定のバージョンまたはバージョン範囲を評価する式。構文ルールについては、「 バージョン定義式 」を参照してください。
    • set define:バージョン条件が満たされたときに定義するスクリプトシンボル。
    Version 式の結果には、式が評価されるバージョンが表示されます。結果が Invalid と表示される場合は、式の構文が正しくありません。
  4. Apply (適用) をクリックします。
アセンブリ定義で定義されたシンボルは、その定義用に作成されたアセンブリ内のスクリプトにのみ適用されます。
注
Version Defines リストを使用して定義されたシンボルは、Define Constraints として使用できます。つまり、特定のパッケージの特定のバージョンもプロジェクトにインストールされている場合にのみアセンブリを使用するように指定できます。

バージョン定義式

式を使用して、正確なバージョンまたはバージョン範囲を指定できます。
バージョン式は数学的な間隔表記を使用します。角かっこ
[]
は、範囲にエンドポイントが含まれることを表し、角かっこ
()
は、範囲にエンドポイントが含まれないことを表します。
以下の表は構文を示しています。

式

評価先

[1.3,3.4.1]
1.3.0 <= x <= 3.4.1
(1.3.0,3.4)
1.3.0 < x < 3.4.0
[1.1,3.4)
1.1.0 <= x < 3.4.0
(0.2.4,5.6.2-preview.2]
0.2.4 < x <= 5.6.2.-preview.2
[2.4.5]
x = 2.4.5
2.1.0-preview.7
x >= 2.1.0-preview.7
注
式にスペースは使用できません。ワイルドカード文字はサポートされません。

Unity バージョン管理スキーム

Unity の現在のバージョン (およびアセンブリ定義をサポートするすべてのバージョン) では、
MAJOR.MINOR.REVISION
、例えば
6000.0.33f1
の 3 つの部分を持つバージョン指定子が使用されます。
  • MAJOR
    バージョンは、Unity
    2022.x.z
    以前のリリース年、または Unity 6(
    6000.x.z
    )以降のメジャー テクニカル バージョンを表す 4 桁の数字です。
  • MINOR
    バージョンは、ターゲットのリリース四半期(
    1
    、
    2
    、
    3
    、
    4
    など)です。
  • REVISION
    指定子は、それ自体に 3 つの部分があり、形式は
    RRzNN
    です。
    • RR
      は 1 桁または 2 桁のリビジョン番号です。
    • z
      はリリース タイプを示す文字です。
      • a
        = アルファ リリース
      • b
        = ベータリリース
      • f
        = 法線のパブリックリリース
      • c
        = 中国リリースバージョン (f に相当)
      • p
        = パッチリリース
      • x
        = 実験的リリース
    • NN
      は 1 桁または 2 桁の増分の数字です。
リリースタイプ指定子は次のように比較されます。
a < b < f = c < p < x
アルファ リリースはベータよりも前と見なされます。ベータは、法線 (
f
) または中国 (
c
) リリースよりも前です。リリース、同じリビジョン番号を持つ法線のリリースまたは中国のリリースよりも後であり、実験的的リリースは他のリリーススタイプよりも後です。実験的リリースでは、終了時の増分の番号は使用されないことに注意してください。
以下の式の例では、6000.0 または 6000.1 バージョンの Unity が含まれていますが、6000.2 以降のバージョンは含まれていません。
"25270591"

パッケージおよびモジュールのバージョン番号

パッケージとモジュールのバージョン指定子は、セマンティックバージョニング形式
MAJOR.MINOR.PATCH-LABEL
に従って 4 つの部分に分かれています。最初の 3 つの部分は常に数字ですが、ラベルは文字列です。プレビュー中の Unity パッケージは、文字列
preview
または
preview.n
を使用します。ここで、 は
n > 0
です。
以下の式の例では、3.2 から 6.1 までの
MAJOR.MINOR
バージョンを持つパッケージのすべてのバージョンが含まれています。
"25270591"

追加リソース