[UE5] API매크로 / DLL import/export매크로

API매크로 / DLL import/export매크로

class MYPROJECT_API UPluginSubsystem : public UGameInstanceSubsystem
{
	GENERATED_BODY()
	
public:

	
};

위 코드를 보면 클래스 이름에 API가 붙은 대문자 단어가 보이는데 이를 API매크로 혹은 DLL import/export매크로 라고 한다.

이는 언리얼 엔진의 모듈 시스템에서 DLL(동적 라이브러리) 경계를 관리하기 위한 매크로이다.

이 매크로는 다른 클래스, 함수 또는 변수에서 해당 모듈을 참조하여 사용할 수 있도록 한다.

클래스, 구조체 등의 이름 앞에 붙여서 링커가 이 모듈을 찾을 수 있도록 해준다.

알게된 계기

플러그인을 만들어서 이 플러그인을 게임 인스턴스 서브시스템에 래핑을 시켜보던 중에 게임 인스턴스 서브시스템 클래스에서 플러그인 헤더 파일을 도저히 찾질 못해서 찾아보던 중에 알게 되었다.

클래스 앞에 API를 붙이지 않으면 언리얼 엔진에서는 다른 클래스 혹은 모듈에서 해당 모듈을 찾지 못 해 include할 수 없게 된다는 걸 알게 되었다.