Clang サニタイザー

Unreal Build Tool (UBT) では、Linux および Android 用の Clang の サニタイザー をサポートしています。このページでは、サポートされているサニタイザーと、ビルドでのサニタイザーの使用方法について説明します。

概要

通常コンパイル時には検出されない多くのタイプのプログラミング エラーがあります。これは、コンパイラがそういったエラーを C++ 構文の有効な使用方法として認識するためです。構文が正しい場合でも、ロジックに不備があると、次をはじめとする望ましくない動作につながることがあります。

• メモリリーク

• 競合状態

• 初期化されていないメモリ

• 配列での範囲外アクセス

• 整数オーバーフロー

通常、これらはランタイム時に試行錯誤によるデバッグを行うことでしか診断することができません。Clang のサニタイザーを有効にしてアプリケーションをビルドすると、これらのエラーを直接報告するログ出力によって、より迅速に検出することができます。

サニタイザーを使用してビルド ツールを実行する

ビルドにサニタイザーを備えるには、目的のサニタイザーの UBT 引数を指定して UnrealBuildTool を実行します。これにより、最終的な実行可能ファイルに目的のサニタイザーがリンクされます。たとえば、次のコマンド ラインでは、アドレス サニタイザー (ASan) をビルドにリンクさせてプロジェクトをビルドします。

Build\BatchFiles\Build.bat MyGame Linux Development -WaitMutex -FromMsBuild -EnableASan

アプリケーションを実行すると、サニタイザーによるエラー検出出力がログに記録されます。これらのビルドは、コマンド ラインから直接実行することができます。または、Visual Studio でプロジェクトの [Properties (プロパティ)] を開いてから、[NMake] > [Build Command Line (ビルド コマンド ライン)] にサニタイザーのコマンドを追加することもできます。

サポートされているサニタイザー

UBT では、以下のサニタイザーをサポートしています。