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 mengupdate 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. Dianjurkan untuk menggunakan versi LTS terbaru dari NodeJS.

Install 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
```
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 mengmigrasi proyek Anda ke __CAPGO_KEEP_1__ 5.
Mengupgrade Proyek iOS Code 4 ke Capacitor 5

Upgrading Capacitor 4 iOS Project to Capacitor 5

Note: __CAPGO_KEEP_0__ 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. Dianjurkan untuk menggunakan versi LTS terbaru dari NodeJS.: Capacitor 5 memerlukan Xcode 14.1+.
Perbarui .gitignore: Lakukan perubahan berikut pada file Anda: .gitignore Perbarui Assets untuk menggunakan ikon aplikasi tunggal
```
- App/Podfile.lock
+ App/output
```
Konteks: Halaman/area: Halaman solusi aplikasi contoh. Peran: Teks alternatif gambar. Dilihat di: komponen solusi/SolutionAppExample.astro. Pesan kunci `solution_app_examples_icon_alt` (Teks Alternatif Ikon Aplikasi Contoh).: Xcode 14 mendukung ikon aplikasi tunggal berukuran 1024x1024. Bersihkan AppIcon.appiconset Anda dengan menghapus semua ukuran yang tidak perlu.

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

Perbarui Variabel Projek Android: Di file Anda, update nilai-nilai Anda ke nilai minimum baru berikut: variables.gradle Update Google Services

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'

Update Plugin Gradle ke 8.0.0:

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

Update Penggabung Gradle ke 8.0.2:

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

Matikan Jetifier:

# 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

Pindahkan paket ke:

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

Update androidScheme 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

: Di __CAPGO_KEEP_0__ 6,: In Capacitor 6, https untuk aplikasi yang sudah ada untuk memungkinkan aplikasi __CAPGO_KEEP_0__ menggunakan fitur Autofill sistem. Untuk menghindari kehilangan data sebagai hasil dari perubahan ini, atur scheme ke androidScheme for existing apps to better enable Capacitor applications to use the system Autofill feature. To avoid data loss as a result of this change, set the scheme to http Update androidScheme
```
{
  server: {
    androidScheme: "http"
  }
}
```
Perbarui Versi Kotlin: Jika proyek Anda menggunakan Kotlin, perbarui variabel ke kotlin_version Perubahan Fungsi Plugin '1.8.20'.

Perubahan Fungsi Plugin yang Berikut telah diubah atau dihapus. Perbarui __CAPGO_KEEP_0__ Anda sesuai:

The following plugin functionality has been modified or removed. Update your code accordingly:

Peta Browser
Kamera
Peralatan
Geolokasi
Peta Google
Pemberitahuan Lokal
Pemberitahuan Lokal
Notifikasi Push
Bar Status

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"/>Push Notifikasi AndroidManifest.xml.
Bar Status androidxMaterialVersion variabel ke 1.8.0.
Perbarui ke androidxExifInterfaceVersion variabel ke 1.3.6.

Ponsel

Ganti DeviceId.uuid ke DeviceId.identifier.
di iOS 16+ DeviceInfo.name akan mengembalikan nama perangkat umum kecuali Anda menambahkan hak istimewa yang tepat Geolokasi.

Perbarui ke

ke playServicesLocationVersion context 21.0.1.

Google Maps

Perbarui variabel-variabel berikut:
- 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 menghadapi __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() dan requestPermissions() secara.

Pemberitahuan Push

For Android 13, a new runtime permission check is required to receive push notifications when targeting SDK 33. Call checkPermissions() Untuk Android 13, perlu dilakukan pengecekan izin runtime baru untuk menerima pemberitahuan push ketika mengarahkan ke __CAPGO_KEEP_0__ 33. Panggil requestPermissions() dan
context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI pendek atau item navigasi. Dilihat di: halaman trust.astro. Pesan kunci `and` (Dan). firebaseMessagingVersion secara. 23.1.2.

Perbarui

ke FADE.

By following these steps and updating your code accordingly, you should now have successfully updated your project from Capacitor 4 to Capacitor 5. Make sure to test your application thoroughly to ensure that all features and plugins are working as expected.

Keep going from Updating from Capacitor 4 to Capacitor 5: A Step-by-Step Guide

Dengan mengikuti langkah-langkah ini dan memperbarui __CAPGO_KEEP_0__ Anda secara, Anda seharusnya sudah berhasil memperbarui proyek Anda dari __CAPGO_KEEP_1__ 4 ke __CAPGO_KEEP_2__ 5. Pastikan untuk menguji aplikasi Anda secara menyeluruh untuk memastikan bahwa semua fitur dan plugin berfungsi seperti yang diharapkan. Update 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, Tambah atau Perbarui Plugin untuk detail implementasi di Tambah atau Perbarui Plugin, Gantian Plugin Ionic Enterprise untuk alur kerja produk di Gantian Plugin Ionic Enterprise, dan Capgo Pembangunan Native untuk alur kerja produk di Capgo Pembangunan Native.