Unity 클라우드 빌드에서 어드레서블 사용

어드레서블 에셋은 로컬이나 원격 에셋 번들에서 에셋을 로드하는 데 사용할 수 있는 고유한 주소를 가진 에셋입니다.

선행 조건

클라우드 빌드에서 어드레서블 에셋을 빌드하려면 다음을 수행해야 합니다.

• 로컬에서 어드레서블을 사용하도록 프로젝트를 전환
• 어드레서블 패키지를 설치합니다.
• 에셋을 어드레서블로 설정
• 업데이트된 프로젝트를 선택된 버전 관리 시스템(VCS)에 커밋

Unity는 클라우드 빌드에서 빌드하기 전에 로컬에서 어드레서블을 사용하는 작업에 익숙해질 것을 권장합니다.

빌드 타겟 설정

완전히 새로운 클라우드 빌드 프로젝트에서 시작하는 경우 먼저 새로운 빌드 타겟을 생성해야 합니다.

1. From the Cloud Build Dashboard, navigate to the build target Configurations page for your project.
2. Go to the build target that you’d like to build Addressables for.
3. On the build target’s advanced settings, edit the Addressables section.

Use the Addressables section to configure properties that determine how the Addressables build process behaves. Each property is described in more detail with a tooltip.

새로운 어드레서블 빌드 실행

새로운 어드레서블 빌드를 실행하려면 다음 단계를 따르십시오.

1. Enable Build Addressables.
2. Click the Save changes button.
3. Build the Target.

클라우드 콘텐츠 제공 서비스 활성화

어드레서블을 클라우드 빌드의 클라우드 콘텐츠 딜리버리 (CCD) 서비스에 업로드하려면 다음을 수행합니다.

1. Go to the build target that you’d like to build Addressables for.
2. On the build target’s advanced settings, edit the Addressables section.
3. Enable Upload Addressables to the Cloud Content Delivery service to upload Addressables to CCD.
4. Choose the required CCD bucket in the Content Delivery Bucket drop-down.
5. Your Content Delivery API Key should already be populated in its field. If not, add it.
6. Enable Automatically create a Cloud Content Delivery release from the bucket if you want to automatically create a CCD release from the selected bucket.
7. Click the Save changes button.
8. Build the Target.

CCD가 있는 어드레서블을 사용하는 데 대한 자세한 내용은 CCD가 있는 어드레서블 에셋 시스템을 참조하십시오.

콘텐츠 업데이트 빌드 실행

콘텐츠 업데이트 빌드는 이전에 빌드한 플레이어를 새로운 어드레서블 콘텐츠로 업데이트합니다.

기존 플레이어를 업데이트하려면 업데이트 빌드에 콘텐츠 상태 파일이 있어야 합니다. 이 파일은 업데이트 빌드의 콘텐츠를 기존 플레이어와 연결합니다. 콘텐츠 상태 파일은 새로운 어드레서블 빌드로 작업할 때 생성됩니다.

이전에 빌드한 플레이어를 새로운 어드레서블 에셋으로 업데이트하려면 다음 단계를 따르십시오.

1. On the build target’s advanced settings, edit the Asset bundles section.
2. Enable Make a content-only build.
3. Click the Save changes button.

빌드 시작

빌드 타겟이 설정되면 새 어드레서블 빌드를 시작하기 위해 다음 단계를 따르십시오.

1. 대시보드의 Build History 페이지로 이동합니다.
2. 어드레서블을 설정한 타겟을 빌드합니다.

새 빌드가 성공적으로 완성되면 빌드에 대한 More 메뉴(⋮)에 Download Addressable Assets 옵션이 표시됩니다.

클라우드 빌드에서 호스팅 공급자로 어드레서블 콘텐츠 복사

어드레서블 빌드를 완성하면 클라우드 빌드에서 호스팅 공급자로 어드레서블 콘텐츠를 복사할 수 있습니다. 이 작업은 수동으로 또는 포스트 빌드 스크립트를 사용하여 수행할 수 있습니다.

어드레서블 콘텐츠를 수동으로 복사

어드레서블 빌드를 완성하면 More 메뉴(⋮)에서 Download Addressables Assets를 선택하십시오. 콘텐츠를 다운로드하면 콘텐츠를 다운로드하면 일반적으로 로컬에서 빌드할 때처럼 호스팅 공급자에 업로드할 수 있습니다.

포스트 빌드 스크립트를 사용하여 어드레서블 콘텐츠 복사

클라우드 빌드는 빌드 전후의 커스텀 셸 스크립트 실행을 지원합니다. 포스트 빌드 스크립트를 사용하면 빌드가 성공적으로 완성될 때 어드레서블 콘텐츠를 자동으로 업로드할 수 있습니다.

포스트 빌드 스크립트를 활성화하려면 다음 단계를 따르십시오.

1. Go to the Cloud Build Configurations page.
2. On your build target’s advanced settings, in the Script hooks section,
3. In the Post-Build Script field, enter the path to your script.

다음 팁은 스크립트를 작성할 때 유용할 수 있습니다.

• 빌드에 대한 어드레서블 콘텐츠는 $WORKSPACE/.build/last/<BUILD_TARGET_ID>/extra_data/addrs/에 있습니다.

• You can set environment variables for secret keys in the Build Target Configurations page.

---