Visual Studio Tools for Unity
機能
- IntelliSense： コード補完
- デバッグ機能
- ブレークポイント
- ウォッチ
- 変数、引数の検査、及び変更
- オブジェクトやデータ構造体を展開
- アナライザー／コード修正
- CodeLens サポート
- Unity Project Explorer (UPE)
公式サイト：
Visual Studio Tools for Unity | Microsoft Docs [公式]
導入
手順
- メニューから「編集 > 環境設定…」 (Edit > Preferences…) を開き、「外部ツール」 (External Tools) タブに切り替える。
- 「外部ツール」 (External Tools) タブに切り替えて、「外部のスクリプトエディター」 (External Script Editor) として
Visual Studio Community 2019を選択する。
ドキュメント：
External Tools – 環境設定 | Unity マニュアル [公式]
クイックスタート： Unity を使ったクロスプラットフォーム開発のための Visual Studio の構成 | Microsoft Docs [公式]
参考：
Unity で Visual Studio をデフォルトのエディタに設定する – Qiita
使い方
ドキュメント：
Visual Studio Tools for Unity を使用する | Microsoft Docs [公式]
Visual Studio C# インテグレーション | Unity マニュアル [公式]
参考：
Unity で Visual Studio を使う – Qiita
Unity で Visual Studio をデフォルトのエディタに設定する – Qiita
Visual Studio 2019 を Unityで使用する。| 58 の Unity や技術のヤマカン！
Visual Studio 2019 を使おう！ | のらくるノート
VS2017 から VS2019 へ環境を移動する。| 土屋つかさの技術ブログは今か無しか
Visual Studio 2019 で保存する度にコンパイルされる問題 | のらくるノート
Unity Editor から Visual Studio を起動する
メニューから「Assets > Open C# Project」を選択して開く。
ドキュメント：
Visual Studio で Unity スクリプトを開く | Microsoft Docs [公式]
ドキュメントを閲覧する
メニューから「ヘルプ > Unity API リファレンス」を選択して開く。ローカルにマニュアルをインストールした場合はローカルのマニュアルを開く。ローカルにマニュアルが存在しない場合はオンラインで開く。
ドキュメント：
Unity のドキュメントへのアクセス | Microsoft Docs [公式]
参考：
Launch local documentation from unity 2018.2.5 – Stack Overflow
.csproj ファイルを生成する
インテリセンスを使用してコード補完を行うためには .csproj ファイルが適切に生成されている必要がある。
.csproj ファイルを生成する範囲を設定するには、メニューから「Edit > Preferences…」を開いて、External Tools タブで 「Generate .csproj Files for」の項目を設定する。デフォルトでは、埋め込みパッケージとローカルパッケージのみが有効となっている。
- Embedded Packages： 埋め込みパッケージ
- Local Packages： ローカルパッケージ
- Registry Packages： レジストリからインストールしたパッケージ
- Git Packages： Git プロトコルでイントールしたパッケージ
- Built-in packages： ビルトインパッケージ
- Local TarBall
- Packages from Unknown Sources
- Player Projects
「Regenerate Project Files」ボタンを押すと .csproj ファイルが再生成される。
ドキュメント：
External Tools | Unity 2018.4 マニュアル [公式]
参考：
Package Manager で追加したパッケージの .csproj を生成する方法 | コガネブログ
「Generate All .csproj Files」をオンにしていても .csproj が生成されない場合 | コガネブログ
Intellisense Not Working with Visual Studio – Unity Forum
Searching code in Package Manager from Visual Studio – Unity Forum
Is there a way to force Unity to regenerate csproj files? – Unity Forum
How to get intellisense setup for a custom embedded package? – Unity Forum
“Step into” package scripts? – Unity Forum
Imported package’s code not showing in Visual Studio – Stack Overflow
互換性のないプロジェクト
現象：
Visual Studio でプロジェクトを開くと次のような警告メッセージが表示される。
この Unity プロジェクトは、Visual Studio Tools for Unity 用に生成されたものではありません。
対処法：
- メニューから「編集 > 環境設定…」 (Edit > Preferences…) を開く。
- 「外部ツール」 (External Tools) タブに切り替えて、「外部のスクリプトエディター」 (External Script Editor) として
Visual Studio Community 2019が選択されていることを確認する。 - 「Regenerate Project Files」を実行する。
ドキュメント：
Visual Studio での互換性のないプロジェクト | Microsoft Docs [公式]
トラブルシューティング
トラブルシューティングと既知の問題 | Microsoft Docs [公式]
Tips
Unity でコーディングするときに Visual Studio ツールを最適化するためのヒント | Unity [公式]
Roslyn Analyzers for Unity
リポジトリ：
microsoft/Microsoft.Unity.Analyzers: Roslyn Analyzers for Unity Game Developers – GitHub
入手：
Microsoft.Unity.Analyzers | NuGet Gallery [Official]
ドキュメント：
Diagnostic Analyzers / Suppressors – Microsoft.Unity.Analyzers – GitHub
サードパーティのアナライザーのインストール | Microsoft Docs [公式]
参考：
how to install analyzers · Issue #80 · microsoft/Microsoft.Unity.Analyzers – GitHub
UNT0014 警告
参考：