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

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

선행 조건

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

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

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

빌드 타겟 설정

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

1. 클라우드 빌드 대시보드에서 프로젝트에 대한 빌드 타겟 Config 페이지로 이동합니다.
2. 어드레서블을 빌드하려면 빌드 타겟에서 Addressable Assets Options 메뉴를 확장합니다.
3. Edit Addressable Asset Options를 클릭합니다.

Addressables Options 페이지를 사용하여 어드레서블 빌드 프로세스의 동작을 결정하는 프로퍼티를 설정할 수 있습니다. 각 프로퍼티는 툴팁에 자세히 설명되어 있습니다.

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

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

1. Edit Addressables Asset Options를 클릭합니다.
2. Build Addressables를 활성화합니다.
3. 타겟 설정을 저장합니다.
4. 타겟을 빌드합니다.

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

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

1. Edit Addressables Asset Options를 클릭합니다.
2. Content Delivery Upload를 활성화하여 어드레서블을 CCD에 업로드합니다.
3. Content Delivery Bucket 드롭다운에서 필요한 CCD 버킷을 선택합니다.
4. Content Delivery API Key가 해당 필드에 이미 채워져 있습니다. 그렇지 않다면 추가합니다.
5. 선택된 버킷에서 CCD 릴리스가 자동으로 생성되도록 설정하려면 Content Delivery Create Release를 활성화합니다.
6. 타겟 설정을 저장합니다.
7. 타겟을 빌드합니다.

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

콘텐츠 업데이트 빌드 실행

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

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

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

1. Edit Addressables Asset Options를 클릭합니다.
2. Build Addressables과 Content Update Build를 활성화합니다.
3. Content Only Build를 활성화합니다(다른 플레이어를 생성하지 않으려는 경우).
4. Content State Location Method를 설정하여 클라우드 빌드가 콘텐츠 상태 파일을 가져오는 방식을 정의합니다.
   클라우드 빌드는 다음의 방식으로 이 파일을 가져올 수 있습니다.
   • 소스 컨트롤에서 가져옵니다. 이 경우 경로를 지정해야 합니다.
   • 이전에 어드레서블을 성공적으로 빌드한 기존 빌드 타겟에서 가져옵니다. 이 경우 타겟을 지정해야 합니다.

클라우드 빌드는 선택한 빌드 타겟에서 생성된 최신 콘텐츠 상태 파일을 자동으로 사용할 수 있습니다.

빌드 시작

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

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

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

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

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

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

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

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

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

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

1. 클라우드 빌드 Config 페이지로 이동합니다.
2. 빌드 타겟에서 Edit Advanced Options를 선택합니다.
3. Post-Build Script Path 필드에 스크립트 경로를 입력합니다.

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

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

• 빌드 타겟 Config 페이지에서 비밀 키에 대한 환경 변수를 설정할 수 있습니다.