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

Capacitor 4에서 Capacitor 5로 업데이트하는 데에는 이전 업데이트와 비교하여 최소한의 중단 변경이 포함됩니다. 이 안내서에서는 프로젝트를 Capacitor 5로 업데이트하는 단계별 지침 및 공식 플러그인의 중단 변경 목록을 제공합니다.

주의Capacitor 5는 NodeJS 16 이상을 요구하며, Node 12은 종료되었으며 Node 14은 2023년 4월 30일 종료될 예정입니다. 최신 LTS 버전의 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 파일:
```
- App/Podfile.lock
+ App/output
```
Assets를 단일 앱 아이콘으로 업데이트하세요: Xcode 14는 1024x1024의 단일 앱 아이콘을 지원합니다. 불필요한 크기를 제거하여 AppIcon.appiconset를 정리하세요.

Capacitor 4 Android 프로젝트를 Capacitor 5로 업그레이드하세요.

Android Studio 업그레이드: Capacitor 5는 Android Studio Flamingo | 2022.2.1 이상이 필요합니다. 이는 Gradle 8의 사용으로 인해 Java JDK 17이 필요하기 때문입니다. Java 17은 Android Studio Flamingo와 함께 제공되므로 추가 다운로드가 필요하지 않습니다.
AGP 업그레이드 도우미 실행: Android Studio는 Gradle과 빌드 파일에 패키지를 이동하는 관련된 업데이트를 도와줄 수 있습니다. 시작하려면 Tools -> AGP Upgrade Assistant.

Android 프로젝트 변수 업데이트: __CAPGO_KEEP_0__ 파일에서 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 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

Move package to 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

Update androidSchemeCapacitor 버전 6에서 : https __CAPGO_KEEP_0__의 기본 설정으로 androidScheme Capacitor 앱을 위해 기존 앱을 Capacitor하여 시스템의 Autofill 기능을 사용할 수 있도록 하기 위해 http 데이터 손실을 피하기 위해 scheme을
```
{
  server: {
    androidScheme: "http"
  }
}
```
현재 기본 설정이더라도 Update Kotlin version kotlin_version __CAPGO_KEEP_0__ 프로젝트가 Kotlin을 사용하는 경우 __CAPGO_KEEP_0__을 '1.8.20'.

변수에

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

다음 __CAPGO_KEEP_0__ 플러그인 기능이 수정되거나 제거되었습니다. __CAPGO_KEEP_0__을 업데이트하십시오:
브라우저
카메라
장치
위치 정보
구글 맵
지역 알림
푸시 알림
상태 바

액션 시트

업데이트 하기 androidxMaterialVersion __CAPGO_KEEP_0__ 1.8.0.

브라우저

업데이트 하기 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 로 DeviceId.identifier.
On iOS 16+, __CAPGO_KEEP_0__ DeviceInfo.name __CAPGO_KEEP_0__의 경우, 일반적인 장치 이름이 반환됩니다. 해당 권한을 추가해야 합니다. Geolocation.

__CAPGO_KEEP_0__를

Google Maps playServicesLocationVersion __CAPGO_KEEP_0__를 21.0.1.

__CAPGO_KEEP_0__를

__CAPGO_KEEP_0__를
- googleMapsPlayServicesVersion __CAPGO_KEEP_0__를 18.1.0.
- googleMapsUtilsVersion __CAPGO_KEEP_0__를 3.4.0.
- googleMapsKtxVersion __CAPGO_KEEP_0__를 3.4.0.
- googleMapsUtilsKtxVersion __CAPGO_KEEP_0__를 3.4.0.
- kotlinxCoroutinesVersion 을 1.6.4.
- androidxCoreKTXVersion 을 1.10.0.
- kotlin_version 을 1.8.20.

지구 근처 알림

Android 13을 대상으로 할 때 SDK 33. Call을 호출하여 지구 근처 알림을 예약하려면 새로운 런타임 권한 검사를 호출해야 합니다. Call checkPermissions() 및 requestPermissions() 따라서.

푸시 알림

Android 13을 대상으로 할 때 SDK 33. Call을 호출하여 푸시 알림을 받으려면 새로운 런타임 권한 검사를 호출해야 합니다. Call checkPermissions() 및 requestPermissions() 따라서.
업데이트 firebaseMessagingVersion 변수에 23.1.2.

상태 표시줄

iOS에서 기본 상태 표시줄 애니메이션을 변경했습니다. FADE.

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

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

__CAPGO_KEEP_0__ 4에서 __CAPGO_KEEP_1__ 5로 업데이트하는 경우 Capacitor 4에서 Capacitor 5로 업데이트하는 경우 자연스러운 네이티브 플러그인 작업을 계획하고 싶다면 __CAPGO_KEEP_0__ Plugin Directory와 연결하세요. Capgo Plugin Directory에서 제품 워크플로우를 확인하세요. Capgo Plugins by __CAPGO_KEEP_1__ Capacitor Plugins by Capgo의 구현 세부 사항을 확인하세요. If you are using Capacitor 4 and want to update to Capgo 5, follow these steps and update your Capacitor accordingly. You should now have successfully updated your project from Capacitor 4 to Capgo 5. Make sure to test your application thoroughly to ensure that all features and plugins are working as expected. 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 세부 사항에 대해 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 제품 워크플로에 대해 Capgo 네이티브 빌드 Capgo 네이티브 빌드 제품 워크플로에 대해