16강. 프로젝트 플러그인과 Engine 플러그인의 차이

?1. 이번 강의에서 해결할 문제

재사용한다는 이유로 개발 중인 플러그인을 Engine 설치 폴더에 넣으면 프로젝트 Git에 포함되지 않고 팀원마다 다른 버전이 로드됩니다. Engine 업데이트나 재설치 때 파일이 사라지며, 관리자 권한과 공용 설치의 변경 위험도 커집니다.

✓2. 학습 목표

✓이 강의를 마치면

• Project Plugin과 Engine Plugin의 검색 경로와 소유권을 비교합니다.
• 개발·검증 단계에서는 Project Plugin을 기본 선택합니다.
• 여러 프로젝트 배포 시 복사·패키지·별도 저장소 전략을 구분합니다.

◇3. 핵심 개념

Project Plugin은 <Project>/Plugins/<PluginName>/에 있고 해당 프로젝트의 버전 관리·빌드와 함께 움직입니다. Engine Plugin은 <Engine>/Engine/Plugins/ 아래에서 여러 프로젝트가 발견할 수 있지만 Engine 설치와 운영 정책에 결합됩니다.

재사용 가능성과 설치 범위는 다릅니다. Project Plugin도 다른 프로젝트에 복사·패키징할 수 있으며, 오히려 원본과 소비 프로젝트가 어떤 버전을 사용하는지 명시하기 쉽습니다.

✎4. 단계별 실습

기준	Project Plugin	Engine Plugin
Git 추적	프로젝트와 함께 명확	Engine 설치와 분리 필요
팀 버전 고정	Commit으로 고정	별도 배포 정책 필요
Engine 업데이트	프로젝트별 이식 검증	설치 전체 영향
개발 중 수정	안전한 기본값	공용 설치 오염 위험

이번 과정의 두 Plugin은 모두 Project Plugin으로 개발합니다.

ArchitectureLab/Plugins/ReusableInteraction/
ArchitectureLab/Plugins/DataGuard/
MigrationProbe/Plugins/ReusableInteraction/
MigrationProbe/Plugins/DataGuard/

최종 이식은 원본 프로젝트의 Binaries, Intermediate, Saved를 복사하지 않고 Source·Descriptor·Config·필요한 Content·Resources만 전달합니다. Precompiled Binary 배포는 대상 Engine Minor·Platform·Configuration 호환 정책을 별도로 요구합니다.

→5. 코드가 동작하는 이유

PluginManager는 Engine과 Project Plugin 검색 경로에서 Descriptor를 발견합니다. Project 위치는 기능이 덜 재사용 가능하다는 뜻이 아니라 해당 프로젝트가 Plugin 버전을 소유한다는 뜻입니다. 별도 저장소나 패키지 관리 전략은 조직 규모에 따라 추가할 수 있습니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• 개발 중 Engine 폴더 직접 수정: Project Plugin에서 검증하고 배포 절차로 승격합니다.
• Engine Plugin을 Git에 자동 포함된다고 생각: 별도의 소스·버전 배포 위치를 정합니다.
• Binaries만 여러 Engine에 복사: Source 재빌드 또는 명시적 Precompile 호환 범위를 사용합니다.
• 같은 이름 Plugin을 두 위치에 둠: 실제 선택 경로를 로그로 확인하고 중복 설치를 제거합니다.

✎7. 직접 실습

✎직접 실습

Plugin 설치 위치, 소유 저장소, 업데이트 담당자, 지원 Engine 버전과 롤백 방법을 한 페이지로 정리하세요. 두 Plugin을 Project Plugins에 두고 IPluginManager BaseDir 로그가 예상 경로인지 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Project Plugin도 재사용 가능한 패키지가 될 수 있는 이유는 무엇인가요?
2. 개발 중 Engine Plugin 위치를 피하는 운영상 이유는 무엇인가요?
3. Source와 Precompiled Binary 배포는 어떤 호환성 책임이 다른가요?

■9. 핵심 요약

■핵심 요약

Plugin 위치는 기능의 품질보다 발견 범위와 버전 소유권을 정합니다. 개발과 이식 검증은 Project Plugin으로 시작하고 Engine-wide 설치는 별도 운영 정책이 있을 때 선택합니다. 다음 강의에서 첫 Project Runtime Plugin을 생성합니다.