Update dari Capacitor 4 ke Capacitor 5: Panduan Langkah demi Langkah

Perbandingan dengan pembaruan sebelumnya, transisi dari Capacitor 4 ke Capacitor 5 melibatkan perubahan yang minimal. Panduan ini menyediakan instruksi langkah demi langkah untuk memperbarui proyek Anda ke Capacitor 5, serta daftar perubahan yang memecahkan untuk plugin resmi.

Catatan: Capacitor 5 memerlukan NodeJS 16 atau lebih tinggi, karena Node 12 telah mencapai akhir masa pakainya dan Node 14 akan mencapai akhir masa pakainya pada tanggal 30 April 2023. Disarankan untuk menggunakan versi LTS terbaru dari NodeJS.

1. Instal versi __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ di proyek Anda: latest version of the Capacitor CLI in your project:

   npm i -D @capacitor/cli@latest

2. Run the following command to let the CLI handle the migration:

   npx cap migrate

   Jika Anda memiliki ekstensi VS __CAPGO_KEEP_0__ terinstal, periksa bagian rekomendasi ekstensi untuk menemukan opsi untuk memigrasi proyek Anda ke __CAPGO_KEEP_1__ 5.

3. Pembaruan Proyek iOS Code 4 ke Capacitor 5

Upgrading Capacitor 4 iOS Project to Capacitor 5

1. : __CAPGO_KEEP_0__ 5 memerlukan Xcode 14.1+.: Capacitor 5 requires Xcode 14.1+.

2. Pembaruan Proyek iOS __CAPGO_KEEP_0__ 4 ke __CAPGO_KEEP_1__ 5: Perlu melakukan perubahan berikut pada file Anda .gitignore file:

   - App/Podfile.lock
   + App/output

3. Update Assets untuk menggunakan ikon aplikasi tunggalcontext: Halaman/area: Bagian contoh aplikasi solusi. Peran: Teks alternatif gambar. Dilihat di: komponen solusi/SolutionAppExample.astro. Pesan kunci `solution_app_examples_icon_alt` (Teks Alternatif Ikon Contoh Aplikasi Solusi).

Upgrading Capacitor 4 Android Project to Capacitor 5

1. Upgrade Project Android dari __CAPGO_KEEP_0__ 4 ke __CAPGO_KEEP_1__ 5: Capacitor 5 requires Android Studio Flamingo | 2022.2.1 or newer due to the usage of Gradle 8, which requires Java JDK 17. Java 17 ships with Android Studio Flamingo, so no additional downloads are needed.

2. : __CAPGO_KEEP_0__ 5 memerlukan Android Studio Flamingo | 2022.2.1 atau lebih baru karena penggunaan Gradle 8, yang memerlukan Java JDK 17. Java 17 dilengkapi dengan Android Studio Flamingo, sehingga tidak perlu download tambahan.Jalankan AGP Upgrade Assistant Tools -> AGP Upgrade Assistant.

3. : Android Studio dapat membantu dengan beberapa update terkait Gradle dan memindahkan paket ke file build. Untuk memulai, jalankanUpdate Variabel Project Android variables.gradle : Dalam file Anda, update nilai-nilai Anda ke minimum baru sebagai berikut:

   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. Perbarui Google Services:

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

5. Perbarui plugin Gradle menjadi 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. Perbarui wrapper Gradle menjadi 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. Matikan Jetifier:

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

8. Pindahkan paket ke 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. Perbarui androidScheme: Di Capacitor 6, https Akan menjadi pengaturan default untuk androidScheme untuk aplikasi yang sudah ada untuk memungkinkan aplikasi Capacitor yang lebih baik menggunakan fitur Autofill sistem. Untuk menghindari kehilangan data sebagai hasil dari perubahan ini, atur scheme menjadi http saat ini, bahkan jika itu adalah pengaturan default saat ini.

   {
     server: {
       androidScheme: "http"
     }
   }

10. Perbarui versi Kotlin: Jika proyek Anda menggunakan Kotlin, perbarui kotlin_version Variabel ke '1.8.20'.

