기술 자료

Unity 엔진

Unity 엔진

데스크톱 플랫폼용 플러그인 빌드

macOS, Windows, Linux 네이티브 코드 라이브러리를 배포합니다.
읽는 시간 3분최근 업데이트: 9일 전

데스크톱 플랫폼용 플러그인은 C, C++, Objective C로 작성할 수 있는 네이티브 코드 라이브러리입니다. 이 페이지에서는 macOS, Windows 및 Linux 플러그인을 설명합니다. 자세한 내용은 네이티브 플러그인을 참고하십시오.

macOS plug-ins

macOS 플러그인을 번들로 배포하거나,
IL2CPP

?

스크립팅 백엔드를 사용하는 경우,
[DllImport("__Internal")]
구문으로 호출할 수 있는 루스 C++ 파일을 배포할 수 있습니다. 루스 C++ 플러그인에 대한 자세한 내용은 IL2CPP용 C++ 소스 코드 플러그인을 참조하십시오.
Xcode로 번들 프로젝트를 생성하려면 다음 단계를 따르십시오.
  1. Xcode를 엽니다.
  2. File > New > Project > macOS > Framework & Library > Bundle을 선택합니다.
Xcode 작업에 대한 자세한 내용은 Apple의 Xcode 기술 자료를 참조하십시오.

요구 사항

  • 64비트 아키텍처와 호환되는 유니버설 바이너리 플러그인을 빌드할 수 있습니다. 또는 별도의 dylib 파일을 제공할 수도 있습니다.
  • 플러그인을 구현하기 위해 C++(
    .cpp
    ) 또는 Objective-C(
    .mm
    )를 사용하는 경우 C 링크로 함수를 선언해야 합니다.
외부 "C"{ float ExamplePluginFunction ();}

Windows 플러그인

Windows의 플러그인은 익스포트된 함수의
.dll
파일이거나 IL2CPP를 사용하는 경우 루스 C++ 파일입니다. 대부분의 언어와 개발 환경에서
.dll
파일을 생성하여 플러그인을 생성할 수 있습니다. 네임 맹글링 문제를 피하려면 C 링크로 모든 C++ 함수를 선언해야 합니다.

Linux plug-ins

Linux의 플러그인은 익스포트된 함수를 가진
.so
파일입니다. 이 라이브러리는 보통 C 또는 C++ 버전이지만 모든 언어를 사용할 수 있습니다. 네임 맹글링 문제를 피하려면 C 링크로 모든 C++ 함수를 선언해야 합니다.
Linux용 네이티브 플러그인을 빌드할 때 빌드된 라이브러리에 다른 네이티브 플러그인에 대한 종속성이 있는 경우 해당 라이브러리에 대한
rpath
를 컴파일하는 동안 지정해야 합니다.
링커 플래그
-Wl, -rpath=$ORIGIN
를 추가하여 런타임 검색 경로를 지정합니다. 링커 플래그는 로더가 시스템 검색 경로를 검색하는 것 외에도 라이브러리의 현재 디렉토리에서 종속성을 찾도록 명령합니다.
-Wl, -rpath=$ORIGIN
와 함께 다른 링커 플래그를 추가할 수 있지만 Unity는 제어하지 않습니다. 예:
/usr/bin/g++ -o binary.c.o -Wl,-rpath=$ORIGIN
또는 환경에서
LD_LIBRARY_PATH=dependency path
를 설정하여 로더가 해당 경로를 검색하여 종속성을 찾도록 지시할 수도 있습니다. Linux 현재 디렉토리의 종속성을 자동으로 검색하지 않습니다. 잘못된 경로로 인해 Unity 에디터 누락된 라이브러리 오류가 발생하므로 올바른 종속성 검색 경로를 설정해야 합니다.

Unity 플러그인 관리

Unity에서 플러그인은 플러그인 인스펙터에서 관리합니다. 플러그인 인스펙터에 액세스하려면
프로젝트 창

?

에서 플러그인 파일을 선택합니다. 스탠드얼론 플랫폼의 경우 라이브러리가 호환되는 CPU 아키텍처를 선택할 수 있습니다. 크로스 플랫폼 플러그인의 경우
.bundle
파일(macOS용),
.dll
파일(Windows용),
.so
파일(Linux용)을 포함해야 합니다. Unity 타겟 플랫폼에 적합한 플러그인을 자동으로 선택하여 플레이어에 포함합니다. 자세한 내용은 플러그인 임포트 및 설정을 참조하십시오.

Plugin Inspector

C# 스크립트에서 플러그인 호출

빌드된 플러그인을 Unity 프로젝트의 Assets 폴더 또는 해당 아키텍처별 하위 디렉토리에 배치합니다. 그런 다음 Unity C# 스크립트에서 호출할 때 이름으로 이를 찾습니다. 예제는 아래와 같습니다.
참고
PluginName
값에 라이브러리 접두사 또는 파일 확장자를 포함하지 마십시오. 예를 들어 플러그인 파일의 실제 이름이 Windows의 경우
PluginName.dll
또는 Linux의 경우
libPluginName
인 경우 두 경우 모두 값이
PluginName
이어야 합니다.

플러그인 언로드

에디터 세션에 로드되면 네이티브 플러그인을 언로드할 수 없습니다. 이미 로드한 플러그인을 변경하려면 Unity 에디터 다시 시작해야 합니다.
에디터 스크립트에서 플러그인 함수 중 하나를 호출하거나 플러그인의 Load on startup 옵션이 활성화된 상태에서 플레이 모드를 시작하면 에디터가 네이티브 플러그인을 로드합니다. 스크립트를 사용하여 수동으로 로드하면 플러그인도 에디터 세션에 로드됩니다.

예제 플러그인

이 프로젝트를 다운로드하여 Unity 플러그인을 구현하는 방법을 알아볼 수 있습니다.
  • 가장 간단한 플러그인 예제: 이 프로젝트는 기본 연산(예: 숫자 출력, 문자열 출력, 두 개의 플로트 추가, 두 개의 정수 추가)을 구현합니다. 이 프로젝트에는 Windows, macOS 및 Linux 프로젝트 파일이 포함되어 있습니다.
  • 네이티브 렌더러 플러그인: 이 플러그인은 모든 일반적인 렌더링이 완료된 후 C++ 코드에서 회전하는 삼각형을 렌더링하고 C++ 코드의 절차적 텍스처를 채우고 Texture.GetNativeTexturePtr를 사용하여 액세스합니다. 이 프로젝트에는 Windows, UWP, macOS, 웹 및 Android 파일이 포함되어 있습니다.

추가 리소스