Capacitor 4 から Capacitor 5 へのアップデート: ステップバイステップガイド

2. AGP Upgrade Assistant ausführen: Android Studio kann bei einigen Updates im Zusammenhang mit Gradle und der Verschiebung von Paketen in Build-Dateien helfen. Starten Sie Tools -> AGP Upgrade Assistant.

3. Android-Projektvariablen aktualisieren: Aktualisieren Sie in Ihrer variables.gradle-Datei Ihre Werte auf die folgenden neuen Mindestanforderungen:

   minSdkVersion = 22
   compileSdkVersion = 33
   targetSdkVersion = 33
   androidxActivityVersion = '1.7.0'
   androidxAppCompatVersion = '1.6.1'
   androidxCoordinatorLayoutVersion = '1.2.0'
   androidxCoreVersion = '1.10.0'
   androidxFragmentVersion = '1.5.6'
   coreSplashScreenVersion = '1.0.0'
   androidxWebkitVersion = '1.6.1'
   junitVersion = '4.13.2'
   androidxJunitVersion = '1.1.5'
   androidxEspressoCoreVersion = '3.5.1'
   cordovaAndroidVersion = '10.1.1'

4. Google Services aktualisieren:

   dependencies {
   -       classpath 'com.google.gms:google-services:4.3.13'
   +       classpath 'com.google.gms:google-services:4.3.15'
   }

5. Gradle-Plugin auf 8.0.0 aktualisieren:

   dependencies {
   -       classpath 'com.android.tools.build:gradle:7.2.1'
   +       classpath 'com.android.tools.build:gradle:8.0.0'
   }

6. Gradle-Wrapper auf 8.0.2 aktualisieren:

   distributionBase=GRADLE_USER_HOME
   distributionPath=wrapper/dists
   - distributionUrl=https\://services.gradle.org/distributions/gradle-7.4.2-all.zip
   + distributionUrl=https\://services.gradle.org/distributions/gradle-8.0.2-all.zip
   zipStoreBase=GRADLE_USER_HOME
   zipStorePath=wrapper/dists

7. Jetifier deaktivieren:

   android.useAndroidX=true
   - android.enableJetifier=true

8. Paket in build.gradle verschieben:

   <?xml version="1.0" encoding="utf-8"?>
   - <manifest xmlns:android="http://schemas.android.com/apk/res/android"
   -     package="[YOUR_PACKAGE_ID]">
   + <manifest xmlns:android="http://schemas.android.com/apk/res/android">

   android {
   +     namespace "[YOUR_PACKAGE_ID]"
         compileSdkVersion rootProject.ext.compileSdkVersion

9. androidScheme aktualisieren: In Capacitor 6 wird https die Standardeinstellung für androidScheme für bestehende Apps sein, um Capacitor-Anwendungen besser in die Lage zu versetzen, die System-Autofill-Funktion zu nutzen. Um Datenverlust durch diese Änderung zu vermeiden, setzen Sie das Schema jetzt auf http, auch wenn es die aktuelle Standardeinstellung ist.

   {
     server: {
       androidScheme: "http"
     }
   }

10. Kotlin-Version aktualisieren: Wenn Ihr Projekt Kotlin verwendet, aktualisieren Sie die kotlin_version-Variable auf '1.8.20'.

Änderungen der Plugin-Funktionalität

Die folgenden Plugin-Funktionalitäten wurden geändert oder entfernt. Aktualisieren Sie Ihren Code entsprechend:

• Action Sheet
• Browser
• Camera
• Device
• Geolocation
• Google Maps
• Local Notifications
• Push Notifications
• Status Bar

Action Sheet

• Aktualisieren Sie die androidxMaterialVersion-Variable auf 1.8.0

Browser

• Aktualisieren Sie die androidxBrowserVersion-Variable auf 1.5.0

Camera

• Fügen Sie für Android 13 die Berechtigung zum Lesen von Medienbildern (<?xml version="1.0" encoding="utf-8"?>) in AndroidManifest.xml hinzu
• Aktualisieren Sie die androidxMaterialVersion-Variable auf 1.8.0
• Aktualisieren Sie die androidxExifInterfaceVersion-Variable auf 1.3.6

Device

• Ändern Sie DeviceId.uuid zu DeviceId.identifier
• Auf iOS 16+ wird DeviceInfo.name einen generischen Gerätenamen zurückgeben, es sei denn, Sie fügen die entsprechenden Berechtigungen hinzu

Geolocation

• Aktualisieren Sie die playServicesLocationVersion auf 21.0.1

Google Maps

• Aktualisieren Sie die folgenden Variablen:

  • googleMapsPlayServicesVersion auf 18.1.0
  • googleMapsUtilsVersion auf 3.4.0
  • googleMapsKtxVersion auf 3.4.0
  • googleMapsUtilsKtxVersion auf 3.4.0
  • kotlinxCoroutinesVersion auf 1.6.4
  • androidxCoreKTXVersion auf 1.10.0
  • kotlin_version auf 1.8.20### Lokale Benachrichtigungen

• Für Android 13 ist eine neue Laufzeit-Berechtigungsprüfung erforderlich, um lokale Benachrichtigungen bei SDK 33 zu planen. Rufen Sie entsprechend checkPermissions() und requestPermissions() auf

Push-Benachrichtigungen

• Für Android 13 ist eine neue Laufzeit-Berechtigungsprüfung erforderlich, um Push-Benachrichtigungen bei SDK 33 zu empfangen. Rufen Sie entsprechend checkPermissions() und requestPermissions() auf
• Aktualisieren Sie die Variable firebaseMessagingVersion auf 2312

Status-Leiste

• Unter iOS wurde die Standard-Status-Leisten-Animation zu FADE geändert

Wenn Sie diese Schritte befolgen und Ihren Code entsprechend aktualisieren, sollten Sie Ihr Projekt erfolgreich von Capacitor 4 auf Capacitor 5 aktualisiert haben. Stellen Sie sicher, dass Sie Ihre Anwendung gründlich testen, um sicherzustellen, dass alle Funktionen und Plugins wie erwartet funktionieren