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

> Follow this workflow to build Addressable Assets.

[어드레서블 에셋](https://docs.unity3d.com/Packages/com.unity.addressables@latest)은 로컬이나 원격 AssetBundles에서 로드하는 데 사용할 수 있는 고유한 주소가 있는 에셋입니다.

## 필수 조건##prerequisites

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

* 로컬에서 어드레서블을 사용하도록 프로젝트를 전환합니다.
  * [Addressables 패키지](https://docs.unity3d.com/Packages/com.unity.addressables@latest?subfolder=/manual/AddressableAssetsGettingStarted.html)를 설치합니다.
  * 에셋을 어드레서블로 설정합니다.
* 업데이트된 프로젝트를 선택한 Version Control System(VCS)에 커밋합니다.

## 빌드 구성##build-configuration

새 Build Automation 프로젝트를 시작하려면 먼저 [새 빌드 구성을 생성](../basic-build-configuration/overview)해야 합니다.

1. [Unity Dashboard](https://cloud.unity.com)에 로그인합니다.
2. **DevOps** > **Build automation** > **Configurations**를 선택합니다.
3. 어드레서블을 빌드할 빌드 구성을 선택합니다.
4. **Edit**를 선택합니다.
5. **Advanced settings** 탭에서 **Yes, build Addressables**를 선택합니다.

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

### 새 어드레서블 빌드 실행##run-a-new-addressables-build

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

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

자세한 내용은 [빌드 수동 실행](../run-builds/run-builds-manually)을 참고하십시오.

### Cloud Content Delivery 서비스를 활성화합니다##enable-cloud-content-delivery-service

Build Automation에서 [Cloud Content Delivery](/ccd/.md)(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 + 어드레서블 설명](/ccd/use-addressables-with-ccd.md)을 참고하십시오.

### 콘텐츠 업데이트 빌드 실행##run-a-content-update-build

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

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

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

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은 선택한 빌드 타겟에서 생성한 최신 콘텐츠 상태 파일을 자동으로 사용할 수 있습니다.

## 빌드 시작##start-a-build

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

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

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

## Build Automation에서 호스팅 제공자로 어드레서블 콘텐츠 복사##copy-addressables-content-from-build-automation-to-your-hosting-provider

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

### 어드레서블 콘텐츠를 수동으로 복사##copy-addressables-content-manually

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

### 포스트 빌드 스크립트를 사용하여 어드레서블 콘텐츠 복사##copy-addressables-content-with-a-post-build-script

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** 페이지에서 비밀 키에 대한 환경 변수를 설정할 수 있습니다.