Android용 Gradle 업그레이드

Google 모바일 광고 Android SDK 22.4.0의 Android 매니페스트에 <property> 요소가 추가되었습니다. 이 버전 이상을 대상으로 빌드하려면 Gradle 6.7.1 이상과 Android Gradle 플러그인 4.2.0 이상을 사용해야 합니다. 이 가이드에서는 Unity 편집기가 호환되는지 확인하는 방법을 설명합니다.

기본 요건

시작 가이드에 따라 필요한 과정을 완료합니다. 다음 지침을 확인하세요.

  • 최소 API 수준을 21로 설정
  • 대상 API 수준을 33 이상으로 설정
  • Custom Main Gradle Template 및 Custom Gradle Properties Template 설정 사용 설정

Unity 2022.2 이상

Unity 2022.2 이상에서는 기본적으로 최신 버전의 Android용 Gradle이 제공됩니다. Google 모바일 광고 Android SDK 22.4.0을 지원하기 위한 추가 조치는 필요하지 않습니다.

Unity 2022.1 및 이전 버전

Unity 2022.2 이하 버전에서는 Google 모바일 광고 Android SDK 22.4.0에서 지원하지 않는 이전 버전의 Android용 Gradle을 사용합니다. 다음 단계는 빌드 프로세스에 따라 최소한 필요한 Gradle 버전으로 업그레이드하는 방법을 보여줍니다.

  1. 맞춤 Gradle 템플릿 사용 설정

    프로젝트 설정 > 플레이어 > Android > 게시 설정 > 빌드로 이동하여 다음을 선택합니다.

    • 맞춤 기본 Gradle 템플릿

  2. 기본 Gradle 템플릿 수정

    Assets/Plugins/Android/baseProjectTemplate.gradle 파일을 열고 Gradle 빌드 도구 4.2.0을 사용하도록 종속 항목을 설정합니다.

      allprojects {
      buildscript {
          dependencies {
              classpath 'com.android.tools.build:gradle:4.2.0'
              **BUILD_SCRIPT_DEPS**
          }
      }
  }
  ...

  3. Gradle 업데이트

    Gradle 버전을 6.7.1로 업데이트합니다. 이 단계는 빌드 프로세스의 일부로 프로젝트를 Android 스튜디오 프로젝트로 내보내는지 여부에 따라 약간 다릅니다.

    Unity 통합 빌드

    Gradle 설치

    Gradle 버전 6.7.1을 다운로드합니다.

    Unity에서 Gradle 경로 설정

    Unity에서 Unity Preferences(Unity 환경설정) > External Tools(외부 도구)를 열고 맞춤 Gradle 경로를 설정합니다.

    Android 스튜디오 빌드

    Android 스튜디오 프로젝트 내보내기

    File > Build Settings 메뉴를 열고 Export Project가 선택으로 선택되어 있는지 사용 설정한 후 Export 버튼을 누릅니다. 내보낸 후에는 Android 스튜디오에서 프로젝트를 엽니다.

    Gradle 래퍼 업데이트

    ./gradle/wrapper/gradle-wrapper.properties 파일을 열고 distributionUrl을 설정하여 Gradle 6.7.1.

    distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip