Twórz aplikacje na Androida 12 z Unity

Podczas kompilowania projektu na Androida kierowanego na Androida 12 (poziom SDK 31) możesz napotkać ten błąd:

Could not determine the dependencies of task ':launcher:compileDebugJavaWithJavac'.
> Installed Build Tools revision 31.0.0 is corrupted. Remove and install again using the SDK Manager.
> Configure project :launcher
WARNING: The option 'android.enableR8' is deprecated and should not be used anymore.
It will be removed in a future version of the Android Gradle plugin, and will no longer allow you to disable R8.
Build-tool 31.0.0 is missing DX at <android-sdk-path>/sdk/build-tools/31.0.0/dx
File ~/.android/repositories.cfg could not be loaded.
Build-tool 31.0.0 is missing DX at <android-sdk-path>/sdk/build-tools/31.0.0/dx

Jest to spowodowane niezgodnością między narzędziami Android Build Tools w wersji 31.0.0 a systemem kompilacji Unity. W wersji 31.0.0 pakietu Android Build Tools DX został usunięty na rzecz D8, co spowodowało problemy z kompilacją Unity na Androida.

Ten błąd może wystąpić w takich sytuacjach:

Przejście na AR Foundation w wersji 1.26 w rozszerzeniach ARCore dla Unity,
kierowanie na Androida na poziomie pakietu SDK 31 w dowolnym projekcie Unity, niezależnie od wersji rozszerzeń ARCore;
Użycie w dowolnym projekcie Unity pakietu Android SDK w poziomie 30, gdy zainstalowana jest wersja narzędzi kompilacji 31.0.0, niezależnie od wersji rozszerzeń ARCore.

Obejście

Współpracujemy z firmą Unity nad rozwiązaniem tego problemu. W tym czasie postępuj zgodnie z instrukcjami, aby utworzyć projekt przeznaczony na Androida 12:

W sekcji Project Settings > Player > Android > Publishing Settings > Build wybierz obie opcje:
1. Custom Main Gradle Template,
2. Custom Launcher Gradle Template.
Wprowadź te zmiany w obu wygenerowanych plikach:
- Assets/Plugins/Android/mainTemplate.gradle
- Assets/Plugins/Android/launcherTemplate.gradle
Usuń z góry pliku ten komentarz, jeśli się tam znajduje:
```
// GENERATED BY UNITY. REMOVE THIS COMMENT TO PREVENT OVERWRITING WHEN EXPORTING AGAIN
```
Następnie zmień wartości compileSdkVersion i buildToolsVersion w ten sposób:
```
buildToolsVersion '30.0.3'
```

Podczas kompilacji Unity pobierze narzędzia kompilacyjne w wersji 30.0.3 i użyje ich do skompilowania projektu, zachowując wybrane targetSdkVersion.

Tworzenie niestandardowych kompilacji Gradle

W przypadku wersji Unity 2019.4, 2020.1 i 2020.2, które zostały utworzone za pomocą starszych wersji, musisz ustawić niestandardową kompilację Gradle na wersję Gradle 6.1.1 lub nowszą. Potrzebujesz też wtyczki Androida do obsługi Gradle w wersji 4.0.1 lub nowszej.

Aplikacje kierowane na pakiet SDK 31 wymagają Gradle w wersji 6.1.1 lub nowszej.

Otwórz Preferences > External Tools > Android > Gradle i ustaw niestandardową kompilację Gradle na Gradle 6.1.1 lub nowszą wersję. Aby pobrać narzędzia do tworzenia Gradle, zobacz sekcję Pobieranie.
Wprowadź te zmiany w obu wygenerowanych plikach:
- Assets/Plugins/Android/mainTemplate.gradle
- Assets/Plugins/Android/launcherTemplate.gradle

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        // Must be Android Gradle Plugin 4.0.1 or later. For a list of
        // compatible Gradle versions refer to:
        // https://developer.android.com/studio/releases/gradle-plugin
        classpath 'com.android.tools.build:gradle:4.0.1'
    }
}

allprojects {
   repositories {
      google()
      jcenter()
      flatDir {
        dirs 'libs'
      }
   }
}

Stosowanie zmian w przypadku aplikacji kierowanych na Androida 12

Jeśli Twoja aplikacja jest kierowana na Androida 12, musisz wyraźnie zadeklarować atrybut android:exported. Wszystkie zmiany w Androidzie 12 znajdziesz w artykule Zmiany w zachowaniu w Androidzie 12.

W sekcji Project Settings > Player > Android > Publishing Settings > Build kliknij Custom Main Manifest.

Zastosuj te zmiany w kampanii Assets/Plugins/Android/AndroidManifest.xml:

Usuń z góry pliku ten komentarz, jeśli się tam znajduje:

<!-- GENERATED BY UNITY. REMOVE THIS COMMENT TO PREVENT OVERWRITING WHEN EXPORTING AGAIN-->

Dodaj atrybut android:exported do tagu <activity>:

 <application>
     <activity android:name="com.unity3d.player.UnityPlayerActivity"
               android:theme="@style/UnityThemeSelector"
               android:exported="true">
         <intent-filter>
             <action android:name="android.intent.action.MAIN" />
             <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
         <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
     </activity>
 </application>