코드 스트리핑이 콘텐츠에 미치는 영향
관리되는 코드 스트리핑 구성이 콘텐츠 빌드에 어떤 영향을 줄지, 그리고 콘텐츠가 의존하는 코드를 어떻게 보존하는지 파악합니다.
읽는 시간 3분최근 업데이트: 9일 전
Unity에서 플레이어를 빌드할 때 사용되지 않는 타입을 제거하여 어셈블리의 크기를 줄이기 위해 UnityLinker 프로세스가 실행됩니다. 이 프로세스는 다음을 스트리핑할 수 있습니다.
- 전체 C# Unity 객체(예: 및
MonoBehaviour인스턴스) Unity는 이러한 요소를ScriptableObject및UnityEngine.dll와 같은 Unity 코어 어셈블리에서 제거할 수 있지만, 해당 어셈블리가 사용된 것으로 표시되면 커스텀 어셈블리에서 보존합니다.Unity.dll - 일반 C# 구조 및 클래스
- 클래스의 일부(예: 사용되지 않는 메서드)
- 해당 모듈의 유형이 참조되지 않은 경우 AI 또는 물리와 같은 전체 Unity 모듈입니다.
코드 스트리핑이 콘텐츠에 미치는 영향은 플레이어에 null 참조 예외, 누락된 유형 오류 또는 크래시로 표시됩니다. 또한 에셋 번들 또는 Addressables 콘텐츠 전용 빌드는 플레이어 빌드에서 제거된 타입을 사용할 수 없습니다.
빌드 보고 인스펙터의 스트리핑 탭을 사용하여 플레이어 빌드에서 보존된 모듈과 타입을 검사할 수 있습니다.
다음과 같은 상황에서 링커가 코드 스트리핑을 방지할 수 있습니다.
에셋 번들에 사용되는 타입의 코드 스트리핑 방지
Unity 에셋 번들에 있는 Unity 오브젝트 타입을 스트리핑할 수 있지만, 플레이어 빌드에 포함된 씬이나 에셋에는 스트리핑할 수 없습니다. 즉, 에셋 번들의 콘텐츠는 플레이 모드에서 테스트하거나 코드 스트리핑이 최소화된 빌드에서 작동할 수 있지만, 코드 스트리핑이 활성화된 플레이어에서 오류나 크래시가 발생합니다.
이를 해결하기 위해 다음과 같이 에셋 번들의 매니페스트 파일을 직접 포함하는 커스텀 빌드 스크립트를 생성할 수 있습니다.
- 플레이어를 빌드하기 전에 에셋 번들을 빌드합니다. 출력 폴더에는 각 에셋 번들에 대한 하나의 파일과 출력 폴더와 동일한 이름의 루트
.manifest파일이 포함되어 있습니다..manifest - 루트 파일의 경로를
.manifestAPI를 사용하여 플레이어 빌드 프로세스에 전달합니다.BuildPipeline.BuildPlayer
자세한 내용은 에셋 번들 파일 포맷 참조 및 를 참조하십시오.
BuildPlayerOptions.assetBundleManifestPath또한 프로젝트에서 Preserve 속성을 사용하거나 수동으로 파일을 작성하여 코드 스트리핑 동작에 더 많은 영향을 줄 수 있습니다.
link.xmlAddressables 사용되는 타입의 스트리핑 방지
Unity 오브젝트 타입이 Adressables로 빌드된 콘텐츠에 있지만 플레이어에 내장된 씬이나 에셋에는 없는 경우 Unity가 해당 타입을 제거할 수 있습니다.
Addressables는 콘텐츠에 사용되는 유형을 설명하는 폴더 안에 자동으로 파일을 생성합니다. 플레이어 빌드는 이 파일을 고려합니다. Addressables 콘텐츠가 플레이어 빌드 이전 또는 동시에 빌드되었는지 여부입니다.
Library/com.unity.addressableslink.xmllink.xml또한 프로젝트에서 Preserve 속성을 사용하거나 수동으로 파일을 작성하여 코드 스트리핑 동작에 더 많은 영향을 줄 수 있습니다.
link.xml모듈 스트리핑 방지
link.xmlAddressables 빌드에서 모듈의 타입을 사용해야 하는 경우 해당 모듈을 참조하는 콘텐츠가 플레이어 빌드에 포함되어 있는지 확인합니다. 예를 들어 물리 모듈을 유지하려면 빌드에 포함된 씬의 게임 오브젝트에 리지드바디 또는 콜라이더와 같은 컴포넌트를 추가하십시오. 그러면 플레이어 빌드 프로세스가 인식하고 모듈을 보존하는 종속성이 생성됩니다.
스크립트 전용 빌드
플레이어 빌드는 폴더 내부의 파일에 사용된 유형을 기록하며, 이를 통해 코드 스트리핑 문제를 진단할 수 있습니다. 이 파일은 이전 플레이어 빌드의 콘텐츠를 재사용할 수 있는 증분 빌드 파이프라인을 지원하는 데 사용됩니다. 이 경우 플레이어 빌드는 해당 파일의 캐시된 유형 사용을 Unity linker로 전달합니다.
Library/PlayerDataCacheScriptsOnlyCache.yaml