기술 자료

Unity 엔진

Unity 엔진

관리되는 플러그인

관리되는 플러그인 사용에 대한 자세한 내용입니다.
읽는 시간 5분최근 업데이트: 9일 전

관리되는 플러그인은 Unity 외부에서 생성하고 Visual Studio와 같은 툴을 사용하여 동적으로 연결된 라이브러리(DLL)에 컴파일하는 .NET 어셈블리입니다.
이는 Unity 프로젝트의 Assets 폴더에 소스 파일로 저장되는 표준 C# 스크립트와 다릅니다. Unity 표준 C# 스크립트가 변경될 때마다 컴파일하지만 DLL은 사전 컴파일되어 변경되지 않습니다. 컴파일된 .dll 파일을 프로젝트에 추가하고 포함된 클래스를 표준 스크립트와 동일한 방식으로 GameObjects에 연결할 수 있습니다.
C#에서 관리되는 코드에 대한 자세한 내용은 Microsoft의 관리되는 코드 문서를 참조하십시오.
관리되는 플러그인에는 .NET 코드만 포함되므로 .NET 라이브러리가 지원하지 않는 기능에 액세스할 수 없습니다. 그러나 Unity 스크립트를 컴파일하는 데 사용하는 표준 .NET 툴에서 관리되는 코드 액세스할 수 있습니다.
Unity DLL로 작업할 때는 스크립트로 작업할 때보다 더 많은 단계를 완료해야 합니다. 하지만 다음과 같이 Unity 프로젝트 .dll 파일을 생성하고 추가하는 것이 도움이 되는 경우가 있습니다.
  • Unity 지원하지 않는 컴파일러를 코드에 사용하려고 합니다.
  • .dll 파일에 타사 .NET 코드를 추가하려고 합니다.
  • 소스 없이 Unity 코드를 제공하려고 합니다.
이 페이지에서는 관리되는 플러그인을 생성하는 데 사용할 수 있는 일반적인 방법과 Visual Studio를 사용하여 관리되는 플러그인을 생성하고 디버그 세션을 설정하는 방법을 설명합니다.

관리되는 플러그인 생성

관리되는 플러그인을 생성하려면 DLL을 생성해야 합니다. 이를 위해서는 다음과 같은 적절한 컴파일러가 필요합니다.
.NET 코드를 생성하는 모든 컴파일러가 Unity 호환되는 것은 아닙니다. 따라서 중요한 작업을 수행하기 전에 일부 사용 가능한 코드로 컴파일러를 테스트해야 합니다. Unity가 현재 지원하는 .NET 프로파일에 대한 자세한 내용은 .NET 프로파일 지원을 참고하십시오.
DLL을 생성하는 데 사용하는 메서드는 DLL에 Unity API 코드가 있는지 여부에 따라 다릅니다.
  • DLL에 Unity API 코드가 포함된 경우 컴파일하기 전에 Unity 자체 DLL을 컴파일러에서 사용할 수 있도록 해야 합니다.
    1. Unity DLL을 찾으려면 다음과 같이 하십시오.
      • Windows에서는 다음으로 이동합니다.
        C:\Program Files\Unity\Hub\Editor\<version-number>\Editor\Data\Managed
      • macOS:
        1. 컴퓨터에서
          Unity.app
          파일을 찾습니다. macOS에서 Unity DLL의 경로는 다음과 같습니다.
          /Applications/Unity/Hub/Editor/<version-number>/Unity.app/Contents/Managed
        2. 오른쪽 클릭
          Unity.app
        3. 패키지 콘텐츠 표시를 선택합니다.
    2. Managed
      폴더에는 각각 모든 에디터 및 엔진 코드에 대한
      UnityEditor.dll
      및
      UnityEngine.dll
      면 어셈블리가 들어 있습니다. 이를 참조하여 에디터 또는 엔진 API를 스크립트에 사용할 수 있도록 합니다. 지원되지 않으므로 개별 모듈 어셈블리를 직접 참조하지 마십시오. 일부 네임스페이스에는 Unity 프로젝트의 컴파일된 라이브러리에 대한 레퍼런스(예:
      UnityEngine.UI
      )도 필요합니다. 프로젝트 폴더의 디렉토리에서 찾습니다.
      ~\Library\ScriptAssemblies
  • DLL에 Unity API 코드가 포함되어 있지 않거나 Unity DLL을 이미 사용할 수 있게 한 경우 컴파일러 문서를 따라 .dll 파일을 컴파일합니다. DLL 컴파일에 사용하는 정확한 옵션은 사용 중인 컴파일러에 따라 다릅니다. 예를 들어, Roslyn 컴파일러인
    csc
    의 커맨드 라인은 macOS에서 다음과 같습니다.
