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

与之前的更新相比，Capacitor 4到Capacitor 5的过渡涉及最小的破坏性更改。这份指南提供了从Capacitor 4升级到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.

安装 latest 在您的项目中使用的 Capacitor CLI 的版本：
```
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 更新 Assets 以使用单个应用图标：
```
- App/Podfile.lock
+ App/output
```
Xcode 14 支持 1024x1024 的单个应用图标。清理您的 AppIcon.appiconset 并删除所有不必要的大小。: Xcode 14 supports a single app icon of 1024x1024. Clean up your AppIcon.appiconset by removing all unnecessary sizes.

升级 Capacitor 4 Android 项目到 Capacitor 5

升级 Android Studio: Capacitor 5 需要 Android Studio Flamingo | 2022.2.1 或更新版本，因为使用 Gradle 8，Gradle 8 需要 Java JDK 17。Java 17 与 Android Studio Flamingo 一起提供，因此无需额外下载。
运行 AGP Upgrade 助手: 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 服务:

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

更新 Gradle 插件到 8.0.0:

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

更新 Gradle 包装器到 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

禁用 Jetifier:

# 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 将成为默认设置 androidScheme 为现有应用程序提供更好的 Capacitor 应用程序使用系统 Autofill 功能的能力。为了避免由于此更改而导致的数据丢失，请将方案设置为 http 现在，即使它是当前默认值
```
{
  server: {
    androidScheme: "http"
  }
}
```
更新Kotlin版本: 如果您的项目使用 Kotlin，更新 kotlin_version 变量 '1.8.20'.

插件功能更改

以下插件功能已修改或删除。更新您的 code 以及：

Action Sheet
浏览器
相机
设备
地理位置
谷歌地图
本地通知
推送通知
状态栏

操作面板

更新 androidxMaterialVersion __CAPGO_KEEP_0__ 1.8.0.

__CAPGO_KEEP_1__

更新 androidxBrowserVersion 变量为 1.5.0.

相机

为 Android 13, 在<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>更新 AndroidManifest.xml.
变量为 androidxMaterialVersion 更新 1.8.0.
变量为 androidxExifInterfaceVersion 设备 1.3.6.

切换

到 DeviceId.uuid __CAPGO_KEEP_0__ DeviceId.identifier.
On iOS 16+， DeviceInfo.name 将返回一个通用设备名称，除非您添加适当的权限.

地理位置

更新 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.

本地通知

对于 Android 13，需要在目标 SDK 33 时执行新版运行时权限检查才能在本地发送通知。请 checkPermissions() 和 requestPermissions() 按照

推送通知

对于 Android 13，需要在目标 SDK 33 时执行新版运行时权限检查才能接收推送通知。请 checkPermissions() 和 requestPermissions() 按照
更新 firebaseMessagingVersion 变量到 23.1.2.

状态栏

在 iOS 上，已将默认状态栏动画更改为 FADE.

通过遵循这些步骤并更新您的 code，您应该现在已经成功更新了您的项目从 Capacitor 4 到 Capacitor 5。确保测试您的应用程序以确保所有功能和插件都按预期工作。

继续从 Updating from Capacitor 4 到 Capacitor 5：一步步指南

如果您正在使用 从 Capacitor 4 到 Capacitor 5：一步步指南 来规划原生插件工作，连接它与 Capgo 插件目录为产品工作流程在 Capgo 插件目录， Capacitor 由 Capgo 插件为实现细节在 Capacitor 由 Capgo 插件，添加或更新插件添加或更新插件的实现细节 Ionic 企业插件替代品 Ionic 企业插件替代品的产品工作流程 Capgo 原生构建 Capgo 原生构建的产品工作流程