콘텐츠 업데이트 빌드

콘텐츠 업데이트를 빌드하려면 Update a Previous Build 스크립트를 실행하십시오.

  1. Update a Previous Build를 통해 자동으로 검사를 실행하지 않으려면 Check for Content Update Restrictions 툴을 실행합니다.
  2. Unity 에디터에서 Addressables Groups 창을 엽니다(Window > Asset Management > Addressables > Groups).
  3. 툴바의 Build 메뉴에서 Update a Previous Build 스크립트를 실행합니다.

빌드는 콘텐츠 카탈로그, 해시 파일 및 에셋 번들을 생성합니다.

생성된 콘텐츠 카탈로그는 원래 애플리케이션 빌드의 카탈로그와 동일한 이름을 사용하며, 이전 카탈로그 및 해시 파일을 덮어씁니다. 애플리케이션은 런타임에 해시 파일을 로드하여 새 카탈로그를 사용할 수 있는지 여부를 결정합니다. 시스템은 애플리케이션과 함께 제공되었거나 애플리케이션이 이미 다운로드한 기존 번들에서 수정되지 않은 에셋을 로드합니다.

시스템은 addressables_content_state.bin 파일의 콘텐츠 버전 문자열과 위치 정보를 사용하여 에셋 번들을 생성합니다. 업데이트된 콘텐츠가 포함되지 않은 에셋 번들은 업데이트를 위해 선택한 빌드와 동일한 파일 이름을 사용하여 작성됩니다. 에셋 번들에 업데이트된 콘텐츠가 포함된 경우, 업데이트된 콘텐츠가 포함된 새 번들이 새 파일 이름으로 생성되어 콘텐츠 호스팅 서비스에서 원본과 공존할 수 있도록 처리됩니다. 모든 에셋 번들을 안전하게 업로드할 수 있더라도, 새 파일 이름을 갖는 에셋 번들만 콘텐츠를 호스팅하는 위치에 복사해야 합니다.

시스템에서는 로컬 에셋 번들과 같이 변경할 수 없는 콘텐츠에 대한 에셋 번들도 빌드하지만, 어드레서블 에셋 엔트리가 참조하지 않으므로 콘텐츠 호스팅 위치에 업로드할 필요는 없습니다.

새 플레이어를 빌드하는 작업과 플레이어 코드 또는 어드레서블과 같은 콘텐츠를 업데이트하는 작업 사이에 빌드 스크립트를 변경해서는 안 됩니다. 이렇게 하면 애플리케이션에서 예기치 않은 동작이 발생할 수 있습니다.

또한 어드레서블 빌드에서 생성한 로컬 콘텐츠 번들을 Project Library 폴더에서 삭제하면, Unity 에디터에서 게임 또는 애플리케이션을 실행하고 Use Existing Build (requires built groups) 플레이 모드 스크립트를 사용할 때 해당 번들에 있는 에셋을 로드하려는 시도가 실패합니다.

Check for Content Update Restrictions 툴

Check for Content Update Restrictions 툴은 콘텐츠 업데이트 빌드를 위해 그룹 조직을 준비합니다. 이 툴은 addressables_content_state.bin 파일 및 그룹 설정을 검사합니다.

그룹의 Update Restrictions 옵션이 이전 빌드에서 Prevent Updates 로 설정된 경우, 이 툴은 변경된 에셋을 새 원격 그룹으로 옮길 수 있는 옵션을 제공합니다. 특별한 이유가 없다면 제안된 변경 사항을 적용하거나 이러한 에셋에 대한 변경 사항을 되돌리십시오.

업데이트 빌드를 생성하면 새 카탈로그는 변경된 에셋을 새로운 원격 에셋 번들에 매핑하고 변경되지 않은 에셋은 원래 에셋 번들에 계속 매핑합니다. Checking for content update restrictions 툴은 Prevent Updates 가 비활성화된 그룹은 확인되지 않습니다.

툴을 실행하려면 다음을 따르십시오.

  1. Unity 에디터에서 Addressables Groups 창을 엽니다(Window > Asset Management > Addressables > Groups).
  2. Groups 창에서 툴바 Tools 메뉴를 통해 Check for Content Update Restrictions 를 실행합니다.
  3. 원하는 경우 툴에서 수행한 그룹 변경 사항을 검토합니다. 툴이 생성한 새 원격 그룹의 이름을 변경할 수 있지만, 에셋을 다른 그룹으로 옮기면 의도하지 않은 결과가 발생할 수 있습니다.

[!중요] Check for Content Update Restrictions 툴을 실행하기 전에 버전 관리 시스템으로 브랜치를 만드십시오. 이 툴은 콘텐츠 업데이트에 적합한 방식으로 에셋 그룹을 재정렬합니다. 브랜치를 생성하면 다음에 전체 플레이어 빌드를 출시할 때 원하는 콘텐츠 배열로 돌아갈 수 있습니다.