Aggiornamento da Capacitor 4 a Capacitor 5: Guida Passo dopo Passo

Rispetto agli aggiornamenti precedenti, la transizione da Capacitor 4 a Capacitor 5 comporta cambiamenti minimi. Questa guida fornisce istruzioni passo dopo passo per aggiornare il tuo progetto a Capacitor 5, nonché una lista dei cambiamenti di rotta per i plugin ufficiali.

Nota: Capacitor 5 richiede NodeJS 16 o superiore, poiché Node 12 ha raggiunto la fine della vita e Node 14 raggiungerà la fine della vita il 30 aprile 2023. Si consiglia di utilizzare la versione LTS più recente di NodeJS.

1. Installa il latest versione del Capacitor CLI nel tuo progetto:

   npm i -D @capacitor/cli@latest

2. Eseguire il seguente comando per consentire al CLI di gestire l'aggiornamento:

   npx cap migrate

   Se alcune fasi di aggiornamento non possono essere eseguite, ulteriori informazioni saranno fornite nell'output del terminale. I passaggi di aggiornamento manuali sono elencati di seguito.

3. Se hai installato l'estensione VS Code , controlla la sezione raccomandazioni dell'estensione per trovare l'opzione di migrare il tuo progetto a Capacitor 5.

Aggiornamento del progetto iOS Capacitor 4 a Capacitor 5

1. Aggiornare Xcode: Capacitor 5 richiede Xcode 14.1+.

2. Aggiornare .gitignore: Apporta le seguenti modifiche al tuo .gitignore file:

   - App/Podfile.lock
   + App/output

3. Aggiorna Assets per utilizzare un'icona di app unica: Xcode 14 supporta un'icona di app unica di 1024x1024. Pulisci il tuo AppIcon.appiconset eliminando tutte le dimensioni non necessarie.

Aggiornamento di Capacitor 4 Progetto Android a Capacitor 5

1. Aggiornamento di Android Studio: Capacitor 5 richiede Android Studio Flamingo | 2022.2.1 o successivo a causa dell'utilizzo di Gradle 8, che richiede Java JDK 17. Java 17 è incluso in Android Studio Flamingo, quindi non sono necessarie scariche aggiuntive.

2. Eseguire l'assistente di aggiornamento di AGP: Android Studio può aiutare con alcune aggiornamenti relativi a Gradle e il movimento di pacchetti nei file di build. Per iniziare, esegui Tools -> AGP Upgrade Assistant.

3. Aggiornamento delle variabili del progetto Android: Nel tuo variables.gradle file, aggiorna i tuoi valori ai seguenti minimi nuovi:

   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. Aggiornamento dei servizi di Google:

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

5. Aggiornamento del plugin di Gradle a 8.0.0:

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

6. Aggiornamento del wrapper di Gradle a 8.0.2:

   # gradle-wrapper.properties
   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. Disabilita Jetifier:

   # gradle.properties
   android.useAndroidX=true
   - android.enableJetifier=true

8. Muovi pacchetto a build.gradle:

   # AndroidManifest.xml
   <?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">

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

9. Aggiorna androidScheme: In Capacitor 6, https sarà la impostazione predefinita per androidScheme per le app esistenti per consentire meglio agli applicazioni Capacitor di utilizzare il sistema del feature di Autofill. Per evitare la perdita di dati a causa di questo cambiamento, impostare lo schema a http ora, anche se è l'impostazione predefinita corrente.

   {
     server: {
       androidScheme: "http"
     }
   }

10. Aggiorna versione Kotlin: Se il tuo progetto utilizza Kotlin, aggiorna il kotlin_version variabile a '1.8.20'.

Cambiamenti nella funzionalità del plugin

La seguente funzionalità del plugin è stata modificata o eliminata. Aggiorna il tuo code di conseguenza:

• Scheda di azione
• Browser
• Camera
• Dispositivo
• Geolocalizzazione
• Google Maps
• Notifiche Locali
• Notifiche Push
• Barra di Stato

Scheda di Azione

• Aggiorna il androidxMaterialVersion variabile a 1.8.0.

Browser

• Aggiorna il androidxBrowserVersion variabile a 1.5.0.

Camera

• Per Android 13, aggiungi la autorizzazione di lettura delle immagini dei media (<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>) in AndroidManifest.xml.
• Aggiorna il androidxMaterialVersion variabile a 1.8.0.
• Aggiorna il androidxExifInterfaceVersion variabile a 1.3.6.

Dispositivo

• Cambia DeviceId.uuid a DeviceId.identifier.
• Su iOS 16+ DeviceInfo.name ritorna un nome dispositivo generico a meno che non aggiungi le autorizzazioni appropriate Autorizzazioni.

Geolocalizzazione

• Aggiorna il playServicesLocationVersion a 21.0.1.

Google Maps

• Aggiorna le seguenti variabili:
  • googleMapsPlayServicesVersion a 18.1.0.
  • googleMapsUtilsVersion a 3.4.0.
  • googleMapsKtxVersion a 3.4.0.
  • googleMapsUtilsKtxVersion a 3.4.0.
  • kotlinxCoroutinesVersion per 1.6.4.
  • androidxCoreKTXVersion per 1.10.0.
  • kotlin_version per 1.8.20.

Notifiche Locali

• Per Android 13, è richiesta una nuova verifica di permesso runtime per pianificare notifiche locali quando si mira a SDK 33. Chiamata checkPermissions() e requestPermissions() di conseguenza.

Notifiche Push

• Per Android 13, è richiesta una nuova verifica di permesso runtime per ricevere notifiche push quando si mira a SDK 33. Chiamata checkPermissions() e requestPermissions() di conseguenza.
• Aggiorna il firebaseMessagingVersion variabile a 23.1.2.

Barra dello Stato

• Sul sistema operativo iOS, l'animazione predefinita della barra dello stato è stata modificata in FADE.

Seguendo questi passaggi e aggiornando il tuo code in conformità, dovresti ora aver aggiornato con successo il tuo progetto da Capacitor 4 a Capacitor 5. Assicurati di testare attentamente la tua applicazione per garantire che tutte le funzionalità e i plugin funzionino come previsto.

Continua da Aggiornamento da Capacitor 4 a Capacitor 5: Una Guida Passo dopo Passo

Se stai utilizzando Aggiornamento da Capacitor 4 a Capacitor 5: Una Guida Passo dopo Passo per pianificare il lavoro dei plugin nativi, connettilo con Directory dei Plugin Capgo per il flusso di lavoro del prodotto in Directory dei Plugin Capgo Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo Aggiungere o Aggiornare Plugin per la descrizione dettagliata in Aggiungere o Aggiornare Plugin, Alternative per Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative per Plugin Enterprise Ionic, e Capgo Costruzione Nativa per il flusso di lavoro del prodotto in Capgo Costruzione Nativa.