CloudflareのCapacitor 4からCapacitorのCapacitor 5へのアップデートの手順

Capacitor 4 から Capacitor 5 へのアップデートの場合、以前のアップデートと比較して最小限の変更が伴います。このガイドでは、プロジェクトを Capacitor 5 にアップデートするためのステップバイステップの指示と公式プラグインの破壊的な変更のリストを提供します。

注意: Capacitor 5 requires NodeJS 16 or higher, as Node 12 has reached end-of-life and Node 14 will reach end-of-life on April 30th, 2023. It is recommended to use the latest LTS version of NodeJS.

__CAPGO_KEEP_0__ latest プロジェクト内で使用されている Capacitor CLI のバージョン:
```
npm i -D @capacitor/cli@latest
```
以下のコマンドを実行して、CLI がマイグレーションを管理するようにします:
```
npx cap migrate
```
マイグレーションステップのいくつかが実行できない場合、ターミナル出力に追加情報が表示されます。手動マイグレーションステップは以下に記載されています。
If you have the VS Code extension installed, check the recommendations section of the extension to find the option to migrate your project to Capacitor 5.

Upgrading Capacitor 4 iOS Project to Capacitor 5

Xcode をアップグレードする:: Capacitor 5 requires Xcode 14.1+.
.gitignore を更新する:: 以下の変更を実行してください。 .gitignore ファイル:
```
- App/Podfile.lock
+ App/output
```
.gitignore を更新する:: アプリのアイコンを 1 つに統合するようにアセットを更新してください。Xcode 14 では、1024x1024 のアプリアイコンがサポートされています。不要なサイズをすべて削除して、AppIcon.appiconset を整理してください。

Android ProjectをCapacitor 4からCapacitor 5にアップグレードする

Android Studioをアップグレードする: Capacitor 5では、Gradle 8の使用により、Java JDK 17が必要です。Java 17はAndroid Studio Flamingoに含まれているため、追加のダウンロードは必要ありません。
AGPアップグレードアシスタントを実行する: Android Studioは、Gradleとパッケージの移動に関する更新を手助けすることができます。開始するには、 Tools -> AGP Upgrade Assistant.

Android Projectの変数をアップデートする: 以下の新しい最小値に更新する variables.gradle 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'

Gradle プラグインを8.0.0にアップデートする:

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

Gradleワッパーを8.0.2にアップデートする:

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

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

AGPアップグレードアシスタントを実行する:

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

パッケージを移動する 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

androidSchemeを更新する: Capacitor 6 から https __CAPGO_KEEP_0__ がシステムのオートフィル機能を使用できるようにするために、既存のアプリケーションに __CAPGO_KEEP_0__ を使用するようにするために、 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 現在のデフォルト値でもある
```
{
  server: {
    androidScheme: "http"
  }
}
```
Kotlinバージョンを更新する: Kotlinを使用するプロジェクトの場合、 kotlin_version __CAPGO_KEEP_0__ を '1.8.20'.

プラグインの機能変更

以下のプラグインの機能が変更または削除されました。code を更新してください:

アクションシート
ブラウザ
カメラ
デバイス
位置情報
Google マップ
ローカル通知
プッシュ通知
ステータスバー

アクションシート

を更新する androidxMaterialVersion __CAPGO_KEEP_0__を 1.8.0.

__CAPGO_KEEP_0__に

更新する androidxBrowserVersion __CAPGO_KEEP_0__を 1.5.0.

カメラ

Android 13の場合、読み取り専用のメディア画像の許可 (<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>) を AndroidManifest.xml.
更新する androidxMaterialVersion __CAPGO_KEEP_0__を 1.8.0.
更新する androidxExifInterfaceVersion __CAPGO_KEEP_0__を 1.3.6.

デバイス

変更 DeviceId.uuid に DeviceId.identifier.
iOS 16+ DeviceInfo.name は、適切な特権を追加しない場合、一般的なデバイス名を返します。特権.

位置情報

を更新してください playServicesLocationVersion Google Maps 21.0.1.

を更新してください

を
- googleMapsPlayServicesVersion に 18.1.0.
- googleMapsUtilsVersion に 3.4.0.
- googleMapsKtxVersion に 3.4.0.
- googleMapsUtilsKtxVersion に 3.4.0.
- kotlinxCoroutinesVersion に 1.6.4.
- androidxCoreKTXVersion に 1.10.0.
- kotlin_version に 1.8.20.

ローカル通知

SDK 33 のターゲットに設定されている場合、Android 13 に対してローカル通知をスケジュールするために必要な新しいランタイムパーミッションチェックを呼び出してください。 checkPermissions() 、 requestPermissions() 。

プッシュ通知

SDK 33 のターゲットに設定されている場合、Android 13 に対してプッシュ通知を受信するために必要な新しいランタイムパーミッションチェックを呼び出してください。 checkPermissions() 、 requestPermissions() 。
更新 firebaseMessagingVersion 変数を 23.1.2.

ステータスバー

iOSで、デフォルトのステータスバーアニメーションが変更されました。 FADE.

codeのバージョンをCapacitorからCapacitorにアップグレードするには、以下の手順に従い、codeを更新する必要があります。Capacitor 4からCapacitor 5にアップグレードした後、すべての機能とプラグインが期待どおりに動作することを確認するために、ご自身のアプリケーションを徹底的にテストしてください。

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

__CAPGO_KEEP_0__を使用している場合 Updating from Capacitor 4 to Capacitor 5: A Step-by-Step Guide __CAPGO_KEEP_0__を接続する Capgo プラグインディレクトリ Capgo プラグインディレクトリの製品ワークフロー Capacitor プラグインズ by Capgo Capacitor プラグインズ by Capgo の実装詳細プラグインの追加または更新プラグインの追加または更新の実装詳細について Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの製品ワークフローについて Capgoネイティブビルド Capgoネイティブビルドの製品ワークフローについて

Capacitor 4 から Capacitor 5 へのアップデートの手順