跳到主要内容
版本：v2

更新 Capacitor Android 项目

有时，您需要对 Android 应用进行 Capacitor 更新，包括更新应用中使用的 Capacitor 版本，或在 Android 代码库中使用与 Capacitor 交互的新方式。

更新 Capacitor Android 库​

要更新应用中使用的 @capacitor/android 版本，只需通过 npm 安装最新版本：

npm install @capacitor/android@2

然后从 Android Studio 中点击 "Sync Project with Gradle Files" 按钮。

更新 Android 项目​

要更新 Android 项目的基本结构，请查看 Capacitor 仓库中对应最新稳定版 Capacitor 标签下的 android-template 项目。核心项目有意保持简洁：您不需要花太多时间就能看出核心项目与您的项目之间的差异。

从 1.0.0 到 1.1.0​

建议的更改：

  • 使用 这些更改 更新 android 文件夹内的 .gitignore 文件

从 <= 1.3.0 到 1.4.0​

建议的更改：

  • 使用 此更改 更新 android/app/src/main/res/values/ 文件夹内的 strings.xml 文件

从 <= 1.5.1 到 2.0.0​

强制更改：

  • 使用 Android X

    Capacitor 2.0 使用 Android X 作为 Android 支持库依赖项（如 Google 推荐），因此原生项目也需要更新为使用 Android X。

    从 Android Studio 执行 Refactor -> Migrate to AndroidX。然后点击 Migrate 按钮，最后点击 Do Refactor。

    如果使用的 Cordova 或 Capacitor 插件尚未使用 Android X，您可以使用 jetifier 工具来修补它们。

npm install -D jetifier
npx jetifier

要使其在每次安装包后自动运行，请在 package.json 的 "scripts" 下添加 "postinstall": "jetifier"。

建议的更改：

  • 创建公共变量

    创建一个包含以下内容的 android/variables.gradle 文件

    ext {
      minSdkVersion = 21
      compileSdkVersion = 29
      targetSdkVersion = 29
      androidxAppCompatVersion = '1.1.0'
      androidxCoreVersion =  '1.2.0'
      androidxMaterialVersion =  '1.1.0-rc02'
      androidxBrowserVersion =  '1.2.0'
      androidxLocalbroadcastmanagerVersion =  '1.0.0'
      firebaseMessagingVersion =  '20.1.2'
      playServicesLocationVersion =  '17.0.0'
      junitVersion =  '4.12'
      androidxJunitVersion =  '1.1.1'
      androidxEspressoCoreVersion =  '3.2.0'
      cordovaAndroidVersion =  '7.0.0'
    }

    在 android/build.gradle 文件中，按照 此处 所示添加 apply from: "variables.gradle"。

  • 使用公共变量

    如果您创建了 variables.gradle 文件，请更新您的项目以使用它们。在 android/app/build.gradle 文件中，进行以下更改：

    • 将 compileSdkVersion 28 改为 compileSdkVersion rootProject.ext.compileSdkVersion
    • 将 minSdkVersion 21 改为 minSdkVersion rootProject.ext.minSdkVersion
    • 将 targetSdkVersion 28 改为 targetSdkVersion rootProject.ext.targetSdkVersion
    • 将 implementation 'androidx.appcompat:appcompat:1.0.0' 改为 implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
    • 将 testImplementation 'junit:junit:4.12' 改为 testImplementation "junit:junit:$junitVersion"
    • 将 androidTestImplementation 'androidx.test.ext:junit:1.1.1' 改为 androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
    • 将 androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.0' 改为 androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

    注意它们现在使用的是双引号而不是单引号，这是变量正常工作所必需的。

  • 建议更新 Android Studio 插件

    当您在 Android Studio 中打开 Android 项目时，会出现一条 Plugin Update Recommended 消息。点击 update。它会告诉您更新 Gradle 插件和 Gradle。点击 Update 按钮。

    您也可以手动更新 Gradle 插件和 Gradle。

    要手动更新 Gradle 插件，请编辑 android/build.gradle 文件。将 classpath 'com.android.tools.build:gradle:3.3.2' 改为 classpath 'com.android.tools.build:gradle:3.6.1'。

    要手动更新 Gradle，请编辑 android/gradle/wrapper/gradle-wrapper.properties。将 gradle-4.10.1-all.zip 改为 gradle-5.6.4-all.zip。

  • 更新 Google Services 插件

    在 android/build.gradle 文件中，将 classpath 'com.google.gms:google-services:4.2.0' 改为 classpath 'com.google.gms:google-services:4.3.3'。

  • 更改 configChanges 以避免应用重启

    在 android/app/src/main/AndroidManifest.xml 文件中，在 activity 的 android:configChanges 属性中添加 |smallestScreenSize|screenLayout|uiMode。

  • 向 FileProvider 文件路径添加 caches 文件夹，以避免编辑图库图片时的权限错误。

    在 android/app/src/main/res/xml/file_paths.xml 中添加 <cache-path name="my_cache_images" path="." />。

关于 API 更改，请查看 发布说明。

Contents

编辑此页