<p>恋愛メタバースMemoriaを開発するFlamers CTOの設楽（だーら）です。<br>
今回はモバイルアプリ上でネイティブアプリと組み合わせてUnityを起動するUaaLについて、サンプルプロジェクトの起動を通して技術調査をいたしました。</p>
<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<h2 id="%E6%A6%82%E8%A6%81">
<a class="header-anchor-link" href="#%E6%A6%82%E8%A6%81" aria-hidden="true"></a> 概要</h2>
<ul>
<li>モバイルのネイティブアプリにUnityビルドを組み込む仕組みであるUnity as a Library（UaaL）のサンプルプロジェクトを起動する</li>
<li>今回はiOS版のみをまとめる（別記事でAndroidについても記述）</li>
<li>（追記）XCodeのSimulatorは実機との挙動の違いなどがあり、極力使わないことにしていきたいと思いました。Simulatorを飛ばして実機で確認したほうがよさそうです。</li>
</ul>
<h2 id="%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88">
<a class="header-anchor-link" href="#%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88" aria-hidden="true"></a> サンプルプロジェクト</h2>
<ul>
<li><a href="https://github.com/Unity-Technologies/uaal-example" target="_blank" rel="nofollow noopener noreferrer">https://github.com/Unity-Technologies/uaal-example</a></li>
</ul>
<h2 id="%E3%82%B4%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#%E3%82%B4%E3%83%BC%E3%83%AB" aria-hidden="true"></a> ゴール</h2>
<ul>
<li>XCodeのSimulatorで下の画像のように、ネイティブアプリ上でUnityが動いている姿を見たい<br>
<img src="https://storage.googleapis.com/zenn-user-upload/4f9a11697b66-20230829.png" loading="lazy" class="md-img">
</li>
</ul>
<h2 id="%E7%92%B0%E5%A2%83">
<a class="header-anchor-link" href="#%E7%92%B0%E5%A2%83" aria-hidden="true"></a> 環境</h2>
<ul>
<li>Unity 2022.3.8f1</li>
<li>XCode 14.3</li>
</ul>
<h1 id="%E5%AE%9F%E8%A1%8C%E6%89%8B%E9%A0%86">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A1%8C%E6%89%8B%E9%A0%86" aria-hidden="true"></a> 実行手順</h1>
<h2 id="unity%E3%83%93%E3%83%AB%E3%83%89">
<a class="header-anchor-link" href="#unity%E3%83%93%E3%83%AB%E3%83%89" aria-hidden="true"></a> Unityビルド</h2>
<ul>
<li>ビルドプラットフォームをiOSにする</li>
<li>Project Settingsで、Target SDKをSimulator SDKに変更する（実機の場合はDevice SDK）<br>
<img src="https://storage.googleapis.com/zenn-user-upload/5331aa93d526-20230829.png" loading="lazy" class="md-img">
</li>
<li>特に署名の必要などはなかった</li>
</ul>
<h2 id="%E5%85%AC%E5%BC%8F%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%81%AE%E9%80%9A%E3%82%8A%E3%81%AB%E9%80%B2%E3%82%81%E3%82%8B">
<a class="header-anchor-link" href="#%E5%85%AC%E5%BC%8F%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%81%AE%E9%80%9A%E3%82%8A%E3%81%AB%E9%80%B2%E3%82%81%E3%82%8B" aria-hidden="true"></a> 公式ドキュメントの通りに進める</h2>
<ul>
<li>
<a href="https://github.com/Unity-Technologies/uaal-example/blob/master/docs/ios.md" target="_blank" rel="nofollow noopener noreferrer">https://github.com/Unity-Technologies/uaal-example/blob/master/docs/ios.md</a>
<ul>
<li>
<ol start="4">
<li>Add UnityFramework.frameworkのremove UnityFramework.framework from the list (select it and press - )では必ずXCodeが落ちた。</li>
</ol>
</li>
</ul>
</li>
</ul>
<h3 id="arm64%E9%96%A2%E4%BF%82%E3%81%AE%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AB%E5%AF%BE%E5%87%A6%E3%81%99%E3%82%8B%EF%BC%88simulator%E3%81%AE%E5%A0%B4%E5%90%88%E3%81%AE%E3%81%BF%EF%BC%89">
<a class="header-anchor-link" href="#arm64%E9%96%A2%E4%BF%82%E3%81%AE%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AB%E5%AF%BE%E5%87%A6%E3%81%99%E3%82%8B%EF%BC%88simulator%E3%81%AE%E5%A0%B4%E5%90%88%E3%81%AE%E3%81%BF%EF%BC%89" aria-hidden="true"></a> arm64関係のエラーに対処する（Simulatorの場合のみ）</h3>
<ul>
<li>通常通りシミュレーターを起動すると、緑のinitボタンを押した段階で以下のようなエラーが出力される。<br>
<code>mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64'</code>
</li>
<li>また、Show Unityのグレーのボタンを推しても"Unity is not initialized"と表示される<br>
<img src="https://storage.googleapis.com/zenn-user-upload/ad3f40490255-20230829.png" loading="lazy" class="md-img">
</li>
<li>以下の画像の様に、NativeiOSAppのBuild Settingsで、Excluded Architectureを設定する
<ul>
<li>
<a href="https://qiita.com/littleossa/items/ff75b19e0ac6713941f8" target="_blank" rel="nofollow noopener noreferrer">参考記事</a><br>
<img src="https://storage.googleapis.com/zenn-user-upload/054f6d37df39-20230829.png" loading="lazy" class="md-img">
</li>
</ul>
</li>
<li>この状態で再度起動すると最初にはった画像のようにUnityが展開される🎉</li>
</ul>
<h1 id="%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0">
<a class="header-anchor-link" href="#%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0" aria-hidden="true"></a> トラブルシューティング</h1>
<ul>
<li>
<p><code>'UnityFramework/UnityFramework.h' file not found</code>のエラーがでる。</p>
<ul>
<li>NativeiOSAppとUnity-iPhoneの順番の問題の可能性がある？</li>
<li>はじめから、NativeiOSAppをUnity-iPhoneの上に来るようにしたら問題が発生しなくなった。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/fd31dfd383a4-20230829.png" loading="lazy" class="md-img">
</li>
</ul>
</li>
<li>
<p><code>Undefined symbol: OBJC_CLASS$_UnityFramework</code>のエラーがでる。</p>
<ul>
<li>
<code>~/Library/Developer/Xcode/DerivedData</code>の中の中間生成物が悪さをしている可能性がある。自分の場合はこのディレクトリごと削除すると問題が解決した。</li>
<li>参考: <a href="https://dev.classmethod.jp/articles/remove-xcode-derived-data/" target="_blank" rel="nofollow noopener noreferrer">https://dev.classmethod.jp/articles/remove-xcode-derived-data/</a>
</li>
</ul>
</li>
</ul>


【Unity/iOS】UaaL（Unity as a Library）のサンプルプロジェクトを起動する

arm64関係のエラーに対処する（Simulatorの場合のみ）

公式ドキュメントの通りに進める

Discussion