유니티 에디터 안드로이드 Maven Central 마이그레이션 가이드

Unity와 아이언소스 합병 절차의 일환으로, 안드로이드용 유니티 레벨플레이 SDK 안드로이드 버전 및 지원 광고 네트워크 어댑터들, 그리고 Ad Quality SDK 안드로이드 버전들의 저장소가 IS.com에서 Maven Central로 변경될 예정입니다.

유니티 레벨플레이를 연동한 made-with-Unity 개발자들은, 유니티 레벨플레이 및 Ad Quality를 문제없이 연동하고 프로젝트를 계속 빌드하려면 2025년 6월 30일 이전까지 Maven Central 저장소로 마이그레이션을 완료해야 합니다.

어떤 버전의 레벨플레이 유니티 플러그인 패키지(레벨플레이 SDK를 래핑하는) 또는 Ad Quality SDK가 연동되어 있는지에 따라 조치해야 할 사항이 다릅니다. 아래의 테이블을 참고하여 SDK 버전에 따라 취해야 할 다음 단계의 조치 사항을 확인하세요.

레벨플레이 유니티 플러그인 패키지 사용자

Ad Quality 유니티 패키지 사용자

수동 마이그레이션을 진행하기에 앞서, 현재 사용중인 레벨플레이 유니티 플러그인 패키지(레벨플레이 SDK를 래핑하는) 및 Ad Quality SDK 버전을 확인합니다. 다음 섹션에서는 SDK 버전들을 확인하고 그에 따라서 수동 마이그레이션 필요 여부를 확인하는 방법을 단계별로 제공합니다. 

레벨플레이 플러그인 패키지 사용자가 수동 마이그레이션 필요 여부를 확인하는 방법

프로젝트에 수동 마이그레인이 필요한지 확인하려면, 하기 단계를 따라서 프로젝트 파일 내의 디펜던시들 중 업데이트가 필요한 사항이 있는지 확인합니다.

유니티 에디터에서 프로젝트에서, Assets > LevelPlay > Editor 폴더로 이동합니다. 이 폴더 내의 모든 XML 파일들에 대해 “https://android-sdk.is.com/” 문자열이 포함되어 있는지 검색합니다. 해당 문자열이 포함된 파일이 있을 경우, 수동 마이그레이션하는 절차 섹션 단계로 이동합니다:

1. IronSourceSDKDependencies.xml 또는 프로젝트 내에서 사용되는 어댑터와 관련된 모든 xml 파일을 엽니다.
2. 저장소 참조 파일 내에서 하기의 코드 라인들을 검색하여, AndroidPackage spec 및 repository 태그들이 아래와 같은지 확인합니다:
   • 하기 코드들이 존재할 경우, 수동 마이그레이션하는 절차 섹션 단계로 이동합니다.
   • 해당 코드들이 없을 경우, 프로젝트 내 디펜던시들은 이미 Maven Central 저장소를 사용하고 있는 것이기 때문에 별도 조치하지 않아도 됩니다.

<androidPackages>
 <androidPackage spec="com.ironsource.sdk:mediationsdk:7.9.0">
 <repositories>
        <repository>https://android-sdk.is.com/</repository>
      </repositories>
 </androidPackage>
</androidPackages>

Ad Quality 유니티 패키지 사용자가 수동 마이그레이션 필요 여부를 확인하는 방법

프로젝트에 수동 마이그레인이 필요한지 확인하려면, 하기 단계를 따라서 프로젝트 파일 내의 디펜던시들 중 업데이트가 필요한 사항이 있는지 확인합니다.

1. 유니티 에디터 프로젝트에서, Assets > LevelPlay > Editor 폴더로 이동합니다.
2. 프로젝트 내의 IronSourceAdQualityDependencies.xml 파일을 엽니다.
3. 저장소 참조 파일 내에서 하기의 코드 라인들을 검색하여, AndroidPackage spec 및 repository 태그들이 아래와 같은지 확인합니다:
   • 하기 코드들이 존재할 경우, 수동 마이그레이션하는 절차 섹션 단계로 이동합니다.
   • 해당 코드들이 없을 경우, 프로젝트 내 디펜던시들은 이미 Maven Central 저장소를 사용하고 있는 것이기 때문에 별도 조치하지 않아도 됩니다.

<androidPackages>
 <androidPackage spec="com.ironsource:adqualitysdk:7.19.1">
 <repositories>
        <repository>https://android-sdk.is.com/</repository>
      </repositories>
 </androidPackage>
</androidPackages>

