版本重點

升級方式

cordova platform remove android
cordova platform add android@12.0.0

安裝方式

cordova platform add android@12.0.0

重大變更

提高最低和目標 SDK 版本

此版本已將最低支援的 SDK 版本提高到 24，也就是 Android 7.0。它也將目標 SDK 提高到 33，也就是 Android 13。
建置工具

要使用 cordova-android@12，必須安裝 SDK 平台 33 和 SDK 建置工具 33.0.2。如果專案中不再使用舊版本的 cordova-android，則可以解除安裝舊版本的建置工具。

安裝 SDK 平台 33
1. 開啟 Android Studio 的 SDK 管理員
2. 點擊 SDK Platforms 標籤
3. 勾選 Android 13.0 (Tiramisu)，其 API Level 為 33
4. 點擊 Apply
安裝 SDK 建置工具 33.0.2
1. 開啟 Android Studio 的 SDK 管理員
2. 點擊 SDK Tools 標籤
3. 勾選 Show Package Details
4. 展開 Android SDK Build-Tools
5. 勾選 33.0.2
6. 點擊 Apply
專案相依性

以下專案相依性已更新
- Kotlin：1.7.21
- Gradle：7.6
- Android Gradle 外掛程式 (AGP)：7.4.2
- Google Services Gradle 外掛程式：4.3.15
- AndroidX App Compat 程式庫：1.6.1
- AndroidX WebKit 程式庫：1.6.0
- AndroidX SplashScreen Core 程式庫：1.0.0
如果您或外掛程式對以下任何設定偏好設定進行了變更，則此版本的建置結果可能與預期的結果不符
- android-minSdkVersion
- android-maxSdkVersion
- android-targetSdkVersion
- android-compileSdkVersion
- android-buildToolsVersion
- GradleVersion
- AndroidGradlePluginVersion
- GradlePluginKotlinVersion
- AndroidXAppCompatVersion
- AndroidXWebKitVersion
- GradlePluginGoogleServicesVersion
請注意此版本中已更新的版本。如果您手動修改了這些值中的任何一個，建議您檢閱並相應地更新偏好設定值。
Node 支援

我們已停止支援 Node 14.x，並將最低 Node 要求提高到大於或等於 16.13.0。

新功能

單色支援

Android 13 新增了主題圖示支援，也稱為單色。此版本已導入對主題圖示的支援。

請在我們的 Cordova-Android GitHub 問題追蹤器上回報您發現的任何問題！

變更內容包括

重大變更

GH-1605 fix!: 使 CoreAndroid 外掛程式在載入時例項化
GH-1539 feat!: 升級 Gradle 7.6 和 AGP 7.4.2
GH-1571 feat!: 將最低 SDK 提高到 24
GH-1538 feat!: 提高目標 SDK 和建置工具以支援 SDK 33
GH-1540 feat!: 提高 node engine 的最低要求 >=16.13.0
GH-1597 deprecate: CoreAndroid.getBuildConfigValue
GH-1541 dep(npm)!: 使用重建的 package-lock 來更新可接受的模組
GH-1566 dep(npm)!: 升級 cordova-common@5.0.0

功能

GH-1602 feat: 新增 listTarget api
GH-1574 feat: 為 WebViewClient.onRenderProcessGone 新增外掛程式掛鉤
GH-1594 feat: 將預設 kotlin 升級到 1.7.21 版
GH-1550 feat: 新增 monochrome 應用程式圖示支援
GH-1589 feat: InspectableWebview 偏好設定
GH-1568 feat: 升級 androidx.appcompat.appcompat 1.6.1
GH-1567 feat: 升級 androidx.webkit.webkit 1.6.0
GH-1547 feat: 升級 com.google.gms.google-services 4.3.15
GH-1546 feat: 升級 androidx.core.core-splashscreen 1.0.0

修正

GH-1606 fix: Gradle 參數解析
GH-1575 fix(BuildHelper): 從 ApplicationInfo 取得套件名稱
GH-1595 fix(test): 原生測試命名空間重構
GH-1471 fix: ANDROID_HOME 是新的預設值，請先檢查並提供建議
GH-1573 fix(GH-1432): 當內容標籤遺失時，預設 content src
GH-1506 fix: 僅在 FadeSplashScreen 為 true 時執行淡出動畫
GH-1505 fix: 正確標記 Maven 的 AppCompat API 相依性
GH-1487 fix: 將 Android 前綴新增至 WindowSplashScreenBrandingImage
GH-1489 fix: 從已過時的 cordova-plugin-splashscreen 匯入類型定義

雜項、重構、相依性和 CI

GH-1493 chore: 新增 lint:fix 指令碼以修正 lint 錯誤
GH-1491 chore: 使用 gradle 7.4.2 發佈網址
GH-1588 refactor: 移除過時的版本代碼檢查
GH-1492 refactor: 取代已棄用的 Handler 建構函式
GH-1587 dep: 升級 npm 相依性
- fs-extra@11.1.1
- nopt@7.1.0
- @cordova/eslint-config@5.0.0
- jasmine@4.6.0
GH-1607 ci: 將 NodeJS 20.x 新增至工作流程矩陣
GH-1542 ci(workflow): 更新 codecov/codecov-action@v3
GH-1532 ci: 更新 codecov/codecov-action 回報格式

部落格 RSS Feed

版本重點

變更內容包括