忍者ブログ

非現実的な話

ゲーム、UnrealEngine4などの話題を取り扱います。取り扱う内容は個人の範囲で調べたものなのでご利用は自己責任でお願いします。

【UE4】ExitCodeについて

×

[PR]上記の広告は3ヶ月以上新規記事投稿のないブログに表示されています。新しい記事を書く事で広告が消えます。

コメント

ただいまコメントを受けつけておりません。

【UE4】ExitCodeについて

突然ですが

「なんかよくわからんけどパッケージに失敗する」
「ビルドが通らなくなった、この前までは出来てたのに」
こんなことありますよね?(つい最近嵌ったばかり)

UnrealEngineの場合、Engineプログラム、UBTなど自作プログラム以外の要因も作用し、結果として「パッケージに失敗する」「ビルドが通らない」ことが起きます。Engineプログラムは膨大な量のコードであるため追うのも大変な作業ですし、「パッケージに失敗する」なんて時は大抵開発の終盤など余裕がない状態ということもあり、一刻も早く解決したい心情にあります。

果たして原因は?

AnsewerHUBを探ってみると、上記の様なエラーが発生した場合、Epicのスタッフさんは以下のログファイルを要求されます。つまり、以下のファイルの中に原因を突き止める手がかりがありそうです。

・cook.txt    :Cookログ
・dxdiag.txt   :システム構成ログ?
・UAT_Logs.txt  :UnrealAutomationToolログ

ほいでさらに調べてみると(中略)、UAT_Logs.txtに「ExitCode」というワードが見られます。終了コードってことは、異常な終了要因を調べる上での手がかりではないでしょうかね。
ということでさらに掘り下げてみます。



ExitCode一覧

 こちらの内容は.csファイルに定義されていますが、明確な対処方法についてまでは明記されていません。なのでAHとソース逆引きでちょっと一覧にしてみました。終了要因について結構な数がありますが未使用のものもあります。ですが、Ver4.8.1→4.9.1の時点で内容が少し更新されていたので、これからより強化されるかと思います。
