トラブルシューティング

このセクションでは、以下の問題に関する情報を提供します。

• Package Manager ウィンドウのエラーメッセージ
• Package Manager が見つからない、またはウィンドウが開かない
• Unity を新しいバージョンにアップグレードした後に問題が発生する
• パッケージのインストールが失敗する
• 認識されないパッケージ
• Windows 上の hostfxr.dll の読み込みエラー
• プロジェクトのパッケージ設定のリセット
• Git URL の認証の問題

ネットワーク関連の問題が発生する場合は、Unity Package Manager Diagnostics (診断) ツールを実行することもできます。詳細は、 ネットワークの問題を参照してください。

Package Manager ウィンドウのエラーメッセージ

Package Manager は、問題が発生すると Package Manager ウィンドウにエラーインジケーターを表示します。

• System-wide issues (システム全体の問題)

Error messages that appear in the status bar indicate the Package Manager has detected an issue that is not related to a specific package. For example, if the Package Manager , it displays this message in the status bar:

ネットワークがパッケージレジストリサーバーにアクセスできない場合、おそらくネットワークとの接続に問題があるためです。ユーザーまたはシステム管理者が ネットワークエラーを修正 すると、ステータスバーがクリアされます。

• Package-specific issues (パッケージ特有の問題)

If a specific package has a problem when loading or installing (for example, when determining which package versions to load), the error icon () appears in the package list next to the compromised package (A). To find out what the problem is, open the compromised package’s details view to see the detailed error message (B):

Package Manager が見つからない、またはウィンドウが開かない

package.manifest ファイルの形式が正しくない場合、Unity コンソールに次のようなエラーが表示されます。

Failed to resolve packages: The file [<project-path>/Packages/manifest.json] is not valid JSON:
  Unexpected token '}' at 44:1
  }

エラーメッセージに含まれる情報を使用して、JSON を修正できます。問題を修正するために使用できるオンライン検証ツールがいくつかあります。修正したファイルを保存すると、Unity は Package Manager ウィンドウを再ロードします。

As of 2019.3, your package.manifest file should not contain any references to the com.unity.package-manager-ui package. You can either reset your Project’s package configuration or remove the following line from the manifest’s dependencies list:

    "com.unity.package-manager-ui": "2.1.1",

Package Manager ウィンドウがまだ表示されない場合は、Unity を再起動してください。

それでも問題が解決しない場合は、Project マニフェストがパッケージバージョンとして “exclude” を使用していないかを確認してください。これは、依存関係 属性にとって非推奨の値です。このような行が見つかった場合は、行全体を削除してください。Package Manager は、プロジェクトに依存関係として明示的に含まれるパッケージのみをインストールするため、その登録を削除すると、Package Manager はパッケージを無視し、インストールしません。

それでも Package Manager の読み込みに失敗する場合は、パッケージが認識されない と プロジェクトのパッケージ設定のリセット の手順に従ってください。

Unity を新しいバージョンにアップグレードした後に問題が発生する

プロジェクトを新しい Unity バージョンにアップグレードすると、Package Manager は、互換性のないパッケージを新しい互換バージョンに自動的に更新します。ただし、パッケージがコンパイルされない場合、Package Manager はコンソールにエラーメッセージを表示します。

これらのメッセージを修正するには、エラーメッセージを読み、可能な限り問題を修正します。たとえば、パッケージに別のパッケージまたはバージョンへの依存関係がない場合があります。その場合は、自身でパッケージをインストールしてみてください。

使用できるものが見つかるまで、以下の一連の解決法を試すこともできます。

• バックアップして、プロジェクトの下の Packages フォルダーを削除します。
• バックアップしてから、プロジェクトの Packages フォルダー内のパッケージソースを削除し、 manifest.json ファイルのみを残します。次に、プロジェクトを再読み込みしてください。
• Create a new empty Project. If the Package Manager window loads successfully, replace the Library/PackageCache/com.unity.package-manager-ui@<version> folder in the failing Project with the same folder from the newly created Project.
• 最後の手段として、プロジェクトをデフォルトのパッケージ設定に リセット し、動作するまでパッケージを 1 つずつ加えてゆきます。

パッケージのインストールが失敗する

レジストリから新しいパッケージをインストールしようとしても機能しない場合は、許可の問題が原因である可能性があります。

キャッシュフォルダーに対する完全な許可が必要です。

• Windows: C:\Users\yourname\AppData\Local\Unity\cache
• MacOS: ~/Users/Library/Unity/cache

ネットワークに問題がある可能性があります。 ファイアウォール と プロキシ の設定を確認してください。

