Eseguire l'upgrade di Gradle per Android

L'SDK Google Mobile Ads per Android 22.4.0 ha aggiunto un elemento <property> nel file manifest Android. Per sviluppare questa versione o successive è necessario Gradle 6.7.1 o versioni successive e il plug-in Android Gradle 4.2.0 o versioni successive. Questa guida ti spiega come assicurarti che il tuo editor Unity sia compatibile.

Prerequisiti

Completa la Guida introduttiva. Assicurati di:

  • Imposta il livello API minimo su 21
  • Imposta il livello API target su 33 o su un livello superiore
  • Attiva le impostazioni Modello Gradle principale personalizzato e Modello proprietà Gradle personalizzato

Unity 2022.2 e versioni successive

Per impostazione predefinita, Unity 2022.2 e successive include le versioni più recenti di Gradle per Android. Non sono richieste ulteriori azioni per supportare l'SDK Google Mobile Ads per Android 22.4.0.

Unity 2022.1 e versioni precedenti

Unity 2022.2 e precedenti utilizza una versione precedente di Gradle per Android, che non è supportata dall'SDK Google Mobile Ads per Android 22.4.0. I seguenti passaggi mostrano come eseguire l'upgrade alla versione Gradle minimamente richiesta in base al processo di compilazione:

  1. Attiva i modelli Gradle personalizzati

    Vai a Impostazioni progetto > Player > Android > Impostazioni di pubblicazione > Build e seleziona:

    • Modello Gradle di base personalizzato

  2. Modifica modello Gradle di base

    Apri il file Assets/Plugins/Android/baseProjectTemplate.gradle e imposta le dipendenze per l'utilizzo degli strumenti di creazione Gradle 4.2.0.

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

    Aggiorna la tua versione Gradle alla 6.7.1. I passaggi sono leggermente diversi a seconda che tu esporti il progetto come progetto Android Studio nell'ambito del processo di compilazione.

    Build integrate Unity

    Installa Gradle

    Scarica Gradle versione 6.7.1.

    Impostare il percorso Gradle in Unity

    In Unity, apri Preferenze Unity > Strumenti esterni e imposta il percorso di valutazione personalizzato.

    Build di Android Studio

    Esportare il progetto Android Studio

    Apri il menu File > Impostazioni build, abilita Esporta progetto selezionata e premi il pulsante Esporta. Al termine dell'esportazione, apri il progetto in Android Studio.

    Aggiornamento del wrapper Gradle

    Apri il file ./gradle/wrapper/gradle-wrapper.properties e imposta distributionUrl per utilizzare 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