csc /r:/Applications/Unity/Hub/Editor/<version-number>/Unity.app/Contents/Managed/UnityEngine.dll /target:library /out:MyManagedAssembly.dll /recurse:*.cs
예제:
  • 빌드에 포함할 라이브러리 경로를 지정하려면
    /r
    옵션을 사용합니다. 이 경우에는
    UnityEngine
    라이브러리입니다.
  • /target
    옵션을 사용하여 필요한 빌드 타입을 지정합니다.
    library
    는 DLL 빌드를 의미합니다.
  • /out
    를 사용하여 라이브러리의 이름을 지정합니다. 이 경우에는
    MyManagedAssembly.dll
    입니다.
  • 포함할 소스 파일의 이름을 추가합니다. 현재 작업 디렉토리와 하위 폴더에
    .cs
    로 끝나는 모든 파일을 추가하려면
    /recurse
    메서드를 사용합니다. 결과 .dll 파일은 소스 파일과 동일한 폴더에 나타납니다.

관리되는 플러그인 사용

DLL을 컴파일한 후에는 다른 에셋처럼 .dll 파일을 Unity 프로젝트 드래그할 수 있습니다. 그런 다음 다음을 수행할 수 있습니다.
  • 관리되는 플러그인을 확장하여 라이브러리의 개별 클래스를 확인합니다.
  • MonoBehaviour 파생된 클래스를 게임 오브젝트로 드래그합니다.
  • 다른 스크립트에서 직접 MonoBehaviour가 아닌 클래스를 사용합니다.

An expanded DLL with the classes visible

Visual Studio로 DLL 생성

이 섹션에서는 다음을 설명합니다.
  • Visual Studio에 간단한 DLL 예제를 빌드하고 통합하는 방법
  • Unity DLL에 대한 디버깅 세션을 준비하는 방법입니다.

프로젝트 설정

  1. Visual Studio를 열고 새 프로젝트를 만듭니다.
  2. File > New > Project > Visual C# > .Net Standard > **Class Library (.NET Standard)**를 선택합니다.
  3. 새 라이브러리에 다음 정보를 추가합니다.
    • Name: 네임스페이스입니다(이 예제에서는
      DLLTest
      를 이름으로 사용).
    • Location: 프로젝트의 부모 폴더입니다.
    • 솔루션 이름: 프로젝트의 폴더입니다.
  4. 스크립트에 Unity DLL을 사용할 수 있도록 합니다. Visual Studio에서 솔루션 탐색기에서 레퍼런스 컨텍스트 메뉴를 열고 Add Reference > Browse > Select File을 선택합니다.
  5. UnityEngine 폴더에 있는 필수 .dll 파일을 선택합니다.

DLL 코딩

  1. 이 예시에서는 솔루션 브라우저에서 기본 클래스의 이름을
    MyUtilities
    로 변경합니다.
  2. 해당 코드를 다음으로 교체합니다.
using System; using UnityEngine;네임스페이스 DLLTest { public class MyUtilities { public int c; public void AddValues(int a, int b) { c = a + b; } public static int GenerateRandom(int min, int max) { System.Random rand = new System.Random(); return rand.Next(min, max); } }}
  1. 프로젝트를 빌드하여 디버그 심볼과 함께 DLL 파일을 생성합니다.

Unity DLL 디버깅

Unity DLL에 대한 디버깅 세션을 설정하려면 다음 단계를 따르십시오.
  1. Unity에서 새 프로젝트를 만들고 빌드된 .dll 파일(예:
    <project folder>/bin/Debug/DLLTest.dll
    )을 Assets 폴더에 복사합니다.
  2. Assets 폴더에 Test라는 C# 스크립트를 생성합니다.
  3. DLL에서 생성한 클래스의 새 인스턴스를 생성하고 해당 함수를 사용하고 콘솔 창에 출력을 표시하는 스크립트로 해당 콘텐츠를 교체합니다. 예를 들어 위 섹션에서 DLL에 대한 테스트 스크립트를 생성하려면 다음 코드를 복사합니다.
using UnityEngine;using System.Collections;using DLLTest;public class Test : MonoBehaviour { void Start () { MyUtilities utils = new MyUtilities(); utils.AddValues(2, 3); print("2 + 3 = " + utils.c); } void Update () { print(MyUtilities.GenerateRandom(0, 100)); }}
  1. 이 스크립트를 씬의 게임 오브젝트에 연결하고 Play를 클릭 수.
Unity 콘솔 창 DLL의 코드 출력을 표시합니다.

안전하지 않은 C# 코드 컴파일

안전하지 않은 C# 코드는 메모리에 직접 액세스할 수 있는 코드입니다. 컴파일러가 보안 위험을 초래하지 않는지 확인할 수 없으므로 기본적으로 활성화되지 않습니다.
안전하지 않은 코드를 사용하여 다음을 수행할 수 있습니다.
  • 포인터를 사용하여 메모리에 액세스합니다.
  • 원시 메모리를 할당합니다.
  • 포인터를 사용하여 메서드를 호출합니다.
안전하지 않은 C# 코드 컴파일에 대한 지원을 활성화하려면 편집 >
프로젝트 설정

?

> 플레이어 > 기타 설정으로 이동하여 안전하지 않은 코드 허용을 활성화합니다.
자세한 내용은 Microsoft의 비보안 코드 문서를 참조하십시오.

추가 리소스