Capacitor 4에서 Capacitor 5로 업데이트하는 방법: 단계별 안내

Capacitor 4에서 Capacitor 5로의 전환은 이전 업데이트와 비교하여 최소한의 깨진 변경 사항을 포함합니다. 이 안내서에서는 Capacitor 5로 업데이트하는 프로젝트에 대한 단계별 지침을 제공하며, 공식 플러그인에 대한 깨진 변경 사항 목록도 제공합니다.

주의Capacitor 5는 NodeJS 16 이상이 필요하며, Node 12은 종료되었으며 Node 14은 2023년 4월 30일 종료될 예정입니다. 최신 LTS 버전의 NodeJS를 사용하는 것을 권장합니다.

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__의 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을 업데이트하세요: __CAPGO_KEEP_0__ 4에서 __CAPGO_KEEP_1__ 5로 업그레이드하는 방법 .gitignore : 파일:
```
- App/Podfile.lock
+ App/output
```
업데이트 자산을 사용하는 단일 앱 아이콘으로 변경하십시오컨텍스트: 해결 방법 페이지 앱 예시 섹션. 역할: 이미지 대체 텍스트. 보이는 곳: 컴포넌트 솔루션/솔루션 앱 예시.아스트로. 메시지 키 `solution_app_examples_icon_alt` (Solution App Examples Icon Alt).

Upgrading Capacitor 4 Android Project to Capacitor 5

__CAPGO_KEEP_0__ 4 Android 프로젝트를 __CAPGO_KEEP_1__ 5로 업그레이드하는 방법: Capacitor 5 requires Android Studio Flamingo | 2022.2.1 or newer due to the usage of Gradle 8, which requires Java JDK 17. Java 17 ships with Android Studio Flamingo, so no additional downloads are needed.
: __CAPGO_KEEP_0__ 5는 Gradle 8의 사용으로 인해 Android Studio Flamingo | 2022.2.1 이상이 필요합니다. Java JDK 17이 필요하며 Java 17은 Android Studio Flamingo와 함께 제공됩니다. 따라서 별도의 다운로드가 필요하지 않습니다.AGP 업그레이드 어시스턴트 실행 Tools -> AGP Upgrade Assistant.

: Android Studio는 Gradle과 패키지의 이동과 관련된 일부 업데이트를 도와줄 수 있습니다. 시작하려면 Android 프로젝트 변수 업데이트 variables.gradle : __CAPGO_KEEP_0__ 파일에서 다음 새로운 최소값으로 업데이트하십시오:

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:

# 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 wrapper를 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 현재 __CAPGO_KEEP_0__ 앱의 기본 설정으로 androidScheme 기존 앱을 위해 Capacitor 앱이 시스템의 Autofill 기능을 사용할 수 있도록 하기 위해 http 이 변경으로 인해 데이터 손실을 피하기 위해 scheme을
```
{
  server: {
    androidScheme: "http"
  }
}
```
현재 기본 설정으로 설정되어도Kotlin 버전을 업데이트하십시오. Kotlin을 사용하는 프로젝트의 경우 kotlin_version 변수에 대한 '1.8.20'.

플러그인 기능 변경

다음 플러그인 기능이 수정되거나 제거되었습니다. code을 업데이트하십시오:

액션 시트
브라우저
카메라
장치
위치 정보
구글 맵
로컬 알림
푸시 알림
상태 바

업데이트

Capacitor 5로 업데이트하는 방법 androidxMaterialVersion Capacitor 5로 업그레이드 1.8.0.

Capacitor 5

Capacitor 5 androidxBrowserVersion Capacitor 5 1.5.0.

Capacitor 5

Capacitor 5<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>Capacitor 5 AndroidManifest.xml.
Capacitor 5 androidxMaterialVersion Capacitor 5 1.8.0.
Capacitor 5 androidxExifInterfaceVersion 변수에 1.3.6.

장치

변경 DeviceId.uuid 로 DeviceId.identifier.
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에서 지역 알림을 예약하기 위해 __CAPGO_KEEP_0__ 33을 대상으로 하려면 새로운 런타임 권한 확인이 필요합니다. Call

For Android 13, a new runtime permission check is required to schedule local notifications when targeting SDK 33. Call checkPermissions() 따라서. requestPermissions() 푸시 알림

푸시 알림

Android 13 에서 푸시 알림을 받으려면 SDK 33. Call 에서 새로운 런타임 권한 검사를 필요로 합니다. checkPermissions() 그리고 requestPermissions() 따라서.
업데이트 하세요. firebaseMessagingVersion 변수를 23.1.2.

Status Bar

iOS 에서 기본 상태栏 애니메이션은 __CAPGO_KEEP_0__ 에서 변경되었습니다. FADE.

code 을 업데이트하고 이 안내를 따르면 Capacitor 4 에서 Capacitor 5 로 프로젝트를 성공적으로 업데이트한 것으로 생각합니다. 모든 기능과 플러그인이 예상대로 작동하는지 확인하기 위해 애플리케이션을 철저히 테스트하세요.

Capacitor 4 에서 Capacitor 5 로 업데이트하는 방법: 단계별 안내

__CAPGO_KEEP_0__ 4 에서 __CAPGO_KEEP_1__ 5 로 업데이트하는 방법: 단계별 안내 Capacitor 4 에서 Capacitor 5 로 업데이트하는 방법: 단계별 안내 native 플러그인 작업을 계획하고 연결하려면 Capgo 플러그인 디렉토리 for the product workflow in Capgo Plugin Directory, Capacitor Capacitor 5에서 Capgo Capacitor 5에서 Capacitor Capacitor 5에서 Capgo 플러그인 추가 또는 업데이트 Capacitor 5에서 플러그인 추가 또는 업데이트 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 대체 Capgo 네이티브 빌드 Capacitor 5에서 Capgo 네이티브 빌드