Unity での条件付きコンパイル
Unity スクリプトで条件付きコンパイルを使用する方法とタイミングの概要。
読み終わるまでの所要時間 7 分最終更新 5日前
Unity の C# 言語のサポートには、ディレクティブの使用が含まれています。ディレクティブを使用すると、特定のスクリプトシンボルが定義されているかどうかに基づいて、コンパイルにコードを選択的に含めたり除外したりできます。C# でのこれらのディレクティブの動作の詳細は、C# プリプロセッサーディレクティブに関する Microsoft のドキュメントを参照してください。
Unity には、スクリプトで使用できる定義済みのシンボル範囲があり、コードの一部をコンパイルに選択的に含めたり除外したりできます。例えば、Windows スタンドアロンプラットフォームのプロジェクトビルドで定義されるシンボルは です。このシンボルが定義されているかどうかは、特殊なタイプのステートメントを使用して確認できます。
UNITY_STANDALONE_WINif#if UNITY_STANDALONE_WIN Debug.Log("Standalone Windows");#endif
#if#endif##elif#else#if UNITY_EDITOR Debug.Log("Unity Editor");#elif UNITY_IOS Debug.Log("Unity iOS");#else Debug.Log("Any other platform");#endif
定義済みのシンボルがいくつかあり、選択したプラットフォーム、エディタバージョン、およびその他のシステム環境シナリオに基づいて、コードを選択的にコンパイルまたは省略できます。Unity の定義済みシンボルの完全なリストについては、Unity スクリプトシンボルリファレンスを参照してください。
エディター、スクリプト、またはアセットファイルを使用して、独自のスクリプトシンボルを定義することもできます。詳細については、カスタムスクリプトシンボル を参照してください。
ディレクティブの代替手段
プリプロセッサー指令は、必ずしもコードを条件付きで含めたり除外したりするための最も適切で信頼性の高い方法ではありません。代替アプローチはここにリストされています。
attributeConditional`
C# の 属性は、関数をよりクリーンに、エラーが発生しにくい方法でストリッピングできます。詳細は、ConditionalAttribute クラス を参照してください。、、、、 などの一般的な Unity コールバックは、エンジンから直接呼び出されるためこの属性の影響を受けません。また、パフォーマンス上の理由から、これらのコールバックはアカウントに含まれません。
ConditionalStart()Update()LateUpdate()FixedUpdate()Awake()アセンブリ定義制約
高レベルの条件付きコンパイルに推奨されるアプローチは、関連するアセンブリ定義ファイルを持つアセンブリにスクリプトを整理することです。条件付きで追加または除外するコードがアセンブリ内にある場合は、アセンブリ定義で制約の定義を設定して、例えば、特定のバージョンのパッケージがプロジェクトに存在する場合にのみコードをコンパイルできます。
条件付き実行
条件付きコンパイルの代わりに、標準文を使用してコンパイル済みコードの条件付き実行を強制できます。例えば、Unity の スクリプトシンボルは、64 ビットアーキテクチャでは信頼性の低いテストであるため、代わりに以下の手順を実行します。
ifUNITY_64if (IntPtr.Size == 4){ // 32 bit code}else{ // 64-bit code}