Mac VSCode를 사용한 Unity개발환경 세팅 및 트러블 슈팅 로그

4 minute read

Mac Visual Studio Code를 사용한 Unity개발환경 세팅 로그 및 트러블 슈팅

VS Code 개발환경 구축

Mac OS / Visual Studio Code 기준으로

Unity3d와 VS Code를 연동한 작업환경을 목적으로 Research를 진행.

개발환경 기록및 문서화를 위한 자료 수집을 목적으로 본 문서에 기록하며 진행한다.

Refference Source

Set up Visual Studio Code with UNITY, MAC, and INTELLISENSE WORKING 2023

2023년 초에 작성된 아래 가이드 영상으로, 세팅 try과정의 대부분을 참고하였다.

vs code 공식 사이트에서의 unity 연동 관련 문서.

그 외 Trouble Shooting 과정에서 확인하거나 도움된 페이지는 아래에 추가로 기록한다.

차례

위 영상에서 추천하는 구축 순서를 대부분 따라 해 본다.

물론 23년 5월 현재 이걸 그대로 따라한다고 해도 vscode 와 unity editor가 완전하게 연동되지 않는것을 먼저 확인했기 때문에, 스탭별로 정보를 모아 해결해보도록 하겠다.

Install Visual Studio Code for Mac and go through the installation process

Close out of Unity and Visual Studio Code

Install Mono Stable Channel for and .NET SDK for Visual Studio Code

I recommend restarting after installing these

Open Unity, install the VS Code package if not installed, set External Tools to Visual Studio Code, Click Regenerate Project Files

Edit – Open C# Assets (if you ever have a problem with VS Code not recognizing your code, close out of VS Code and Open it with this button)

Download C#, Unity Tools, Unity Debugger, Unity Code Snippets, Unity Snippets, C# XML Documentation, using Halcyon Theme

Settings: -Omnisharp: Use Modern Net Turn Off. Set Omnisharp Mono Path (/Library/Frameworks/Mono.framework/Versions/Current”, Disable Telemetry (collect analytics on you), Turn off CodeLens, inlay hints parameters c#,

Close VS Code, word wrap to word wrap column (search wrap), wrapping indent (indent)

Edit – Open C# Assets

Make sure Intellisense is working, fire in bottom right, opens up terminal and tells you if there are any errors, choose correct solution

Go to Debug Tab, Create Launch.json Unity Debugger, Place Breakpoint, Press Play, Go to Unity and Enable Debugging Session, Press Play in Unity, then you can step through the code and see details

실행 스탭

Visual Studio Code, Unity hub, Unity Editor 설치
Unity와 VSC를 닫을 것
.net SDK(arm-64)와 Mono framework(Stable Channel)를 설치
1. dot net SDK ( https://dotnet.microsoft.com/en-us/download ) arm-64 버전으로
2. mono framework(https://www.mono-project.com/download/stable/ ) 해당 영상에서는 Stable Channel을 추천하지만, (https://www.androidhuman.com/2020-09-14-unity_with_vscode)에서는 Visual Studio Channel을 추천한다.)
재시동 할것.
Unity를 열고, Package Manager에서 VS Code Package를 설치, External Tools에서 VisualStudioCode를 설정 후, Regenerate Project Files
Open C# Assets - (유니티에서 VS Code 실행)
VS Code 에서 아래 플러그인들 설치 Download C#, Unity Tools, Unity Debugger, Unity Code Snippets, Unity Snippets, C# XML Documentation, using Halcyon Theme (나는 덕후테마가 많이 포함된 Doki Theme를 추가로 설치했다.)
(중요) Settings - Omnisharp : Use Modern Net 체크 해제.

이 시점에서 이런 에러를 맞이하게된다.
Mono Path 설정 CodeLens, inlay hints parameters c#를 disable할것을 추천 (나는 나름 유용하게 쓰는 기능이라 남기고 싶다.???)
VS Code를 닫고 word wrap to word wrap column(스트링 관련 플러그인 설정…딱히 필요 없어보인다.)
Edit — Open C# Assets

문제 1- OmniSharp requirese a complete install of Mono

역시 다시 이 오류에 부딪힌다…..
- https://github.com/OmniSharp/omnisharp-vscode/issues/5445 의 정보를 토대로 1.25.0으로 C# extention(Omnisharp)를 다운그레이드 이슈에서는 1.25.1에서의 같은 문제가 1.25.0으로 다운그레이드로 해결됨이 제시되었다.
- 맥에서의 1.25.7(현재 버전)에서의 같은 문제 역시 보고되어 있다.
- 영상에서 정상동작에 사용된 확장 버전이 1.25.0에서 확인 후 1.25.2 및 1.25.4까지 확인해보도록 한다.(1.25.5, 1.25.6 버전은 존재하지 않는다.)
- 1.25.0버전, 1.25.4 확인, .NET Core SDK에 대한 문제가 추가로 발생했다.
  
  문제 2 - The .NET Core SDK cannot be located.
  
  이번에는 .NET core를 패스에서 찾지 못하는 문제 확인.
- 여기에서 Get the SDK의 링크가 우리가 받은 dot net SDK 의 링크와 다르다.
  
  Visual Studio Code용 .NET SDK 다운로드
  
  링크에 존재하는 Visual Studio Code 용 Dot net SDK를 다운받는다.
- Visual Studio Code용 Dot net SDK를 설치한 후 문제 2 - The .NET Core SDK cannot be located. 는 해결되었지만 문제 1- OmniSharp requirese a complete install of Mono 는 여전했다.
- Mono를 Visual Studio Channel 로 다시 다운로드하여 설치한 결과, 문제 1- OmniSharp requirese a complete install of Mono 이 사라졌다.
  
  문제 1과 문제 2가 모두 해결된 상태
  
  OmniSharp가 정상동작하는 상태
이로써 참조가 동작하는 상태에 진입했다. 드디어 Intellisense와 Debug가 동작하는지 확인하는 단계에 진입할 수 있게 되었다.
Intellisense가 동작하는지 확인, 터미널에 오류가 뜨는지 확인, 올바른 솔루션이 열렸는지 확인.

vs code의 Debugger메뉴에서 Unity Debugger를 통해 Launch.json을 생성한다. vs code에서 Dubug를 시작하면 Editor에서 뜬 창에서 아래 창이 팝업되고, debugging for session을 Enable해주면 연동이 완료되어 디버그 가능한 상태가 된다.

이제 Unity에서 실행버튼을 눌러 디버그를 확인하면 끝.

VS Code에서의 연결을 알리는 팝업

BreakPoint로 디버그 상태를 테스트하여 마무리