레벨플레이 플러그인 패키지 사용자가 수동 마이그레이션하는 절차

하기 단계를 따라서 프로젝트의 Maven Central로의 마이그레이션을 완료하고 프로젝트 디펜던시들이 올바르게 업데이트 되도록 합니다:

1. 프로젝트 내의 Assets > LevelPlay > Editor 폴더로 이동합니다.
2. IronSourceSDKDependencies.xml 파일을 삭제합니다.
3. 하기의 미디에이션 어댑터 디펜던시 XML 파일이 있을 경우, 이들을 삭제합니다:
   • ISAdColonyAdapterDependencies.xml 
   • ISAdMobAdapterDependencies.xml
   • ISAppLovinAdapterDependencies.xml
   • ISAPSAdapterDependencies.xml
   • ISBidMachineAdapterDependencies.xml
   • ISBigoAdapterDependencies.xml
   • ISChartboostAdapterDependencies.xml
   • ISCSJAdapterDependencies.xml
   • ISFacebookAdapterDependencies.xml
   • ISFyberAdapterDependencies.xml
   • ISHyprMXAdapterDependencies.xml
   • ISInMobiAdapterDependencies.xml
   • ISMaioAdapterDependencies.xml
   • ISMintegralAdapterDependencies.xml
   • ISMobileFuseAdapterDependencies.xml
   • ISMolocoAdapterDependencies.xml
   • ISMyTargetAdapterDependencies.xml
   • ISOguryAdapterDependencies.xml
   • ISPangleAdapterDependencies.xml
   • ISSmaatoAdapterDependencies.xml
   • ISSuperAwesomeAdapterDependencies.xml
   • ISTapJoyAdapterDependencies.xml
   • ISTencentAdapterDependencies.xml
   • ISUnityAdsAdapterDependencies.xml
   • ISVerveAdapterDependencies.xml
   • ISVungleAdapterDependencies.xml
   • ISYandexAdapterDependencies.xml
4. Ads Mediation 패키지에서Network Manager를 열고, ironSource SDK 및 필요한 미디에이션 어댑터들을 선택한 후, Install버튼을 누릅니다.
5. Assets > LevelPlay > Editor 폴더에서 XML 파일들이 업데이트 되었는지 확인하여 마이그레이션이 성공 여부를 확인하고, 아래의 XML 파일들이 해당 폴더 안에 있는지 확인합니다:
   • IronSourceSDKDependencies.xml
   • 재설치한 어댑터들이 정의된 각 어댑터의 디펜던시 XML 파일.
6. 아래의 파일들을 열어 Maven Central의 디펜던시들을 올바르게 참조하고 있는지 확인합니다:
   

   <androidPackages>   
      <androidPackage spec="com.unity3d.ads-mediation:mediation-sdk:x.x.x">
      </androidPackage>
    </androidPackages>

    <androidPackages>
      <androidPackage spec="com.unity3d.ads-mediation:unityads-adapter:x.x.x">
      </androidPackage>
    </androidPackages>
   

7. 프로젝트를 빌드하고 실행하여 마이그레이션 성공을 검증합니다. 만약 마이그레이션 중 이슈가 발생했을 경우, 유니티 레벨플레이 플러그인 패키지 버전을 7.9.0 이상 버전으로 업데이트 합니다.

Ad Quality 패키지 사용자가 수동 마이그레이션하는 절차

하기 단계를 따라서 프로젝트의 Maven Central로의 마이그레이션을 완료하고 프로젝트 디펜던시들이 올바르게 업데이트 되도록 합니다:

1. 프로젝트 루트 폴더에서 Assets > LevelPlay > Editor 폴더로 이동합니다.
2. IronSourceAdQualityDependencies.xml 파일을 삭제합니다.
3. Maven Central 저장소를 지원하는 XML 버전 (7.19.2 이상)을 다운로드 합니다.
4. Assets > LevelPlay > Editor 폴더에서 XML 파일들이 업데이트 되었는지 확인하여 마이그레이션이 성공 여부를 확인하고, 아래의 XML 파일이 해당 폴더 안에 있는지 확인합니다:
   • IronSourceAdQualityDependencies.xml
5. 아래의 파일을 열어 Maven Central의 디펜던시들을 올바르게 참조하고 있는지 확인합니다:
   

   <androidPackages>   
      <androidPackage spec="com.unity3d.ads-mediation:adquality-sdk:x.x.x">
      </androidPackage>
    </androidPackages>

6. 프로젝트를 빌드하고 실행하여 마이그레이션 성공을 검증합니다.