Unity Android 네이티브 플러그인 가이드
이 문서는 Unity에서 Android 플랫폼을 위한 네이티브 플러그인을 생성하고 사용하는 방법에 대한 안내입니다. 네이티브 플러그인은 C/C++로 작성된 코드로, Unity 스크립트와 원활하게 상호작용할 수 있습니다. 사용하고자 하는 플러그인 타입은 프로젝트의 스크립팅 백엔드에 따라 달라질 수 있습니다.
네이티브 플러그인 소개
Unity에서 사용할 수 있는 다양한 네이티브 플러그인 타입은 다음과 같습니다:
- 공유 라이브러리:
.so형식의 파일로 패키징된 플러그인. - 정적 라이브러리:
.a형식의 파일로 패키징된 플러그인. - C/C++ 소스 파일: Unity가 IL2CPP 생성 파일과 함께 컴파일하는 C/C++ 소스 파일입니다. 확장자는
.c,.cc,.cpp,.h입니다.
스크립팅 백엔드 호환성
아래의 표는 다양한 네이티브 플러그인 타입과 그에 대한 스크립팅 백엔드의 호환성을 보여줍니다.
| 스크립팅 백엔드 | 공유 라이브러리 | 정적 라이브러리 | C/C++ 소스 파일 |
|---|---|---|---|
| IL2CPP | 지원 | 지원 | 지원 |
| Mono | 지원 | 지원 안 함 | 지원 안 함 |
네이티브 플러그인 생성 방법
- 프로젝트 설정: Unity 프로젝트를 설정한 후, Android 플랫폼을 선택합니다.
- 플러그인 파일 생성: 네이티브 코드를
.so또는.a파일로 컴파일하거나 C/C++ 소스 파일을 준비합니다. - Unity에서 플러그인 사용: Unity 스크립트에서
DllImport를 사용하여 네이티브 함수를 호출합니다.
예제 코드 (C#)
다음은 Unity에서 네이티브 플러그인을 사용하는 간단한 예제입니다.
using System.Runtime.InteropServices;
using UnityEngine;
public class NativePluginExample : MonoBehaviour
{
[DllImport("MyNativePlugin")]
private static extern int Add(int a, int b);
void Start()
{
int result = Add(5, 3);
Debug.Log("Result from native plugin: " + result);
}
}
추가 리소스
이 문서가 Unity에서 Android용 네이티브 플러그인을 사용하는 데 도움이 되길 바랍니다!