Build Automation에서의 어드레서블 빌드

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

필수 조건

Build Automation에서 어드레서블 에셋을 빌드하려면 먼저 다음을 수행해야 합니다.

  • 로컬에서 어드레서블을 사용하도록 프로젝트를 전환합니다.
  • 업데이트된 프로젝트를 선택한 Version Control System(VCS)에 커밋합니다.

빌드 구성

새 Build Automation 프로젝트를 시작하려면 먼저 새 빌드 구성을 생성해야 합니다.

  1. Unity Cloud Dashboard에 로그인합니다.
  2. DevOps > Build automation > Configurations를 선택합니다.
  3. 어드레서블을 빌드할 빌드 구성을 선택합니다.
  4. Edit를 선택합니다.
  5. Advanced settings 탭에서 Yes, build Addressables를 선택합니다.

Addressables 섹션을 사용하여 어드레서블 빌드 프로세스가 동작하는 방식을 결정하는 프로퍼티를 설정합니다. 툴팁을 통해 각 프로퍼티에 대한 세부 정보를 알 수 있습니다.

새 어드레서블 빌드 실행

새 어드레서블 빌드를 실행하려면 다음 단계를 따릅니다.

  1. DevOps > Build automation > Configurations로 이동합니다.
  2. 구성이 완료된 Addressables 설정이 있는 빌드 구성을 선택합니다.
  3. Build를 선택합니다.

자세한 내용은 빌드 수동 실행을 참고하십시오.

Cloud Content Delivery 서비스를 활성화합니다.

Build Automation에서 Cloud Content Delivery(CCD) 서비스에 어드레서블을 업로드하는 방법은 다음과 같습니다.

  1. 빌드 타겟 고급 설정에서 Addressables 섹션으로 이동합니다.
  2. Upload Addressables to the Cloud Content Delivery service를 선택합니다.
  3. Content Delivery Bucket 드롭다운에서 필요한 CCD 버킷을 선택합니다.
  4. 필드에 Content Delivery API Key가 입력되어 있지 않은 경우 API 키를 추가합니다.
  5. 선택한 버킷에서 CCD 릴리스를 자동으로 생성하려면 Automatically create a Cloud Content Delivery release from the bucket을 선택합니다.
  6. Save and build를 선택합니다.

CCD와 함께 어드레서블 사용에 대한 자세한 내용은 CCD + 어드레서블 설명을 참고하십시오.

콘텐츠 업데이트 빌드 실행

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

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

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

  1. Edit Addressables Asset Options를 선택합니다.
  2. Yes, build Addressables, Make a content-update build를 차례로 선택합니다.
  3. 다른 플레이어를 생성하려는 경우를 제외하고 Make a content-only build를 선택합니다.
  4. Build Automation에서 콘텐츠 상태 파일을 가져오는 방법을 정의하려면 콘텐츠 상태 파일 위치 메서드를 설정합니다.
    Build Automation은 다음의 방법으로 이 파일을 가져올 수 있습니다.
    • 소스 관리에서 파일을 가져오려면 경로를 지정합니다.
    • 이전에 어드레서블을 성공적으로 빌드한 기존 빌드 타겟에서 파일을 가져오려면 타겟을 지정합니다.

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

빌드 시작

빌드 타겟이 설정되어 새 어드레서블 빌드를 시작하려면 다음 단계를 따릅니다.

  1. Build Automation, Build History로 이동합니다.
  2. 어드레서블을 설정한 타겟을 빌드합니다. 빌드를 실행하는 방법에 대한 자세한 내용은 빌드 수동 실행을 참고하십시오.

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

Build Automation에서 호스팅 제공자로 어드레서블 콘텐츠 복사

어드레서블 빌드를 완료하면 Build Automation에서 호스팅 제공자로 어드레서블 콘텐츠를 복사할 수 있습니다. 콘텐츠를 수동으로 복사하거나 포스트 빌드 스크립트를 사용할 수 있습니다.

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

어드레서블 빌드를 완료하면 더보기 메뉴(⋮)에서 Download Addressables Assets를 선택합니다. 콘텐츠를 다운로드하면 콘텐츠를 로컬에서 빌드할 경우 호스팅 제공자로 업로드할 수 있습니다.

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

Build Automation은 빌드 전후에 커스텀 셸 스크립트를 실행하는 기능을 지원합니다. 빌드가 성공적으로 완료되면 어드레서블 콘텐츠를 자동으로 업로드하는 포스트 빌드 스크립트를 생성할 수 있습니다.

포스트 빌드 스크립트를 활성화하려면 다음 단계를 따릅니다.

  1. Build Automation Configurations 페이지로 이동합니다.
  2. Build Target에서 Edit Advanced Options를 선택합니다.
  3. Post-Build Script Path 필드에 스크립트 경로를 입력합니다.

스크립트를 작성할 경우 다음 정보를 고려합니다.

  • 빌드에 대한 어드레서블 콘텐츠는 $OUTPUT_DIRECTORY/extra_data/addrs에 있습니다.
  • Build Target Configurations 페이지에서 비밀 키에 대한 환경 변수를 설정할 수 있습니다.
Unity logo Documentation
Copyright © 2025 Unity Technologies
"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.