Capacitor 4からCapacitor 5へのアップグレード：ステップバイステップガイド

Capacitor 4からCapacitor 5への移行は、以前のアップデートと比較して、重大な変更は最小限です。このガイドでは、プロジェクトをCapacitor 5にアップデートするための手順と、公式プラグインの変更点を説明します。

注意: Capacitor 5はNodeJS 16以上が必要です。Node 12はすでにサポート終了しており、Node 14は2023年4月30日にサポート終了となります。NodeJSの最新LTSバージョンの使用を推奨します。

プロジェクトにCapacitor CLIのlatestバージョンをインストールします：
```
npm i -D @capacitor/cli@latest
```
以下のコマンドを実行して、CLIに移行を処理させます：
```
npx cap migrate
```
移行手順が実行できない場合は、ターミナル出力に追加情報が表示されます。手動での移行手順は以下に記載されています。
VS Code拡張機能をインストールしている場合、拡張機能の推奨セクションでプロジェクトをCapacitor 5に移行するオプションを確認してください。

Capacitor 4 iOSプロジェクトからCapacitor 5へのアップグレード

Xcodeのアップグレード: Capacitor 5にはXcode 14.1以上が必要です。
.gitignoreの更新: .gitignoreファイルに以下の変更を加えてください：
```
- App/Podfile.lock
+ App/output
```
単一のアプリアイコンを使用するようにアセットを更新: Xcode 14は1024x1024の単一アプリアイコンをサポートします。不要なサイズを削除してAppIcon.appiconsetをクリーンアップしてください。

Capacitor 4 AndroidプロジェクトからCapacitor 5へのアップグレード

Android Studioのアップグレード: Capacitor 5はGradle 8の使用によりJava JDK 17が必要なため、Android Studio Flamingo | 2022.2.1以降が必要です。Java 17はAndroid Studio Flamingoに同梱されているため、追加のダウンロードは不要です。
AGPアップグレードアシスタントの実行: Android StudioはGradleに関連する更新とパッケージのビルドファイルへの移動を支援できます。開始するには、Tools -> AGP Upgrade Assistantを実行してください。

Androidプロジェクト変数の更新: variables.gradleファイルで、以下の新しい最小値に更新してください：

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'

Google Servicesの更新:

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

Gradleプラグインを8.0.0に更新:

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

Gradleラッパーを8.0.2に更新:

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

Jetifierを無効化:

android.useAndroidX=true
- android.enableJetifier=true

パッケージをbuild.gradleに移動:

<?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">

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

androidSchemeの更新: Capacitor 6では、既存のアプリのシステムAutofill機能をより良く有効にするため、androidSchemeのデフォルト設定がhttpsになります。このデータ損失を避けるため、現在のデフォルトであっても、スキームをhttpに設定してください。
```
{
  server: {
    androidScheme: "http"
  }
}
```
Kotlinバージョンの更新: プロジェクトでKotlinを使用している場合、kotlin_version変数を'1.8.20'に更新してください。

プラグイン機能の変更

以下のプラグイン機能が変更または削除されました。コードを適切に更新してください：

Action Sheet
Browser
Camera
Device
Geolocation
Google Maps
Local Notifications
Push Notifications
Status Bar

Action Sheet

androidxMaterialVersion変数を1.8.0に更新してください。

Browser

androidxBrowserVersion変数を1.5.0に更新してください。

Camera

Android 13の場合、AndroidManifest.xmlにメディア画像読み取り権限（<?xml version="1.0" encoding="utf-8"?>）を追加してください。
androidxMaterialVersion変数を1.8.0に更新してください。
androidxExifInterfaceVersion変数を1.3.6に更新してください。

Device

DeviceId.uuidをDeviceId.identifierに変更してください。
iOS 16以降では、適切なエンタイトルメントを追加しない限り、DeviceInfo.nameは一般的なデバイス名を返します。

Geolocation

playServicesLocationVersionを21.0.1に更新してください。

Google Maps

以下の変数を更新してください：
- 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に

Local Notifications

Android 13でSDK 33をターゲットにする場合、ローカル通知をスケジュールするには新しいランタイム権限チェックが必要です。checkPermissions()とrequestPermissions()を適切に呼び出してください。

Push Notifications

Android 13でSDK 33をターゲットにする場合、プッシュ通知を受信するには新しいランタイム権限チェックが必要です。checkPermissions()とrequestPermissions()を適切に呼び出してください。
firebaseMessagingVersion変数を23.1.2に更新してください。

Status Bar

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

これらの手順に従いコードを更新することで、プロジェクトをCapacitor 4からCapacitor 5に正常にアップデートできるはずです。すべての機能とプラグインが期待通りに動作することを確認するため、アプリケーションを十分にテストしてください。