Pengubahan Fungsi Plugin

Berikut ini adalah pengubahan atau penghapusan fungsi plugin. Perbarui code Anda sesuai dengan perubahan ini:

• Aplikasi Tindakan
• Pembaruan Browser
• Kamera
• Peralatan
• Geolokasi
• Peta Google
• Pemberitahuan Lokal
• Pemberitahuan Push
• Status Bari

Sheet Aksi

• Perbarui variabel ke androidxMaterialVersion Ponsel Browser 1.8.0.

Perbarui variabel ke

• Kamera androidxBrowserVersion Untuk Android 13, tambahkan izin membaca gambar media ( 1.5.0.

) di

• Perbarui variabel ke<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>Perbarui variabel ke AndroidManifest.xml.
• Perbarui variabel ke androidxMaterialVersion Perbarui variabel ke 1.8.0.
• Perbarui variabel ke androidxExifInterfaceVersion ubah ke 1.3.6.

Perangkat

• Ganti DeviceId.uuid menjadi DeviceId.identifier.
• context: Halaman/area: Halaman produk pembaruan hidup. Peran: Label UI singkat atau item navigasi. Kunci pesan `live_update_dynamic_label_to` (Label Dinamis Pembaruan Hidup To). DeviceInfo.name Pada iOS 16+ akan mengembalikan nama perangkat umum kecuali Anda menambahkan hak istimewa yang tepat.

Geolokasi

• Perbarui playServicesLocationVersion menjadi 21.0.1.

context: Halaman/area: Halaman produk pembaruan hidup. Peran: Label UI singkat atau item navigasi. Kunci pesan `live_update_dynamic_label_to` (Label Dinamis Pembaruan Hidup To).

• Peta Google
  • googleMapsPlayServicesVersion ke 18.1.0.
  • googleMapsUtilsVersion ke 3.4.0.
  • googleMapsKtxVersion ke 3.4.0.
  • googleMapsUtilsKtxVersion ke 3.4.0.
  • kotlinxCoroutinesVersion ke 1.6.4.
  • androidxCoreKTXVersion ke 1.10.0.
  • kotlin_version Pemberitahuan Lokal 1.8.20.

Untuk Android 13, perlu dilakukan pengecekan izin runtime baru untuk mengatur pemberitahuan lokal ketika mengarahkan ke __CAPGO_KEEP_0__ 33. Panggil

• For Android 13, a new runtime permission check is required to schedule local notifications when targeting SDK 33. Call checkPermissions() sehingga. requestPermissions() Pemberitahuan Push

Untuk Android 13, perlu dilakukan pengecekan izin runtime baru untuk mengatur pemberitahuan lokal ketika mengarahkan ke __CAPGO_KEEP_0__ 33. Panggil

• For Android 13, sebuah pengecekan izin runtime baru diperlukan untuk menerima notifikasi push ketika mengarahkan ke SDK 33. Panggil checkPermissions() dan requestPermissions() sesuai dengan itu.
• Update firebaseMessagingVersion ke 23.1.2.

Status Bar

• Pada iOS, animasi status bar default telah berubah menjadi FADE.

Mengikuti langkah-langkah ini dan memperbarui code Anda sesuai dengan itu, Anda seharusnya sudah berhasil memperbarui proyek Anda dari Capacitor 4 ke Capacitor 5. Pastikan untuk menguji aplikasi Anda secara menyeluruh untuk memastikan bahwa semua fitur dan plugin berfungsi seperti yang diharapkan.

Teruskan dari Migrasi dari Capacitor 4 ke Capacitor 5: Panduan Langkah demi Langkah

Jika Anda menggunakan Migrasi dari Capacitor 4 ke Capacitor 5: Panduan Langkah demi Langkah untuk merencanakan kerja plugin native, hubungkannya dengan Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin, Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo, Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin, Alternatif Plugin Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic, dan Capgo Pembangunan Nativ untuk alur kerja produk di Capgo Pembangunan Nativ.