メインコンテンツまでスキップ

ADT既知の問題

Last updated on November 9, 2026

注釈:本資料はAI技術を用いて翻訳されています。

以下は、ADTの既知または一般的な問題のリストです。この一覧は積極的に維持されており、各問題が解決されるたびに更新されます。

[Smart Build] 他のSmart Buildアクティビティが実行されていない場合でも、トラックが「In queue」ステータスのままになる​

ADT Distribution ラベル — Smart Buildキュー状態ADT Hub ラベル — Smart Buildキュー状態

特定のエラー条件下では、Smart Builds CLIが適切に終了しない場合があります。これにより、ユーザーが別のスマートビルドをダウンロードする際に「In queue」ブロッカーに遭遇する可能性があります。

回避策: ADT Hubを再起動して、CLIをオフにしてから再度オンにします。

173文字制限を超えるパスでクラッシュビデオ生成が失敗する​

ADT Health ラベル — クラッシュビデオ生成ADT SDK ラベル — クラッシュビデオ生成

Microsoft Windowsには、260文字(MAX_PATH)というよく知られたファイルパス長の制限があります。場合によっては、ファイルパスが約173文字を超えると、特定の操作が失敗し始めることがあります。ADT SDKがUnrealゲームプロジェクトのPluginsフォルダ内にインストールされている場合、完全なファイルパスが過度に長くなる可能性があります。特に次の場合:

  • ゲームプロジェクトに深いディレクトリ構造がある、または

  • プロジェクトフォルダまたは親フォルダが長いディレクトリ名を使用している。

これにより、ADTアプリケーションが必要なファイルにアクセスできなくなり、クラッシュビデオ生成の失敗やその他の予期しない動作などの問題が発生する可能性があります。

回避策: この制限に達しないようにするには:

  • ゲームプロジェクトを浅いディレクトリに配置します(例:C:\Users\Username\Documents\Unity\LongFolderName\AnotherLongFolderName\MyGameではなくC:\Projects\MyGame)。

  • 可能な限り短いフォルダ名とファイル名を使用します。

プロジェクトを多くのレベルのサブディレクトリの下にネストすることは避けてください。

長いインストールパス(文字制限超過)でIssue Reporterが空白の画像を表示する​

ADT Health ラベル — Issue Reporterの空白画像ADT SDK ラベル — Issue Reporterの空白画像

Microsoft Windowsには、260文字(MAX_PATH)というよく知られたファイルパス長の制限があります。場合によっては、ファイルパスが約173文字を超えると、特定の操作が失敗し始めることがあります。ADT SDKがUnrealゲームプロジェクトのPluginsフォルダ内にインストールされている場合、完全なファイルパスが過度に長くなる可能性があります。特に次の場合:

  • ゲームプロジェクトに深いディレクトリ構造がある、または

  • プロジェクトフォルダまたは親フォルダが長いディレクトリ名を使用している。

これにより、ADTアプリケーションが必要なファイルにアクセスできなくなり、クラッシュビデオ生成の失敗やその他の予期しない動作などの問題が発生する可能性があります。

回避策: この制限に達しないようにするには:

  • ゲームプロジェクトを浅いディレクトリに配置します(例:C:\Users\Username\Documents\Unity\LongFolderName\AnotherLongFolderName\MyGameではなくC:\Projects\MyGame)。

  • 可能な限り短いフォルダ名とファイル名を使用します。

プロジェクトを多くのレベルのサブディレクトリの下にネストすることは避けてください。

クラッシュファイルがまだ処理中の場合、playtestの完了時のクラッシュがレポートから欠落する​

ADT Playtest ラベル — playtestクラッシュレポートADT Hub ラベル — playtestクラッシュレポート

playtestの完了時に発生したクラッシュは、対応するクラッシュファイルがバックエンド(BE)によって処理されている場合、レポートに反映されません。

解決策を積極的に調査していますが、回避策はまだ決定されていません。

Hubの更新に失敗すると、以前のデータが削除され、ダウンロードボタンが表示される​

ADT Hub ラベル — Hub更新失敗

ADT Hubが更新のダウンロードに失敗すると、トラックにダウンロードボタンが表示され、ダウンロードが失敗したことを示し、以前のダウンロードのデータもアンインストールされます。

回避策: ダウンロードボタンを再度クリックすると、ADT Hubはキャンセル後に停止した場所からダウンロードを自動的に再開します。

[macOS] AI Assistantが自動MCPサーバー接続をガイドできない​

ADT Hub ラベル — macOSのAI Assistant

macOSでは、ADT HubのAI Assistantはまだ自動MCPサーバー接続の手順をユーザーにガイドできません。

回避策: MCPサーバーを手動で接続してください。macOSでのガイド付き自動接続のサポートは、今後のリリースで予定されています。

Promote Build to Steam: 「Set Live on Default Branch」はまだ利用できない​

ADT Distribution ラベル — Promote Build to SteamADT Hub ラベル — Promote Build to Steam

Promote Build to SteamのこのAlphaリリースでは、ADT Hubから「Set Live on Default Branch」を実行することはできません。

回避策: Steam Mobile Appを使用して、ビルドを手動で承認しLiveに設定してください。ADT Hubから直接デフォルトブランチでビルドをLiveに設定する機能のサポートは、今後のリリースで予定されています。