어드레서블 에셋 빌드

어드레서블 콘텐츠 빌드 단계에서는 Unity 에디터에서 설정한 그룹 설정 및 현재 플랫폼을 기반으로 어드레서블 그룹의 에셋을 에셋 번들로 전환합니다.

모든 플레이어 빌드의 일부로 어드레서블 콘텐츠를 빌드하도록 어드레서블 시스템을 설정하거나, 플레이어 빌드를 만들기 전에 콘텐츠를 별도로 빌드할 수 있습니다. 이러한 옵션 설정에 대한 자세한 내용은 플레이어 빌드로 어드레서블 콘텐츠 빌드를 참조하십시오.

콘텐츠를 플레이어 빌드의 일부로 빌드하기 위해 Unity를 설정하는 경우, 에디터 Build Settings 창의 일반 Build 또는 Build and Run 버튼을 사용하여 빌드를 시작하십시오. Unity는 플레이어를 빌드하기 전 단계로 어드레서블 콘텐츠를 빌드합니다.

이전 버전의 Unity를 사용하거나 콘텐츠를 별도로 빌드하도록 Unity를 설정한 경우, Addressables Groups 창의 Build 메뉴를 사용하여 어드레서블 빌드를 생성해야 합니다. 다음에 프로젝트의 플레이어를 빌드할 때는 현재 플랫폼에 대해 마지막으로 실행한 어드레서블 콘텐츠 빌드에서 생성된 아티팩트를 사용합니다.

Addressables Groups 창에서 콘텐츠 빌드를 시작하려면 다음 단계를 따르십시오.

Addressables Groups 창(메뉴: Windows > Asset Management > Addressables > Groups)을 엽니다.
Build 메뉴에서 옵션을 선택합니다.
- New Build: 특정 빌드 스크립트로 빌드를 수행합니다. 커스텀 스크립트가 없으면 Default Build Script 를 사용하십시오.
- Update a Previous Build: 기존 빌드를 기반으로 업데이트를 빌드합니다. 어드레서블 시스템은 이전 빌드를 업데이트하기 위해 이전 빌드에서 생성된 addressables_content_state.bin 파일을 필요로 합니다. 이 파일은 Unity 프로젝트의 Assets/AddressableAssetsData/Platform 폴더에 있습니다. 콘텐츠 업데이트에 대한 자세한 내용은 콘텐츠 업데이트를 참조하십시오.
- Clean Build: 캐시된 빌드 파일을 삭제합니다.

기본적으로 빌드는 프로파일 설정에서 LocalBuildPath 및 RemoteBuildPath 변수에 대해 정의된 위치에 파일을 생성합니다. Unity가 플레이어 빌드에 사용하는 파일에는 에셋 번들(.bundle), 카탈로그 JSON 및 해시 파일, 설정 파일이 포함됩니다.

[!경고] 로컬 빌드 또는 로드 경로를 기본값에서 바꾸지 마십시오. 바꾼 경우 플레이어 빌드를 생성하기 전에 로컬 빌드 아티팩트를 커스텀 빌드 위치에서 프로젝트의 StreamingAssets 폴더로 복사해야 합니다. 또한 이러한 경로를 변경하면 플레이어 빌드의 일부로 어드레서블을 빌드할 수 없습니다.

RemoteBuildPath 에 빌드하는 그룹이 있는 경우 해당 에셋 번들, 카탈로그, 해시 파일을 호스팅 서버에 업로드해야 합니다. 프로젝트에서 원격 콘텐츠를 사용하지 않는 경우 모든 그룹이 로컬 빌드 및 로드 경로를 사용하도록 설정하십시오.

콘텐츠 빌드는 어드레서블이 플레이어 빌드에서 직접 사용하지 않는 다음 파일도 생성합니다.

addressables_content_state.bin: 콘텐츠 업데이트 빌드를 만드는 데 사용됩니다. 동적 콘텐츠 업데이트를 지원하는 경우 각 콘텐츠 릴리스 후에 이 파일을 저장해야 합니다. 그렇지 않은 경우에는 이 파일을 무시할 수 있습니다.
AddressablesBuildTEP.json: 빌드 성능 데이터를 로깅합니다. 자세한 내용은 빌드 프로파일링을 참조하십시오.

콘텐츠 빌드를 설정 및 수행하는 방법에 대한 자세한 내용은 어드레서블 콘텐츠 빌드를 참조하십시오.

전체 콘텐츠 빌드 시작

전체 콘텐츠 빌드를 만들려면 다음 단계를 따르십시오.

Build Settings 창에서 원하는 Platform Target 을 설정합니다.
Addressables Groups 창(메뉴: Asset Management > Addressables > Groups)을 엽니다.
Groups 창의 Build 메뉴에서 New Build > Default Build Script 커맨드를 선택합니다.

이제 빌드 프로세스가 시작됩니다.

빌드가 완료되면 플레이어 빌드를 수행하고 RemoteBuildPath 의 원격 파일을 호스팅 서버에 업로드할 수 있습니다.

[!중요] 애플리케이션을 다시 빌드하지 않고 원격 콘텐츠 업데이트를 퍼블리시하려는 경우, 퍼블리시된 각 빌드에 대해 addressables_content_state.bin 파일을 보존해야 합니다. 이 파일이 없으면 업데이트가 아닌 전체 콘텐츠 빌드 및 플레이어 빌드만 생성할 수 있습니다. 자세한 내용은 콘텐츠 업데이트 빌드를 참조하십시오.