# Maven Central 마이그레이션 가이드

> 빌드.gradle을 업데이트하여 is.com 저장소를 제거하고 mavenCentral()을 추가한 다음 적절한 Maven 종속성을 사용하여 Unity 레벨플레이 SDK 및 Ad Quality SDK를 임포트하여 Unity 레벨플레이 Android 프로젝트를 Maven Central로 마이그레이션할 수 있습니다.

Unity Ironsource 통합의 일환으로 Android용 Unity 레벨플레이 SDK, 지원되는 모든 광고 네트워크 어댑터, Android용 Ad 품질 SDK는 is.com에서 Maven Central으로 마이그레이션됩니다.

Unity 레벨플레이를 통합한 Unity로 제작된 개발자는 프로젝트 종속성을 Maven Central에 **2025년 6월 30일** 이내에 마이그레이션해야 프로젝트를 계속 빌드하고 Unity 레벨플레이와 광고 품질을 사용합니다.

> **Note:**
>
> 프로젝트를 Maven Central로 마이그레이션해야 합니다. SDK는 IS.com에서 더 이상 액세스할 수 없으므로 개발 워크플로 중단되지 않고 Unity 레벨플레이 프로젝트를 계속 빌드하지 않도록 마이그레이션하십시오.

프로젝트에 통합한 레벨플레이 SDK를 포함하는 레벨플레이 Unity 패키지 버전과 광고 품질 SDK에 따라 특정 조치를 취해야 합니다. SDK 버전에 따라 다음 표를 참고하여 다음 단계를 결정하십시오.

## 레벨플레이 Unity 패키지 사용자

| **레벨플레이 Unity 패키지 버전** | **설치 날짜**                             | **필요 행동**                                                                                                                                                              |
| ---------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 7.9.0 이상               | 2024년 11월 21일 이후 설치                   | 필요 없는 행동 업데이트 시 마이그레이션이 자동으로 수행됩니다.                                                                                                                                    |
| 7.9.0 - 8.4.1          | 2024년 11월 21일 이전에 설치되었으며 이후 업데이트되지 않음 | 자동 마이그레이션을 활성화하다, 사용 가능하다 현재 버전보다 최신 Unity 패키지 버전으로 업데이트합니다.  업데이트하지 않기로 선택한 경우 프로젝트 종속성을 확인하고 필요한 경우 매뉴얼 마이그레이션 단계를 따르십시오. 자세한 내용은 **수동 마이그레이션이 필요한지 확인** 섹션을 참고하십시오. |
| 7.9.0 이전 버전            | 모든 날짜                                 | 개발 및 빌드 기능을 유지하려면 Unity 패키지 버전을 최소 7.9.0으로 업데이트해야 합니다.                                                                                                                 |

## 광고 품질 Unity 패키지 사용자

| **광고 품질 SDK 버전** | **설치 날짜**                             | **필요 행동**                                                                                                                                                        |
| ---------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 7.19.2 이상        | 2024년 10월 30일 이후 설치                   | 행동 필요하지 않습니다. 업데이트 시 마이그레이션이 자동으로 수행됩니다.                                                                                                                         |
| 7.19.2 이상        | 2024년 10월 30일 이전에 설치되었으며 이후 업데이트되지 않음 | 현재 버전보다 최신 SDK 버전으로 업데이트하여 자동 마이그레이션을 활성화하다, 사용 가능하다.   업데이트하지 않기로 선택한 경우 프로젝트 종속성을 확인하고 필요한 경우 매뉴얼 마이그레이션 단계를 따르십시오. 자세한 내용은 **수동 마이그레이션이 필요한지 확인** 섹션을 참고하십시오. |
| 7.19.2 이전 버전     | 모든 날짜                                 | 개발 및 빌드 기능을 유지하려면 SDK 버전을 최소 7.19.2로 업데이트해야 합니다.                                                                                                                 |

> **Note:**
>
> Maven Central에서 지원되는 최소 SDK 버전은 다음과 같습니다.
>
> * Unity LevelPlay SDK: 7.9.0
> * Unity Ad Quality SDK: 7.19.2
>
> 프로젝트에서 이전 SDK 버전을 사용하는 경우 개발 및 빌드 기능을 계속 진행하려면 지원되는 최소 버전으로 업데이트해야 합니다. is.com의 지원이 사용 중단 예정 이전 버전을 사용하는 프로젝트는 업데이트될 때까지 더 이상 빌드 함수 않습니다.

매뉴얼 마이그레이션을 진행하기 전에 레벨플레이 SDK를 래핑하는 레벨플레이 Unity 패키지와 사용 중인 Ad 품질 SDK 버전을 확인합니다. 다음 섹션 SDK 버전을 확인하고 매뉴얼 마이그레이션이 필요한지 확인하는 단계를 설명합니다.

## 레벨플레이 Unity 패키지 사용자에게 매뉴얼 마이그레이션이 필요한지 확인합니다.

프로젝트에 매뉴얼 마이그레이션이 필요한지 확인하려면 다음 단계에 따라 프로젝트 파일의 오래된 종속성을 확인하십시오.

