💻

[Unity + VSCode] エディターの初期設定手順メモ(MacOS M2チップ)

2023/03/26に公開

はじめに

Unityの開発環境を入れ直す必要があり、改めてVSCodeの初期設定を行いました。
一部躓いた点がありましたのでメモとしてまとめます。

公式ドキュメント

基本的な流れは公式ドキュメント通り進めました。
https://docs.unity3d.com/ja/2021.2/Manual/ScriptingToolsIDEs.html
https://code.visualstudio.com/docs/other/unity

環境

OS・ツールなど バージョン 備考
MacOS Ventura( 13.2.1 ) MacbookPro M2Proチップ
VSCode 1.76.2 -
Unity 2021.3.21f1 -

VSCodeの設定手順

1: .NET SDKのインストール

以下より.NetSDKをダウンロード&インストール

Microsoft | .NETのダウンロード
.NET SDKダウンロード

2: Mono のインストール

以下よりMonoをダウンロード&インストール

Mono | Download
Monoダウンロード

3: VSCode 拡張機能インストール

VSCode起動後、拡張機能から「C#」をインストール
(拡張機能の検索窓から "C#" で検索し、対象機能をインストール)
C#インストール

4: VSCode の設定から、「Omnisharp: use Modern Net」をオフ

  1. VSCodeを開いた状態で、 ⌘(コマンドキー) + ,(カンマキー) を押して設定画面を開く
  2. 検索窓から "use Modern Net" と入力
  3. "use Modern Net" のチェックを外してオフにする
    04_VSCode設定

5: UnityのエディターをVSCodeに設定する

Unityで適当なプロジェクトを起動後、 以下からVSCodeを選択
メニューバー内、[Unity] > [Settings] > [External Tools] > [External Script Editor] > "Visual Studio Code" を選択
05_Unity設定

6: VSCodeの起動や入力補完(インテリセンス)の確認

  1. Unity起動後、適当なC#スクリプトを作成する
  2. 作成したC#スクリプトをダブルクリックした後、VSCodeが起動すること
  3. Unityのクラス名やプロパティを入力する際に、入力補完や定義メソッドへのリンクが表示されたら設定完了
    06_VSCode確認-1
    06_VSCode確認-2

躓いた問題の対応

「OmniSharp requires a complete install of Mono 〜」ダイアログが表示される

問題の概要

UnityからVSCodeを開いたタイミングで、以下の警告ダイアログが頻繁に表示される事象が発生。
ダイアログ内の [Download Mono] を選択すると、ブラウザでMonoのダウンロード先が開く。
07_OmniSharpRqquiresMonoダイアログ

対応策

問題のメッセージで検索すると、2つの対応方法があった。
両方試したが、方法2の対応で解決した。

  • 方法1: OmniSharp 拡張機能のバージョンをダウングレードする(v1.25.2 にダウングレード)
  • 方法2: MonoのダウンロードパスをVSCodeに設定する

https://github.com/microsoft/vscode-dev-containers/issues/1474#issuecomment-1138768231

対応手順(方法2の手順)

  1. Monoのインストール場所を確認する
    以下コマンドでインストール場所を確認
ターミナルコマンド
which mono
コマンド実行結果(例)
/Library/Frameworks/Mono.framework/Versions/Current/Commands/mono
  1. VSCodeを起動後、設定から 「Omnisharp: Mono Path」 に上記Monoのインストールパスを設定する
    08_OmniSharpパス設定.

  2. VSCodeを一旦終了し、Unityから起動した際にダイアログが出なくなることを確認できたら完了

補足

方法1による対応手順
  1. 以下より、OmniSharp拡張機能の v1.25.2 をダウンロードする
    ※今回はM2 Macbookなので、「csharp-1.25.2-alpine-arm64.vsix」をダウンロード

https://github.com/OmniSharp/omnisharp-vscode/releases/tag/v1.25.2

  1. VSCodeを起動し、インストール済みの「C#」拡張機能をアンインストールする

  2. VSCodeの以下メニューから、項番1でダウンロードしたファイルをインストールする
    [拡張機能] > [・・・(メニュー)] > [VSIX からのインストール] > "ダウンロードしたファイルを選択"
    09_拡張機能の手動インストール

参考URL

Discussion