Unity6, 어드레서블(Addressables) 2.2.2 원격 업데이트 애러 이슈

유니티6 마이그레이션 이후

유니티6로 마이그레이션을 하면서 어드레서블 패키지도 자연스럽게 최신 버전으로 올려졌으나, 원격 리소스를 업데이트 받는 로직이 작동이 정상적으로 되지 않았습니다. 이를 해결하기 위해 알아보니 2.2.2 버전을 기준으로 원격 리소스 접근할 때 판단하는 CanUpdateContent 프로퍼티 변수가 잘못 작성되었고, 이를 배포를 했다고 하네요. 현재 기준으로는 언제 새로운 버전이 나올지 모르는 상태라고 합니다.

스크립트

아래와 같이 패키지 캐싱이 되어있는 위치로 이동하여 Addressables.cs를 수정해주어야합니다.

{your_project_name}\Library\PackageCache\com.unity.addressables@4f7e840f4cce\Runtime\Addressables.cs

CanUpdateContent 프로퍼티 판단 조건 중에 "CatalogLocation.Dependencies.Count == 2"로 되어있는 부분을 "CatalogLocation.Dependencies.Count == 3"으로 수정해주어야합니다.

 

수정 전

74번째 라인
.. <중략> ..

        /// <summary>
        /// Checks to see if the provided CatalogLocation contains the expected amount of dependencies to check for catalog updates
        /// </summary>
        public bool CanUpdateContent
        {
            get { return !string.IsNullOrEmpty(LocalHash) && CatalogLocation != null && CatalogLocation.HasDependencies && CatalogLocation.Dependencies.Count == 2; }
        }

.. <중략> ..

 

수정 후

74번째 라인
.. <중략> ..

        /// <summary>
        /// Checks to see if the provided CatalogLocation contains the expected amount of dependencies to check for catalog updates
        /// </summary>
        public bool CanUpdateContent
        {
            get { return !string.IsNullOrEmpty(LocalHash) && CatalogLocation != null && CatalogLocation.HasDependencies && CatalogLocation.Dependencies.Count == 3; }
        }

.. <중략> ..

자동화

저의 경우 하나의 프로젝트를 플랫폼 별로 프로젝트 폴더를 만들어서 여러 분할하여 프로젝트 폴더 여러 있습니다. CI/CD(빌드 파이프라인 시스템)를 통해서 그렇기에 이를 자동으로 처리해주는 작업이 필요하여 아래와 같은 코드를 작성했습니다.

 

AddressablesFixer.cs를 생성하여 Editor 폴더 안에 넣어두고 사용하면 되겠습니다.

using System.IO;
using UnityEngine;
using UnityEditor;
using UnityEditor.Build;
using UnityEditor.Build.Reporting;

/// <summary>
/// 어드레서블 원격 컨텐츠 업데이트 처리하는 로직 버그 수정 업데이트
/// 참고: https://discussions.unity.com/t/addressable-checkforcatalogupdates-does-not-work/1516925/13
/// </summary>
[InitializeOnLoad]
public class AddressablesFixer : IPreprocessBuildWithReport
{
    public int callbackOrder => 0;

    private static string DEST_PATH = Path.Combine("Library", "PackageCache", "com.unity.addressables@4f7e840f4cce", "Runtime", "Addressables.cs");
    private static string FIX_TARGET = "CatalogLocation.Dependencies.Count == 2";
    private static string FIX_CONTEXT = "CatalogLocation.Dependencies.Count == 3";

    /// <summary>
    /// 에디터 실행 시 호출하여 자동 갱신
    /// </summary>
    static AddressablesFixer()
    {
        FixFile();
    }

    /// <summary>
    /// 빌드 시작 전 자동 갱신
    /// </summary>
    /// <param name="report"></param>
    public void OnPreprocessBuild(BuildReport report)
    {
        FixFile();
    }

    /// <summary>
    /// 메뉴를 통한 직접 갱신
    /// </summary>
    [MenuItem("Addressables/AddressablesFixer")]
    public static void Menu()
    {
        FixFile();
    }

    /// <summary>
    /// 파일 수정
    /// </summary>
    private static void FixFile()
    {
        if (File.Exists(DEST_PATH))
        {
            string context = File.ReadAllText(DEST_PATH);
            context = context.Replace(FIX_TARGET, FIX_CONTEXT);
            AssetDatabase.Refresh();
            Debug.Log("Addressables.cs 파일 교체 완료");
        }
    }
}

 

1. 에디터 실행 시, 갱신
2. 빌드 시, 갱신
3. 메뉴 아이템을 통한 직접 갱신

직접 메뉴 아이템 실행 가능하지만, 빌드 기준으로는 자동 갱신되도록 작성되었습니다. (파일만 추가하세요.😉)

마무리

유니티6가 아직까지는 안정화 되지 않아서 그런지 생각보다 알려지지 않은 이슈인 것 같습니다. 어드레서블 시스템을 사용하는데 있어서 원격지의 리소스를 못 읽어오는 부분은 엄청 치명적이어서 당황했네요. 다른 분들에게도 도움되길 바라며 작성해봅니다.

---

참고 : https://discussions.unity.com/t/addressable-checkforcatalogupdates-does-not-work/1516925/12