学校、官公庁、またはネットワークで保護された職場などの組織環境では、プロキシサーバーを設定してネットワークとインターネット間のトラフィックを制御しているために、Unity または Package Manager で認識されない独自のサーバー証明書を使用する場合があります。 ネットワーク管理者に相談してください。

パッケージが認識されない

多くのコンパイルエラーが表示される場合、Unity が既存のプロジェクトのパッケージを認識していないことを示している可能性があります。この場合、.NET コンポーネントが欠落している可能性があります。

Windows の場合

1. Visual Studio 2017 version 15.9.0 以降と、Other Toolsets (他のツールセット) で選択した .NET Core cross-platform development workload (.NET Core クロスプラットフォームの開発) と一緒に、ダウンロードしてインストールします。 .NET SDK v2.2.101 コンポーネントをダウンロードしてインストールします。

MacOS の場合

1. .NET SDK v2.2.101 コンポーネントをダウンロードしてインストールします。

2. 推奨される更新プログラムを Visual Studio にインストールします。

3. Homebrew を使用して、mono を作成してインストールします。

     brew update
       brew install mono # optional
       brew upgrade mono
   

4. 必要な場合は、Project 以下の Library/obj/temp フォルダーを削除し、 Unity を再起動します。

5. それでも、問題が解決しない場合は、コンピューターも再起動します。

Windows 上の hostfxr.dll の読み込みエラー

コンソールが hostfxr.dll ライブラリが見つかったが、Unity が C:\<path_to_app>\hostfxr.dll からのロードに失敗したと報告した場合、Windows 7 または Windows Server 2008 R2 では KB2999226 と KB2533623 の両パッチをインストールすることでこのエラーを修正できます。

プロジェクトのパッケージ設定のリセット

プロジェクトのパッケージの問題が多すぎる場合は、プロジェクトをリセットして、Unity のエディターバージョンの デフォルトのパッケージ設定 に戻すことができます。この操作により、プロジェクト内のすべてのパッケージがリセットされます。 これによって問題の原因を修正することはできないかもしれませんが、問題が何であるかを理解するのに役立ちます。

Note: You can’t undo resetting your package configuration, so make sure you back up the manifest.json file first or make sure your Project is under source control. You can also take extra precautions by cloning your Project and testing out the operation on the clone before proceeding.

デフォルトのパッケージ設定に戻すには、Help メニューから Reset Packages to defaults を選択します。

プロジェクトの複製のリセット

最終的な変更を実行する前に、デフォルトパッケージへ戻すことをテストすることもできます。

1. Project フォルダーをコピーし、名前を変更して見つけやすくします (例えば、プロジェクトの名前が MyProject の場合、clone_MyProject などを使用します)。

2. 新しく複製として作られたプロジェクトをロードします。

3. Help メニューから、Reset Packages to defaults を選択します。

   プロジェクトのサイズによっては、数分かかる場合があります。

4. パッケージが正常にリセットされたことを確認します。正常にリセットされれば、元のプロジェクトで安全に操作を実行できます。

Git URL の認証の問題

SSH プロトコルを使用して Git URL でパッケージをインストールする場合、バックグラウンドで ssh-agent を実行していて、PID 環境変数が適切に設定されていても、Git から認証エラーを受け取る場合があります。

スクリプトがバックグラウンドで ssh-agent を起動する際、エクスポートされた環境変数が有効なのは、現在スクリプトが走る Bash シェルとその地点から起動する子プロセスのみです。なぜなら、スクリプトは親プロセス、無関係のプロセス、作成済みの子プロセスの環境変数を変更できないからです。仮にスクリプトが .bashrc に位置していたとしても、Bash シェルで実行されてしまうでしょう。

Unity アイコンをダブルクリック、または、Unity Hub を使用して Unity または Unity Hub (Windows と macOS の両方) を起動してもシェルで実行されないため、スクリプトは実行されません。つまり、Unity Editor の処理にはこれらの変数が設定されていないため、最終的に Unity によって呼び出される Git 処理にもこれらの変数は含まれません。

この問題を解決するには、以下のいずれかを実行できます。

• 最初に (Unity Hub を開く前に) Bash シェルを開き、そのシェルから Unity エディターを手動で起動 します。
• Windows を使用している場合は、setx コマンドを使用して、Hub の処理が始まる前に Windows レジストリに環境変数を永続的に設定します。この解決策は、起動時にスクリプトを 1 回実行し、Hub が Windows で起動しないことを確認できる場合に最適です。例えば、以下のように使用します。

  # Expose env variables to native windows
    setx SSH_AGENT_PID "$SSH_AGENT_PID"
    setx SSH_AUTH_SOCK "$SSH_AUTH_SOCK"