Unity 에디터에서 **Assets** > **LevelPlay** > **Editor**로 이동합니다. 이 폴더의 XML 파일에서 문자열 `https://android-sdk.is.com/`를 검색합니다. 찾은 경우 다음의 **매뉴얼 마이그레이션 단계** 섹션으로 이동합니다.

1. IronSourceSDKDependencies.xml 또는 프로젝트에 사용된 어댑터와 관련된 xml 파일을 엽니다.
2. 저장소 레퍼런스 파일에서 다음 코드 줄을 검색하고 AndroidPackage 사양 및 저장소 태그가 다음과 같는지 확인합니다.
   * 이러한 코드 줄이 있는 경우, **매뉴얼 마이그레이션 단계** 섹션으로 이동합니다.
   * 이러한 코드 라인이 없는 경우 프로젝트의 종속성이 이미 Maven Central을 사용하므로 행동 필요하지 않습니다.

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

## 광고 품질 Unity 패키지 사용자에게 매뉴얼 마이그레이션이 필요한지 확인합니다.

프로젝트에 매뉴얼 마이그레이션이 필요한지 확인하려면 다음 단계에 따라 프로젝트 파일의 오래된 종속성을 확인하십시오.

1. Unity 에디터에서 **Assets** > **LevelPlay** > **Editor**로 이동합니다.
2. 프로젝트에서 IronSourceAdQualityDependencies.xml을 엽니다.
3. 저장소 레퍼런스 파일에서 다음 코드 줄을 검색하고 AndroidPackage 사양 및 저장소 태그가 다음과 같는지 확인합니다.
   * 이러한 코드 줄이 있는 경우, **매뉴얼 마이그레이션 단계** 섹션으로 이동합니다.
   * 이러한 코드 라인이 없는 경우 프로젝트의 종속성이 이미 Maven Central을 사용하므로 행동 필요하지 않습니다.

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

## 레벨플레이 Unity 패키지 사용자를 위한 매뉴얼 마이그레이션 단계

> **Note:**
>
> 2024년 11월 21일 이전에 설치된 7.9.0과 8.4.1 사이의 레벨플레이 패키지 버전을 사용하고 패키지 버전을 업데이트하고 싶지 않은 경우 매뉴얼 마이그레이션이 필요합니다. 이는 해당 날짜 이후에 최신 레벨플레이 버전으로 업데이트할 수 없는 퍼블리셔에도 적용됩니다.

다음 단계에 따라 프로젝트를 Maven Central로 매뉴얼 마이그레이션하면서 종속성이 올바르게 업데이트되었는지 확인합니다.

1. 프로젝트의 **Assets** > **LevelPlay** > **Editor** 폴더로 이동합니다.

2. IronSourceSDKDependencies.xml 파일을 삭제합니다.

3. 다음 설치된 Mediation 어댑터 종속성 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 패키지에서 **네트워크 관리자**를 열고 레벨플레이 SDK와 필요한 Mediation 어댑터를 선택한 다음 **설치**를 선택합니다.

5. **Assets** > **LevelPlay** > **Editor** 폴더에서 XML 파일이 업데이트되었는지 확인하고 다음 XML 파일이 있는지 확인합니다.
   * IronSourceSDKDependencies.xml
   * 다시 설치한 어댑터에 대한 해당 어댑터 종속성 XML 파일.

6. 다음 파일을 열고 Maven Central의 종속성을 올바르게 참조하고 있는지 확인합니다.

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

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

7. 프로젝트를 빌드 실행하여 성공적인 마이그레이션을 확인합니다. 마이그레이션에 문제가 발생하면 Unity 레벨플레이 패키지를 버전 7.9.0 이상으로 업데이트하십시오.

## 광고 품질 패키지 사용자를 위한 매뉴얼 마이그레이션 단계

> **Note:**
>
> 7.19.2 이전 버전의 Ad 품질 SDK를 사용 중이거나 7.19.2 이상 버전을 사용 중이지만 최신 설치 날짜가 2024년 10월 30일 이전인 경우 매뉴얼 마이그레이션이 필요합니다.

다음 단계에 따라 프로젝트를 Maven Central로 매뉴얼 마이그레이션하면서 종속성이 올바르게 업데이트되었는지 확인합니다.

1. 프로젝트의 **Assets** > **LevelPlay** > **Editor** 폴더로 이동합니다.

2. IronSourceAdQualityDependencies.xml 파일을 삭제합니다.

3. [Maven Central을 지원하는 XML 버전을 다운로드합니다(7.19.2 이상).](http://ssa.public.s3.amazonaws.com/Dependencies-xmls/AdQuality/7.24.0/IronSourceAdQualityDependencies.xml)

4. **Assets** > **LevelPlay** > **Editor** 폴더에서 XML 파일이 업데이트되었는지 확인하고 다음 XML 파일이 있는지 확인합니다.
   * IronSourceAdQualityDependencies.xml

5. 다음 파일을 열고 Maven Central의 종속성을 올바르게 참조하고 있는지 확인합니다.

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

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