Files
MagnetismHeroes/Assets/MagnetismHeroes/Editor/AGENTS.md
T

2.1 KiB

Unity 제작과 Android 빌드

이 Editor 전용 어셈블리는 자산 생성·연결·표현 증거와 Android 빌드를 소유한다. 게임의 런타임 규칙·이어하기 파일·사용자 청취 승인은 소유하지 않는다. 런타임이 이 어셈블리를 참조하지 않게 유지한다.

현재 완성 Main 씬은 Assets/MagnetismHeroes/Scenes/Main.unity다. 초기 Prepare/ConnectApp 및 단계별 Assets.Build는 기존 씬·프리팹·스테이지·음성 참조를 덮을 수 있으므로 일반 실행 전 준비 명령으로 사용하지 않는다. 특정 제작 수정의 대상·기존 참조·생성 diff를 확인하고 필요한 경로만 갱신한다.

씬·프리팹·ScriptableObject·메타데이터는 Editor API로 만들고 Undo/dirty/save 및 필수 참조를 처리한다. URP의 임시 생성 설정 변화는 원본과 정확히 일치하는 알려진 변환인지 확인한 경우만 정리한다. 모델 root 회전·아치 구멍의 MeshCollider·TMP static glyph와 승인 WAV GUID를 보존한다.

Android 빌드는 Main만 포함하고 ARM64 IL2CPP release APK를 만든다. 출력 경로는 MAGNETISM_APK_PATH를 사용한다. 개발 모델 가중치·제작 캐시·QA 녹음 도구를 포함하지 않는다. 승인 메시에서 파생한 읽기 전용 복원 형상은 필요한 런타임 판정 자산이므로 이 제외 대상과 구분한다. 빌드 수정은 실제 AndroidBuild와 APK inspection, 표현·연결 변경은 Edit/Play와 실제 화면으로 검증한다. 파일 생성 성공을 설치·재생 성공으로 기록하지 않는다.

풍경 변경은 PlaygroundSceneryAssets의 대상 한정 경로로 지면·충돌 역할·30개 고정 배치만 갱신한다. 실제 import root를 보존하고 메시 바닥·접근 가능한 표면으로 접지한다. PlaygroundRestoreGeometryAssets는 승인 메시의 읽기 전용 정점·삼각형과 원본·meta 해시를 추출하며 기존 캐시의 자동 재생성을 거부한다. 초기 구·목표·기존 GUID와 승인 파일 보존, 모든 초기 구의 실제 첫 hit 선택·끌기, 두 가로 비율의 화면을 검증한다.