기술 자료

Unity 엔진

Unity 엔진

Unity 플러그인으로 정적 라이브러리 컴파일

정적 라이브러리에서 함수를 호출합니다.
읽는 시간 2분최근 업데이트: 9일 전

Emscripten을 사용하여 라이브러리를 컴파일하고 Unity 라이브러리를 사용할 수 있습니다. 플러그인 디렉토리에서 직접 C++ 코드가 아닌 C++ 코드를 캡슐화하는 라이브러리에서 함수를 호출하는 것이 더 유용할 수 있습니다. 이 장점은 다음과 같습니다.
  • 코드를 Web Unity 프로젝트 더 쉽게 연동할 수 있습니다.
  • 특히 대형 라이브러리에서는 코드가 C++ 코드에서 함수를 호출하는 것보다 더 나은 성능을 낼 수 있습니다.
  • 다양한 프로젝트에서 코드를 재사용할 수 있습니다.

Unity 정적 라이브러리를 사용하는 단계

Unity 플러그인으로 사용할 수 있는 정적 라이브러리를 컴파일하려면 다음 단계를 따르십시오.
  1. Emscripten SDK 다운로드
  2. 기존 프로젝트 스크립트 구성
  3. 컴파일러 옵션 업데이트
  4. 정적 라이브러리 파일 컴파일 및 가져오기
  5. C# 스크립트에서 정적 라이브러리 함수 호출

1. Emscripten SDK 다운로드

Unity 버전과 일치하는 Emscripten SDK를 다운로드해야 합니다.
Unity 버전에 적합한 Emscripten 버전을 찾으려면 Emscripten용 웹 네이티브 플러그인을 참조하십시오.
Emscripten SDK를 설치하는 방법에 대한 다운로드 링크와 자세한 내용은 다운로드 및 설치(Emscripten)를 참조하십시오.

2. 기존 프로젝트 스크립트 구성

Emscripten은 gcc 또는 clang 컴파일러를 대체하는 역할을 합니다. 기존 C/C++ 코드가 있는 경우 C++ 프로젝트를 다음과 같이 변경해야 합니다.
  • C/C++ 컴파일러로 "emcc" 사용
  • 정적 링커로 "emar" 사용
자세한 내용은 Emscripten의 프로젝트 컴파일 및 실행 기술 자료를 참조하십시오.

3. 컴파일러 옵션 업데이트

Unity 프로젝트에 다음의 플레이어 설정이 있는 경우 C/C++ 프로젝트에 컴파일러 옵션을 추가해야 할 수 있습니다(메뉴: Edit >
프로젝트 설정

?

> Player).

프로퍼티

설명

예외 사용이 프로퍼티가 없음으로 설정된 경우 컴파일러 옵션 "-fno-exceptions"를 추가합니다.
네이티브 C/C++ 멀티스레드 활성화이 프로퍼티가 활성화된 경우 컴파일러 옵션 ‘-pthread’를 포함합니다.
WebAssembly 2023 활성화이 프로퍼티가 활성화된 경우 다음 컴파일러 옵션을 포함합니다.
  • "-fwasm-exceptions"
  • "-sSUPPORT_LONGJMP=wasm"
  • "-mbulk-memory"
  • "-mnontrapping-fptoint"
  • "-msimd128"
  • "-msse4.2"

4. 정적 라이브러리 파일 컴파일 및 임포트

정적 라이브러리 파일을 컴파일한 다음
Assets/Plugins
폴더의 Unity 프로젝트로 파일을 임포트합니다.
참고
Plugins 폴더가 없는 경우 자체 폴더를 생성해야 합니다.

5. Unity C# 스크립트에서 정적 라이브러리 함수 호출

Unity C# 스크립트에서 정적 라이브러리 함수를 호출할 수 있습니다. 함수를 호출하는 방법은 C# 스크립트에서 C 또는 C++ 함수를 호출하는 것과 동일합니다. 예를 들어 Unity C# 스크립트에서 C/C++/C# 함수 호출을 참고하십시오.

추가 리소스