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

Compared to previous updates, the transition from Capacitor 4 to Capacitor 5 involves minimal breaking changes. This guide provides step-by-step instructions for updating your project to Capacitor 5, as well as a list of breaking changes for official plugins.

Catatan: Capacitor 5 memerlukan NodeJS 16 atau lebih tinggi, karena Node 12 telah mencapai akhir masa pakai dan Node 14 akan mencapai akhir masa pakai pada tanggal 30 April 2023.

Instal versi terbaru dari __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ di proyek Anda: latest version of the Capacitor CLI in your project:
```
npm i -D @capacitor/cli@latest
```
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 memigrasikan proyek Anda ke __CAPGO_KEEP_1__ 5.
Mengupgrade Proyek iOS Code 4 ke Capacitor 5

Upgrading Capacitor 4 iOS Project to Capacitor 5

: __CAPGO_KEEP_0__ 5 memerlukan Xcode 14.1+.: Capacitor 5 requires Xcode 14.1+.
Upgrade: Perbarui hal-hal berikut: .gitignore file:
```
- App/Podfile.lock
+ App/output
```
Update Assets untuk menggunakan ikon aplikasi tunggal: Xcode 14 mendukung ikon aplikasi tunggal berukuran 1024x1024. Bersihkan AppIcon.appiconset Anda dengan menghapus semua ukuran yang tidak perlu.

Upgrading Capacitor 4 Project Android ke Capacitor 5

Upgrade Android Studio: Capacitor 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, jadi tidak perlu download tambahan.
Jalankan AGP Upgrade Assistant: Android Studio dapat membantu dengan beberapa update terkait Gradle dan memindahkan paket ke file build. Untuk memulai, jalankan Tools -> AGP Upgrade Assistant.

Update Android Project Variables: Dalam file Anda, perbarui nilai-nilai Anda ke minimum baru sebagai berikut: variables.gradle file, update your values to the following new minimums:

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'

Perbarui Google Services:

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

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'
}

Perbarui pengguna 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

Matikan Jetifier:

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

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

Perbarui androidScheme: Di Capacitor 6, https Akan menjadi pengaturan default untuk androidScheme untuk aplikasi yang sudah ada untuk memungkinkan aplikasi Capacitor menggunakan fitur Autofill sistem. Untuk menghindari kehilangan data sebagai hasil dari perubahan ini, atur scheme menjadi http sekarang, bahkan jika itu adalah pengaturan default saat ini.
```
{
  server: {
    androidScheme: "http"
  }
}
```
Perbarui versi Kotlin: Jika proyek Anda menggunakan Kotlin, perbarui kotlin_version variabel untuk '1.8.20'.

Fungsi Perubahan Plugin

Fungsi plugin berikut telah diubah atau dihapus. Perbarui code Anda sesuai:

Sheet Aksi
Browser
Kamera
Perangkat
Lokasi
Peta Google
Pemberitahuan Lokal
Pemberitahuan Push
Status Bar

Tutup Layar Aksi

Perbarui androidxMaterialVersion variabel ke 1.8.0.

Ponsel Browser

Perbarui androidxBrowserVersion variabel ke 1.5.0.

Kamera

Untuk Android 13, tambahkan izin membaca gambar media (<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/> ) di AndroidManifest.xml.
Perbarui androidxMaterialVersion variabel ke 1.8.0.
Perbarui androidxExifInterfaceVersion variabel untuk 1.3.6.

Perangkat

Ubah DeviceId.uuid ke DeviceId.identifier.
Pada iOS 16+, DeviceInfo.name akan mengembalikan nama perangkat umum kecuali Anda menambahkan hak istimewa yang tepat Geolocation.

Perbarui

ke playServicesLocationVersion Peta Google 21.0.1.

Perbarui variabel-variabel berikut:

__CAPGO_KEEP_0__
- 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 ke 1.8.20.

Pemberitahuan Lokal

Untuk Android 13, perlu dilakukan pengecekan izin runtime baru untuk mengatur pemberitahuan lokal ketika mengarahkan ke SDK 33. Panggil checkPermissions() dan requestPermissions() sesuai.

Pemberitahuan Push

Untuk Android 13, perlu dilakukan pengecekan izin runtime baru untuk menerima notifikasi push ketika mengarahkan ke SDK 33. Panggil checkPermissions() dan requestPermissions() sesuai dengan itu.
Perbarui firebaseMessagingVersion variabel ke 23.1.2.

Status Bar

Pada iOS, animasi status bar bawaan telah berubah menjadi FADE.

Dengan 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.

Lanjutkan dari Updating dari Capacitor 4 ke Capacitor 5: Panduan Langkah demi Langkah

Jika Anda menggunakan Updating dari Capacitor 4 ke Capacitor 5: Panduan Langkah demi Langkah untuk merencanakan kerja plugin native, hubungkannya dengan Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, 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.