Assembly Definition (アセンブリ定義) アセットをクリックして、 Inspector ウィンドウで アセンブリのプロパティを設定します。
Assembly Definition プロパティは以下のセクションに分かれています。
プロパティ | 説明 |
---|---|
名前 | アセンブリの名前 (ファイル拡張子なし)。アセンブリの名前は、プロジェクト全体で一意でなければなりません。特に複数のプロジェクトでアセンブリを使用する場合は、名前の競合の可能性を減らすために、逆引き DNS 命名スタイルを使用することを検討してください。 ノート: Unity は、Assembly Definition アセットに割り当てた名前を Name フィールドのデフォルト値として使用しますが、必要に応じて名前を変更できます。ただし、GUID ではなく名前でAssembly Definition を参照する場合、名前を変更すると参照が壊れます。 |
Allow ‘unsafe’ code | アセンブリ内のスクリプトで C# の ‘unsafe’ キーワードを使用している場合は、Allow ‘unsafe’ Code オプションを有効にします。この設定を有効にすると、Unity はアセンブリをコンパイルする際に C# コンパイラーに /unsafe オプションを渡します。 |
Auto Referenced | 定義済みのアセンブリが、このプロジェクトのアセンブリを参照するかどうかを指定します。Auto Reference オプションを無効にすると、Unity はコンパイル時にアセンブリを自動的には参照しません。これは、ビルドに含まれるかどうかには影響しません。 |
No Engine References | これを有効にすると、Unity はアセンブリをコンパイルする際に、UnityEditor や UnityEngine への参照を加えません。 |
Override References | これを有効にすると、このアセンブリが依存するプリコンパイルされたアセンブリを手動で指定できます。Override References を有効にすると、Inspector に Assembly References セクションが表示され、ここで参照を指定できます。 プリコンパイルされたアセンブリは、Unity プロジェクトの外でコンパイルされたライブラリです。デフォルトでは、プロジェクトで定義したアセンブリは、プロジェクトに追加したすべてのプリコンパイルされたアセンブリを参照します。これは、定義済みのアセンブリがすべてのプリコンパイルされたアセンブリを参照するのと同じです。Override References を有効にすると、このアセンブリは Assembly References で加えたプリコンパイルされたアセンブリのみを参照します。ノート: プロジェクトのアセンブリが自動的にプリコンパイルされたアセンブリを参照するのを避けるには、そのアセンブリの Auto Referenced オプションを無効にします。詳細は、Plugin Inspector を参照してください。 |
Root Namespace | このアセンブリ定義のスクリプトのデフォルトの名前空間です。Rider または Visual Studio をコードエディターとして使用している場合、このアセンブリ定義で作成する新しいスクリプトにはすべて、この名前空間が加えられます。 |
Assembly Definition アセットの作成 を参照してください。
Unity がアセンブリをコンパイルまたは参照するために定義しなければならないコンパイラーの #define ディレクティブを指定します。
Unity は、Define Constraints (制約定義) が すべて 満たされている場合にのみ、Project アセンブリをコンパイルし参照します。Constraint (制約) は C# の #if プリプロセッサーディレクティブのように動作しますが、スクリプトレベルではなくアセンブリレベルで動作します。制約を満たすためには、 Define Constraints 設定ですべてのシンボルを定義する必要があります。
シンボルが未定義であることを指定するには、そのシンボルの前に否定の ! (エクスクラメーション) 記号を付けます。例えば、以下のようなシンボルを Define Constraints に指定した場合です。
!ENABLE_IL2CPP
UNITY_2018_3_OR_NEWER
この制約は、シンボル ENABLE_IL2CPP が定義されておらず、シンボル UNITY_2018_3_OR_NEWER が定義されている場合に満たされます。つまり、Unity は、Unity 2018.3 以降の IL2CPP 以外のスクリプティングランタイムでのみ、このアセンブリをコンパイルして参照します。
||
(OR) 演算子を使って、制約が満たされるためには少なくとも 1 つの制約が存在しなければならないことを指定できます。例えば、以下のようになります。
UNITY_IOS || UNITY_EDITOR_OSX
UNITY_2019_3_OR_NEWER
!UNITY_ANDROID
UNITY_IOS か UNITY_EDITOR_OSX のいずれかと、UNITY_2019_3_OR_NEWER が定義され、UNITY_ANDROID が定義されていない場合に制約条件が満たされます。それぞれの行は、その中の制約条件の間で論理的な AND を実行することに類似しています。上の例は以下に相当します。
(UNITY_IOS OR UNITY_EDITOR_OSX) AND (UNITY_2019_3_OR_NEWER) AND (NOT UNITY_ANDROID)
Unity のビルトインの #define ディレクティブ、グローバルコンパイラーレスポンス (.rsp) ファイルで定義されているシンボル、プロジェクトの Scripting Define Symbols Player 設定で定義されているシンボルのいずれかを使用できます。ビルトインのシンボルのリストなど、詳細は プラットフォーム依存のコンパイル を参照してください。
ノート: Scripting Define Symbols の設定は、プラットフォーム固有のものです。この設定を使用して、Unity がアセンブリを使用するかどうかを定義する場合は、関連するすべてのプラットフォームで必要なシンボルを定義するようにしてください。
条件付きでアセンブリを加える を参照してください。
Unity は、各制約に、現在定義されている設定に基づくインジケータを付けています。例えば、次の 2 つの制約は、1 つのシンボルは現在定義されているが、もう 1 つは定義されていないことを示しています。全体の制約が満たされるためには、個々の制約が true である必要があるので、Define Constraints ボックスも無効または互換性がないとマークされます。
この例の制約を満たすために、Scripting Backend を IL2CPP に変更することができます (Player Settings で)。ただし、多くの場合、重要なのはプロジェクトをビルドするときに制約がどのように評価されるかであり、Unity エディターで制約がどのように表示されるかではありません。例えば、IL2CPP バックエンドを使用するビルドにのみ加え、Mono バックエンドを使用する他のビルドには加えたくないアセンブリがあるかもしれません。
プロパティ | 説明 |
---|---|
Assembly Definition References | Assembly Definition アセットを使って作成した他のアセンブリへの参照を指定します。Unity はこれらの参照を使用してアセンブリをコンパイルし、アセンブリ間の依存関係も定義します。 |
Use GUIDs | この設定は、Unity が他の Assembly Definition アセットへの参照をどのようにシリアル化するかを制御します。このプロパティを有効にすると、Unity は参照を Assembly Definition 名ではなく、アセットの GUID として保存します。名前ではなく GUID を使用することは、Assembly Definition アセットの名前を変更しても、それを参照する他の Assembly Definition ファイルを更新する必要がないという意味で効率的です。 |
Assembly Definition アセットの作成 を参照してください。
Assembly References セクションは、 Override References プロパティ (General セクション内) を有効にした場合にのみ表示されます。このエリアでは、このアセンブリが依存しているプリコンパイルされたアセンブリへの参照すべてを指定できます。
プリコンパイルされたプラグインのアセンブリを参照 を参照してください。
アセンブリのプラットフォーム互換性を設定します。Unity は、含まれる (または除外されない) プラットフォーム上でのみ、このアセンブリをコンパイルまたは参照します。
プラットフォーム固有のアセンブリの作成 を参照してください。
Specify which symbols to define according to the current version of Unity or versions of the packages and modules in a project.
プロパティ | 説明 |
---|---|
Resource | “Unity” or a package or module |
Define | The symbol to define when the Expression field evaluates to true for the item specified in the Resource field. |
式 | バージョンまたはバージョンの範囲を定義する式。[バージョン定義式] を参照してください。 |
Expression outcome | The Expression evaluated as a logical statement, where “x” is the version checked. If the Expression outcome says, Invalid, then the Expression is malformed. |
See Defining symbols based on Unity and project package versions.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.