Code 概要 詳細 要因、対処方法?
-1 UATが見つからない 何らかの要因でUATが見つからない アンチウイルスソフトを切るなど
UBTでプロジェクト再構築
0 成功 正常終了時
1 不明なエラー 他の終了コードに該当しない時 ※1
2 引数エラー コンフィグ、ゲーム名異常
コードエラーなど
nativeコード内の引数に異常があるため再ビルドによるエラー確認
plugin、sdkなどのエラーも含む
3 不明なコマンドエラー Cook、Compile、Deploy関連の登録外コマンド実行時 アセットファイルが破損している可能性があるため、破損ファイルの修復
10 SDKが見つからない レジストリからMobileDeviceDLL、iTunesMobileDeviceDLLが見つからない時
iTunes未インストール時
iTunesのインストールなど
11 プロビジョニングファイルが見つからない プロビジョニングファイルの読み込みエラー時
プロビジョニングファイル名異常時
プロビジョニングファイルのバイナリファイルが破損している可能性があるためリビルド?
12 証明書が見つからない プロビジョニングファイルはあるが証明書異常
13 プロビジョニングファイル、証明書が見つからない プロビジョニングファイル、証明書の両方に異常
14 プロパティリストが見つからない .plistファイル名異常
15 プロパティリストのキーが見つからない プロパティリストのキー文字列異常時
16 プロビジョニングファイルの期限切れ エラー出力なし
17 証明書の期限切れ エラー出力なし
18 プロビジョニングファイルと証明書の認証エラー エラー出力なし
19 コードのサポート対象外エラー エラー出力なし
20 プラグインサポート対象外エラー エラー出力なし
25 不明なクック失敗 Cookエラー ファイルサイズ(2GB)オーバー
アセットファイルの破損
アセットファイルのパス内に特殊文字を含むなど
windowsのユーザ名などに特殊文字を含む場合もエラーとなる
アセットの絶対パスが255文字を超える
Nativeコードのビルドエラーなど
26 不明なデプロイ失敗 エラー出力なし
27 不明なビルド失敗 エラー出力なし
28 不明なパッケージ失敗 エラー出力なし
29 不明なランチ失敗 エラー出力なし
30 ステージファイルの紛失 ステージファイルが無い
31 IPAファイル生成失敗 IPAファイル名異常
32 CodeSign失敗
33 デバイスのバックアップ失敗
34 アプリケーションアンインストール失敗
35 アプリケーションインストール失敗
36 アプリケーションが見つからない 上記34,35に該当しないエラー
37 スタブのサイン失敗 スタブが正しく証明されていない
38 プロパティリストからIPAが見つからない IPAから.plistファイルが見つからない
39 ファイル削除エラー ファイルのDelete失敗
ファイル操作系全般
Deleteの例外
例外はMSDN参照
40 ディレクトリ削除エラー ディレクトリのDelete失敗
ファイル操作系全般
Deleteの例外
例外はMSDN参照
41 ディレクトリ生成エラー ディレクトリのCreate失敗
ファイル操作系全般
CreateDelectoryに失敗
例外はMSDN参照
42 ファイルコピーエラー ファイルのCopy失敗
ファイル操作系全般
サニティーチェック異常、コピー元とコピー先でファイル名に相違がある場合
50 Obbファイルサポートエラー エラー出力なし Androidのパッケージは単一の.obb、.pakファイルのみサポートしている
51 パッケージ情報取得失敗 .apkファイルからパッケージ情報の取得に失敗 PKG名、PKGVer名異常、またはPKGVerの名前長異常を修正
52 コンフィグターゲットサポートエラー 複数プラットフォームを指定したターゲット構成でのパッケージ実行時 単一のターゲット構成しかパッケージ不可だが通常単一ターゲットしか選択できない
53 Obbファイルが見つからない .obb、.pakファイルが見つからない場合
54 AndroidBuildToolのパスエラー AndroidBuildToolsが見つかりませんでした。
55 APKの構築エラー アーキテクチャに適したAPKが見つからない
56 ファイルのインストール失敗 デバイスのファイルの展開に失敗 使用中のデバイスが接続されているか確認
57 リモート証明書が見つからない 実行ファイルの署名に失敗 開発者証明書がリモートMac上のシステムキーチェーンにインストールされていることを確認
100 ランチャーエラー エラー出力なし
101 UATのランチ失敗 エラー出力なし
102 ステージディレクトリの削除失敗 別プロセスでステージングディレクトリを使用している可能性あり
103 実行不能 実行ファイル、binaryファイルに異常がある場合
UE4Gameのbinaryファイルがない場合
IDEでUE4プロジェクトをビルド
UBTで再ビルド
150 Development用にデバイスが設定できていない Xcodeのデバイスウィンドウ上でDevelopmentが有効になっていることを確認
151 SDKより新しいOSデバイスが使用されている デバイス上のOSよりも新しいSDKのインストールを確認


空白のセルが多くない?

脳内補間で補いましょう。
断じて途中で飽きた訳ではない。断じて。



コード1:不明なエラーについて

もちろん、予期せぬエラーも発生することがあり、稀にこのエラーが見られます。
AHの逆引きより、容易な修正で済みそうな箇所を抜粋。

【※1:不明なエラーの一例】
・Android APIの不足
・Android NDKの指定(環境変数)誤り
・AutomationToolのフォルダが読み取り専用になっている



その他で何か打つ手はないか・・・

AnswerHUBにログと状況を纏めて送るのがやはり一番正確かと思いますが、
とりあえず困った時に私は以下の内容について一通り確認しています。
意外と単純な見落としであるケースもたまにあるので、確認すべき事項を予めリストアップしておくと良いかもしれません。後任の人とかのためにも。

【その他の確認】
・PCのスペック(グラフィックボードのスペック等)が足りているか
・異なるバージョンでの動作するか確認
・Intermediate、Savedフォルダの削除後にソリューションからリビルド
・VisualStudioのビルド構成が正しいか確認
・独自で追加したPluginを外してみる
・最低限必要なPluginが有効となっているか確認


まとめ

表とか作ったけど、中途半端になってしまった...
しかし、また嵌るかもしれないので忘備録ってことで。
個人的にはErrorCode=25が一番起きやすい印象、アセット関連とか。
こちらの内容はVer4.9.1のbranchで調べた内容・・・だったと思います。
AnswerHUBなど過去の情報も参考にしているので、修正されたり更新されているかもしれませんので、あくまで「こんなこともあるんだ」程度に留めておくのが良いかもです。

コメント

プロフィール

UnrealEngine4について調べる。
ゲームはそんなに得意ではない。

ブログ内検索

カレンダー

11 2017/12 01
S M T W T F S
1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30
31

リンク

  • [PR]
    PR