.NET 프로파일 지원
안정적인 스크립팅 런타임: 알려진 한계

추가 클래스 라이브러리 어셈블리 레퍼런스

Unity 프로젝트에서 기본적으로 컴파일되지 않는 .NET 클래스 라이브러리 API의 일부에 액세스해야 하는 경우 프로젝트에서 Unity의 C# 컴파일러에 알릴 수 있습니다. 이 동작은 프로젝트에서 사용하는 .NET 프로파일에 따라 다릅니다.

.NET Standard 2.0 프로파일

프로젝트에서 .NET Standard 2.0 API 호환성 수준(Api Compatibility Level) 을 사용하는 경우 .NET 클래스 라이브러리 API의 일부를 사용하기 위해 추가로 해야 하는 작업은 없습니다. API의 일부가 없는 것처럼 보이면 .NET Standard 2.0과 함께 포함되어 있지 않기 때문일 수 있습니다. 이 경우 프로젝트에서 .NET 4.x API 호환성 수준(Api Compatibility Level) 을 대신 사용해야 할 수 있습니다.

.NET 4.x 프로파일

Unity에서는 NET 4.x API 호환성 수준(Api Compatibility Level) 을 사용하는 경우 기본적으로 다음 어셈블리를 레퍼런스합니다.

  • mscorlib.dll
  • System.dll
  • System.Core.dll
  • System.Runtime.Serialization.dll
  • System.Xml.dll
  • System.Xml.Linq.dll

그 외의 클래스 라이브러리 어셈블리는 csc.rsp 파일을 사용하여 참조해야 합니다. 이 파일을 Unity 프로젝트의 Assets 디렉토리에 추가하여 커맨드 라인 인자를 C# 컴파일러에 추가로 전달하는 데 사용할 수 있습니다. 예를 들어 System.Net.Http.dll 어셈블리에서 정의되는 HttpClient 클래스를 프로젝트에서 사용하는 경우 C# 컴파일러에서 다음과 같은 초기 오류 메시지를 표시할 수 있습니다.

`HttpClient` 타입은 레퍼런스되지 않는 어셈블리에서 정의됩니다. 'System.Net.Http, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' 어셈블리에 대한 레퍼런스를 추가해야 합니다.

다음 csc.rsp 파일을 프로젝트에 추가하여 이 오류를 해결할 수 있습니다.

-r:System.Net.Http.dll

위 예의 설명대로 클래스 라이브러리 어셈블리를 레퍼런스해야 합니다. 어셈블리를 Project 디렉토리로 복사하지 마십시오.

프로파일 간 전환

csc.rsp 파일을 사용하여 클래스 라이브러리 어셈블리를 참조하는 경우 주의를 기울이십시오. Api Compatibility Level 을 .NET 4.x에서 .NET Standard 2.0으로 변경하는 경우 위 예와 같은 csc.rsp 파일이 프로젝트에 있으면 C# 컴파일에 실패합니다. System.Net.Http.dll 어셈블리는 .NET Standard 2.0 프로파일에 없으므로 C# 컴파일러가 이 어셈블리를 찾을 수 없습니다.

csc.rsp 파일에는 최신 .NET 프로파일에만 해당하는 부분이 있을 수 있습니다. 프로파일을 변경하는 경우 csc.rsp 파일도 수정해야 합니다.


.NET 프로파일 지원
안정적인 스크립팅 런타임: 알려진 한계