MRが楽しい

MRやVRについて学習したことを書き残す

HoloLens2アプリ開発環境の構築手順

本日は MRTK v2 の技術調査枠です。
Unity と MRTK を使って HoloLens2 アプリを開発する環境の構築手順を記事にします。
f:id:bluebirdofoz:20210803225807j:plain

HoloLens2アプリ開発に必要なツール

Unity と MRTK を利用して HoloLens2 アプリを開発する場合、以下の環境が必要です。
・Unity 2019.4.x または Unity 2020.3.8 以降
Visual Studio 2019
Windows SDK 10.0.18362.0 以降
・MRTK(MixedRealityToolkit-Unity)

docs.microsoft.com
docs.microsoft.com

推奨のUnityバージョンについて

MRTK は 2021/8/3 現在、OpenXR プラグイン 1.0.0.0 と Unity 2020.3.8 以降の環境で開発が進められています。
github.com

Unityのインストール

Unity は Unity Hub を利用してインストールすることをお奨めします。
以下のインストール手順を参照し、Unity Hub をインストールして下さい。
bluebirdofoz.hatenablog.com

Unity Hubを利用した特定バージョンの Unity のインストール手順は以下を参照してください。
bluebirdofoz.hatenablog.com

なお、2021/8/3 現在、Unity Hub における最新の推奨リリースバージョンは 2020.3.15f2 になります。
f:id:bluebirdofoz:20210803230203j:plain

Unity をインストールする際、[モジュールをインストールに加える]画面の[Platform]欄で以下のコンポーネントにチェックを入れます。
コンポーネントを選択することで HoloLens2 で動作する UWP プラットフォームのアプリをビルド可能になります。
・Universal Windows Platform Build Support
Windows Build Support (IL2CPP)
f:id:bluebirdofoz:20210804215311j:plain

この時点で Visual Studio 2019 を未インストールの場合は[Microsoft Visual Studio Community 2019]にもチェックを入れることで、同時に Visual Studio Community 2019 と必要な機能のインストールを実行できます。
f:id:bluebirdofoz:20210803230243j:plain

Community 以外のエディションのインストールを行いたい場合は、次の手順に従って、利用したいエディションの Visual Studio 2019 のインストールを手動で実施してください。

Visual Studio 2019 のインストール

以下のインストール手順を参照し、Visual Studio 2019 をインストールします。
bluebirdofoz.hatenablog.com

HoloLens2 アプリを開発するためには Visual Studio 本体のインストールに加え、以下の追加機能のインストールが必要です。

ワークロードのインストール

HoloLens2 アプリの開発には以下の2つのワークロードのインストールが必要になります。
・ユニバーサル Windows プラットフォーム開発
・Unity によるゲーム開発

Visual Studio に後から追加機能のインストールを行う場合、Visual Studio Installer を起動します。
f:id:bluebirdofoz:20210803230554j:plain

Visual Studio 2019 のインストーラの[変更]ボタンを選択し、追加のインストール設定を開きます。
f:id:bluebirdofoz:20210803230646j:plain

[ワークロード]タブを開き、以下の2つのワークロードがインストールされていることを確認します。
・ユニバーサル Windows プラットフォーム開発
・Unity によるゲーム開発
f:id:bluebirdofoz:20210803230447j:plain

インストールされていなければワークロードをチェックし、[変更]ボタンでインストールを実行します。

C++(v142)ユニバーサルのインストール

アプリを IL2CPP でビルドを行う場合、[C++(v142)ユニバーサルWindowsプラットフォーム]オプションのインストールが必要になります。
[ユニバーサル Windows プラットフォーム開発]を選択し、[インストールの詳細]欄から[C++(v142)ユニバーサルWindowsプラットフォーム]にチェックを入れ、[変更]ボタンでインストールを行います。
f:id:bluebirdofoz:20210803231045j:plain

Windows SDKのインストール

HoloLens2 アプリの開発には Windows SDK のバージョン 10.0.19041.0 または 10.0.18362.0 が必要になります。
こちらは[ユニバーサル Windows プラットフォーム開発]のワークロードをインストールしていれば[Windows 10 SDK (10.0.19041.0)]が自動でインストールされています。
f:id:bluebirdofoz:20210803231105j:plain

Mixed Reality Feature Toolのダウンロード

MRTK のパッケージは Mixed Reality Feature Tool を使って Unity プロジェクトにインポートできます。
以下のページの[Download]から Mixed Reality Feature Tool の最新版をダウンロードします。
www.microsoft.com
f:id:bluebirdofoz:20210803231137j:plain

Mixed Reality Feature Tool の使い方や利用条件の詳細は以下の記事を参照してください。
bluebirdofoz.hatenablog.com