我們很高興宣佈,我們剛剛發佈了 cordova-plugin-file
的更新!
升級方式
cordova plugin remove cordova-plugin-file
cordova plugin add cordova-plugin-file@8.1.3
此修補程式修正了當應用程式透過 schemes 主機託管時,iOS 裝置上的 FileEntry.toURL()
問題。此 API 的目的是產生可用於 DOM 的 URL,例如用於圖片標籤。然而,當 webview 配置為使用 schemes 時,iOS 裝置總是產生無法使用的 file://
URI。
從 8.1.3 開始,如果 iOS webview 配置為使用 app schemes,FileEntry.toURL()
將產生一個 app-scheme URI,否則將產生一個 file://
URI。
這使行為更接近 Android 的實作。
請依照 如何提交錯誤 指南報告您發現的任何問題!
我們很高興宣佈,我們剛剛發佈了 cordova-plugin-camera
的重大更新!
升級方式
cordova plugin remove cordova-plugin-camera
cordova plugin add cordova-plugin-camera@8.0.0
這是一個重大更新,因為它包含一些為了更好的目的而進行的破壞性公開 API 機制!
破壞性變更包括
此外,allowEdit
功能現在已棄用。查看更多詳細資訊。
Camera 外掛程式先前在使用 getPicture
API 時,傳回的路徑非常不一致。有時是 file://
URI,有時是原始檔案路徑。應用程式必須檢查,並且通常會自行為路徑加上前綴,才能使用它們。因此,我們將傳回的資料簡化為 URI。
現在,所有平台都一致地傳回 <scheme>:...
。
對於所有平台,當使用 DATA_URL
選項時,傳回的 base64 編碼影像過去只會傳回 base64 編碼的部分。從 v8.0.0 開始,傳回的字串現在包含 data:
URI 標頭,包括 base64 資料表示的 MIME 類型。
對於 iOS,先前總是會一致地傳回 file://
URI,因此這裡沒有進行任何變更。
對於 Android,API 的行為取決於內容的基礎來源而一致。大多數時候,會傳回原始檔案路徑。現在它始終會傳回某種 URI,但與 iOS 不同,假設它會是 file://
URI 是不安全的。
如果您之前正在測試並為檔案路徑加上前綴,則不再需要這樣做。使用 FILE_URI
選項時傳回的所有 URI 都可以由 cordova-plugin-file@8.1.2 或更高版本解析。
有關如何使用結果的範例,請參閱 Camera 外掛程式文件
對於所有使用 FILE_URI
選項的平台,傳回的 URI 僅為暫時存取。
當從相機取得內容時,檔案會儲存在應用程式的臨時目錄中,當磁碟空間不足時,作業系統可能會隨時清除該目錄。
當從使用者的圖庫取得內容時,傳回的 URI 具有作業系統提供的臨時讀取權限,該權限通常在應用程式結束後過期。
這表示不應儲存 getPicture
傳回的 URI。應用程式應根據其需求和要求決定如何處理它。
範例 1: 應用程式正在接收使用者個人資料圖片的影像,並且需要對該內容進行持久存取。
解決方案:應用程式應將內容複製到應用程式的資料目錄,並儲存和使用複製的 URI。
範例 2: 應用程式正在接收要編輯或進行操作的影像。它只需要一次讀取即可將資料載入記憶體,以將資料放入影像編輯器中。
解決方案:應用程式可以安全地使用暫時 URI 來讀取和顯示內容,並稍後儲存經過處理的資料。
對於 Android 7 - 12,此外掛程式過去總是包含 WRITE_EXTERNAL_STORAGE
權限,並且由於實作原因,需要它才能運作。
從 v8.0.0 開始,Camera 外掛程式不再自動包含權限宣告,因為在大多數情況下不再需要它。
如果您的應用程式啟用 saveToPhotoAlbum
選項,則需要在 config.xml
檔案中新增以下內容
<platform name="android">
<config-file target="AndroidManifest.xml" parent="/*" xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
</config-file>
</platform>
如果您的應用程式不使用 saveToPhotoAlbum
,則您的應用程式不需要任何權限即可操作相機或從使用者的圖庫中選取。
嘗試使用 saveToPhotoAlbum
而不宣告 WRITE_EXTERNAL_STORAGE
將導致在 Android 7、Android 8 和 Android 9 裝置上傳回錯誤。
從相機拍攝影像或從圖庫選取影像時,allowEdit
功能現在已棄用。此功能的行為在各平台之間不一致,並且通常不可靠,因為它取決於基礎相機應用程式的支援,而該相機應用程式不是標準的。
該功能目前仍然存在,並且應該可以像文檔所述的警告一樣正常工作,但 Apache Cordova 將不再為使用該功能引起的問題提供支援。allowEdit
選項計劃在稍後完全移除,並且沒有直接的替代方案。
使用 allowEdit
功能的使用者應轉為使用專用的影像處理函式庫。
當應用程式配置為使用 schemes 時,iOS 上的 FileEntry.toURL
方法不會產生可供 DOM 使用的 URI。此問題的 修復 將在稍後提供。同時,可以使用以下方法作為變通方案
// TODO: Remove when https://github.com/apache/cordova-plugin-file/pull/642 is released
function toDomURL(fileEntry) {
if (cordova.platform === "ios") {
return window.WkWebView.convertFilePath(fileEntry.nativeUrl);
}
else {
return fileEntry.toURL();
}
}
如果您的應用程式仍然在 iOS 上以 file://
通訊協定託管,則不需要此變通方案。
當從使用者的圖庫中選取影像時,Android 將開始傳回 content://
而不是 file://
URI,以便使用基礎的 MediaStore API。為了使這些路徑可以解析為可供 DOM 使用的 URL,AndroidInsecureFileModeEnabled
偏好設定必須為 "false"
(預設值)。
請依照 如何提交錯誤 指南報告您發現的任何問題!
我們很高興宣佈發佈 cordova-lib
。
升級方式
如果 Cordova CLI 是全域安裝的
npm uninstall -g cordova
npm install -g cordova@latest
如果 Cordova CLI 是在您的專案中本機安裝的
npm uninstall cordova
npm install cordova@latest
在此修補程式版本中,我們引入了數個修正。最顯著的變更包括
請依照 如何提交錯誤 指南報告您發現的任何問題!
我們很高興宣佈,我們剛剛發佈了 cordova-plugin-file
的更新!
升級方式
cordova plugin remove cordova-plugin-file
cordova plugin add cordova-plugin-file@8.1.2
此修補程式是對回歸問題的修正。有關更多詳細資訊,請參閱 8.1.1 發佈部落格 文章。
在 8.1.1 中,當在任何不指向 Android 上應用程式內部資產的 file://
上使用時,FileEntry.toURL()
方法會中斷。現在已更正此問題。
此錯誤並未影響 iOS 裝置。
請依照 如何提交錯誤 指南報告您發現的任何問題!
我們很高興宣佈,我們剛剛發佈了 cordova-plugin-file
的更新!
升級方式
cordova plugin remove cordova-plugin-file
cordova plugin add cordova-plugin-file@8.1.1
對於 Android,我們修正了阻止在 content://
檔案項目上使用 .toURL()
的問題。現在,.toURL()
將在 file://
和 content://
檔案項目上傳回可供 DOM 使用的 URL。
這對於計劃用於相機外掛程式的即將發佈的版本非常重要。
請注意,AndroidInsecureFileModeEnabled
偏好設定必須關閉。如果 AndroidInsecureFileModeEnabled
偏好設定開啟,則 .toURL()
將傳回基礎 URL,而現代 Android 裝置將拒絕 content://
檔案路徑。如果您的專案仍然使用 AndroidInsecureFileModeEnabled
,現在是時候透過關閉 AndroidInsecureFileModeEnabled
偏好設定來強烈考慮遷移到 schemes。
預設情況下,AndroidInsecureFileModeEnabled
偏好設定已停用。如果您的專案沒有明確啟用它,則不需要任何操作。
對於 iOS,沒有任何變更。
編輯 (2024-10-28):此修補程式在 Android 平台上解析某些 file://
URI 上的 .toURL()
時引入了回歸。請改為升級到 cordova-plugin-file@8.1.2
。
請依照此 如何提交錯誤 指南報告您發現的任何問題!
我們很高興宣佈,我們剛剛發佈了下一個 Cordova iOS 版本的 beta 版。這是 Cordova iOS 8.0.0-beta.1!
這是 Cordova 支援的用於建置 iOS 應用程式的平台開發人員預覽。此 beta 版發佈的目的是讓外掛程式作者和應用程式開發人員測試他們的外掛程式和專案,並在最終發佈 Cordova iOS 8.0.0 之前提供回饋和錯誤報告。此版本包含數個破壞性 API 變更和專案結構變更,這就是我們提供此 beta 版進行測試的原因。
此 beta 版不適用於生產 App Store 提交。
對於外掛程式作者,我們撰寫了一份關於 將外掛程式升級到 Cordova iOS 8.x 的指南。
要在您的專案中測試升級
cordova platform remove ios
cordova platform add ios@8.0.0-beta.1
安裝以進行測試
cordova platform add ios@8.0.0-beta.1
App
。完整的變更日誌可在此處閱讀 這裡。請在我們的 Cordova-iOS GitHub 問題追蹤器上回報您發現的任何問題!
我們很高興宣布剛發佈了 Cordova iOS 7.1.1
!這是 Cordova 用於建置 iOS 應用程式的其中一個支援平台。
升級方式
cordova platform remove ios
cordova platform add ios@7.1.1
安裝方式
cordova platform add ios@7.1.1
正確解除安裝具有資源標籤的插件
修正了如果插件在 plugin.xml
中定義了 <asset>
標籤,則無法正確解除安裝插件的問題。
新增插件期間的版本警告
修正了安裝插件時顯示版本檢查失敗警告的問題。
將 CODE_SIGN_ENTITLEMENTS
移至 Xcode 專案中應用程式目標的目標設定。
請在我們的 Cordova-iOS GitHub 問題追蹤器上回報您發現的任何問題!
我們很高興宣布剛發佈了 Cordova Android 13.0.0
!這是 Cordova 用於建置 Android 應用程式的其中一個支援平台。
升級方式
cordova platform remove android
cordova platform add android@13.0.0
安裝方式
cordova platform add android@13.0.0
提高目標 SDK
此版本已將目標 SDK 提高至 34 (Android 14)。
提高 Android Studio 要求
如果從 Android Studio 建置和執行,則需要 Android Studio Jellyfish。
所需建置工具
若要使用 cordova-android@13
,必須安裝 SDK 平台 34
和 SDK 建置工具 34.0.0
。如果您的專案不再使用舊版 cordova-android,則可以解除安裝較舊版本的建置工具。
安裝 SDK 平台 34
SDK Platforms
索引標籤API Level
為 34
的 Android 14.0 ("UpsideDownCake")
Apply
安裝 SDK 建置工具 34.0.0
SDK Tools
索引標籤Show Package Details
Android SDK Build-Tools
34.0.0
Apply
專案相依性
已將下列專案相依性提升
1.9.24
8.7
8.3.0
如果您或插件已變更下列任何組態偏好設定,則此版本的建置結果可能與預期不符
偏好設定 | 預設值 |
---|---|
android-minSdkVersion |
24 |
android-maxSdkVersion |
未設定 |
android-targetSdkVersion |
34 |
android-compileSdkVersion |
已組態的 android-targetSdkVersion 值 |
android-buildToolsVersion |
34.0.0 |
GradleVersion |
8.7 |
AndroidGradlePluginVersion |
8.3.0 |
GradlePluginKotlinVersion |
1.9.24 |
請注意此版本中已更新的版本。如果您已手動修改任何這些值,建議您檢閱並據此更新偏好設定值。
提高 Java 要求
由於先前描述的相依性和工具的新版本,Java 開發套件 (JDK) 要求已提高至版本 17。
已移除 kotlin-android-extensions
當 kotlin 大於或等於版本 1.8.0
時,將不再簽出 kotlin-android-extensions
。
新增 SplashScreenBackgroundColor
偏好設定支援
新增了對一般偏好設定的支援,使其在設定啟動畫面背景顏色時可在各平台之間保持一致。
當涉及 Cordova Android 平台時,會套用下列優先順序
AndroidWindowSplashScreenBackground
偏好設定SplashScreenBackgroundColor
偏好設定BackgroundColor
偏好設定#ffffff
硬式編碼新增對檔案輸入擷取的相機意圖支援
允許使用者在 HTML 檔案 input
標籤包含 capture
旗標時存取和使用相機。
範例
<input type="file" capture />
新增 ResolveServiceWorkerRequests
偏好設定支援
新增了一個偏好設定,可讓服務工作程式請求透過資源載入器傳送。預設情況下,此設定為啟用狀態。
可以使用下列偏好設定來停用此設定。
<preference name="ResolveServiceWorkerRequests" value="false" />
請在我們的 Cordova-android GitHub 問題追蹤器上回報您發現的任何問題!
我們很高興宣布剛發佈了 Cordova iOS 7.1.0
!這是 Cordova 用於建置 iOS 應用程式的其中一個支援平台。
升級方式
cordova platform remove ios
cordova platform add ios@7.1.0
安裝方式
cordova platform add ios@7.1.0
SplashScreenBackgroundColor
偏好設定支援
此偏好設定可讓您設定啟動畫面的背景顏色。如果未提供 SplashScreenBackgroundColor
,則會回復為 BackgroundColor
,這是目前的行為,然後在未定義任何內容時回復為系統背景顏色。
privacy-manifest
支援
此版本提供範本空白的隱私資訊清單檔案 PrivacyInfo.xcprivacy
,可從 config.xml
進行設定。
此版本特別著重於為應用程式開發人員提供設定此組態的支援,而稍後發佈的版本將會為插件開發人員引入支援。
建議插件開發人員在其插件文件中提供必要的組態設定,以協助應用程式開發人員。
以下是應用程式開發人員可以定義來設定隱私資訊清單檔案的 config.xml 範例項目。
<platform name="ios">
<privacy-manifest>
<key>NSPrivacyTracking</key>
<true/>
<key>NSPrivacyCollectedDataTypes</key>
<array/>
<key>NSPrivacyAccessedAPITypes</key>
<array/>
<key>NSPrivacyTrackingDomains</key>
<array/>
</privacy-manifest>
</platform>
NSPrivacyTracking
、NSPrivacyCollectedDataTypes
、NSPrivacyAccessedAPITypes
和 NSPrivacyTrackingDomains
的內容和值將取決於所使用的特定原生 API。
建議您閱讀 Apple 開發人員文件,以更了解這些參數。
將 PROVISIONING_PROFILE_SPECIFIER
用於手動程式碼簽署
允許您在 build.json
組態檔案中,或透過 CLI 命令,使用佈建設定檔的 UUID 或名稱值作為建置旗標 provisioningProfile
。
WASM MIME 類型錯誤
在 Cordova WebView 中啟用 WebAssembly 支援。
請在我們的 Cordova-iOS GitHub 問題追蹤器上回報您發現的任何問題!
我們很高興宣布剛發佈了 Cordova Electron 4.0.0
!這是 Cordova 用於建置 Electron 應用程式的其中一個支援平台。
升級方式
cordova platform remove electron
cordova platform add electron@4.0.0
安裝方式
cordova platform add electron@4.0.0
此版本中一些值得注意的重大變更是
Node.js 要求
此版本要求環境具有 Node.js 18.0.0
或更高版本。建議使用目前的 LTS,在本版本發佈時為 20.11.1
。
Electron 更新
Electron 核心相依性已更新至 29.0.0
。此版本的 Electron 隨附下列應用程式堆疊
關於 Electron 29.0.0 的更多資訊,可在此處的 部落格文章 中閱讀。
已移除插件引數的意外多維陣列包裝
在 Cordova-Electron 3.0.0 中,引入了插件支援,但發生了插件引數的意外多維陣列包裝。此包裝可能未被應用程式開發人員注意到,但它影響了插件開發人員。
通常,插件包含一組可能接受引數的 API,而這些引數會轉送到插件的原生端。由於引數散佈不當,插件開發人員必須持續在第一層存取索引 0,才能擷取實際引數,如 args[0][0]
。從未出現 args[n+1]
的情況。
此版本修正了此問題。如果插件的設計旨在讀取傳入的引數,則插件開發人員將需要更新其插件。
如需快速入門指南和深入的組態設定,請查看我們的 Cordova Electron 文件!
請在 issues.cordova.io 回報您發現的任何問題!
非常感謝您參與我們的使用者與貢獻者問卷調查。我們收到 228 份回覆。讓我們直接深入探討資料。
此問卷調查收到 200 多份回覆,而且考慮到只有一小部分實際看到問卷調查的人會回覆,因此可能有很多快樂的 Cordova 使用者以及新的和長期運行的應用程式專案。我們收到了一些關於最受歡迎的改進和最大痛點的良好回饋。
Apache Cordova 專案團隊希望更了解使用者和貢獻者。因此,我們邀請您參與一份針對 Cordova 應用程式開發者和外掛貢獻者的簡短問卷調查。
問卷問題的設計不包含任何個人資訊,並可以匿名回答。請注意,本問卷使用 Google 表單處理回覆。處理資料時將適用 Google 隱私權政策。
非常感謝您參與本次問卷調查。本次問卷調查的目標是找出 Cordova 社群可以共同改進的領域。問卷調查從現在起開放至 2023 年 12 月 24 日。結果將在 Cordova 部落格上分享。
我們很高興宣布,我們剛剛發布了 cordova-plugin-inappbrowser
的更新!
這是一個包含重大變更的新主要版本,需要至少 cordova-android@10.0.0
和 cordova-ios@6.0.0
。請務必檢查並更新您的平台。
此主要版本中最值得注意的改進包括:
請在 GitHub 上回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 cordova-plugin-geolocation
的更新!
升級方式
cordova plugin remove cordova-plugin-geolocation
cordova plugin add cordova-plugin-geolocation@5.0.0
此外掛的 JavaScript 已升級為使用 ES6 功能,例如 let
和 const
。
注意:此版本未能升級所需的引擎。儘管已聲明需要 cordova-android
>= 6.3.0,且未聲明需要 iOS,但新的最低需求將會是:
這些平台的早期版本可能無法如預期運作。一如既往,建議使用可用的最新版本。引擎可能會在稍後的修補程式版本中修正。
此版本已移除對已棄用的 cordova-windows 平台的支援。
iOS 上地理位置序列化的健全檢查
在 iOS 上,罕見的 Infinity
值會導致 JSON 序列化期間發生當機。現在已捕獲此問題,並會順利產生位置無法使用錯誤。
改善 Android 權限處理
Android 已收到修正,可處理粗略與精確位置權限,以改善在 Android 12 以上裝置上的相容性。Android 現在將處理以下情況:
COARSE
位置的權限請求。COARSE
和 FINE
(高精確度)位置的權限請求。COARSE
但需要 FINE
時的權限升級。如需這些變更的更多詳細資訊,請參閱 PR。
heading
和 speed
已進行修正,以更好地符合 W3C 地理位置 API 規格。如果判定這兩個值都不在預期的有效範圍內,它們現在將會傳回 null
,以便在 Cordova 和其他 Web 環境之間提供更好的一致性。
請依照此 如何提交錯誤 指南報告您發現的任何問題!
我們很高興宣布,我們剛剛發布了以下外掛的更新!
升級方式
cordova plugin remove cordova-plugin-camera
cordova plugin add cordova-plugin-camera@7.0.0
cordova plugin remove cordova-plugin-media
cordova plugin add cordova-plugin-media@7.0.0
cordova plugin remove cordova-plugin-file-transfer
cordova plugin add cordova-plugin-file-transfer@2.0.0
cordova-plugin-camera
Android 13 支援
在此版本的 camera
外掛中,WRITE_EXTERNAL_STORAGE
權限的 maxSdkTarget
已設定為 32
。進行此變更的原因是此權限已棄用,並由 Android 13 更精細的權限 READ_MEDIA_IMAGES
和 READ_MEDIA_VIDEO
取代。此外,getPermissions
方法已獲得改進,可根據 Android 版本準確擷取所需的權限。如果使用 Android 13 及更高版本,則也會根據媒體類型擷取權限。
此外,為了支援 Android 13 (SDK 33) 上新的精細權限,我們已將 cordova-android
的最低需求提高到 12.0.0
版本。此版本的 Cordova-Android 特別包含處理 Android 13 的必要更新,並使用新的權限成功編譯您的專案。
移除已棄用的平台
由於 Cordova-Windows 和 Cordova-OSX 平台已棄用,因此已從此外掛中移除對這些平台支援的邏輯。
保留來自相片圖庫的圖片 Exif 資料 (iOS)
此版本包含修復程式,可保留 iOS 圖片的 EXIF 資料。
cordova-plugin-media
Android 13 支援
在此版本的 media
外掛中,檔案外掛的相依性已升級到 8.0.0
版本,其中導入了 Android 13 支援。此支援包含 Android 13 更精細的權限 READ_MEDIA_IMAGES
、READ_MEDIA_VIDEO
和 READ_MEDIA_AUDIO
。
此外,我們已將 cordova-android
的最低需求提高到 12.0.0
版本。
如需更多資訊,請參閱 Cordova 的 File Plugin 8.0.0 發佈部落格文章。
移除已棄用的 Windows 平台
由於 Cordova-Windows 平台已棄用,因此已從此外掛中移除對該平台支援的邏輯。
能夠從自訂配置和開頭斜線目錄路徑載入檔案
檔案外掛現在可以接受使用自訂配置或開頭斜線建構的 URL。
自訂配置範例
依預設,iOS 使用以下自訂配置 app://127.0.0.1/
。您現在可以傳入 app://127.0.0.1/file.mp4
,以代表位於應用程式內容載入來源根目錄 www
中的媒體檔案。
開頭斜線範例
如果提供的 URL 為 /file.mp4
,也可以從上述範例載入相同的檔案 file.mp4
。它將會從應用程式內容載入來源根目錄 www
導覽。
提升 Android 的音訊品質
從此外掛版本開始,Android 擷取的音訊品質已顯著提高。這是藉由將位元率提高到 96 Kbps 並將取樣率提高到 44.1 kHz 來達成的。
PR 注意事項:此外掛使用 AAC 編碼器,與 MP3 編碼器相比,通常可以在較低的位元率下提供更好的音訊品質。在研究 AAC 與 MP3 可接受的位元率時,有些建議 AAC 使用 96 Kbps,而 MP3 使用 128 Kbps。但這並不表示它們是相同的。就品質而言,它將始終取決於來源和底層設備。
cordova-plugin-file-transfer
針對 Android 13 支援升級檔案相依性
在此版本的 file-transfer
外掛中,檔案外掛的相依性已更新為 8.0.0
版本,以啟用 Android 13 支援。因此,cordova-android
的最低需求已提高到 12.0.0
版本,以與更新的檔案外掛一致。
如需更多資訊,請參閱 Cordova 的 File Plugin 8.0.0 發佈部落格文章。
移除已棄用的平台
由於 Cordova Windows/WP8、OSX、Amazon Fire OS、Blackberry 10、Windows Phone 和 Firefox OS 平台已棄用,因此已從此外掛中移除對這些平台支援的邏輯。
移除已棄用的 whitelist
外掛
舊版的 whitelist
外掛已棄用很長時間,且在 file-transfer
外掛中不再需要。此外掛將繼續呼叫並檢查 shouldAllowRequest
方法,該方法是平台核心編碼的一部分。
如需如何設定清單的更多資訊,請參閱 Cordova 文件中的 允許清單頁面。
修正 Android Q+ 的下載功能
移除硬式編碼的 X-Requested-With
標頭
此硬式編碼的標頭已從 Android 平台中移除。此標頭也未在任何其他平台中設定。如果想要將 HTTP 呼叫「偽裝」成 XMLHttpRequest,則由應用程式開發人員設定標頭。
修復檔案上傳時遺失的標頭
在 iOS 中,標頭資料在檔案上傳期間未正確設定。在此版本中,更新了 applyRequestHeaders
方法,以確保已套用標頭。
重新實作 UserAgent 覆寫
在 iOS 中,使用 WebView 的 navigator.userAgent
值覆寫 UserAgent 的功能已重新實作。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova iOS 7.0.1
!這是 Cordova 支援建置 iOS 應用程式的平台之一。
升級方式
cordova platform remove ios
cordova platform add ios@7.0.1
安裝方式
cordova platform add ios@7.0.1
修正
在 Xcode 11 上建置
Cordova-iOS 7 的文件指出支援 Xcode 11 及更高版本。但是,由於最近為了支援 LimitsNavigationsToAppBoundDomains
而進行的變更,在 Xcode 11 上建置會失敗。為了解決此問題,我們新增了條件檢查,以確保可以使用 Xcode 11 建置應用程式。請注意,使用 Xcode 11 建置時,LimitsNavigationsToAppBoundDomains
功能將無法使用。
修正 Xcode pbxproj 中的路徑
Cordova-iOS 7.0.0 的 Xcode 專案檔案缺少某些檔案的路徑資訊。雖然這在 Xcode 應用程式中運作良好,但對於嘗試以程式設計方式修改專案檔案的外掛程式和掛鉤造成了問題。我們已修正此問題,方法是確保 Xcode 專案中的所有檔案都包含路徑屬性。
請在我們的 Cordova-iOS GitHub 問題追蹤器上回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Android 12.0.1
!這是 Cordova 支援建置 Android 應用程式的平台之一。
升級方式
cordova platform remove android
cordova platform add android@12.0.1
安裝方式
cordova platform add android@12.0.1
修正
自適應圖示修正
在 Cordova-Android 12.0.0 中,隨著 Android 13 的主題圖示支援推出,出現了一個問題。此問題導致由於不正確的驗證檢查而未產生自適應圖示。
在此版本中,已修正有問題的驗證檢查。因此,即使未提供單色屬性,也會產生自適應圖示。
請在我們的 Cordova-Android GitHub 問題追蹤器上回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 cordova-plugin-media-capture
的更新!
升級方式
cordova plugin remove cordova-plugin-media-capture
cordova plugin add cordova-plugin-media-capture@5.0.0
支援 Android 13+
從 Android 13 (SDK 33) 開始,READ_EXTERNAL_STORAGE
權限不再起任何作用。取而代之的是,此權限已由更精細的權限取代:READ_MEDIA_IMAGES
、READ_MEDIA_VIDEO
和 READ_MEDIA_AUDIO
。此外,從 API 等級 30 及以上開始,WRITE_EXTERNAL_STORAGE
已 停止提供寫入權限。
為了適應此變更,我們引入了這三個新的權限。這可確保針對 Android 13 及更高版本,與讀取各種媒體檔案相關的現有功能和行為得以維護。
READ_EXTERNAL_STORAGE
和 WRITE_EXTERNAL_STORAGE
權限仍有定義,但已宣告 maxSdkVersion
屬性,其值為 32
,以確保它們不會在 API 33 或更高版本中使用。
此外,為了支援 Android 13 (SDK 33) 上新的精細權限,我們已將 cordova-android
的最低需求提高到 12.0.0
版本。此版本的 Cordova-Android 特別包含處理 Android 13 的必要更新,並使用新的權限成功編譯您的專案。
為 iOS 新增影片 quality
選項
您現在可以變更 iOS 上擷取影片的品質。預設情況下,它將擷取最高品質。
修正各種 iOS 當機問題
實作了各種修正,以增強 iOS 上的穩定性和使用者體驗。以下是一些範例變更
請依照此 如何提交錯誤 指南報告您發現的任何問題!
我們很高興宣佈,我們剛剛發佈了 cordova-plugin-file
的更新!
升級方式
cordova plugin remove cordova-plugin-file
cordova plugin add cordova-plugin-file@8.0.0
已移除 WRITE_EXTERNAL_STORAGE
權限
根據 Android 11 中儲存空間更新 的官方文件,WRITE_EXTERNAL_STORAGE
權限已不再運作,且不會授予寫入外部儲存空間的權限。
如果針對 API 等級低於
Build.VERSION_CODES.Q
(SDK 29) 的應用程式未將此權限列入允許清單,則無法授予應用程式此權限。
雖然 Cordova 預設已從外掛程式中移除此權限,但如果需要,您仍然可以使用專案的 config.xml
檔案中的 config-file
標籤將其加回。
範例
<config-file target="AndroidManifest.xml" parent="/*" xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
</config-file>
請務必注意,您的 Cordova 專案中使用的其他外掛程式可能仍然包含 WRITE_EXTERNAL_STORAGE
權限。若要驗證權限是否由其他外掛程式加入,您可以檢查合併的 AndroidManifest.xml
檔案。
合併的 AndroidManifest.xml
檔案位於下列位置
platforms/android/app/build/intermediates/merged_manifest/debug/AndroidManifest.xml
請記住,上面提供的範例檔案路徑特定於偵錯組建。對於發行組建或不同的組建變體,檔案路徑可能會略有不同。
支援 Android 13+
從 Android 13 (SDK 33) 開始,READ_EXTERNAL_STORAGE
權限不再起任何作用。取而代之的是,此權限已由更精細的權限取代:READ_MEDIA_IMAGES
、READ_MEDIA_VIDEO
和 READ_MEDIA_AUDIO
。
為了適應此變更,我們引入了這三個新的權限。這可確保針對 Android 13 及更高版本,與讀取各種媒體檔案相關的現有功能和行為得以維護。
此外,為了支援新的精細權限和 Android 13 (SDK 33),我們已將 cordova-android
的最低需求提高到 12.0.0
版。此版本的 Cordova-Android 專門包含處理 Android 13 並成功使用新權限編譯專案的必要更新。
請依照此 如何提交錯誤 指南報告您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova iOS 7.0.0
!這是 Cordova 用於建置 iOS 應用程式的其中一個支援平台。
升級步驟
cordova platform remove ios
cordova platform add ios@7.0.0
新的安裝步驟
cordova platform add ios@7.0.0
從 framework
標籤中移除 podspec
類型
自 Cordova-iOS 5.0.0 起,新增了新的 podspec
標籤,以改善 CocoaPods 提供的功能的可讀性和支援。
此版本正式移除了 framework
標籤的舊 type="podspec"
實作。如果您維護外掛程式並且仍然使用 framework
標籤來載入 pod 規格,建議您移轉至較新的實作。
如需實作規格,請參閱我們的 Apache Cordova - Podspec 文件。
已移除預設 CONFIGURATION_BUILD_DIR
覆寫
這會變更產生輸出檔案的位置。
build/emulator
將變為 build/Debug-iphonesimulator
build/device
將變為 build/Release-iphoneos
這將有助於確保偵錯和發行檔案永遠不會混合在同一個目錄中,並改善對 macOS maccatalyst
組建的支援。
更新支援的 NodeJS 版本
我們已停止支援 NodeJS 14.x,並將最低 NodeJS 需求提高到大於或等於 16.13.0。
已捨棄平台二進位檔
我們不再於 cordova-ios
npm 套件或 GitHub 存放庫中提供或封裝以平台為中心的工作流程二進位檔。
請使用 cordova
CLI 工具來管理您的 Cordova 專案外掛程式和平台組態。
將 Images.xcassets
重新命名為 Assets.xcassets
CDVViewController
中移除已淘汰的 API colorFromColorString
CDVCommandDelegateImpl
類別新增 LimitsNavigationsToAppBoundDomains
偏好設定組態
此偏好設定可讓您使用 Cookie 驗證或瀏覽器 API,但需要將值設定為 YES
。預設值為 NO
。
支援 Apple Cloud Distribution Signing
Apple Cloud Distribution Signing 允許使用 AppStore Connect API 金鑰自動管理發行簽署憑證和佈建描述檔。使用 Cordova-iOS 7.0.0,您可以在 build.json
中指定 AppStore Connect API 認證,或將其作為 cordova
工具的命令列參數。
這些選項是 authenticationKeyPath
、authenticationKeyID
和 authenticationKeyIssuerID
,它們與現有的 automaticProvisioning
選項搭配運作。
啟用 Mac Catalyst 支援
使用 Cordova-iOS 建置的應用程式現在可以使用 Catalyst 執行階段以 macOS 為目標。可以透過在 Xcode 專案設定中選取「macOS - Catalyst」核取方塊,然後在 Xcode 中為 macOS 目標進行建置來啟用此功能。
目前,不支援從 Cordova 的命令列工具為 Catalyst 進行建置。
請在我們的 Cordova-iOS GitHub 問題追蹤器上回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova CLI 的重大更新!
此 CLI 版本也包含最新的內部程式庫
此版本停止支援 Nodejs 14。Cordova 需要的最低支援版本大於或等於 16.13.0。
在所有版本中,我們已將所有 npm 套件更新為 Cordova 可以支援的最新版本。
重大變更
我們已從平台清單中移除已淘汰的平台 OSX 和 Windows。雖然您仍然可以安裝這些平台,但您需要使用完整的 npm 套件名稱 cordova-osx
和 cordova-windows
。請注意,這些平台不再受到積極維護,而且它們可能無法如預期般運作,並且未來可能會損壞。因此,它們將不會獲得任何進一步的支援。
此外,我們已移除所有內部平台釘選。當執行 cordova platform add <PLATFORM>
命令時,它將始終從 npm 登錄檔擷取可用的最新平台。這可讓您立即存取新發布的平台。如果您需要命令持續擷取特定版本,則需要更新命令以包含版本釘選,如下所示:cordova platform add <PLATFORM>@<VERSION>
。
請在我們的 GitHub 問題追蹤器上回報您發現的任何問題!提交時,請在下面選擇適當的存放庫。
我們很高興宣布,我們剛剛發布了 Cordova Android 12.0.0
!這是 Cordova 用於建置 Android 應用程式的其中一個支援平台。
升級方式
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
SDK Platforms
索引標籤33
API 等級
的 Android 13.0 (Tiramisu)
Apply
若要安裝 SDK 建置工具 33.0.2
SDK Tools
索引標籤Show Package Details
Android SDK Build-Tools
33.0.2
Apply
專案相依性
已將下列專案相依性提升
1.7.21
7.6
7.4.2
4.3.15
1.6.1
1.6.0
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 問題追蹤器上回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 Cordova Browser 7.0.0
!這是 Cordova 支援的平台之一,用於建置以瀏覽器為目標的應用程式。
此版本包含針對較新 NodeJS 執行階段的更新,並包含 ShellJS 安全性修復。
升級方式
cordova platform remove browser
cordova platform add browser@7
請在 GitHub Issues 回報您發現的任何問題!
如需更詳細的發行說明,請參閱 RELEASENOTES.md
我們很高興地宣布,我們剛剛發布了 Cordova iOS 6.3.0
!這是 Cordova 用於建置 iOS 行動應用程式的官方平台。這個次要版本包含三個重要的修復,以準備即將到來的主要版本。
此版本包含一個修復程式,可讓您使用最新的 iOS 和 Xcode 版本檢查 WebView 內容。它還修復了 iOS 16 的錯誤以及 NodeJS 18 的問題。
此版本為 iOS 16.4 或更新版本新增了偏好設定 InspectableWebview
。請查看 Pull request 以取得文件。
升級方式
cordova platform remove ios
cordova platform add ios@6.3.0
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布 cordova-common@5.0.0
已發布。這是幾乎所有 Cordova 工具都在幕後使用的程式庫之一,並提供用於處理諸如 config.xml
解析之類的事務的公用程式。
此主要版本中最顯著的變更為
node>=16
由於 Node.js 14 即將結束生命週期(2023 年 4 月),我們已將最低要求提高到 16.0.0。此更新也將最低 npm 要求提高到 7.10.0。
monochrome
屬性為了準備 Cordova-Android 的下一個主要版本,其中包含對 Android 單色圖示的支援邏輯。
我們很高興地宣布,我們剛剛發布了 cordova-plugin-screen-orientation
的更新!
升級方式
cordova plugin remove cordova-plugin-screen-orientation
cordova plugin add cordova-plugin-screen-orientation@3.0.3
此版本改善了與較新 iOS 版本的相容性(請參閱 (#107)),並包含其他版本更新。
請按照此 如何提交錯誤 指南回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 Cordova CLI 的次要更新!
此版本也將我們的內部程式庫固定到最新版本
此版本正式將已淘汰的旗標附加到可用平台輸出畫面上的 Windows 和 OSX 平台。
我們更新了內部流程,將 config.xml
中的所有 XML 屬性值傳遞給平台套件,以便我們輕鬆更新平台,而無需更新工具和 CLI。
我們已將所有可能的 npm 套件更新到 Cordova 可以支援的最新非主要版本。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布 cordova-common@4.1.0
已發布。這是幾乎所有 Cordova 工具都在幕後使用的程式庫之一,並提供用於處理諸如 config.xml
解析之類的事務的公用程式。
此次要版本中最顯著的改進是能夠將幾乎所有 XML DOM 元素屬性傳遞到平台的 JS 工具。透過傳遞所有屬性資料,Cordova-Common 不再需要為新增和支援新的平台屬性而更新。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 cordova-plugin-media
的更新!
升級方式
cordova plugin remove cordova-plugin-media
cordova plugin add cordova-plugin-media@6.1.0
對於 Android,我們更新了媒體錯誤回應物件,以包含「message」屬性。此屬性將提供有關錯誤的其他資訊。它也與 iOS 傳回的媒體錯誤回應物件同步。
對於 iOS,已實作檔案架構支援。套用了兩個修復程式,以防止在時間未定義時擷取位置時發生當機,並確保在發布錄製後定義類別。
請依照此 如何提交錯誤 指南報告您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 Cordova Android 11.0.0
!這是 Cordova 支援的平台之一,用於建置 Android 應用程式。
升級方式
cordova platform remove android
cordova platform add android@11.0.0
安裝方式
cordova platform add android@11.0.0
Android 12 開機畫面 API 整合
從 Android 12 開始,所有 Android 12 或更高版本的裝置都會顯示新的應用程式啟動動畫。Google 已套用此要求,以將標準設計帶到所有應用程式啟動畫面。
由於此要求,使用者已看到並回報在應用程式啟動期間顯示多個開機畫面。由於無法停用新的開機畫面 API,因此舊的開機畫面外掛程式在 Cordova-Android 11+ 中已淘汰。
我們已將 Android 12 開機畫面 API(包括相容性程式庫)整合到 Cordova-Android 平台的核心,以提供對 Android API 22+ 的支援。
如需更多資訊,請參閱 PR 和 Cordova 文件。
工具和預設支援變更
targetSdk
):32
32.0.0
7.4.2
1.5.21
7.2.1
4.3.10
1.4.2
1.4.0
1.0.0-rc01
環境變數 ANDROID_HOME
截至 2022 年 4 月 27 日,Google 似乎已推翻其聲明,並宣布 ANDROID_HOME
現在是設定 SDK 安裝目錄路徑的正確環境變數。它也指出指向 SDK 安裝目錄的 ANDROID_SDK_ROOT
已被淘汰。
自訂編譯 SDK
我們新增了使用偏好設定旗標 android-compileSdkVersion
設定自訂 compileSdk 值的功能。
範例
<preference name="android-compileSdkVersion" value="31" />
Node 支援
由於 Node 12 不再受 Node.js 團隊支援,我們已停止支援 Node 12。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 cordova-plugin-media
和 cordova-plugin-media-capture
的更新!
升級方式
cordova plugin remove cordova-plugin-media
cordova plugin add cordova-plugin-media@6.0.0
cordova plugin remove cordova-plugin-media-capture
cordova plugin add cordova-plugin-media-capture@4.0.0
cordova-plugin-media
對於 Android,WRITE_EXTERNAL_STORAGE
和 READ_PHONE_STATE
權限的保護層級為危險。因此,我們移除了這些權限的宣告。
cordova-plugin-file
相依性已更新為使用版本 ^7.0.0
。
先前僅在 iOS 平台上支援的 setRate
功能現在在 Android 平台上也支援。iOS 的此功能也進行了修復。
cordova-plugin-media-capture
對於 Android,已移除 RECORD_VIDEO
權限定義,因為它從未使用過,而且似乎從不存在。
cordova-plugin-file
相依性已更新為使用版本 ^7.0.0
。
Android 的權限檢查已統一,以修復不同擷取方法之間的不一致之處。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 Cordova Electron 3.1.0
!這是 Cordova 支援的平台之一,用於建置 Electron 應用程式。
升級方式
cordova platform remove electron
cordova platform add electron@3.1.0
安裝方式
cordova platform add electron@3.1.0
此版本中一些值得注意的變更和新功能是
Electron 更新
Electron 核心相依性已更新為 14.2.9
。
定義和固定 Electron 版本
新增了定義和固定特定 Electron 版本的功能。此功能利用了 npm 8 中引入的 npm 的 overrides
屬性。
範例
在 Cordova 應用程式的 package.json
檔案中,新增下列內容
"overrides": {
"cordova-electron": {
"electron": "14.2.9",
}
}
如果您的專案中已新增平台,您將需要移除該平台或刪除 platforms
目錄,然後再執行 cordova prepare electron
來重新簽出已固定的版本。如果您的專案目錄中也有 package-lock.json
檔案,也需要將其移除。
如需快速入門指南和深入設定,請查看我們的 Cordova Electron 文件!
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 Cordova Android 10.1.2
!這是 Cordova 支援的平台之一,用於建置 Android 應用程式。
升級方式
cordova platform remove android
cordova platform add android@10.1.2
安裝方式
cordova platform add android@10.1.2
此版本中值得注意的修復程式包括偵測使用 Java 11 的 JAVA_HOME
環境變數、正確逸出應用程式名稱,以及在 activity
上明確定義 android:exported
屬性。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 cordova-plugin-file
和 cordova-plugin-device
的更新!
升級方式
cordova plugin remove cordova-plugin-file
cordova plugin add cordova-plugin-file@7.0.0
cordova plugin remove cordova-plugin-device
cordova plugin add cordova-plugin-device@2.1.0
cordova-plugin-file
對於 Android,已新增 WebViewAssetLoader
代理處理常式,以支援在使用自訂配置時載入 cdvfile
URL。建議使用 toURL
方法來擷取可用的 URL。當應用程式從 http
或 https
通訊協定提供時,toURL
將傳回適用的可用 cdvfile
URL。如果應用程式從 file
通訊協定使用,toURL
將傳回原生 file
URL。
cordova-plugin-device
已新增 Electron 原生支援。
對於 Android,sdkVersion
屬性現在包含在 window.device
物件上,並在 getInfo
回應物件中傳回。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了開機畫面外掛程式的更新!
此修補程式版本修正了 Android 上的一些錯誤,包括「返回按鈕」事件的相關問題,一些使用者回報了此問題。
我們在此宣布棄用 cordova-osx。
這表示 Cordova 開發社群將不再在這個平台上進行任何工作。請遷移到 cordova-electron
平台,或嘗試使用 cordova-ios
平台的 Mac Catalyst。
osx 平台的使用率和活躍度長期以來一直很低。Cordova 用於構建 macOS 應用程式的其他解決方案都得到了積極維護,特別是 cordova-ios 提供了更好的外掛程式支援。
我們衷心接受並感謝您的回饋!
我們很高興宣布我們剛剛發布了 Cordova OSX 7.0.0
!這是 Cordova 支援用於構建 macOS 桌面應用程式的平台之一。
此版本包含各種依賴性更新,並使該平台可以在 AppleSilicon Mac 上運行。
我們已將此版本所需的最低 NodeJS 版本提高到 12.x。
我們計劃很快棄用 cordova-osx
平台。請遷移到 cordova-electron
平台,或嘗試使用 cordova-ios
平台的 Mac Catalyst。
請隨時查看郵件清單上的討論 1 2 以獲取更多資訊,如果您有任何意見,請留言。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布我們剛剛發布了 Cordova 媒體外掛程式 (5.0.4)
的更新!
升級方式
cordova plugin remove cordova-plugin-media
cordova plugin add cordova-plugin-media@5.0.4
已解決 Android 11 的掛載儲存問題
Android 11 已棄用 Environment.getExternalStorageDirectory()
API,這導致了獲取和掛載到外部目錄的問題。在此版本中,我們將 API 更改為 context.getExternalFilesDir(null)
,這是建議用於獲取和掛載外部儲存目錄的替代 API。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova CLI 的重大更新!
在此 CLI 版本中,它也將使用最新的內部函式庫和範本
此版本放棄了 Nodejs 10 的支援。Cordova 要求的最低支援版本為 12.x。
在所有版本中,我們都已將所有 npm 套件更新到 Cordova 可以支援的最新版本。
Cordova CLI 11.0.0
在此版本中,我們修復了使用者將 macOS 環境升級到 macOS Monterey 後無法使用 Cordova CLI 的問題。此問題是由其中一個套件依賴 insight
引起的。先前的解決方法是重新安裝 Cordova CLI,但在此版本中不再需要這樣做。
Cordova Lib 11.0.0
我們已將所有平台固定設定更新為使用最新發布的平台。這表示新的 Cordova 應用程式專案現在將使用支援平台的最新主要版本。
cordova-android@^10.1.1
cordova-electron@^3.0.0
cordova-ios@^6.2.0
Cordova Create 4.0.0
所有新專案現在都將從最新的 App Hello World 範本開始。
Cordova App Hello World 範本 6.0.0
請參閱 App Hello World 發布部落格文章以獲取更多詳細資訊。
請在 issues.cordova.io 回報您發現的任何問題!
Apache Cordova 團隊祝您佳節愉快,並在新的一年有個美好的開始。
我們很高興宣布我們剛剛發布了範本的重大更新!
在此版本中,我們從預設範本中移除了已棄用的 cordova-plugin-whitelist
。該外掛程式的功能已整合到 Cordova Android 核心,自 10.0.0 版本起。
如果您創建一個新的 Cordova 專案並使用舊版本的 Cordova Android (<10),則需要新增 cordova-plugin-whitelist
外掛程式。
此外,Cordova 已從預設的 config.xml
檔案中移除了過多的 access
和 allow-intent
設定。先前,預設範本假設使用者需要的預設值,但並非所有使用者應用程式都需要這些設定。
移除這些過多的預設值將有助於預設情況下推動更安全的應用程式,將預設專案配置減少到最低限度,並推動定義存取權限的選擇加入方法。
現有專案不受這些變更的影響。預設範本僅在初始專案建立期間使用。
我們很高興宣布我們剛剛發布了 cordova-lib 10.1.0
!
在此次小版本發布中,我們引入了各種改進和修復。此版本中最顯著的變更如下
cordova-ios@^6.2.0
cordova-android@^9.1.0
cordova-electron@^1.1.1
package.json
中正確的固定平台版本。請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布我們剛剛發布了 Cordova Android 10.1.1
!這是 Cordova 支援用於構建 Android 應用程式的平台之一。
升級方式
cordova platform remove android
cordova platform add android@10.1.1
安裝方式
cordova platform add android@10.1.1
此版本中值得注意的修復程式是關於處理「允許導覽」和「允許橋接存取」的預設原則,其中還涵蓋了協定和主機名稱的使用案例。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布我們剛剛發布了 Cordova Electron 3.0.0
!這是 Cordova 支援用於構建 Electron 應用程式的平台之一。
升級方式
cordova platform remove electron
cordova platform add electron@3.0.0
安裝方式
cordova platform add electron@3.0.0
此版本中一些值得注意的重大變更和新功能如下
14.17.6
。Cordova 外掛程式支援
在 Cordova Electron 的早期版本中,我們沒有適當的外掛程式系統。
有一個臨時解決方案 nodeIntegration
,允許應用程式開發人員和外掛程式開發人員存取 Node 模組。這原本是臨時的,並不強烈建議,因為它可能會導致 安全性問題。
有了新的支援,外掛程式將會預先載入並在與 Web 應用程式不同的環境中執行。此功能稱為 環境隔離。
此外,此系統遵循我們現有的外掛程式結構。這表示應用程式程式碼不需要針對 Electron 與任何其他平台進行任何特殊呼叫。
如需快速入門指南和深入設定,請查看我們的 Cordova Electron 文件!
請在 issues.cordova.io 回報您發現的任何問題!
這個問題已經討論了很多年,即使我們同意這樣做,我們從未真正有所行動。移除事物總是比添加事物更困難。
過去,我們有來自社群的積極貢獻,以翻譯我們的文件,我們有一個相當健全的系統來整合所有這些翻譯並發布靜態 HTML 網站。這個系統多年來一直完美運行,但是社群翻譯的速度放慢,然後停止,而系統仍然謹慎地處理這一切。自 Cordova CLI 3.1.0 以來,我們一直在提供翻譯文件,而這些翻譯文件的維護開始在 Cordova CLI 6.x 左右分歧。
在接下來的幾週內,我們將對文件系統進行積極的變更。
包括
archive
網站我們要感謝那些主動創建翻譯文件的人,以及那些投入時間和精力來維護它們的人。
我們歡迎您的回饋和意見。
~ Apache Cordova 提交者
我們很高興宣布我們剛剛發布了相機外掛程式的更新!
我們很高興宣布我們剛剛發布了 Cordova 相機外掛程式 (6.0.0)
的更新!
升級方式
cordova plugin remove cordova-plugin-camera
cordova plugin add cordova-plugin-camera@6.0.0
需要 Cordova-Android
10.x 或更高版本
此次重大版本發布已將最低 Cordova-Android 要求提升到 10.x 或更高版本。此要求變更是為了 AndroidX 僅支援計畫而做的。
如果您的專案使用舊版本的 Cordova-Android,請在使用前升級 Android 平台。
cordova platform remove android
cordova platform add android@10.x
AndroidX
僅支援
在此版本中,我們已完全遷移到 AndroidX 函式庫,不再支援 Android Support 函式庫。
如果您之前使用 cordova-plugin-androidx-adapter 外掛程式將相機的舊版 Android Support 函式庫參考遷移到新的 AndroidX 參考,則可以移除它,除非您的專案使用其他未遷移到 AndroidX 的第三方外掛程式。
HEIC 支援
我們引入了支援,將 HEIC 檔案格式編碼為 WebView 顯示定義的 EncodingType
。
套件可見性支援
我們已更新此外掛程式,以支援 Android 11 中引入的關於套件可見性的重大變更。
有關套件可見性的更多資訊,請查看以下 Google 的資源
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布我們剛剛發布了 Cordova Android (10.1.0)
的小版本更新!這是 Cordova 支援用於構建 Android 行動應用程式的平台之一。
升級方式
cordova platform remove android
cordova platform add android@10.1.0
在此次小版本發布中,我們
更新核心函式庫
新增 HTTP
協定支援
在 Cordova-Android 10.0.0 版本中,我們引入了對 WebViewAssetLoader
的支援。預設情況下,我們僅支援 https
協定。一些使用者要求支援 http
協定;因為並非所有使用者都能透過安全的協定載入資源。
現在使用者可以透過設定 scheme
preference
旗標來使用 https
(預設) 或 http
。
<preference name="scheme" value="http" />
預設的 scheme
將保持為 https
,因為我們認為應用程式應該是安全的。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 Cordova Android (10.0.1)
的錯誤修復更新!這是 Cordova 用於建置 Android 行動應用程式的支援平台之一。
升級方式
cordova platform remove android
cordova platform add android@10.0.1
在這個修補程式版本中,我們修正了三個回報的導致建置問題的錯誤。
修復了 GradlePluginGoogleServicesEnabled
無效版本錯誤
將 GradlePluginGoogleServicesEnabled
設定旗標設定為 true
的專案會看到無效的版本錯誤。此錯誤是由於建置過程讀取了錯誤的變數參考所導致。
修正了錯誤擷取最新建置工具的問題
已安裝建置工具 31.x 的使用者注意到 Cordova 預設嘗試使用較新的建置工具。
預設情況下,Cordova-Android 10.x 會嘗試擷取最新安裝的建置工具,但它應該只在支援的主要版本範圍內選擇。
例如,Cordova-Android 10.x 支援 SDK 建置工具 30.0.3。如果發布並安裝了 30.x 內的較新版本的建置工具,則 Cordova 應該擷取並使用它。如果環境有 31.x 或更高版本,則應忽略它們。
較新的主要版本尚未經過測試,可能與 Cordova 不相容。
現在只會發現並使用支援的主要範圍內的版本。
修正了使用釘選的建置工具進行建置的問題
已安裝最新 Android 建置工具 SDK 31 的使用者也注意到了這個問題。
由於 SDK 31 包含導致與 Cordova 不相容的重大變更,使用者嘗試將建置工具版本釘選為 30.0.3。
由於上述問題「修正了錯誤擷取最新建置工具的問題」,提供的釘選版本被忽略了。
釘選版本現在比擷取最新版本的功能具有更高的優先順序。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 Cordova Android 10.0.0
!這是 Cordova 用於建置 Android 行動應用程式的支援平台之一。
升級方式
cordova platform remove android
cordova platform add android@10.0.0
AndroidX
僅支援
在此版本中,我們已完全遷移到 AndroidX 程式庫,不再支援 Android Support Library。所有繼續使用 Android Support Library 的外掛程式都需要更新以參考新的 AndroidX 程式庫。
如果外掛程式尚未更新,您仍然可以使用 cordova-plugin-androidx-adapter 外掛程式,該外掛程式可用於將舊版參考遷移到新的 AndroidX 參考。
WebViewAssetLoader
支援
預設情況下,會啟用 WebViewAssetLoader
,並允許應用程式從「正確」的來源提供其內容。這將使 Angular 等框架的路由工作更加容易。
在沒有其他設定的情況下,應用程式內容會從 https://127.0.0.1/
提供。您可以透過設定偏好選項 hostname
來設定主機名稱。
<preference name="hostname" value="localhost" />
依性質,協定 https
是不可設定的。
請注意,這是一個重大變更,會導致與 file://
協定相關的資料遺失,例如 Cookie、本機儲存、本機快取和基於 Web 的資料庫。您需要處理資料的遷移。如果您目前無法遷移資料,您可以透過設定 AndroidInsecureFileModeEnabled
偏好旗標來還原此設定。
<preference name="AndroidInsecureFileModeEnabled" value="true" />
設定此旗標會將內容保留在 file://
協定上,Google 報告此協定是不安全的。
Android App Bundles aab
支援
預設情況下,發行組建現在會為發行產生 aab
格式的套件類型。
依性質,aab
套件無法手動部署或推送到裝置進行測試。如果您需要測試發行組建,您需要使用 packageType
旗標將套件類型變更回 apk
。
偵錯組建將繼續建立 apk
格式的套件。
工具和預設支援變更
targetSdk
):30
30.0.3
7.1.1
1.5.20
4.2.2
4.3.5
Node 支援
由於 Node 10 不再受 Node.js 團隊支援,因此我們已停止對 Node 10 的支援。
Java 11 支援
在目前版本的 Android Studio 4.2 中,Android 工具現在可以支援在 Java 11 上執行。請注意,這並不表示您可以開始編譯 Java 11 原始碼。
請在 issues.cordova.io 回報您發現的任何問題!
對於啟用 Google Services Gradle 外掛程式的使用者或外掛程式,存在已知問題。
https://github.com/apache/cordova-android/issues/1284
我們正在準備並計劃在未來三天內進行修補程式版本投票。
我們很高興地宣布,我們剛剛發布了 Whitelist 外掛程式的更新!
1.3.5 修補程式版本是 Whitelist 外掛程式的最終版本。Whitelist 外掛程式將移至 cordova-android
儲存庫。
我們很高興地宣布,我們剛剛發布了 Network Information 外掛程式的更新!
3.0.0 主要版本修正了 Android 上的行為。online
事件在非預期的時間執行。
所有已棄用的 navigator.network
參考已移除。
我們很高興宣布我們剛剛發布了相機外掛程式的更新!
5.0.2 修補程式版本修正了 Android 上的錯誤。使用 Android 上的相機外掛程式拍攝照片後,應用程式偶爾會當機。當主要活動被 Android OS 銷毀以釋放記憶體時,並且當應用程式隨後使用 PendingIntent 恢復時,會發生此當機,因為狀態的還原未正確處理。
我們很高興地宣布,我們剛剛發布了 Cordova Android 9.1.0
!這是 Cordova 用於建置 Android 行動應用程式的支援平台之一。
升級方式
cordova platform remove android
cordova platform add android@9.1.0
在此次小版本發布中,有各種重構和錯誤修正。此外,還有一些新功能。
以下是一些新功能重點
新增了自訂 Gradle 儲存庫支援
有時會有第三方程式庫不存在於我們定義的儲存庫中。透過此功能,開發人員現在可以更輕鬆地覆寫我們在 Gradle 建置指令碼中定義的預設儲存庫清單。
此外,由於 JFrog 將停止使用 JCenter 儲存庫,開發人員可以自行承擔風險移除它。由於這是小版本發布,因此我們並未移除 JCenter 作為預設儲存庫之一,因為這會被視為重大變更。
支援 webp
影像作為啟動畫面
之前我們僅支援 png
檔案格式作為啟動畫面,因為 webp
支援僅從 API 17 開始引入。由於 cordova-android@9.x
的最低 SDK 版本已提高到 22,因此引入 webp
支援成為可能。
眾所周知,webp
檔案格式支援透明度,並提供與 png
檔案相同或相似的品質,但其最大好處是可以將影像檔案大小減少約 25%。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 cordova-plugin-inappbrowser
的更新!
這是一個新的主要版本,包含重大變更,至少需要 cordova-android@9.0.0
和 cordova-ios@6.0.0
。請務必檢查並更新您的平台。
此主要版本中最值得注意的改進包括:
InAppBrowserStatusBarStyle
設定為 'darkcontent'。請在 issues.cordova.io 回報您發現的任何問題!
我們在此宣布棄用 cordova-plugin-wkwebview-engine。
這表示 Cordova 開發社群將不再對此外掛程式進行任何工作。您可以繼續在執行 cordova-ios@5.1.1
或更早版本的現有和新應用程式中按原樣使用此外掛程式,但 Cordova 團隊將不會修正任何進一步的問題。
自 cordova-ios@6
起,WKWebView 實作已移至核心 iOS 平台。我們鼓勵所有人更新到 cordova-ios@6
並移除 cordova-plugin-wkwebview-engine
。
我們衷心接受並感謝您的回饋!
我們很高興地宣布,我們剛剛發布了 Cordova iOS 6.2.0
!這是 Cordova 用於建置 iOS 行動應用程式的官方平台。
此版本包含小的錯誤修正、相依性更新並解決了一些啟動畫面問題。外掛程式開發人員現在可以掛鉤到 WKURLSchemeHandler
(了解更多)。
升級方式
cordova platform remove ios
cordova platform add ios@6.2.0
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了 WKWebView 引擎外掛程式的更新!
此外掛程式不支援 cordova-ios@6
,因為 iOS 平台現在內建 WKWebView 引擎。因此,此修補程式版本更新了外掛程式,使其在安裝 cordova-ios@6
或更高版本時不會安裝。如果執行 cordova-ios@6
或更高版本,可以安全地移除此外掛程式。
我們很高興地宣布,cordova-fetch@3.0.1
已於 2021 年 2 月發布。此模組負責從 npm 套件登錄中安裝平台和外掛程式,此版本新增了對 npm 版本 7 的相容性。
升級方式
由於 cordova-fetch
是 cordova
命令列工具的相依性,您需要重新安裝 cordova
套件才能更新
npm uninstall -g cordova
npm install -g cordova
此修補程式版本中最顯著的修復是針對使用最新 npm 版本進行外掛程式和平台安裝的問題。更多詳細資訊可以在pull request和原始錯誤回報單中找到。感謝 Raphael 實作此修復。
請在 issues.cordova.io 回報您發現的任何問題!
我們已解決相機外掛程式中可能影響某些 Cordova (Android) 應用程式的安全問題。
CVE-2020-11990: Apache Cordova 外掛程式相機存在資訊洩漏漏洞
漏洞類型
CWE-200:將敏感資訊暴露給未經授權的參與者
嚴重性: 低
供應商: Apache 軟體基金會
可能的攻擊者條件
能夠安裝(或引導受害者安裝)特製(或惡意)Android 應用程式的攻擊者。Android 文件將外部快取位置描述為應用程式專屬,但是,「這些檔案沒有任何安全強制措施。例如,任何持有 Manifest.permission.WRITE_EXTERNAL_STORAGE 的應用程式都可以寫入這些檔案。」(因此可以讀取)。
可能的受害者
使用基於 Apache Cordova 的應用程式拍照且附加可移除儲存裝置的 Android 使用者。
可能的影響
受影響的版本
使用相機外掛程式的 Cordova Android 應用程式
(cordova-plugin-camera 版本 4.1.0 及以下)
升級路徑
擔心此問題的開發人員應安裝 cordova-plugin-camera 的 5.0.0 或更高版本
緩解步驟
升級外掛程式並重新建置應用程式,更新部署。
致謝
[編輯:將致謝變更為個人]
Saison Information Systems Co., Ltd. 的 Akihiro Matsumura 向 IPA 報告了此漏洞。
JPCERT/CC 在資訊安全早期預警夥伴關係下與開發人員協調。
[編輯:新增 JPCERT/CC 公告的連結]
我們很高興宣布我們剛剛發布了 Cordova Electron 2.0.0
!這是 Cordova 支援的用於建置 Electron 應用程式的平台之一。
升級方式
cordova platform remove electron
cordova platform add electron@2.0.0
安裝方式
cordova platform add electron@2.0.0
此版本中一些值得注意的重大變更和新功能如下
12.18.4
。現在支援使用自訂的 scheme
和 hostname
preference
旗標。您可以透過在 config.xml
檔案中設定 preference 選項 scheme
和 hostname
,輕鬆在您的 Cordova 專案中設定此選項。
<preference name="scheme" value="app" />
<preference name="hostname" value="localhost" />
cordova run
命令。這對於將 inspect 旗標傳遞以偵錯主要程序非常有用。如需快速入門指南和深入設定,請查看我們的 Cordova Electron 文件!
請在 issues.cordova.io 回報您發現的任何問題!
此漏洞是 Android WebView 中的通用跨網站指令碼 (UXSS) 漏洞,允許跨網域 iframe 在頂層文件中執行任意 JavaScript。為 Android 裝置建置的 Apache Cordova 應用程式如果允許載入來自它們不控制的網域的 http 內容,可能會受到影響。理論上,這會在 iframe 中,或透過使用 InAppBrowser 外掛程式 (cordova-plugin-inappbrowser) 來實現。
如果您的應用程式載入本機頁面(例如,Cordova 應用程式中的 index.html 從 malicious-example.com 載入 iframe),則此漏洞不需要使用者互動即可利用。
此漏洞已在 Android WebView 83.0.4103.106 版中修復。使用者必須自行從 Google Play 商店更新他們的 Android WebView。
您可以採取預防措施來避免此漏洞。
_system
呼叫 InAppBrowser)請勿使用 iframe,如果必須使用,請永遠不要在應用程式的主要 webview 中使用。使用 sandbox
屬性將可緩解此漏洞(最好是使用空值)。請避免一起使用這些 sandbox 屬性 allow-popups allow-top-navigation allow-scripts
,因為它們無法緩解此漏洞。
<iframe sandbox='' src='http://untrusted-source' />
大多數這些預防措施一直是 Apache Cordova 的溫和建議,但未反映在通常保持開放的預設值中。Apache Cordova 提交者正在調查在框架層級防止此漏洞,並收緊預設值以防止無意中暴露。同時,如果您懷疑您的應用程式存在漏洞,請遵循上述預防措施。
感謝 Alesandro Ortiz 發現此漏洞並提醒我們注意。
編輯:修復了未連結的連結 -JM
我們很高興宣布我們剛剛發布了相機外掛程式的更新!
在此主要版本中,我們已
DestinationType
的 NATIVE_URI
。對於 iOS,NATIVE_URI
傳回已過時且無法與 WKWevView
搭配使用的 ALAssetsLibrary
。CordovaUri
類別協助程式。由於我們事先知道檔案路徑,因此這個過程是不必要的。我們很高興宣布我們剛剛發布了 Cordova iOS 6.1.1
!這是 Cordova 用於建置 iOS 行動應用程式的官方平台。
升級方式
cordova platform remove ios
cordova platform add ios@6.1.1
此版本主要包含針對部署到裝置的修復,以及對 cordova-common 程式庫的更新,我們希望此更新能解決關於 Info.plist
修改的幾個問題。
解決部署到已連線裝置的問題(自 6.0.0 以來)
Cordova iOS 6.0.0 版本無法將應用程式部署到已連線的 iPhone 和 iPad 裝置。感謝第一次投稿的 imgos 追蹤問題的來源並提供修復。
修復識別正確 Info.plist
檔案的問題
這一直是 Cordova iOS 使用者的長期痛點,尤其是在外掛程式嘗試使用 edit-config
或 config-file
將指示新增至 Info.plist
檔案時。在某些情況下,根據安裝的外掛程式和 CocoaPods,這些設定變更最終會進入錯誤的 plist 檔案中。
此問題已在 Cordova Common 4.0.2 中修復,並且我們已將該相依性引入此版本。更多詳細資訊可以在pull request和原始錯誤回報單中找到。
在使用自訂配置時將 startURL
附加至初始 URL(自 6.0.0 以來)
在 Cordova iOS 6.0.0 中使用自訂配置和指向 www
子資料夾的 config.xml
content
路徑時,該子資料夾會被視為自訂配置的根目錄。雖然這不是常見情況,但事實證明,mobilespec 測試套件的實作方式就是如此。
此處的修復是自訂配置的根目錄將始終對應到 www
資料夾。更多詳細資訊可以在pull request中找到。
請在 issues.cordova.io 回報您發現的任何問題!
Adobe 最近宣布 PhoneGap 即將關閉。Cordova 如何受到影響?簡而言之:影響不大。
請放心,Apache Cordova 仍然活躍且正在維護中!
我們想藉此機會感謝 Adobe 和 PhoneGap 團隊在設計和建置這些工具、服務和社群中所付出的所有心血。沒有他們,混合式行動應用程式就不會是現在這樣。
如今,我們很幸運地擁有由社群完全維護的開源軟體 Cordova。PhoneGap 最初是 Nitobi Software 在 2008 年啟動的開源專案。Nitobi Software 在 2011 年被 Adobe 收購,並在不久後將 PhoneGap 作為 Cordova 捐贈給Apache 軟體基金會。在過去九年中,Apache Cordova 是 Adobe PhoneGap 和 PhoneGap Build 的核心工具,只要社群的健全狀況保持良好且持續有貢獻,它就會繼續蓬勃發展。如果您使用過、正在使用或希望開始使用 Cordova,也請考慮貢獻並參與這個很棒的社群,以幫助它成長。
我們,Apache Cordova 的社群和貢獻者,要衷心感謝 Adobe 和所有 PhoneGap 團隊成員為這個混合式行動社群所付出的一切,並感謝他們將 Cordova 分享給 Apache 軟體基金會,使其得以繼續成長和繁榮。
Apache Cordova 的貢獻者
我們很高興宣布我們剛剛發布了 cordova 10.0.0
!
升級方式
npm uninstall -g cordova
npm install -g cordova@10.0.0
除了各種改進和修復之外,此版本還更新了其核心程式庫。
以下平台已更新至最新的釘選版本。
cordova-android@^9.0.0
cordova-ios@^6.1.0
cordova-osx@^6.0.0
此外,此版本還進行了以下變更:
plugin save
命令,該命令自 7.0 版本以來已成為預設行為。cordova info
的顯示。請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發佈了 cordova-lib 10.0.0
!
除了各種改進和修復之外,此版本還:
plugin save
命令,該命令自 7.0 版本以來已成為預設行為。請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發布了開機畫面外掛程式的更新!
在這個主要版本中,iOS 相關的原始碼已完全移除,因為它已整合到 Cordova-iOS 6.x 平台的核心中。
我們最近發佈了說明,說明如何更新您的應用程式以移除所有 UIWebView
參照,因為 Apple 現在拒絕所有使用 UIWebView
的應用程式。
我們正在討論這個警告
ITMS-90809:已棄用的 API 使用 - Apple 將停止接受使用 UIWebView API 的應用程式提交。
自上一篇文章以來,有些事情發生了變化,並且發佈了新版本的 cordova-ios。
我們很高興地宣布,cordova-common@4.0.2
已於 2020 年 7 月發佈。這是幾乎所有 Cordova 工具幕後使用的程式庫之一,它提供了一些實用程式,用於處理諸如 config.xml
剖析之類的事情。
此修補程式版本中最值得注意的修復是在專案中存在多個 plist
檔案時,能夠更新正確應用程式的 plist
檔案。更多詳細資訊可以在提取請求和原始錯誤票證中找到。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發佈了 Cordova Android 9.0.0
!這是 Cordova 支援的用於建置 Android 行動應用程式的平台之一。
升級方式
cordova platform remove android
cordova platform add android@9.0.0
新增 Kotlin 支援
Kotlin 是用於開發 Android 應用程式的最新靜態類型語言之一。它旨在與現有的語言 Java 完全協同工作。
預設情況下,Cordova 已禁用 Kotlin,但可以使用 config.xml
中的 GradlePluginKotlinEnabled
偏好設定啟用它。
此外,Kotlin 的程式碼樣式和版本是可配置的。預設情況下,Cordova 將程式碼樣式設定為 official
並使用版本 1.3.50
。
以下是一個用於啟用和設定 Kotlin 的 config.xml
範例。
<preference name="GradlePluginKotlinEnabled" value="true" />
<preference name="GradlePluginKotlinCodeStyle" value="official" />
<preference name="GradlePluginKotlinVersion" value="1.3.50" />
對於插件開發人員,建議確保將 Kotlin 檔案放置在平台 src/main/kotlin
目錄中。
新增 AndroidX 支援
AndroidX 是 Android 支援程式庫的新的和改進的命名空間。不再維護原始支援程式庫。
建議使用 AndroidX,以便您的應用程式執行最新的支援程式庫,但預設情況下,Cordova 已禁用 AndroidX 支援,以與現有的插件相容。
許多 Android 支援的插件仍然使用舊的支援程式庫,這些程式庫在使用 AndroidX 支援程式庫時無法建置。建議研究每個插件,以查看它們是否支援 AndroidX,然後再啟用此功能。
建議插件開發人員開始遷移以支援 AndroidX。應用程式開發人員也可以使用 Jetifier 自動遷移其現有的第三方程式庫以使用 AndroidX。
您可以透過將 config.xml
中的 AndroidXEnabled
偏好設定設定為 true
來啟用此功能。
<preference name="AndroidXEnabled" value="true" />
如果您之前使用 cordova-plugin-androidx 插件來啟用 AndroidX 支援,則此偏好設定標誌不再需要此插件。
cordova-plugin-androidx-adapter 插件可用於將舊的參照遷移到新的 AndroidX 參照。
新增 Google 服務支援
若要使用 Google API 或 Firebase 服務,在建置 Android 應用程式時,需要啟用 Gradle 插件 Google 服務。
對於插件開發人員,可以透過將 GradlePluginGoogleServicesEnabled
preference
標誌設定為應用程式的 config.xml
來啟用此功能。從 plugin.xml
檔案中,您可以透過新增以下行來執行此操作
<config-file target="config.xml" parent="/*">
<preference name="GradlePluginGoogleServicesEnabled" value="true" />
<preference name="GradlePluginGoogleServicesVersion" value="4.2.0" />
</config-file>
Android 版本支援更新
注意:由於 Cordova 已將最低 SDK 版本提高到 22,因此我們不再支援或測試 Android 5.0 或更低版本。
Gradle 和 Gradle 插件版本支援更新
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發佈了 Cordova iOS 6.1.0
!這是 Cordova 用於建置 iOS 行動應用程式的官方平台。
升級方式
cordova platform remove ios
cordova platform add ios@6.1.0
此版本主要包含對 6.0.0 版本問題的修復。
解決 CocoaPods 發佈問題(自 6.0.0 起)
由於 Pod 規格的問題,Cordova iOS 6.0.0 版本無法發佈到 CocoaPods。這些問題已解決,並且 Cordova iOS 6.1.0 可用。
修正橫向預設方向(自 6.0.0 起)
在 Cordova iOS 6.0.0 中進行的變更會產生副作用,導致任何未在 config.xml
中指定 Orientation
偏好設定的應用程式都禁用橫向方向。我們已還原該變更,新應用程式將符合 Xcode 預設值(允許縱向和橫向方向)。
為了確保您的應用程式正確支援您想要的方向,我們建議設定 Orientation
偏好設定。
修正隱形啟動畫面錯誤(自 6.0.0 起)
Cordova iOS 6.0.0 中的一個錯誤會導致啟動畫面不可見,除非在 config.xml
中設定了 BackgroundColor
偏好設定。這不是預期的行為,並導致人們對無法與啟動畫面後面的網頁檢視互動感到困惑。
在 Cordova iOS 6.1.0 中,我們已修正了啟動畫面,使其始終具有背景顏色(預設為系統背景顏色),並且啟動分鏡腳本圖片應該保持可見。
若要自訂您的應用程式及其啟動畫面的背景顏色,請使用 config.xml
中的 BackgroundColor
偏好設定。
新增對深色模式啟動畫面的支援(新功能)
現在可以在您的應用程式在深色模式下執行時,選擇性地使用不同的啟動畫面圖片。您可以使用 ~dark
後綴(也支援 ~light
)在 config.xml
中設定這些圖片。
<!-- Default image to be used for all modes -->
<splash src="res/screen/ios/Default@2x~universal~anyany.png" />
<!-- Image to use specifically for dark mode devices -->
<splash src="res/screen/ios/Default@2x~universal~anyany~dark.png" />
<!-- Image to use specifically for light mode devices -->
<splash src="res/screen/ios/Default@2x~universal~anyany~light.png" />
新增 iPad 桌面配置行為的偏好設定(新功能)
iPadOS 13 預設在網頁檢視中使用桌面配置,而不是行動配置。您現在可以使用 config.xml
中的 PreferredContentMode
偏好設定在您的應用程式中控制此行為。有效選項為 mobile
和 desktop
。
新增網頁檢視視窗處理的偏好設定(新功能)
從歷史上看,Cordova iOS 不支援使用諸如 window.open
或帶有 target="_blank"
的連結之類的 API 建立新的網頁檢視視窗。預設行為不一致,某些連結在 Safari 中外部開啟,而某些連結無法點擊。現在,在 config.xml
中有一個 AllowNewWindows
偏好設定,用於控制應用程式中新視窗的行為。
當false(預設行為)時,會開啟新視窗的連結會像未請求新視窗一樣在同一個網頁檢視中開啟。
當true 時,會開啟新視窗的連結將在應用程式頂部建立新的網頁檢視。此新的網頁檢視不提供任何控制項,因此您必須透過 window.close()
包含關閉它的方法。
位於 allow-navigation
URL 清單之外的連結將繼續在 Safari 中開啟。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發佈了 Cordova OSX 6.0.0
!這是 Cordova 支援的用於建置 macOS 桌面應用程式的平台之一。
此版本包含各種依賴項更新。
我們已將此版本所需的最低 NodeJS 版本提高到 10.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布,我們剛剛發佈了一些插件的更新!
此主要版本中最顯著的變更為
UIWebView
程式碼,此版本也從 InAppBrowser 插件 GH-635 中移除了 UIWebView
程式碼。在 Cordova-iOS 6.x 平台中,啟動畫面功能已整合到其核心中,並且不再需要此插件。此版本會阻止將插件新增到 iOS 6.x 平台。
cordova-ios
需求 <6.0.0我們很高興宣布,我們的工具剛剛發布了更新!
targetName
新增至 getBuildProperty
的參數我們很高興宣布,我們剛剛發布了 Cordova iOS 6.0.0
!這是 Cordova 用於建置 iOS 行動應用程式的官方平台。
升級方式
cordova platform remove ios
cordova platform add ios@6.0.0
此主要版本中最顯著的變更為
新增 Xcode 11 相容性,並將最低 iOS 版本提升至 11.0
自 2020 年 4 月起,Apple 要求所有應用程式商店提交的內容都必須以 Xcode 11 建置,並以 iOS 13 SDK 為目標。
Apple 已在 iOS 8.0–9.0 中棄用 mediaPlaybackRequiresUserAction
屬性,並以 mediaTypesRequiringUserActionForPlayback
取代。Apple 也已在 iOS 8.0-9.0 中棄用 mediaPlaybackAllowsAirPlay
屬性,並以 allowsAirPlayForMediaPlayback
取代。
如果您已在專案的 config.xml
檔案中設定這些屬性中的任何一個,建議您使用新的偏好設定選項 MediaTypesRequiringUserActionForPlayback
或 AllowsAirPlayForMediaPlayback
進行更新。
此外,MediaTypesRequiringUserActionForPlayback
的值已變更。過去它是一個 boolean
值,但現在是一個 string
值,可以是 all
、audio
、video
或 none
。
將 WKWebView
支援移至 Cordova-iOS,並移除 UIWebView
程式碼
由於這項變更,cordova-plugin-wkwebview-engine
外掛程式已過時,並且無法在此版本中使用。如果您已安裝此外掛程式,可以使用 cordova plugin remove cordova-plugin-wkwebview-engine
安全地移除它。
此外,此版本還引入了 WKURLSchemeHandler
支援。使用自訂方案來透過修復由於 WKWebView
對 file
方案採用的嚴格安全性原則而存在的 CORS 問題,來提供您的應用程式內容。您可以透過在 config.xml
檔案中設定偏好設定選項 scheme
和 hostname
,輕鬆地將您的 Cordova 專案設定為使用自訂方案。
<preference name="scheme" value="app" />
<preference name="hostname" value="localhost" />
重要的是要知道,隨著 WKURLSchemeHandler
的引入,已停止支援 iOS 10。
整合 SplashScreen
外掛程式程式碼,並以啟動故事板取代啟動影像
如果您是從啟動影像移轉,可以在SplashScreen 文件中找到如何設定啟動故事板影像的詳細資訊。
將最低 CocoaPods 版本要求提升至 1.8.0
自 CocoaPods 1.7.0 起,引入了 CDN 支援。它稍後在 1.7.2 中最終確定,但直到 1.8.0 才設定為預設值。透過 CDN 取得 podspec 比傳統 GitHub 儲存庫提供了巨大的效能增強。使用 CDN,Cordova 使用者不再需要等待 CocoaPod 的 GH 儲存庫同步。使用 pod 和全新的 CocoaPods 安裝來建置專案現在只需不到一分鐘。
您可以查看他們的示範影片,了解 CocoaPods 使用 CDN 變得多快。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們的工具和範本剛剛發布了更新!
我們已將所有套件所需的最低 Node.js 版本提升至 10.x,並開始將節點 JavaScript 現代化以使用受支援的 ES6。
window.navigator
argscheck.checkArgs
中某些參數格式的剖析opn
取代為 open
index.css
,修正重複的 env
right請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,cordova-common@4.0.0
已在 2020 年 3 月發布。這是幾乎所有 Cordova 工具都在幕後使用的程式庫之一,並且提供了用於處理 config.xml
剖析等項目的公用程式。
此主要版本中最顯著的變更為
由於已停止支援 Node.js 6.x 和 8.x,我們已將此版本所需的最低 Node.js 版本提升至 10.x。
Apple 開始拒絕包含 UIWebView
參考的應用程式。您需要更新您的應用程式以修正此問題,而這篇文章總結了所需的步驟。
這應該可以解決將應用程式上傳到 App Store Connect 後的警告
ITMS-90809:已棄用的 API 使用 - Apple 將停止接受使用 UIWebView API 的應用程式提交。
引入了新的 preference
旗標 WKWebViewOnly
,以在編譯期間從 Cordova 的程式碼中移除所有 UIWebView
參考。建議將 cordova-ios
平台升級至 5.1.1
版。
我們很高興宣布,我們剛剛發布了 cordova-plugin-inappbrowser
的更新!
此小版本中最顯著的改進是
WKWebViewOnly
偏好設定的支援。請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Windows 7.0.1
版!這是 Cordova 用於建置 Windows 應用程式的支援平台之一。
升級方式
cordova platform remove windows
cordova platform add windows@7.0.1
修補程式版本,以解決 winjs
相依性路徑的問題 (#331)
我們很高興宣布,我們剛剛發布了 cordova-node-xcode
的更新!這是用於剖析、編輯和寫入 xcodeproj 專案檔案的幕後程式庫之一。
包含一些外部貢獻的小版本
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova iOS 5.1.1
!這是 Cordova 用於建置 iOS 行動應用程式的官方平台。
升級方式
cordova platform remove ios
cordova platform add ios@5.1.1
此修補程式版本中最顯著的修正,是使準備步驟等待平台新增步驟完成。這解決了在新增平台之前設定 WKWebViewOnly
旗標時所看到的問題。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova iOS 5.1.0
!這是 Cordova 用於建置 iOS 行動應用程式的官方平台。
升級方式
cordova platform remove ios
cordova platform add ios@5.1.0
此小版本中最顯著的改進是
UIWebView
的能力。minDeploymentTarget
提升至 10.0
。請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,cordova-common 3.2.1
已於 2019 年 11 月發布。這是幾乎所有 Cordova 工具都在幕後使用的程式庫之一,並且提供了用於處理 config.xml
剖析等項目的公用程式。
此修補程式版本中最顯著的變更是
.jsproj
擴充功能作為 XML 允許擴充功能,以便可由 config-file
標籤編輯。plugin.xml
定義的權限未新增。我們很高興宣布,我們剛剛發布了 Cordova Android 8.1.0
!這是 Cordova 用於建置 Android 行動應用程式的支援平台之一。
升級方式
cordova platform remove android
cordova platform add android@8.1.0
此小版本中最顯著的改進是支援建置 .aab
套件組合。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Electron 1.1.1
!這是 Cordova 支援的用於建構 Electron 應用程式的平台之一。
升級方式
cordova platform remove electron
cordova platform add electron@1.1.1
安裝方式
cordova platform add electron@1.1.1
此修補程式版本中一些值得注意的修復包括:
package.json
缺少 dependencies
屬性時,準備工作不再失敗。如需快速入門指南和深入的組態設定,請查看我們的 Cordova Electron 文件!
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Electron 1.1.0
!這是 Cordova 支援的用於建構 Electron 應用程式的平台之一。
升級方式
cordova platform remove electron
cordova platform add electron@1.1.0
安裝方式
cordova platform add electron@1.1.0
此版本中引入的一些值得注意的功能包括:
此外,我們已將 cordova-common@^3.2.0
和 fs-extra@^8.0.1
依賴項升級,以解決 fs-extra
的缺陷,該缺陷導致 Windows 環境中隨機建置失敗。 閱讀更多
如需快速入門指南和深入的組態設定,請查看我們的 Cordova Electron 文件!
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,cordova-common 3.2.0
已於 2019 年 6 月發布。這是幾乎所有 Cordova 工具在幕後使用的程式庫之一,並提供處理諸如 config.xml
解析等事物的工具。
我們很高興宣布 Cordova iOS 5.0.1
已發布!此版本修正了與 Xcode 10.2 模擬器和 Cocoapod 支援相關的各種錯誤。
升級方式
cd my_project
npx cordova platform remove ios
npx cordova platform add ios@5.0.1
要明確新增它
npx cordova platform add ios@5.0.1
目前,所有最新發布的平台、工具和核心程式庫都需要安裝最低版本的 node 6.x
。此外,我們還新增了對 node 10.x
的支援。
Node.js 基金會已報告 6.x 版的生命週期終止 (EOL) 將於 2019 年 4 月 30 日。展望未來,Node.JS 基金會還安排在 2019 年 12 月 31 日棄用 8.x,以與排定的 OpenSSL-1.0.2 生命周期終止時間對齊。
自 2018 年 10 月 30 日起,node 10.x
已開始其長期支援 ([LTS][1]) 週期。因此,由於 node 10.x
是來自 Node.js 的預設下載,我們也建議使用者在 8.x 達到 EOL 之前/屆時升級至目前的 LTS (10.x)。
在這兩個不同的棄用期間,我們將準備我們的工具、平台、核心程式庫和外掛程式,以遵循 Node.js 基金會報告的 EOL 時程。
我們也計劃新增 node 12.x
支援。目前,node 12.x
正在等待於 2019 年 4 月 23 日發布。
外掛程式本身的 JavaScript 檔案不受影響,因為它們的 JavaScript 支援取決於平台瀏覽器支援。對於 Electron 平台,如果使用 Node.js API,則可能會產生影響。
我們很高興宣布,我們剛剛發布了 plugman 3.0.0
!Plugman 是一個命令列工具,我們提供此工具在 以平台為中心的工作流程中安裝和解除安裝外掛程式。
升級方式
npm uninstall -g plugman
npm install -g plugman@3.0.0
除了各種改進和修復之外,此版本還移除了 browserify
和 fetch
選項。
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 cordova 9.0.0
!
升級方式
npm uninstall -g cordova
npm install -g cordova@9.0.0
除了各種改進和修復之外,此版本還更新了其核心程式庫。
預設情況下,所有最新平台版本均可用。
cordova-android@^8.0.0
cordova-browser@^6.0.0
cordova-electron@^1.0.0
cordova-ios@^5.0.0
cordova-osx@^5.0.0
cordova-windows@^7.0.0
此外,Cordova Electron 是最新支援的平台之一,也已推出!
此版本也已棄用 browserify
、fetch
和 copy-from
選項。
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 cordova-lib 9.0.0
!
除了各種改進和修復之外,此版本還移除了 --browserify
標誌。
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Electron 1.0.2
!這是 Cordova 支援的用於建構 Electron 應用程式的平台之一。
安裝方式
Cordova 8.x
cordova platform add cordova-electron@1.0.2
由於原始版本是針對 Cordova CLI 9.x,因此在發布後階段才決定在 Cordova CLI 8.x 上提供支援。
在此版本中,Cordova CLI 8.x 現在支援 Electron。
請注意,在 Cordova CLI 8.x 上,任何接受平台引數的命令都必須是 cordova-electron
。
範例
cordova run cordova-electron --nobuild
cordova build cordova-electron
如需快速入門指南和深入的組態設定,請查看我們的 Cordova Electron 文件!
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Windows 7.0.0
!這是 Cordova 支援的用於建構 Windows 應用程式的平台之一。
升級方式
cordova platform remove windows
cordova platform add windows@7.0.0
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Electron 1.0.0
!這是 Cordova 最新支援的用於建構 Electron 應用程式的平台之一。
安裝方式
Cordova CLI 9.x
cordova platform add electron@1.0.0
此版本的一些主要功能
electron-builder@^20.38.4
)如需快速入門指南和深入的組態設定,請查看我們的 Cordova Electron 文件!
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Android 8.0.0
!這是 Cordova 支援的用於建構 Android 行動應用程式的平台之一。
升級方式
cordova platform remove android
cordova platform add android@8.0.0
除了各種改進和錯誤修復之外,此版本還包含一些主要功能。
一些主要功能是:
此外,由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova iOS 5.0.0
!這是 Cordova 支援的用於建構 iOS 行動應用程式的平台之一。
升級方式
cordova platform remove ios
cordova platform add ios@5.0.0
除了各種改進和錯誤修復之外,此版本還包含一些主要功能。
一些主要功能是:
此版本僅支援 Xcode 9 及更高版本。重要的是要知道,從 2019 年 3 月開始,Apple 要求所有提交至 App Store 的新應用程式都必須使用 iOS 12.1 SDK 或更高版本 (Xcode 10) 建置。 來源
此外,由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova OSX 5.0.0
!這是 Cordova 支援的用於建構 macOS 桌面應用程式的平台之一。
除了各種修復之外,此版本還包括對 Swift 4 和 App Store 圖示的支援。
此外,由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 Cordova Browser 6.0.0
!這是 Cordova 支援的用於建構以瀏覽器為目標的應用程式的平台之一。
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 cordova-node-xcode
的更新!這是用於剖析、編輯和寫入 xcodeproj 專案檔案的幕後程式庫之一。
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,我們剛剛發布了 cordova-create
的更新!這是用於建立 Cordova 樣式專案的幕後程式庫之一,並且包括對 Cordova 範本的支援。
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布,cordova-common 3.1.0
已於 2019 年 1 月發布。這是幾乎所有 Cordova 工具在幕後使用的程式庫之一,並提供處理諸如 config.xml
解析等事物的工具。
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
此版本的目的是在需要時使用真正的單例物件。以下是主要變更:
以下是先前未宣布的 cordova-common 3.0.0
版本中的主要變更:
PluginInfo.getPodSpecs
方法 (#48)ios.json
和 android.json
中 config_munge
的計數錯誤問題 (#24)plist_helpers
中的貪婪正則表達式 (#45)cordova-registry-mapper
相依性 (#33)cross-spawn
進行平台獨立的生成 (#50)我們很高興宣布,我們的工具剛剛發布了更新!
由於 NodeJS 團隊已於 2018 年 4 月 30 日停止支援 NodeJS 4.x,因此我們已將此版本所需的最低 NodeJS 版本提高至 6.x。
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣佈 Cordova node xcode 1.1.0
版本已於 2018 年 12 月發佈。
此修補程式發佈的目的是包含以下更新
pbxFile
擴展名的問題 (#31)pegjs
移至 package.json
中的 devDependencies
(#10)由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 Node.js 4.x 的版本。
我們很高興地宣佈 Cordova Android 7.1.4
已發佈!這解決了最近 7.1.3
版本中引入的錯誤。感謝我們的使用者在 GitHub issues 上快速回報並協助找出問題。
如果您因為第三方外掛程式的相容性問題而一直停留在 Cordova Android 6.x,我們強烈建議您嘗試更新到 Cordova Android 7.1.4
。如果您在此新版本中遇到任何外掛程式相容性問題,請提交問題。
升級方式
npm install -g cordova
cd my_project
cordova platform remove android
cordova platform add android@latest
要明確新增它
cordova platform add android@7.1.4
我們很高興地宣佈 Cordova Android 7.1.3
已發佈!此版本解決了與外掛程式相容性相關的幾個問題。
如果您因為第三方外掛程式的相容性問題而一直停留在 Cordova Android 6.x,我們強烈建議您嘗試更新到 Cordova Android 7.1.3。如果您在此新版本中遇到任何外掛程式相容性問題,請提交問題。
升級方式
npm install -g cordova
cd my_project
cordova platform remove android
cordova platform add android@latest
要明確新增它
cordova platform add android@7.1.3
我們很高興地宣佈 Cordova Android 7.1.2
已發佈!此版本修復了與 gradle 儲存庫和外掛程式相容性相關的各種錯誤。
如果您因為第三方外掛程式的相容性問題而一直停留在 Cordova Android 6.x,我們強烈建議您嘗試更新到 Cordova Android 7.1.2。如果您在此新版本中遇到任何外掛程式相容性問題,請提交問題。
升級方式
npm install -g cordova
cd my_project
cordova platform remove android
cordova platform add android@7.1.2
要明確新增它
cordova platform add android@7.1.2
我們很高興地宣佈 Cordova CLI 8.1.2
修補程式版本已於 2018 年 10 月發佈。
此修補程式發佈的目的是包含 cordova-lib@8.1.1
的錯誤修復更新,如下所示
cordova-lib@8.1.1
相依性,以重新引入在 cordova-lib@8.1.0
次要版本中移除的 xcode
和其他相依性 (GH-706)由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 Node.js 4.x 的版本。
我們很高興地宣佈 cordova-lib 8.1.1
已於 2018 年 10 月發佈。
此版本發佈的目的是解決版本 8.1.0
中引入的可能的相依性損壞問題,如 GH-706 中所述。以下是重要的變更
xcode
相依性,以避免在下一個主要版本之前中斷諸如 branch-cordova-sdk
之類的外掛程式8.1.0
中刪除的其他相依性,以更好地確保任何其他使用 requireCordovaModule
的外掛程式或應用程式不會因次要版本升級而損壞由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 NodeJS 4.x 的版本。
我們很高興地宣佈 Cordova Windows 6.0.1
已發佈!此版本修復了與之前的 cordova-windows@6.0.0
版本相關的各種錯誤。
升級方式
npm install -g cordova
cd my_project
cordova platform rm windows
cordova platform add windows@latest
要明確新增它
cordova platform add windows@6.0.1
我們很高興地宣佈 Cordova CLI 8.1.1
熱修復已於 2018 年 9 月發佈。
此熱修復發佈的目的是解決 Cordova CLI 8.1.0
版本中損壞的幾個項目
由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 NodeJS 4.x 的版本。
我們很高興地宣佈 Cordova CLI 8.1.0
已於 2018 年 9 月發佈。
此版本發佈的目的是解決 npm audit
問題,使用最新版本的 cordova-android 和 cordova-windows,並包含其他一些最新更新。以下是重要的變更
cordova-lib@8.1.0
insight
以解決 npm audit
警告由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 NodeJS 4.x 的版本。
我們很高興地宣佈 cordova-lib 8.1.0
已於 2018 年 9 月發佈。
此版本發佈的目的是解決 npm audit
問題,使用最新版本的 cordova-android 和 cordova-windows,並包含其他一些最新更新。以下是重要的變更
true
(GH-624)由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 NodeJS 4.x 的版本。
我們很高興地宣佈 cordova-fetch 1.3.1
已於 2018 年 9 月發佈。
此版本發佈的目的是解決 package.json
中的專案 URL 並包含一些小的錯誤修正。以下是重要的變更
由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 NodeJS 4.x 的版本。
我們很高興地宣佈 Cordova OSX 4.0.2
(適用於 macOS) 已發佈!此版本修復了與之前的 cordova-osx@4.0.1
版本相關的各種錯誤。
升級方式
npm install -g cordova
cd my_project
cordova platform rm osx
cordova platform add osx@latest
要明確新增它
cordova platform add osx@4.0.2
我們很高興地宣佈 Cordova browser 5.0.4
已發佈!此版本修復了與之前的 cordova-browser@5.0.3
版本相關的各種錯誤。
升級方式
npm install -g cordova
cd my_project
cordova platform rm browser
cordova platform add browser@latest
要明確新增它
cordova platform add browser@5.0.4
隨著 Apple 在 WWDC 2018 上宣佈 iOS 12 beta SDK,隨之而來的是 UIWebView(最初與第一個 iOS SDK 捆綁在一起的網頁檢視)已被 棄用 的消息。這對 iOS 開發人員的意義是,未來某個時候,Apple 將從其 SDK 中移除 UIWebView,開發人員應立即開始遷移到使用 WKWebView 元件。
Cordova iOS 從第 4 版開始就預期到這一點,將平台使用的 WebView 移至外掛程式中。預設使用的 WebView 仍然是 UIWebView,但您可以選擇使用 WKWebView,透過 cordova-plugin-wkwebview-engine 外掛程式。UIWebView 和 WKWebView 都是外掛程式,前者包含在 cordova-ios 平台中。
在未來版本的 Cordova iOS 中,我們將在 cordova-ios 平台中同時提供這兩個 WebView 外掛程式,使開發人員能夠測試並將使用者轉移到新的 WKWebView 元件。這個未來版本的 Cordova iOS 將提供一個橋接 WebView 外掛程式,可以在執行時切換使用的 WebView 外掛程式。先前,您只能在建置時選擇要使用的 WebView。
我們很高興宣布 Cordova iOS 4.5.5
已經發布!此版本修復了與先前 cordova-ios@4.5.4
版本相關的各種錯誤。
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@latest
要明確新增它
cordova platform add ios@4.5.5
我們很高興宣布 cordova-common 2.2.5
已於 2018 年 7 月發布。這是幾乎所有 Cordova 工具幕後使用的程式庫之一,並提供處理 config.xml 剖析等功能的實用工具。
此版本發布的目的是解決 NodeJS 4.x 已被棄用的問題。以下是主要變更:
package.json
使用 plist@2 以避免在 NodeJS 4.x 上出現警告由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 NodeJS 4.x 的版本。
我們很高興宣布 Cordova Android 7.1.1
已經發布!此版本修復了與先前 cordova-android@7.1.0
版本相關的各種錯誤。
升級方式
npm install -g cordova
cd my_project
cordova platform remove android
cordova platform add android@7.1.1
要明確新增它
cordova platform add android@7.1.1
我們很高興宣布 cordova-js 4.2.4
已經發布。這是每個 Cordova 平台實作中使用的 cordova.js
JavaScript 程式碼的來源。
此版本發布的目的是為了包含最近的記錄更新,其中封裝建置中已解決了內部 npm audit
訊息。以下是主要變更:
我們很高興宣布 cordova-common 2.2.4
已經發布。這是幾乎所有 Cordova 工具幕後使用的程式庫之一,並提供處理 config.xml 剖析等功能的實用工具。
此版本發布的目的是解決 cordova-ios@4 的相依性問題。以下是主要變更:
npm audit
問題由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 NodeJS 4.x 的版本。
我們很高興宣布 cordova-common 2.2.3
已經發布。這是幾乎所有 Cordova 工具幕後使用的程式庫之一,並提供處理 config.xml 剖析等功能的實用工具。
此版本發布的主要目的是使某些相依性保持最新,但也進行了一些小的錯誤修復
config.xml
查找的一致性更高<edit-config>
或 <config-file>
時發出警告由於 NodeJS 4.x 支援已於 2018 年 4 月 30 日結束,我們將按照我們 先前宣佈的 棄用時間表進行。這可能是最後一個支援 NodeJS 4.x 的版本。
今天更新了以下外掛程式
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera
cordova plugin add cordova-plugin-camera@latest
變更包括
我們很高興宣布 cordova-windows 6.0.0
的發布。
這是一個可能會變更您所依賴功能的主要版本,因此請務必閱讀以下變更清單
cordova build windows
現在預設會建置 Windows 10 UWP 應用程式。cordova build windows -- --appx=8.1-win
、cordova build windows -- --appx=8.1-phone
或等效的組態選項即可。15.5.x
) 建置應用程式,而無需任何其他組態或變通方法(例如 5.0.0 所需的環境變數 VSINSTALLDIR
)。 (注意:Visual Studio 2017 不再支援 Windows 8.1 應用程式,因此您只能使用已安裝的 Visual Studio 2015 建置這些應用程式。)MSBUILDDIR
允許直接設定用於建置應用程式的 MSBuild 工具。雖然 VSINSTALLDIR
一直是一種偶然也適用於在不同 MSBuildTools 版本之間切換的變通方法,但我們現在明確說明此功能:只需將 ENV 變數設定為您想要的 MSBuild 資料夾(例如 C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\MSBuild\15.0\Bin
或 C:\Program Files (x86)\MSBuild\14.0\bin\
),它將用於建置您的專案。與往常一樣,此新版本只會在下一個版本的 Cordova CLI 發布後,才會新增為 cordova platform add windows
的預設 cordova-windows
版本。在此之前,請使用以下命令來移除並重新新增 windows
平台
cordova platform rm windows
cordova platform add windows@6.0.0
如同常見情況,cordova-windows 的 6.0.0
版本並不完美,並且有一些已知的限制
如果您在使用此新版本時遇到問題,您可以使用 cordova-windows
存放庫的 GitHub 問題來提出。
cordova-windows
的未來進行此更新提醒我們,除了 Windows 10 桌面/UWP 之外,還有多少程式碼需要支援其他平台變體,特別是 Windows 8.1 和 Windows Phone 8.1,以及 Windows 10 Mobile。
由於 Microsoft 最近終止了對所有 Windows 8.1 變體的主流支援,總體市場佔有率下降到 6% 以下,而且 Visual Studio 2017 不再支援 8.1 開發,我們預期不會有任何需要更新 cordova-windows
的 8.1 支援的未來變更。Windows 10 Mobile 也是如此,它不再由 Microsoft 積極開發,並且不會收到安全修復之外的任何其他更新。
因此,我們決定棄用 cordova-windows
的所有「行動裝置」和「手機」建置目標。在不久的將來,我們將發布 7.0.0
版本,其中將移除對這些平台變體的支援,並專注於 Windows 10 UWP - 這將大大降低複雜性並簡化未來維護。
當然,支援這些平台的 cordova-windows 6.0.0
將保持可用,並在必要時接收錯誤修復(類似於 cordova-windows@4
是最後一個支援 Windows 8.0 的版本)。
如果您對這些計劃有任何異議或評論,請在本部落格文章的評論中告訴我們。
我們很高興宣布 Cordova Android 7.1.0
已經發布!此版本修復了與先前 cordova-android@7.0.0
版本相關的各種錯誤。
升級方式
npm install -g cordova
cd my_project
cordova platform remove android
cordova platform add android@7.1.0
要明確新增它
cordova platform add android@7.1.0
Cordova 開發人員有多種方法可以測試和除錯其 Cordova 應用程式。對於功能測試,開發人員會使用模擬器、模擬器和實體裝置。裝置可以位於內部部署,或有許多可用的雲端產品。您甚至可以使用很棒的工具來除錯您的應用程式,例如 Chrome 和 Safari 的網頁應用程式除錯功能,以及 Microsoft 的 Visual Studio Code 適用於 Apache Cordova 的擴充功能的出色除錯功能。
對於除錯外掛程式,或是除錯使用 Cordova 外掛程式的應用程式來說,情況還不算太糟。我認為大多數的外掛程式在任何實體裝置上都具備運作所需的條件,除非該外掛程式需要某些外部硬體裝置,或是有其他並非每台裝置都具備的要求。對於幾個核心的 Cordova 外掛程式而言,裝置模擬器和模擬器會公開一些功能,讓測試人員能夠模擬相機、加速計、指南針和其他裝置端的功能(不過令人驚訝的是,早期的 iOS 模擬器並不支援相機模擬)。
當涉及到測試外掛程式的所有功能,特別是模擬錯誤狀況以了解應用程式如何回應時,情況就會變得複雜。開發人員常常會修改外掛程式碼,不是建立模擬情境,就是在測試期間手動更改外掛程式的行為。在許多情況下,開發人員必須手動在其外掛程式中強制產生錯誤狀況,才能驗證應用程式內的錯誤檢查。我沒有寫過很多 Cordova 外掛程式,但就我所做的一些工作而言,我希望有一個更好的方法。 好吧,事實證明確實有。
今天更新了以下外掛程式
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera
cordova plugin add cordova-plugin-camera@latest
變更包括
今天更新了以下外掛程式
我們上次的外掛程式版本發佈存在一個問題,導致無法從 npm 安裝。這些外掛程式的修訂版本修正了錯誤,讓您可以從 npm 以及 git url 安裝。
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera
cordova plugin add cordova-plugin-camera@latest
變更包括
今天更新了以下外掛程式
在最近的 cordova@8
工具版本中,我們已不再支援已棄用的平台(Ubuntu、BlackBerry10、Windows Phone 8、FirefoxOS)。此外掛程式版本的主要重點也在於不再支援這些平台。這就是為什麼許多外掛程式的主要版本號碼都增加了。
cordova-plugin-contacts
和 cordova-plugin-globalization
已正式棄用。請閱讀我們在 https://cordova.dev.org.tw/news/2017/11/27/Deprecation-of-cordova-contacts-plugin.html 上關於棄用 cordova-plugin-contacts
的決定。對於 cordova-plugin-globalization
,我們在 https://cordova.dev.org.tw/news/2017/11/20/migrate-from-cordova-globalization-plugin.html 上撰寫了遷移至內建 ECMA 國際化 API 的遷移指南。
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera
cordova plugin add cordova-plugin-camera@latest
變更包括
我們剛剛發布了工具的更新!
cordova save
命令。此命令並非必要,因為 cordova 會自動儲存相依性。--nofetch
旗標。現在我們所有的相依性擷取都透過 cordova-fetch
進行。這讓我們可以捨棄我們隨 cordova 一起提供的 npm@2
相依性。相反地,我們現在只使用您的系統 npm
來執行所有擷取作業。若要更新您的 cordova CLI
npm install -g cordova@latest
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布 Cordova Android 7.0.0
已經發佈!
在此版本中,我們變更了 Android 專案的預設專案結構。目前使用 CLI 並將平台目錄中的所有內容視為建置成品的人員應該不會注意到任何差異。
不過,這對於建立獨立 Cordova Android 專案的人員來說是一項重大的重大變更。這也表示檔案的位置已變更,且已與 Android Studio 使用的結構對齊。
這可能會影響使用 edit-config 的 plugin.xml 檔案和 config.xml 檔案,並導致使用 edit-config 的外掛程式無法與 Android 6.x 和 Android 7.x 相容。若要修正此問題,請在您的 XML 檔案中執行下列步驟
<!-- An existing config.xml -->
<edit-config file="AndroidManifest.xml" target="/manifest/application" mode="merge">
<!-- needs to change to -->
<edit-config file="app/src/main/AndroidManifest.xml" target="/manifest/application" mode="merge">
升級方式
npm install -g cordova
cd my_project
cordova platform remove android
cordova platform add android@7.0.0
要明確新增它
cordova platform add android@7.0.0
我們在此宣布棄用 cordova-plugin-contacts。
這表示 Cordova 開發社群將不會再在此外掛程式上進行任何工作。您可以繼續在現有和新的應用程式中按原樣使用此外掛程式,但任何進一步的問題將不會由 Cordova 團隊修正。
一般來說,當我們棄用外掛程式時,我們會提供替代的標準 API 以供遷移,但是,最新的 W3C Contacts API 指出,由於各種隱私和安全性問題,實作標準的工作已停止。一些主要問題是可能洩漏使用者的聯絡人、收件人安全且及時地處置聯絡人資訊,以及使用者不慎授予權限。
我們衷心接受並感謝您的回饋!
我們很高興宣布 Cordova iOS 4.5.4
的次要版本已發佈!
此版本持續為最新的 iOS 11 新增更新,並包含一些 iPhone X 的修正。
注意事項
注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.5.4
要明確新增它
cordova platform add ios@4.5.4
建立 Cordova Globalization 外掛程式的目的是為了在大多數行動平台無法區分這些設定時,取得資訊並根據使用者的地區設定、語言和時區執行作業。隨著瀏覽器中新的 API 推出,我們現在可以使用 ECMA 國際化 API,在 iOS、Android、Windows 裝置和桌上型電腦瀏覽器上達成此目標。因此,不再需要此 cordova 外掛程式,且將很快停止使用。
cordova globalization 外掛程式定義一個全域 navigator.globalization 物件,該物件提供各種方法來存取使用者的地區設定、語言和時區。若要從瀏覽器取得偏好的語言,可以使用 navigator.globalization.getPreferredLanguage 方法,如下所示
navigator.globalization.getPreferredLanguage(function (language) {
console.log('language: ' + language.value + '\n');
}, function () {
console.log('Error getting language\n');
});
可以使用下列方式找出目前的地區設定
navigator.globalization.getLocaleName(function (locale) {
console.log('locale: ' + locale.value + '\n');
}, function () {
console.log('Error getting locale\n');
});
ECMA 國際化 API 提供 Intl
物件,該物件提供語言敏感字串比較、數字格式設定以及日期和時間格式設定。首先,我們應該檢查瀏覽器是否支援該 API
if (window.Intl && typeof window.Intl === 'object') {
console.log('API available');
}
可以使用 navigator
物件從瀏覽器中找出偏好的語言標籤
console.log(navigator.language);
可以使用 Intl.getCanonicalLocales(locales)
方法找出地區設定名稱。locales
是具有語言標籤的字串值或字串值陣列。然後可以取得地區設定名稱,如下所示
Intl.getCanonicalLocales('EN-US'); // ["en-US"]
Intl.getCanonicalLocales(['EN-US', 'Fr']); // ["en-US", "fr"]
從 cordova globalization 外掛程式遷移的另一個實例可以在此範例中看到:navigator.globalization.dateToString 方法。此方法在 cordova 外掛程式中使用,如下所示
navigator.globalization.dateToString(
new Date(),
function (date) {
alert('date: ' + date.value + '\n');
},
function () {
alert('Error getting dateString\n');
},
{ formatLength: 'short', selector: 'date' }
);
使用下列程式碼,可以使用國際化 API 獲得類似的結果
var date = new Date();
console.log(new Intl.DateTimeFormat().format(date));
這裡 是尋找關於 ECMA 國際化 API 中各種方法的更多資訊的優良資源。
我們衷心接受並感謝您的回饋!
今天更新了以下外掛程式
在我們上次的外掛程式版本發佈中,我們棄用了 cordova-plugin-compat
,因為它已整合到 cordova-android@6.3.0
中。因此,對於此發佈週期,我們已從依賴它的外掛程式中移除相依性,並讓外掛程式的主要版本號碼躍進。以下外掛程式已捨棄 cordova-plugin-compat
:cordova-plugin-camera
、cordova-plugin-contacts
、cordova-plugin-file
、cordova-plugin-geolocation
、cordova-plugin-media
和 cordova-plugin-media-capture
。
我們也變更了以下外掛程式中使用描述的運作方式:cordova-plugin-camera
、cordova-plugin-contacts
、cordova-plugin-media
、cordova-plugin-geolocation
和 cordova-plugin-media-capture
。存取特定 api 的 iOS 應用程式需要使用描述。Apple 想要了解為什麼您的應用程式需要某些權限。我們現在建議您透過 edit-config
標籤將使用描述新增至您的應用程式。檢視外掛程式文件的 iOS Quirks
區段,以查看如何使用的範例。這裡是 cordova-plugin-camera
的範例。
cordova-plugin-statusbar
已更新,可在新的 iPhone X
上運作。
最後,cordova-plugin-file-transfer
已正式棄用。我們建議改為使用內建的 XHR
api。請在 https://cordova.dev.org.tw/blog/2017/10/18/from-filetransfer-to-xhr2.html 上閱讀關於停止使用 cordova-plugin-file-transfer
的資訊。
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera@latest --save
變更包括
我們想要宣布 Cordova Android 6.4.0
已經發佈!
此版本現在使用 Android Studio 3.0 隨附發佈的最新 Android Gradle 外掛程式。
由於 Google 最近對 Android Studio 所做的變更,Cordova Android 現在要求將 Gradle 安裝為所有平台上 Android 開發的獨立相依性。您可以透過遵循 gradle.org 上的這些指示來執行此操作。
我們將在不久的將來移除使用 Android Studio 作為相依性提供 Gradle 的程式碼。
Google 也更改了使用的 Gradle DSL,導致目前在此版本的 Cordova 中 Crosswalk WebView 的支援出現問題。很遺憾,由於 Crosswalk 已不再受 Crosswalk Project 支援,我們不確定 這個問題 是否會被修復。
如果您需要 Crosswalk 的支援,我們建議您目前繼續使用 cordova-android 6.3.0,並避免使用或升級您的 Android Studio 專案。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@6.4.0
要明確新增它
cordova platform add android@6.4.0
我們很高興宣布 Cordova iOS 4.5.3
的次要版本已發布!
此版本繼續為最新的 iOS 11 和 Xcode 9 添加更新。
注意事項
注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.5.3
要明確新增它
cordova platform add ios@4.5.3
我們剛發布了對 cordova-fetch
的一些變更!
版本重點
我們剛發布了對 cordova-browser
的更新
版本重點
升級方式
cd my_project
cordova platform update browser@5.0.1
要明確新增它
cordova platform add browser@5.0.1
請在 issues.cordova.io 回報您發現的任何問題!
在 Cordova 存在的早期,建立了 file-transfer 外掛程式 來解決下載二進制檔案的問題。當時,沒有很好的選項可以使用符合標準的 Web API 來解決此問題。Web 採用了一條曲折的道路才找到解決方案(請參閱 Firefox 的 sendAsBinary
和現在已廢棄的 FileSystem API 的 BlobBuilder 等),但今天您可以結合我們的好朋友 XMLHttpRequest 的最新功能,以及一些較新的 JavaScript 類型和物件,來解決這個問題。對於 Cordova 來說,這是一個令人興奮的時刻,因為這個專案的夢想始終是最終減少該專案維護的 API 範圍,而是看到常規的 Web API 能夠處理這些用例。
因此,Cordova 正在逐步淘汰 file-transfer 外掛程式。「逐步淘汰」是什麼意思?總結如下:
Apache Cordova 的我們都不想讓你們失望,所以我們認為最好向你們展示如何使用這些較新的 XHR 功能來實現 file-transfer 讓您執行的操作,而且以一種可以在任何現代 Web 瀏覽器中啟動的方式!
根據您與底層裝置檔案系統的互動程度以及在哪些平台上,您可能仍然需要依賴 Cordova File 外掛程式。如果您的應用程式的 JavaScript 中仍然有對 requestFileSystem
或 root.fs
的參考,您肯定需要 File 外掛程式,因為這些是不符合標準的 API。請注意並小心!
JavaScript 中的二進制類型以及擴展的 XHR 功能在以下 Cordova 支援的平台上可用,無需任何其他外掛程式
一如既往,請查看 caniuse.com 以取得所需位元的詳細支援,例如 Blob
、Typed Arrays 和 擴展的 XHR 功能。
標準很好,但您實際上必須複製貼上什麼來取代先前的 FileTransfer 範例?我們為您準備好了
這是 FileTransfer 的「下載二進制檔案」範例的替代方案
window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, function (fs) {
console.log('file system open: ' + fs.name);
fs.root.getFile('bot.png', { create: true, exclusive: false }, function (fileEntry) {
console.log('fileEntry is file? ' + fileEntry.isFile.toString());
var oReq = new XMLHttpRequest();
// Make sure you add the domain name to the Content-Security-Policy <meta> element.
oReq.open("GET", "https://cordova.dev.org.tw/static/img/cordova_bot.png", true);
// Define how you want the XHR data to come back
oReq.responseType = "blob";
oReq.onload = function (oEvent) {
var blob = oReq.response; // Note: not oReq.responseText
if (blob) {
// Create a URL based on the blob, and set an <img> tag's src to it.
var url = window.URL.createObjectURL(blob);
document.getElementById('bot-img').src = url;
// Or read the data with a FileReader
var reader = new FileReader();
reader.addEventListener("loadend", function() {
// reader.result contains the contents of blob as text
});
reader.readAsText(blob);
} else console.error('we didnt get an XHR response!');
};
oReq.send(null);
}, function (err) { console.error('error getting file! ' + err); });
}, function (err) { console.error('error getting persistent fs! ' + err); });
這是 FileTransfer 的「上傳檔案」範例的類似替代方案
window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, function (fs) {
console.log('file system open: ' + fs.name);
fs.root.getFile('bot.png', { create: true, exclusive: false }, function (fileEntry) {
fileEntry.file(function (file) {
var reader = new FileReader();
reader.onloadend = function() {
// Create a blob based on the FileReader "result", which we asked to be retrieved as an ArrayBuffer
var blob = new Blob([new Uint8Array(this.result)], { type: "image/png" });
var oReq = new XMLHttpRequest();
oReq.open("POST", "http://mysweeturl.com/upload_handler", true);
oReq.onload = function (oEvent) {
// all done!
};
// Pass the blob in to XHR's send method
oReq.send(blob);
};
// Read the file as an ArrayBuffer
reader.readAsArrayBuffer(file);
}, function (err) { console.error('error getting fileentry file!' + err); });
}, function (err) { console.error('error getting file! ' + err); });
}, function (err) { console.error('error getting persistent fs! ' + err); });
請注意,上述兩個範例都依賴 File 外掛程式,因此如果您從您的應用程式中移除 FileTransfer 外掛程式,請務必新增 File 外掛程式!
如果您想了解一些實現二進制資料傳輸的細節,您需要掌握兩個(可能三個)概念。MDN 有一篇關於此主題的絕對精彩的文章,值得快速閱讀,但我也會在這裡提供摘要。
長期以來,沒有辦法在 JavaScript 中直接表示二進制資料並存取記憶體中的底層位元組。我們可以將此資料編碼為不同的格式(base64,有人要嗎?),這很酷,但讓我直接玩弄這些位元組就好。就我們的目的而言,我們對兩個特定物件感興趣:ArrayBuffer 和 Blob。為什麼我們關心這兩個?因為我們可以讓 XHR 以這些類型傳回下載的資料,或將這些類型直接傳遞給 XHR 的 send
方法。
有兩個較新的 XHR 功能,最初是作為其開發期間稱為「XHR2」的一部分,我們需要利用它來將所有這些組合在一起。
對於下載二進制資料,我們需要將 responseType
屬性設定為 arraybuffer
或 blob
- 這會告訴 XHR 我們希望取回的資料類型。設定 responseType
後,我們可以存取唯讀的 response
屬性,以取得代表 XHR 擷取資料的 ArrayBuffer
或 Blob
物件。
對於上傳二進制資料,則較為簡單:直接將 Blob
或 ArrayBuffer
傳遞給 XHR 的 send
方法。就是這樣。
二進制類型和擴展的 XHR 功能在現代桌面瀏覽器和最近的行動瀏覽器(和 WebView)中都得到很好的支援。對於現有的 Cordova 使用者,只要您的應用程式以平台和作業系統版本的組合為目標,如上述平台支援下所列,您應該就可以順利執行!請記住,如果您依賴某些 File 外掛程式 API(如 requestFileSystem
、root
或 getFile
),您需要確保 File 外掛程式已新增到您的應用程式中。
祝您編碼符合標準愉快!
我們很高興宣布 Cordova iOS 4.5.2
的次要版本已發布!
此版本繼續為最新的 iOS 11 和 Xcode 9 添加更新。
注意事項
注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.5.2
要明確新增它
cordova platform add ios@4.5.2
我們剛發布了我們工具的一個小更新!
--production
旗標。這表示當執行命令 cordova platform add android
或 cordova plugin add cordova-plugin-device
時,在底層我們會執行 npm install cordova-android --production
。--production
旗標只會從 package.json
安裝 dependencies
,並跳過 devDependencies
。這應該會加快安裝速度(尤其是在安裝平台和外掛程式的本機副本時)。您可以透過傳遞 --noprod
旗標或透過 cordova config set production false
在全域範圍內關閉此旗標。--save-exact
旗標。這將允許儲存平台或外掛程式的確切版本,而不是範圍。cordova platform add android@6.3.0 --save-exact
。您也可以透過 cordova config set save-exact true
在全域組態中預設設定為 truecordova-node-xcode
在 apache cordova 旗下發布的第一個版本。它最初是建立並用作 cordova-lib
的相依性,但現在也正被許多其他專案使用。我們已決定為該專案發布 1.0.0
的主要版本。這是為了表示該專案在 semver
方面的穩定性。從先前的版本以來沒有發生任何重大變更。npm@5+
時還原外掛程式和平台的問題。--link
選項安裝外掛程式的問題。cordova platform save
的棄用警告cordova-lib
API 呼叫中的 .raw
。如果您將 cordova-lib
作為 node 模組使用,請更新您的 API 呼叫!您可以在 https://github.com/apache/cordova-cli/commit/0a42092971dc8fe2f483bd42c3b9de26fdec677c 中看到變更範例。若要更新您的 cordova CLI
npm install -g cordova@latest
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布 Cordova Android 6.3.0
已發布!
此版本現在以最新的 Android API 等級 API 26 為目標,並且已修復與 Android SDK Tools 26.0.2 版本相關的問題。Google 變更了 Android 模擬器的執行方式,導致部署到模擬器時發生錯誤。
此版本包含 cordova-plugin-compat
的整合,因此請在更新到此版本的 cordova-android
後,從專案中移除該外掛程式。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@6.3.0
要明確新增它
cordova platform add android@6.3.0
我們很高興宣佈 Cordova iOS 4.5.1
的小版本已發佈!
此版本為最新的 iOS 11 和 Xcode 9 提供更新。您現在可以為這個新版本建立組建,並正確部署到模擬器或裝置。
注意事項
Apple 也做了一些可能會影響您目前應用程式的變更,特別是在視口 (viewport) 方面。以下是一些可能對您轉換到 iOS 11 有幫助的資源
我們也注意到與狀態列外掛程式相關的特定問題。團隊正在努力解決這些問題,以在下一個外掛程式版本中推出。
注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.5.1
要明確新增它
cordova platform add ios@4.5.1
由於以下外掛程式已被棄用,因此今天已更新
cordova-plugin-console
已整合到 cordova-ios@4.5.0+
中。不再需要它。如果您計劃更新您的 cordova-ios
,請務必從您的專案中移除它!
同樣地,cordova-plugin-compat
已整合到即將推出的 cordova-android@6.3.0
版本中。當您更新到最新版本的 cordova-android
時,請從您的專案中移除它。
cordova-plugin-device-motion
和 cordova-plugin-device-orientation
已正式棄用。這些外掛程式將被內建的 W3C 裝置運動和方向 API 取代,這些 API 現在在 iOS、Android 和 Windows 上都支援。請查看 PhoneGap 團隊為 裝置運動 和 裝置方向 撰寫的遷移指南。
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera@latest --save
變更包括
我們很高興宣佈 Cordova iOS 4.5.0
的小版本已發佈!
新增了三個新功能
handleOpenURLWithApplicationSourceAndAnnotation:
(新的選擇器,會傳送帶有額外中繼資料的 URL)重要! 如果您的專案中包含 cordova-plugin-console
,您必須移除它,否則您的專案將無法建置。
如果您曾經需要停用內建的 console 外掛程式,請註釋掉或移除平台特定 config.xml
中的 Console
<feature>
標籤,和/或在 deviceready
事件之後立即呼叫此程式碼
cordova.require('cordova/plugin/ios/logger').useLogger(false);
其他值得注意的問題
ios-deploy
相依性至 v1.9.2,其中包含針對 Xcode 9 的修復ios-sim
更新至 v6.0.0,並支援較新的 iPad (這也修復了一些相關錯誤)<access>
標籤屬性 allows-arbitrary-loads-for-media
(反映正確的應用程式傳輸安全性值)。舊的屬性 allows-arbitrary-loads-in-media
已棄用。注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.5.0
要明確新增它
cordova platform add ios@4.5.0
我們剛剛發佈了一些對 cordova-common
的變更!
版本重點
config.xml
中 <config-file>
的支援。getAccesses
的 allows-arbitrary-loads-for-media
屬性剖析。framework
標籤的變數。JSON
使用 2 個空格進行縮排。請注意,此版本將開始滾動到即將推出的平台和 cordova-cli
版本中。
我們剛剛發佈了 cordova-browser
和 cordova-serve
的更新
版本重點
manifest.json
新增至瀏覽器專案。這啟用基本漸進式網頁應用程式支援PlatformApi
。升級方式
cd my_project
cordova platform update browser@5.0.0
要明確新增它
cordova platform add browser@5.0.0
請在 issues.cordova.io 回報您發現的任何問題!
我們剛發布了我們工具的一個小更新!
在此版本中,使用我們的預設範本建立新的 cordova 應用程式時,預設會包含 package.json
檔案。
若要更新您的 cordova CLI
npm install -g cordova@latest
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣佈 Apache Cordova 7.0.0
已發佈!
最值得注意的變更包括
package.json
,則在呼叫 cordova prepare
時會自動為您建立。config.xml
和 package.json
。平台和外掛程式版本的詳細資料也會自動儲存到 config.xml
和 package.json
。不再需要 --save
旗標來儲存。使用 --nosave
來防止儲存到 config.xml
或 package.json
。npm
來將模組 npm install
安裝到您的專案中。不再需要 --fetch
旗標。使用 --nofetch
旗標來還原為 pre-Cordova@7.0
行為 (不使用 npm install
來提取模組)。cordova prepare
後,package.json
和 config.xml
應包含相同的平台和版本。如果發生衝突,package.json
的優先順序高於 config.xml
。例如,假設 package.json
包含 cordova-android@6.0.0
,而 config.xml
包含 cordova-android@4.0.0
。執行 cordova prepare
後,config.xml
和 package.json
都只會包含 cordova-android@6.0.0
。package.json
檔案。我們已新增對自訂平台的支援。這將允許未來使用自訂平台,以及現有平台的修改版本。範例
cordova platform add custom-platform-name
cordova config
命令來 set
、get
、delete
、edit
和 list
全域 Cordova 選項。例如,您可以使用以下命令 cordova config set <key> <value>
來將 autosave
或 fetch
的值設定為 true
或 false
。autosave
作為預設設定。在 cordova 中,autosave
預設為 true。範例:```cordova config set autosave false
```
In the following case, you are turning off `fetch` as the default setting. `fetch` is `true` by default in cordova. Example:
```
cordova config set fetch false
```
In addition, the `cordova config` command supports the `browserify` setting, which allows the JavaScript of plugins to be loaded at build time compared to run time. For instance, if the `browserify` value is not explicitly passed in by the user, the `cordova config` command will automatically set the `browserify` value saved in `~/.config/configstore/` to be saved `globally`. Users can get and set `browserify`. `browserify` is `false` by deafult in cordova. Example:
```
cordova config get browserify
cordova config set browserify true
```
cordova-windows
:已捨棄對 4.0.0 之前任何版本的支援。cordova-android
:已捨棄對 5.0.0 之前任何版本的支援。cordova-ios
:已捨棄對 4.0.0 之前任何版本的支援。cordova-osx
:已捨棄對 4.0.0 之前任何版本的支援。升級方式
npm install -g cordova@latest
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣佈 Cordova Android 6.2.3
已發佈!此修補程式版本實際上新增了對 Android SDK Tools v26 和更新版本的支援。很遺憾,我們忘記將這些變更納入 6.2.2 版本中。
如果您使用的是最新的 Android SDK Tools,我們強烈建議您升級到此版本。舊版本的 cordova-android
無法與最新的 Android SDK Tools 搭配使用!
升級方式
npm install -g cordova
cd my_project
cordova platform update android@6.2.3
要明確新增它
cordova platform add android@6.2.3
在此版本被固定為預設的 Android 平台之前,必須明確新增此版本,直到即將推出的 cordova@7
版本為止。
今天更新了以下外掛程式
版本重點
tests/
資料夾中新增 package.json,為 Cordova@7 版本做準備。data:
URI 作為聯絡人的照片欄位。loadstop
事件的 url
現在是字串而不是物件,使其與其他平台一致。.wav
檔案錄製並新增 .m4a
錄製支援。overlaysWebView
。您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera@latest --save
變更包括
我們很高興宣佈 Cordova Android 6.2.2
已發佈!此修補程式版本新增了對 android sdk tools 26.0.1
的支援。如果您使用的是最新的 Android sdk tools,我們強烈建議您升級到此版本。舊版本的 Cordova-Android 無法與最新的 Android sdk tools 搭配使用!
升級方式
npm install -g cordova
cd my_project
cordova platform update android@6.2.2
要明確新增它
cordova platform add android@6.2.2
在此版本被固定為預設的 Android 平台之前,必須明確新增此版本,直到即將推出的 cordova@7
版本為止。
我們很高興宣佈 Cordova iOS 4.4.0
的小版本已發佈!
新增了三個新功能
其他值得注意的問題
注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.4.0
要明確新增它
cordova platform add ios@4.4.0
我們很高興宣布 Cordova Android 6.2.1
已發佈!
此版本已修正由 Android SDK Tools 25.3.1 版本引入的問題。Google 放棄了對 android
二進位檔的支援,因此 cordova-android
現在已採用對 avdmanager
和 sdkmanager
二進位檔的支援。我們也藉此機會重寫了如何在使用者系統上使用 Gradle 的方式。cordova-android
現在需要使用者系統上安裝 Android Studio 或 Gradle。
此版本還新增了對 config.xml
中 <resource-file>
元素的支援,該元素會在 cordova prepare
期間複製指定的檔案。這允許提供任意檔案,例如特殊通知尺寸的圖示或 API 設定 JSON 檔案。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@6.2.1
要明確新增它
cordova platform add android@6.2.1
在此版本被固定為預設的 Android 平台之前,必須明確新增此版本,直到即將推出的 cordova@7
版本為止。
最初發表於此 PhoneGap 部落格
最近發佈了 cordova 螢幕方向外掛程式的新版本 (2.0.0)。此外掛程式的目的是以所有主要平台通用的方式設定/鎖定螢幕方向。此新版本符合 W3C 螢幕方向 API 中提到的規範,目前為公開草案。
此外掛程式包含以下主要更新
可以使用以下程式碼將螢幕方向鎖定為特定方向,例如橫向:
screen.orientation.lock('landscape').then(function success() {
console.log("Successfully locked the orientation");
}, function error(errMsg) {
console.log("Error locking the orientation :: " + errMsg);
});
上述程式碼會根據旋轉將螢幕方向裝置設定為任何橫向模式 (橫向主要或橫向次要)。screen.orientation.lock(OrientationLockType); 方法會傳回 Promise。成功設定方向後,它會解析 Promise。如果螢幕未成功鎖定,則 Promise 會拒絕並出現 'NotSupportedError'。可以使用以下程式碼解除鎖定螢幕方向
screen.orientation.unlock();
上述程式碼會使螢幕適應裝置的預設方向。unlock 方法不會傳回 Promise。
可以使用以下程式碼存取目前的螢幕方向:
console.log('Orientation is' + screen.orientation.type);
'onchange' 事件處理常式的使用範例
screen.orientation.onchange = function(){
console.log(screen.orientation.type);
};
也可以將 'change' 事件新增至 screen.orientation 物件
screen.orientation.addEventListener('change', function(){
console.log(screen.orientation.type);
});
示範應用程式包含在 github 存放庫中。將此外掛程式新增至其中後,示範應用程式允許使用者使用 screen.orientation.lock() 方法測試方向類型。示範應用程式的詳細說明請參閱此處。
今天更新了以下外掛程式
版本重點
getOrientation
方法變更為傳回定義的列舉 EXIF
,而不是以度為單位的方向input[type=file]
檔案選擇器的支援acc
檔案。主要版本升級至 3.0.0
。媒體外掛程式現在需要 cordova-android >= 6.1.0
WKProcessPool
以進行 Cookie 共用您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera@latest --save
變更包括
我們很高興宣布 Cordova Windows 5.0.0
已發佈!
此版本引入了 資源檔案行為的重大變更 (請參閱 文件,了解如何將先前行為還原給參照檔案) 並新增了 外掛程式的 WinMD + C++ 型 DLL 組合支援。
另一個重點是 與 Android 上的 --gradleArg
和 iOS 上的 --buildFlag
類似的新 buildFlag
功能,允許將自訂旗標傳遞至 MSBuild。
此版本也修正了 SplashScreen 和 VS 專案產生的一些問題。
請參閱下面的發行說明,了解更多詳細資訊和其餘的變更。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@5.0.0
要明確新增它
cordova platform add windows@5.0.0
在我的實習期間,身為一名新開發人員,我經歷了許多令人興奮、難忘的亮點 - 在 Jira 上關閉我的第一個錯誤、首次以 PhoneGap 實習生的身分提交至 GitHub,以及發送我的第一個提取請求進行審閱。所有這些時刻都讓我記憶猶新,因為它們對我來說是全新的,而且讓我能夠以真實、相關的方式為 Cordova 社群做出貢獻。(並非所有實習生都有機會做這麼棒的工作!)然而,我最難忘的時刻發生在實習幾個月後,當時我收到一封電子郵件,邀請我成為正式的 Apache Cordova 提交者!對我來說,這絕對是一個重大亮點,也是我實習期間最棒的日子之一!
那麼,我實際上做了什麼才能成為「正式的提交者」?我先要說我必須做很多我不熟悉且具有挑戰性的事情!我發現我真正需要關注的兩個主要類別是 - (1) 技術工作和 (2) 學習如何成為 Cordova 社群的活躍成員。
在實習初期,我開始研究 Jira 上最簡單的問題,並要求處理一些經驗有限的情況下可以處理的小問題 (修正錯字甚至是測試編號等)。即使我沒有做出任何重大貢獻,我仍然經歷了尋找問題所在、學習開發工作流程,以及不再被許多 Cordova 存放庫壓垮的過程。在過程中,我問了問題、問了更多問題,然後…沒錯…問了更多問題!我想要確保我清楚了解我正在做什麼以及我為什麼要做。有時「為什麼」的部分即使在解釋了好幾次之後還是讓我摸不著頭腦,但我仍然不斷重新提問,直到事情開始變得有道理。(感謝團隊和導師如此有耐心,並且忍受我偶爾的茫然眼神!)
我逐漸被賦予在 Cordova 中處理更複雜的任務。除錯、協助建立新功能和測試確實是我花費大部分時間的地方。我必須學習閱讀和理解他人的程式碼、觀看我的導師除錯並嘗試一些策略、編寫測試和使用案例、測試和重新測試,以及接收回饋 (有時來自多人)!回顧過去,我發現最令人驚訝和重要的事情之一是,實際上有多少努力是花在合併提取請求上的 - 這是我之前絕對不知道的事情。我必須要有耐心並學習到,不只是在本地所有東西都通過並帶有漂亮的小綠點,CI 測試也必須通過,而且社群也需要時間進行最後的審查。然而,最後,當你的 PR 終於合併時,這真的、真的太棒了!
當然,努力成為提交者的另一個重要部分是要熟悉 Cordova 社群!身為一個外人,接觸社群是而且仍然很困難,尤其是在你是新手時。已經建立了關係、Slack 頻道和期望,因此我並不總是確定該如何互動和建立存在感。真正幫助我變得更加健談的兩件事是學習在 Jira 上進行分類和收到來自各個成員對我工作的回饋。這些經驗幫助我以一對一的方式與成員交談、更了解他/她面臨的問題,並慢慢開始建立新的關係。學習成為社群中更重要的一部分是我仍在努力的事情 - 然而,從積極的方面來說,我總是發現當我與 Cordova 社群中的任何人交談時,他/她總是歡迎、在這裡提供支援,或者也只是願意進行友好的聊天。
我正在繼續努力的幾件事
雖然獲得提交者資格是我為自己設定的目標,但我認為重要的是要記住,隨之而來的是責任。對我來說,提交者資格意味著表明您想要繼續參與開放原始碼開發和 Cordova 社群。我很高興和自豪能夠做到這一點,並且我真的期待接下來要做的事情!
在 cordova-android
中發現了一個安全性問題。我們正在發佈 cordova-android@6.1.2
以解決此安全性問題。我們建議所有使用 cordova-android
建置的 Android 應用程式都升級為使用 6.1.2
版。其他 Cordova 平台 (例如 iOS) 不受影響,並且沒有更新。
當使用 Cordova CLI 時,請使用以下命令更新
cordova platform update android@6.1.2
安全性問題是 CVE-2017-3160
為了您的方便,此處包含此 CVE 的文字。
我們的工具的新更新現已推出!
若要更新您的 cordova CLI
npm install -g cordova@latest
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興宣布 Cordova Android 6.1.1
已發佈!
請在您的專案中執行以下命令,將您目前安裝的插件儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform update android@6.1.1
要明確新增它
cordova platform add android@6.1.1
今天更新了以下外掛程式
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,更新您的 inappbrowser 插件
cordova plugin rm cordova-plugin-inappbrowser --save
cordova plugin add cordova-plugin-inappbrowser@latest --save
變更包括
今天更新了以下外掛程式
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,更新您的 camera 插件
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera@latest --save
變更包括
我們很高興地宣布 Cordova iOS 4.3.1
的修補程式版本已發布!
注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.3.1
要明確新增它
cordova platform add ios@4.3.1
我們很高興地宣布 Cordova Android 6.1.0
已發布!
請在您的專案中執行以下命令,將您目前安裝的插件儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform update android@6.1.0
要明確新增它
cordova platform add android@6.1.0
我們的工具的新更新現已推出!
版本重點
6.0.0
,並將 iOS 更新至 4.3.0
。請閱讀 Android@6.0.0 發布網誌 和 iOS@4.3.0 發布網誌。edit-config
對 config.xml
的支援。edit-config
現在在 plugin.xml
和 config.xml
中的運作方式相同。請在 https://cordova.dev.org.tw/docs/en/6.x/plugin_ref/spec.html#edit-config 閱讀相關資訊EventListener interface
的 Channel.prototype.subscribe
支援cordova-lib
中拆分出 cordova-create
。已將 cordova-create
發佈到 npm
。若要更新您的 cordova CLI
npm install -g cordova@latest
請在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布 Cordova iOS 4.3.0
的次要版本已發布!
此版本包含
<framework>
標籤中的 CocoaPods
支援(僅限靜態程式庫)--buildFlag
選項可傳送額外的 xcodebuild
旗標注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.3.0
要明確新增它
cordova platform add ios@4.3.0
我們很高興地宣布 Cordova Windows 4.4.3
已發布!
此版本修正了應用程式啟動、啟動畫面和 VS 專案產生的一些主要問題。
請參閱下面的發行說明,了解更多詳細資訊和其餘的變更。
從 6.3.0 版本開始,Cordova CLI 將在建立新專案時自動開始使用此版本的 cordova-windows。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.4.3
要明確新增它
cordova platform add windows@4.4.3
我們很高興地宣布 Cordova Android 6.0.0
的主要版本已發布!
請在您的專案中執行以下命令,將您目前安裝的插件儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform update android@6.0.0
要明確新增它
cordova platform add android@6.0.0
以下項目最近已發布
Google 最近向所有使用 cordova-plugin-geolocation
的人發出警告,要求他們將 android.hardware.location.gps
新增到其 AndroidManifest.xml
中。我們已更新 cordova-plugin-geolocation
插件,以便在安裝插件時自動將此設定新增到您專案的 AndroidManifest.xml
中。這表示地理位置插件僅在具有 GPS
的 android 裝置上運作。如果此限制對您造成負面影響,請告訴我們。
版本重點
cordova-app-hello-world
:已更新預設 CSP
以包含 img-src
,並將 content:
新增至其中,以解決 CB-4078您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,更新您的 geolocation 插件
cordova plugin rm cordova-plugin-geolocation --save
cordova plugin add cordova-plugin-geolocation@latest --save
變更包括
目前,所有平台和插件都必須安裝至少 node 0.10
。node 0.10
已脫離 LTS 一段時間,且其維護期(安全性錯誤修正)於 2016 年 10 月 31 日終止。node 0.12
將於 2017 年 1 月 1 日停止維護。
將有兩個不同的棄用期間,一個用於 node 0.x
,另一個用於 node 4.x
。
node 6.x
將於 2016 年 10 月 18 日進入主動式 LTS(因此是 nodejs.org 上預設和建議下載的版本),並且將是我們建議使用者在這兩個棄用期間升級的版本。
node 6.x
為我們帶來什麼?99% 的 ES2015 (ES6) 支援和 100% 的 ES2016 (ES7) 支援。
插件中的 JavaScript 檔案本身不受影響,因為它們的 JavaScript 支援取決於平台瀏覽器支援。例如,iOS 10 中支援 ES6,而在較舊的 iOS 平台上僅支援 ES5。
今天更新了以下外掛程式
版本重點
camera
、contacts
和 media-capture
以與 iOS 10 搭配使用camera
:CB-4078 修正 Android 4.4+ 裝置上的 方向/縮放
問題。新增對 content:
的支援。splashscreen
:CB-8056 為 Windows 平台實作啟動畫面Android Log class
而不是 Cordova LOG class
的問題您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera@latest --save
變更包括
我們很高興地宣布已發布 Cordova Android 5.2.2
和 Cordova iOS 4.2.1
的修補程式版本!我們也更新並發布了 Cordova Common 1.4.1
。
這些版本修正了 plugin.xml
中新 edit-config
功能的問題。請在 https://cordova.dev.org.tw/docs/en/latest/plugin_ref/spec.html#edit-config 閱讀有關 edit-config
的更多資訊。
注意:更新 iOS 時,請務必儲存您的外掛程式,否則可能不會重新安裝目前未儲存的外掛程式。在您的專案中執行下列命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform update android@5.2.2
cordova platform rm ios
cordova platform add ios@4.2.1
要明確新增它
cordova platform add android@5.2.2
cordova platform add ios@4.2.1
cordova
和 cordova-lib
的新更新現已推出!
在此版本中,我們修正了一些錯誤,包括導致 cordova run
和 cordova emulate
命令忽略 --nobuild
選項的回歸問題。
若要更新您的 cordova CLI
npm install -g cordova@latest
請務必在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布 Cordova Windows 4.4.2
已發布!
此版本修正了我們在 4.4.1 中遺漏的一些問題。特別是,我們修正了 Visual Studio「15」預覽版中新安裝體驗所發生的建置問題。如需其餘變更,請參閱以下版本資訊。
Cordova CLI 6.3.0 將在建立新專案時自動開始使用此版本的 cordova-windows。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.4.2
要明確新增它
cordova platform add windows@4.4.2
cordova
、cordova-lib
、cordova-common
和 cordova-fetch
的新更新現已上線!
版本重點
從這個版本開始,應用程式和插件開發人員將能夠使用 edit-config
指令從 config.xml
和 plugin.xml
檔案編輯 XML 設定檔。此功能的文件仍在開發中,但您目前可以參考此 提取請求
此外,cordova-fetch
功能現在可用於 create
命令,您可以在從範本建立新應用程式時使用它。
cordova create Foo --template TEMPLATE_NAME --fetch
若要更新您的 cordova CLI
npm install -g cordova@latest
請務必在 issues.cordova.io 回報您發現的任何問題!
我們很高興地宣布 Cordova Windows 4.4.1
已發布!
在此版本中,我們修正了許多與應用程式恢復、啟動畫面功能等相關的問題。此外,我們還新增了指定 msbuild
可執行檔位置以建置專案的功能。
下一個版本的 Cordova CLI 在建立新專案時,將會自動開始使用此版本的 Cordova-Windows。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.4.1
要明確新增它
cordova platform add windows@4.4.1
我們很高興宣佈 Cordova Android 5.2.1
已發佈!
此版本修正了一個小但惱人的錯誤,該錯誤導致無法在具有 API 23 映像檔的模擬器上部署應用程式。
此版本將會在下一個 Cordova 版本中預設使用。目前,若要安裝此版本的 Cordova-android,您需要明確指定版本。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@5.2.1
要明確新增它
cordova platform add android@5.2.1
我們很高興宣佈 Cordova Android 5.2.0
已發佈!
此版本包含許多錯誤修正。請閱讀以下完整變更日誌。
需要發佈新版本的 cordova-cli
,才能將此版本的 cordova-android 固定為建立新專案時的預設版本。如果您現在想要開始使用此版本,請確保在執行 cordova platform add/update
時指定版本。
注意: 更新時,請務必儲存您的外掛程式,否則目前未儲存的外掛程式可能不會重新安裝。請在您的專案中執行以下命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform update android@5.2.0
要明確新增它
cordova platform add android@5.2.0
我們很高興宣佈 Cordova iOS 4.2.0
已發佈!
除了修復一些錯誤之外,此版本還新增了對 cordova-ios
的 Node 6 支援!
需要發佈新版本的 cordova-cli
,才能將此版本的 cordova-ios 固定為建立新專案時的預設版本。如果您現在想要開始使用此版本,請確保在執行 cordova platform add/update
時指定版本。
注意: 更新時,請務必儲存您的外掛程式,否則目前未儲存的外掛程式可能不會重新安裝。請在您的專案中執行以下命令,將您目前安裝的外掛程式儲存到 config.xml
中
cordova plugin save
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.2.0
要明確新增它
cordova platform add ios@4.2.0
Cordova Ubuntu 4.3.4
已發佈。
這是一個修補程式版本,修正了與建置和偵錯以 Ubuntu 裝置為目標的 Cordova 應用程式相關的錯誤。請參閱下方的變更日誌以了解詳細資訊。
升級方式
npm install -g cordova
cd my_project
cordova platform update ubuntu@4.3.4
要明確新增它
cordova platform add ubuntu@4.3.4
我們很高興宣佈 Cordova Windows 4.4.0
已發佈!
此版本新增了一些重大改進,例如由於新的「增量準備」功能而提高了「prepare」效能、內嵌啟動畫面外掛程式支援等等。請參閱下方的完整變更清單。
下一個版本的 Cordova CLI 在建立新專案時,將會自動開始使用此版本的 Cordova-Windows。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.4.0
要明確新增它
cordova platform add windows@4.4.0
cordova
、cordova-lib
、plugman
和 cordova-common
的新更新現已上線!我們也發佈了第一個版本的 cordova-fetch
,此模組由 cordova-lib
用於透過 npm install
擷取外掛程式和平台。
版本重點
--fetch
選項cordova
,以收集資料以進行資料驅動開發。目標是使用資料來協助引導 cordova
的開發。cordova
將在第一次使用時發出提示,讓使用者選擇停用它。輸入 cordova telemetry -h
以取得更多資訊。node-xcode
相依性並更新測試。新的 cordova-fetch
功能在 --fetch
旗標之後。在新增和移除外掛程式和平台時使用它。
cordova plugin add/rm PLUGINID --fetch
cordova platform add/rm PLATFORM --fetch
這將會擷取外掛程式/平台並使用 npm install
將其安裝到您的應用程式。您應該會看到一個新的 node_modules
目錄。這是我們最終在您的 cordova 應用程式中支援 package.json
的第一步。
若要更新您的工具
如果您已安裝 cordova
npm install -g cordova@latest
如果您已安裝 plugman
npm install -g plugman@latest
請務必在 issues.cordova.io 回報您發現的任何問題!
CVE-2015-5207 - 繞過 Apache Cordova iOS 中的存取限制
嚴重性:高
廠商:The Apache Software Foundation
受影響的版本:cordova-ios 3.9.2 及更早版本
描述:Apache Cordova iOS 包含 2 種方法,可以繞過白名單提供的 URL 存取限制。攻擊者可以使用這 2 種方法中的任何一種,在僅使用白名單來載入受信任資源的應用程式中載入惡意資源。
升級路徑:關注此問題的開發人員應安裝 4.0.0 或更高版本的 cordova-ios 平台。
致謝:此問題是由 Recruit Technologies Co.,Ltd. 的 Muneaki Nishimura (nishimunea) 發現的。__
CVE-2015-5208 - Apache Cordova iOS 中任意外掛程式執行問題
嚴重性:高
廠商:The Apache Software Foundation
受影響的版本:cordova-ios 3.9.2 及更早版本
描述:當使用者點擊連結時,可以執行任意外掛程式。
升級路徑:關注此問題的開發人員應安裝 4.0.0 或更高版本的 cordova-ios 平台。
致謝:此問題是由 Recruit Technologies Co.,Ltd. 的 Muneaki Nishimura (nishimunea) 發現的。
今天更新了以下外掛程式
此版本包含一個名為 cordova-plugin-compat 的新外掛程式。cordova-plugin-compat
允許外掛程式回溯相容性,這些外掛程式必須升級為適用於 cordova-android@5+
的新權限模型。外掛程式作者可以使用並依賴 cordova-plugin-compat
來繼續支援較舊版本的 (<5
) cordova-android
。請查看 cordova-plugin-compat 存放庫 以取得更多資訊。先前,我們在需要權限更新的外掛程式中封裝了 PermissionHelper.java
的複本,但現在已決定將 PermissionHelper.java
儲存在 cordova-plugin-compat
中會更好。
外掛程式作者也可以使用新的 engines 元素來指定您的外掛程式支援哪些版本的 cordova-android
。請在我們的 外掛程式擷取部落格文章中閱讀更多相關資訊。
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera@latest --save
變更包括
我們很高興宣佈 Cordova Windows 4.3.2
已發佈!
此版本修正了許多錯誤,包括某些 config-file
變更未套用至 appxmanifest 檔案的問題,以及使用 target
屬性 (請參閱 圖示指南 以了解 target
屬性的用法) 指定的圖示遭省略的錯誤。請參閱下方的完整變更清單。
Cordova CLI 6.1.1 在建立新專案時,將會自動開始使用此版本的 Cordova-Windows。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.3.2
要明確新增它
cordova platform add windows@4.3.2
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
cordova-cli
和 cordova
的新修補程式更新現已上線!
我們必須修正最近發佈的 6.1.0 版本中發現的一些問題。
若要更新您的工具
如果您已安裝 cordova
npm install -g cordova@latest
如果您已安裝 plugman
npm install -g plugman@latest
我們很高興宣佈 Cordova iOS 4.1.1
已發佈!
此版本解決了問題 CB-10773,這是在 Windows 電腦上建立 iOS 專案,然後在 OSX 上建置的問題。
需要發佈新版本的 cordova-cli
,才能將此版本的 cordova-ios 固定為建立新專案時的預設版本。如果您現在想要開始使用此版本,請確保在執行 cordova platform add/update
時指定版本。
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.1.1
要明確新增它
cordova platform add ios@4.1.1
新版本的 cordova 工具現已上線!
版本重點包括
若要更新您的工具
如果您已安裝 cordova
npm install -g cordova@latest
如果您已安裝 plugman
npm install -g plugman@latest
Cordova 6.0.0 版本在 cordova-lib 中引入了核心外掛程式版本的釘選。
我們很高興宣佈即將發佈的 Cordova 6.1.0 版本的新功能之一是一個通用的 API,它允許任何外掛程式引導 CLI 選擇適用於給定專案的相容外掛程式版本以進行擷取。這將外掛程式相依性資訊從 cordova-lib 中移出,以便它可以獨立於 Cordova 工具進行更新,並支援核心之外的協力廠商外掛程式。我們希望此功能能改善 Cordova 的外掛程式生態系統,並減少 Cordova 開發人員在將新外掛程式新增至專案時遇到的一些挫折。
今天更新了以下外掛程式
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera@2.1.1 --save
變更包括
我們很高興宣佈 Cordova Browser 4.1.0
已發佈。在下一個 cordova-cli
版本發佈後,它將會成為預設的 Browser 版本。
升級方式
npm install -g cordova
cd my_project
cordova platform update browser@4.1.0
要明確新增它
cordova platform add browser@4.1.0
我們很高興宣佈我們已對文件進行重大內容更新。
我們很高興宣佈 Cordova iOS 4.1.0
已發佈!
此版本解決了問題 CB-10530,這是一個在啟動後應用程式會定期凍結的問題。
需要發佈新版本的 cordova-cli
,才能將此版本的 cordova-ios 固定為建立新專案時的預設版本。如果您現在想要開始使用此版本,請確保在執行 cordova platform add/update
時指定版本。
升級方式
npm install -g cordova
cd my_project
cordova platform rm ios
cordova platform add ios@4.1.0
要明確新增它
cordova platform add ios@4.1.0
我們很高興地宣布 Cordova Android 5.1.1
已發布。
當建立新專案時,Cordova CLI 6.0.0 將會自動開始使用此版本的 Cordova-Android。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@5.1.1
要明確新增它
cordova platform add android@5.1.1
我們很高興地宣布 Cordova OSX 4.0.0
已發布! 這是讓 cordova-osx
可以與 cordova-cli
協同運作的必要更新。 快來試用看看吧!
透過以下方式將其新增至您的專案:
cordova platform add osx@4.0.0
今天更新了以下外掛程式
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的媒體外掛程式:
cordova plugin rm cordova-plugin-media --save
cordova plugin add cordova-plugin-media@2.2.0 --save
變更包括
在 cordova-plugin-inappbrowser
版本 1.2.0
中發現一個重要的回歸問題。 我們正在發布 cordova-plugin-inappbrowser
的 1.2.1
版本,以解決 CB-10407:InAppBrowser 在 Android 上不觸發 loadstart
事件的問題。 此版本還包括針對 Android、iOS 和 Windows 平台的一些其他改進。
您可以先移除該外掛程式,然後重新新增它來更新外掛程式。
cordova plugin rm cordova-plugin-inappbrowser --save
cordova plugin add cordova-plugin-inappbrowser --save
變更包括
我們很高興地宣布 Cordova Windows 4.3.1
已發布!
這是一個修補程式版本,修正了與外掛程式安裝相關的一些小錯誤,以及導致 Windows 10 通用應用程式在某些情況下重新啟動而不是繼續運作的重大問題。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.3.1
要明確新增它
cordova platform add windows@4.3.1
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
新版本的 cordova 工具現已上線!
版本重點包括
cordova-android@5
、cordova-ios@4
和 cordova-windows@4.3
。cordova-android@5.1
支援 Android 6.X.X (Marshmallow)cordova-ios@4.0
新增了 iOS9 和 WKWebView
支援cordova-windows@4.3
更新了平台以使用新的 Platform API。create
命令新增了新的範本功能。例如:cordova create --template cordova-app-hello-world
。這可以透過 npm、git URL 或本機路徑來提取範本。cordova
。 這表示 cordova plugin add cordova-plugin-camera
將會提取外掛程式的釘選版本,而不是總是抓取 latest
。 使用者仍然可以透過 cordova plugin add cordova-plugin-camera@VERSION
安裝任何版本的外掛程式。若要更新您的工具
如果您已安裝 cordova
npm install -g cordova@latest
如果您已安裝 plugman
npm install -g plugman@latest
我們很高興地宣布 Cordova Android 5.1.0
已發布。
此更新為 Android 外掛程式開發人員引入了新的 API。 啟動外部活動的外掛程式現在可以更好地處理記憶體不足裝置上的方法呼叫。 在這種情況下,當外部活動將 Cordova Activity 推到背景時,Android OS 有時會終止 Cordova Activity。 這會導致外掛程式遺失它們在 javascript 中待處理的任何回呼。 新的 API 允許外部活動呼叫的結果透過在 Cordova Activity 被銷毀並重新建立後於 javascript 中觸發的 resume 事件傳遞。 希望實作新 API 的外掛程式開發人員應閱讀更新的外掛程式指南 這裡。
兩個核心外掛程式支援此新 API,並已更新以修正長期存在的錯誤
鼓勵應用程式開發人員更新其外掛程式和 cordova-android 版本,以利用這些錯誤修正。 請注意,上述修正也需要對您的應用程式進行變更。 更多資訊可以在每個外掛程式的 README 中找到,以及在已發布到 Cordova 文件的新 Android 生命週期指南 中找到。 此指南提供了關於如何在 Android 平台上處理低記憶體情境以及將新的 resume API 整合到您的應用程式中的說明和指導。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@5.1.0
要明確新增它
cordova platform add android@5.1.0
今天更新了以下外掛程式
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera --save
變更包括
我們很高興地宣布 Cordova Windows 4.3.0
已發布!
此版本的主要目標是為 Windows 帶來對 Platform Api 介面和 統一訊息記錄的支援。 它將在下一個 cordova-cli
發布之後成為預設的 Windows 版本。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.3.0
要明確新增它
cordova platform add windows@4.3.0
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
Cordova Ubuntu 4.3.3
已發布。
這是一個重要的修補程式版本,修正了執行階段中的一個重大問題。 建議開發人員立即將其應用程式的 Ubuntu 平台支援程式碼更新到這個最新版本。 這將確保應用程式能夠繼續在 Ubuntu 中使用最新的 Oxide 1.12 版本。
升級方式
npm install -g cordova
cd my_project
cordova platform update ubuntu@4.3.3
要明確新增它
cordova platform add ubuntu@4.3.3
我們很高興地宣布 Cordova Ubuntu 4.3.2
已發布。 這是一個修補程式版本,包含多項可用性改進,並將預設架構更新為 ubuntu-sdk-15.04
。
升級方式
npm install -g cordova
cd my_project
cordova platform update ubuntu@4.3.2
要明確新增它
cordova platform add ubuntu@4.3.2
我們很高興地宣布 Cordova iOS 4.0.1
已發布。 這是一個修補程式版本。
升級方式
npm install -g cordova
cd my_project
cordova platform update ios@4.0.1
要明確新增它
cordova platform add ios@4.0.1
今天更新了以下外掛程式
此版本為 cordova-plugin-inappbrowser
外掛程式帶來了 cordova-ios@4.0.0
平台的相容性,並且也向後相容於 cordova-ios@3。
更新了 cordova-plugin-wkwebview-engine
外掛程式,以修正與在 cordova-plugin-inappbrowser
中載入頁面相關的錯誤。
安裝方式
cordova plugin add cordova-plugin-inappbrowser --save
cordova plugin add cordova-plugin-wkwebview-engine --save
變更包括
今天更新了以下外掛程式
這是此外掛程式的初始版本。 此外掛程式需要 cordova-ios@4.0.0
。 請閱讀 iOS 4.0.0 發布部落格,以取得更新說明。
安裝方式
cordova plugin add cordova-plugin-wkwebview-engine --save
如果您正在考慮從在 iOS 上使用 UIWebView 進行移轉,請閱讀 README,並注意此外掛程式的限制。
變更包括
我們很高興地宣布 Cordova iOS 4.0.0
已發布。
這是一個主要版本,並且已移除已棄用的 API。 一些第三方外掛程式可能需要更新才能相容。 此版本為可插拔的 Webview 新增了一流的支援 - 也就是說,我們現在支援 WKWebView -- iOS 的捆綁式現代 WebView!
該平台現在支援用於啟動畫面和圖示的資產目錄 - 當您在 config.xml 中使用 <splash>
和 <icon>
標籤時,這一切對您都是透明的。
ios-sim 現在與平台捆綁在一起,您不再需要單獨安裝它。 但是,對於 ios-deploy,您將需要將您的版本更新到最新版本。
最低部署目標已更新為 iOS 8.0。 這表示此平台版本僅在 iOS 8 裝置和更高版本上進行了測試,並且僅支援這些 iOS 版本。
cordova-ios@4.0.0
將在下一版本的 cordova
中成為預設的 iOS 版本。 如果您迫不及待想要嘗試,可以立即試用
cd my_project
cordova platform update ios@4.0.0
# To install the WKWebView engine (optional):
cordova plugin add cordova-plugin-wkwebview-engine
我們正在將 cordova-plugin-wkwebview-engine
外掛程式發布到 npm。 如果您決定在我們發布此外掛程式之前更新到 cordova-ios@4.0.0
,請暫時透過 git
安裝該外掛程式。
cordova plugin add https://github.com/apache/cordova-plugin-wkwebview-engine.git#1.0.0
請注意,相較於預設的 UIWebView,cordova-plugin-wkwebview-engine
外掛程式有一些限制,請查閱 README 以取得更多詳細資訊。
除了 <access>
標籤之外,還支援新的 <allow-intent>
和 <allow-navigation>
標籤,相關說明請參閱這裡。 請注意,您不需要安裝 cordova-plugin-whitelist
即可使用 cordova-ios-4.0.0
。
cordova
會將 <access>
和 <allow-navigation>
標籤轉換為適當的 應用程式傳輸安全性 (ATS) 指令,這些指令是 iOS 9 中的新增功能。 <access>
和 <allow-navigation>
標籤也支援兩個新屬性:minimum-tls-version
和 requires-forward-secrecy
。
升級方式
npm install -g cordova
cd my_project
cordova platform update ios@4.0.0
要明確新增它
cordova platform add ios@4.0.0
cordova-cli
和 cordova
的新修補程式更新現已上線!
我們必須修正最近發布的 5.4.0 版本中發現的一些問題。
若要更新您的工具
如果您已安裝 cordova
npm install -g cordova@latest
今天更新了以下外掛程式
以下外掛程式現在需要 cordova-android@5.0.0
。 請閱讀 Android 5.0.0 發布部落格,以取得更新說明。
由於 cordova-android@5.0.0
在 cordova
中尚未預設釘選,您現在必須明確安裝這五個外掛程式的新版本。 上述五個外掛程式的先前發布版本在 npm 上仍然設定為 latest
,而不是這些新發布的版本。 一旦我們發布將 cordova-android@5.0.0
釘選的 cordova@6
,這些將會設定為 latest
。
例如:
cordova plugin add cordova-plugin-camera@2.0.0 --save
若要查看外掛程式有哪些版本,請執行 npm info PLUGINNAME versions
。
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm cordova-plugin-camera --save
cordova plugin add cordova-plugin-camera --save
變更包括
更新於 2016/02/20
Apache Cordova 重新審視了 CVE-2015-5256「Apache Cordova 在 Android 上容易受到不當應用白名單限制的影響」。經過進一步調查,我們發現此漏洞的限制比先前了解的更為有限。我們將嚴重性降至「低」,並更新描述、受影響版本和升級路徑。
CVE-2015-5257 仍然是 Cordova 3.6.4 中存在的有效漏洞,此漏洞已在較新版本的 Cordova 中修復,我們鼓勵使用者升級至 4.1.1 版本,對於需要支援 Marshmallow (API 23+) 的使用者,我們建議升級至 Cordova Android 5.1.x。
使用 Cordova CLI 時,要使用 Cordova Android 4.1.1 或 5.1.0 的命令為
cordova platform add android@4.1.0
cordova platform add android@5.1.0
安全問題為 CVE-2015-5256 和 CVE-2015-5257
為了您的方便,此處包含 CVE 的文字。
我們很高興地宣布 Cordova Windows 4.2.0
已發布!
此版本增加了對 Windows 10 和 Windows Phone 8.1 上 返回按鈕處理的支援以及各種其他改進。它將在下一個 cordova-cli
版本發布後成為預設的 Windows 版本。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.2.0
要明確新增它
cordova platform add windows@4.2.0
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
我們很高興地宣布 Cordova Android 5.0.0
已發布。
在此版本中,現在支援外掛程式中的 Android Marshmallow 權限檢查。由於最近 Android 變更的性質,主要版本已遞增以反映新的 API 變更。只有使用 Google 定義的特定權限的外掛程式才會受到此變更的影響。以下核心外掛程式需要更新
cordova-plugin-camera
cordova-plugin-geolocation
cordova-plugin-contacts
cordova-plugin-file
cordova-plugin-media
我們正在將這些外掛程式發布到 npm。如果您決定在我們發布外掛程式之前更新到 cordova-android@5.0.0
,請暫時透過 git
安裝這些更新的外掛程式。
cordova plugin add https://github.com/apache/cordova-plugin-camera.git
有關如何使用新的 Android 權限 API 的資訊可以在 Cordova 文件中找到,可在此處 找到。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@5.0.0
要明確新增它
cordova platform add android@5.0.0
新版本的 cordova 工具現已上線!
發布重點
cordova plugin add
時,Cordova 會自動將舊式外掛程式 ID 轉換為新式外掛程式 ID。只有當舊式外掛程式 ID 存在於 registry-mapper 中時才會發生這種情況,它將自動轉換為新的 ID 並從 npm 提取。CLI
現在會知道是否有較新版本可用,並會提示使用者更新。cordova-lib
中的一些核心公用方法已移至名為 cordova-common
的新模組。cordova-common
在 cordova-lib
和 Cordova 平台之間共用。若要更新您的工具
如果您已安裝 cordova
npm install -g cordova@latest
如果您已安裝 plugman
npm install -g plugman@latest
我們很高興地宣布 Cordova iOS 3.9.2
已發布,它將是預設的 iOS 版本。
此版本解決了多個 iOS 9/9.1 和 XCode 7/7.1 問題。它也棄用了許多 API,這些 API 將在 Cordova iOS 4.0.0
中移除。如需完整的 API 變更列表,請參閱 4.0.md 中的 API 變更
升級方式
npm install -g cordova
cd my_project
cordova platform update ios@3.9.2
Cordova 工具 5.3.3 已發布,以正確支援 Node v4。
如果您目前正在為 iOS 平台開發並計畫使用 Node v4,我們建議您更新至此版本
如果您已安裝 cordova
npm install -g cordova
如果您已安裝 plugman
npm install -g plugman
發現 cordova-plugin-file-transfer 外掛程式的中等安全問題。我們正在發布 cordova-plugin-file-transfer
的版本 1.3.0
,以解決此安全問題。我們建議所有目前使用此外掛程式舊版本的應用程式盡快升級。
您可以先移除該外掛程式,然後重新新增它來更新外掛程式。
例如,要更新您的檔案傳輸外掛程式
cordova plugin rm cordova-plugin-file-transfer --save
cordova plugin add cordova-plugin-file-transfer --save
安全問題為 CVE-2015-5204。
為了您的方便,此處包含 CVE 的文字
新版本的 cordova 工具現已上線!
若要更新您的工具
如果您已安裝 cordova
npm install -g cordova
如果您已安裝 plugman
npm install -g plugman
從今天開始,plugins.cordova.io 已變為不可變。我們鼓勵外掛程式作者將他們的外掛程式移至 npm(如果他們尚未這樣做)。外掛程式作者應查看我們的指南以轉換至 npm 這裡。
使用者可以在我們新的 cordova npm 搜尋頁面上開始搜尋已移至 npm 的 cordova 外掛程式。
需要 Cordova CLI 5.0.0 或更高版本才能從 npm 提取外掛程式。如果您想使用最新版本的外掛程式,請更新您的 Cordova 版本。或者,舊的 cli 使用者可以透過 git URL 新增外掛程式。範例
cordova plugin add https://github.com/apache/cordova-plugin-camera.git
如果您第一次錯過,請務必查看我們之前關於將外掛程式移至 npm 的部落格文章。
我們很高興地宣布 Cordova BlackBerry 3.8.0
已發布,它將在下一個 cordova-cli
版本發布後成為預設的 BlackBerry 版本。
此版本增加了在任何工作站作業系統上新增 blackberry10 平台、新增子網域白名單並包含多項錯誤修正的功能。
升級方式
npm install -g cordova
cd my_project
cordova platform update blackberry10@3.8.0
要明確新增它
cordova platform add blackberry10@3.8.0 --save
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
我們很高興地宣布 Cordova Windows 4.1.0
已發布,它將在下一個 cordova-cli
版本發布後成為預設的 Windows 版本。
此版本與 Windows 10 的 RTM 版本一致,並支援它包含的 Web 平台增強功能,例如託管應用程式和新版本的 WinJS。它也支援用於包含原生或 .NET 元件的 Cordova 外掛程式的新 .NET Native 編譯模型。
還有許多錯誤修正,包括平台相依性問題以及在 Mac 上為 Windows 執行 cordova prepare
的能力。
最後,使用者可設定的封裝參數現在已完全支援,因此 Windows 程式碼簽署需求不會覆寫其他平台的程式碼簽署需求。使用 config.xml 中 <widget>
的 windows-packageVersion
屬性來指定 Windows Store 提交的獨立版本,並合併由 Windows Store 指派的應用程式名稱,設定名為 WindowsStoreIdentityName
的 <preference>
。
現在支援在主控台中查看來自您應用程式的 console.log 訊息和例外狀況。這對於快速診斷很有用。在管理員命令提示字元中,您可以執行
platforms\windows\cordova\log
升級方式
npm install -g cordova
cd my_project
cordova platform update windows@4.1.0
要明確新增它
cordova platform add windows@4.1.0 --save
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
新版本的 cordova 工具現已上線!
發布重點
Plugman
publish
、unpublish
、addUser
和 owner add/rm
命令。我們鼓勵外掛程式作者改為發布到 npm。在 http://plugins.cordova.io/npm/authors.html 瞭解更多資訊。clean
命令新增至 cordova-cli
。這會清除專案的建置成品。執行 cordova clean -h
以取得更多資訊。--save
旗標儲存至 config.xml
時,使用波浪符號而不是插入符號。plugman platform add
--usegit
旗標的棄用警告。--browserify
嘗試。例如,cordova run android --browserify
。若要更新您的工具
如果您已安裝 cordova
npm install -g cordova
如果您已安裝 plugman
npm install -g plugman
我們很高興地宣布 Cordova iOS 3.9.0
已發布,它將在下一個 cordova-cli 版本發布後成為預設的 iOS 版本。
更新:若要部署到 iOS 裝置,開發人員必須將他們的 ios-deploy 相依性更新到 1.4.0 或更高版本。執行 npm install ios-deploy -g
以下載最新版本。
除了許多錯誤修正之外,現在也支援檢查 iOS 平台的系統需求
$>cordova requirements ios
Requirements check results for ios:
Apple OS X: installed darwin
Xcode: installed 6.3
ios-deploy: installed 1.7.0
ios-sim: installed 4.1.1
並支援 為 iOS 平台簽署應用程式
$>/path/to/my/project/cordova/build --codeSignIdentity="iPhone Distribtion" --provisioningProfile="926c2bd6-8de9-4c2f-8407-1016d2d12954"
升級方式
npm install -g cordova
cd my_project
cordova platform update ios@3.9.0
我們很高興地宣布 Cordova Android 4.1.0
已發布。
在此版本中,現在支援檢查 Android 平台的系統需求
$>cordova requirements android
Requirements check results for android:
Java JDK: installed 1.7.0
Android SDK: installed
Android target: installed android-19,android-21,android-22,Google Inc.:Google APIs:19,Google Inc.:Google APIs (x86 System Image):19,Google Inc.:Google APIs:21
Gradle: installed 1.12
除了許多錯誤修正之外,mininumSdkTarget 也已從 7 切換為 14。Cordova 最低支援的 Android OS 現在是 Ice Cream Sandwich。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@4.1.0
要明確新增它
cordova platform add android@4.1.0
今天更新了以下外掛程式
新版本的 cordova 工具現已上線!
發布重點
cordova requirements
命令cordova prepare --browserify
現在支援第三方外掛程式,可在執行時建置您的 cordova.js
!快來試試!若要更新您的工具
如果您已安裝 cordova
npm install -g cordova
如果您已安裝 plugman
npm install -g plugman
Cordova 工具 4.3.1 已發佈,以釘選 Android 平台的 3.7.2 版本,其中包含重要的安全性更新。
如果您目前正在使用 Cordova 4.x 並為 Android 平台開發,我們建議您更新到此版本
npm install -g cordova@4.3.1
如果您有使用 Cordova Android 3.7.1 或更早版本的現有專案,您可以將它們更新到 3.7.2
cordova platform update android@3.7.2
我們很高興宣佈 Cordova Windows 4.0.0 已發佈!
windows-target-version
偏好設定,您將會看到此警告,且應考慮將其變更為 8.1。windows8
平台關鍵字。對於所有外掛程式,請使用 windows
作為平台關鍵字。在 Cordova 的 Android 平台中發現了一個重大的安全性問題。我們正在發佈 Cordova Android 的 4.0.2 版本以解決這些安全性問題。我們建議所有使用 Cordova 4.0.x 或更高版本建置的 Android 應用程式都升級為使用 Cordova Android 的 4.0.2 版本。如果您使用的是較舊版本的 Cordova,我們也已發佈具有相同修復的 3.7.2 版本,並且我們建議您將專案升級到這些已修復的任何一個版本。其他 Cordova 平台(如 iOS)不受影響,且沒有更新。
使用 Cordova CLI 時,使用 Cordova Android 4.0.2 的命令是
cordova platform add android@4.0.2
而使用 3.7.2 的命令是
cordova platform add android@3.7.2
安全性問題是 CVE-2015-1835
為了您的方便,此處包含 CVE 的文字。
新版本的 cordova 工具現已上線!
發布重點
config.xml
中的 <feature>
標籤已重新命名為 <plugin>
標籤。如果尚未安裝,則將 <plugin>
標籤新增至 config.xml
會在 cordova prepare
時擷取並安裝它。config.xml
中管理外掛程式和平台相依性的功能。新增外掛程式或平台時,請使用 --save
旗標將它們新增至 config.xml
。例如:cordova platform add android --save
。現有專案可以使用 cordova plugin save
和 cordova platform save
命令將所有先前安裝的外掛程式和平台儲存到專案的 config.xml
中。當執行 cordova prepare
時,將自動還原平台和外掛程式。這可讓開發人員輕鬆地在不同的開發環境中以及與同事之間管理和共用他們的相依性。若要更新您的工具
如果您已安裝 cordova
npm install -g cordova
如果您已安裝 plugman
npm install -g plugman
Apache Cordova 團隊很高興宣佈新的外掛程式發佈,這與我們將核心外掛程式移至 npm 的動作一致!
隨著移轉至 npm,我們已決定重新命名我們的核心外掛程式,以提高可讀性並更好地符合 npm 生態系統。
org.apache.cordova.*
變更為 cordova-plugin-*
。cordova plugin add cordova-plugin-device
安裝外掛程式。使用新的 ID 將直接從 npm 擷取外掛程式。我們目前的 Cordova 外掛程式登錄 (CPR) 將至少繼續運作 6 個月 (2015 年 10 月 15 日
),因為我們會協助外掛程式開發人員轉換至 npm。這也將允許目前的 Cordova 開發人員將其 CLI
升級至 5.0.0 或更高版本。
2015 年 7 月 15 日
將 CPR 切換為唯讀。若要在 npm 上尋找外掛程式,請搜尋 ecosystem:cordova。我們正在與 npm 合作以提高可探索性,並將在今年稍後宣佈更多資訊。我們鼓勵所有第三方外掛程式開發人員在其外掛程式的 package.json
中新增 ecosystem:cordova
作為關鍵字。
我們很高興宣佈已發佈 Cordova Android 4.0.0
!
此版本新增了重要的功能,並且也導入了一些重大變更。但大多數情況下,它為 Crosswalk(捆綁的現代 WebView!)新增了一流的支援!
cordova-android@4.0.0
將成為下一個 cordova
版本中的預設 android 版本。如果您迫不及待,現在就可以試試看
cd my_project
cordova platform update android@4.0.0
cordova plugin add https://github.com/apache/cordova-plugin-whitelist.git#r1.0.0
# To install Crosswalk (optional):
cordova plugin add https://github.com/MobileChromeApps/cordova-plugin-crosswalk-webview.git#1.0.0
新版本的 cordova 工具現已上線!
若要更新您的工具
如果您已安裝 cordova
npm install -g cordova
如果您已安裝 plugman
npm install -g plugman
發布重點
iOS-deploy
相依性,才能在 iOS 裝置上啟動。請執行 npm install -g ios-deploy
以安裝最新版本 1.4.0
。--save
命令儲存已安裝的外掛程式和平台的清單。在準備期間會自動還原已儲存的平台和外掛程式。例如:cordova platform add android --save
。這應該會讓團隊更容易開發 cordova 專案。plugman createpackagejson <plugin_path>
將 package.json
檔案新增至其外掛程式。我們很高興宣佈已發佈 Cordova Windows 3.8.0
!
此版本新增了對新的 Visual Studio 2015 工具的支援,並且還有其他各種改進。在發佈 cordova-cli 4.3.0 時,它將成為預設的 Windows 版本。
升級方式
npm install -g cordova
cd my_project
cordova platform update windows
要明確新增它
cordova platform add windows@3.8.0
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
更新:若要部署到 iOS 裝置,開發人員必須將其 ios-deploy
相依性更新至最新版本。執行 npm install ios-deploy -g
以下載最新版本的 1.4.0
。
我們很高興宣佈已發佈 Cordova iOS 3.8.0
!
此版本包含多項錯誤修正,並且會在 cordova-cli 4.3.0 發佈時成為預設的 iOS 版本。此版本也需要 Xcode 6。
升級方式
npm install -g cordova
cd my_project
cordova platform update ios
要明確新增它
cordova platform add ios@3.8.0
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
今天更新了以下外掛程式
這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
您可以透過移除外掛程式,然後重新新增來更新任何外掛程式。
例如,要更新您的相機外掛程式
cordova plugin rm org.apache.cordova.camera
cordova plugin add org.apache.cordova.camera
變更包括
我們很高興宣佈 Cordova Android 3.7.1
已發佈!
此版本包含多項錯誤修正,並將 target-sdk 設定為 android-21(在 Lollipop 裝置上可實現相當不錯的圖形加速!)。它會在 cordova-cli 4.1.0 發佈時成為預設的 Android 版本。
升級方式
npm install -g cordova
cd my_project
cordova platform update android@3.7.1
要明確新增它
cordova platform add android@3.7.1
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
新版本的 cordova 工具現已上線!
若要更新您的工具
如果您已安裝 cordova
npm install -g cordova
如果您已安裝 plugman
npm install -g plugman
今天更新了以下外掛程式
這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
您可以移除任何外掛程式,然後重新新增以更新它。例如,要更新您的相機外掛程式
cordova plugin rm org.apache.cordova.camera
cordova plugin add org.apache.cordova.camera
變更包括
Apple 最近宣佈,提交到 Apple App Store 的新應用程式和更新的應用程式必須包含64 位元支援才能獲得核准。此變更將由 Apple App Store 從 2015 年 2 月 1 日開始實施。
這表示從那時起,基於 Cordova 的應用程式應使用具有 64 位元 iOS 支援的 Cordova 版本建置。
第一個包含 iOS 64 位元的 Cordova 版本是 3.4.1。因此,為了符合 Apple App Store 的這些要求,您應該在此二月期限之前至少使用 Cordova 的 3.4.1 版本。
在使用 Cordova 開發行動應用程式時,效能是許多開發人員普遍關心的問題。雖然最近的 WebView 改進使順暢的體驗變得容易實現,但始終要注意應用程式中可能使應用程式 不穩定 的程式碼。
最新版本的 Android 和 iOS WebView 可以連接並利用瀏覽器中的開發人員工具來分析應用程式的渲染效能。開發人員工具提供有關影格速率、重繪、版面配置等詳細資訊的深入解析。
文章(例如 我的效能稽核工作流程 和 執行階段效能檢查表)闡述了網頁效能稽核的典型工作流程。類似的原則也可以應用於應用程式。
新版本的 cordova 工具現已上線!
若要更新您的工具
如果您已安裝 cordova
npm install -g cordova
如果您已安裝 plugman
npm install -g plugman
Windows 平台範本中的憑證已於 2014 年 11 月 11 日過期,因此,目前使用 Cordova CLI 建置 Windows 會失敗。這會影響所有現有的專案以及在 Cordova 版本 <= 4.0.0
之前使用命令列建立的任何新專案。
請注意,這不會影響 WP8 平台。
為 Windows 建置 Cordova 時,您可能會看到類似以下的錯誤訊息
cordova run windows
C:\Program Files (x86)\MSBuild\Microsoft\VisualStudio\v12.0\AppxPackage\Microsoft.AppXPackage.Targets(1772,9): error APPX0108: The certificate specified has expired.
如需有關更新憑證的詳細資訊,請參閱 http://go.microsoft.com/fwlink/?LinkID=241478。
此問題將在下一個 Cordova CLI 版本中修正
但是,為了確保您在這段時間內可以繼續為 Windows 建置現有的 Cordova 專案,請將位於 yourCordovaProject\platforms\windows\CordovaApp_TemporaryKey.pfx
的過期憑證,替換為此處的新憑證。請確保下載的檔案重新命名為 CordovaApp_TemporaryKey.pfx
我們很高興宣佈 Cordova Windows & WP8 3.7.0
已發佈!
此版本包含多項錯誤修正。
它將在下一個 cordova-cli 版本(Cordova CLI 4.1.0)中提供,預計會在幾天內發佈。
升級方式(一旦 CLI 更新發佈後)
npm install -g cordova
cd my_project
cordova platform update windows
若要明確新增它(現在可用)
cordova platform add windows@3.7.0
cordova platform add wp8@3.7.0
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
我們很高興宣佈 Cordova iOS 3.7.0
已發佈!
此版本包含多項錯誤修正,並且會在 cordova-cli 4.1.0 發佈時成為預設的 iOS 版本。此版本也需要 Xcode 6。
升級方式
npm install -g cordova
cd my_project
cordova platform update ios
要明確新增它
cordova platform add ios@3.7.0
對於非 CLI 專案或 3.0 之前的專案,請參閱 升級指南。
今天更新了以下外掛程式
值得注意的變更包括
cordova-splashscreen
外掛程式的 iPhone 6/6+
支援cordova-network-information
外掛程式的類型從 Mobile
變更為 Cellular
。cordova-media-capture
外掛程式新增 Windows 支援cordova-globalization
外掛程式重新實作 getPreferredLanguage()
和 getLocaleName()
。cordova-file-transfer
外掛程式新增 ms-appdata URIs
支援這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
您可以移除任何外掛程式,然後重新新增以更新它。例如,要更新您的相機外掛程式
cordova plugin rm org.apache.cordova.camera
cordova plugin add org.apache.cordova.camera
其他變更包括
我們很高興宣佈 Apache Cordova CLI 4.0
已發佈!
我們也發佈了 Cordova-Browser 3.6.0
、Cordova-Android 3.6.4
、Cordova-Windows 3.6.4
和 Cordova-WP8 3.6.4
。
最值得注意的變更包括
4.0.0
以反映我們在 發佈政策 中的變更。--target
旗標的支援升級方式:(將 android
替換為您想要更新的平台)
npm install -g cordova
cd my_project
cordova platform update android
對於非 CLI 專案或 3.0 之前的專案,請參閱升級指南。
我們最近決定更新我們的發佈流程,以納入平台的獨立發佈。這表示我們的平台維護人員可以在需要時發佈更新,而無需等待其他平台準備好發佈。
今天更新了以下外掛程式
值得注意的變更包括
這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
我們很高興宣佈 Apache Cordova 3.6
已發佈!
最值得注意的變更包括
升級方式:(將 android
替換為您想要更新的平台)
npm install -g cordova
cd my_project
cordova platform update android
對於非 CLI 專案或 3.0 之前的專案,請參閱升級指南。
在準備 3.6.0 發佈時,候選發佈版本發佈到一個只能寫入一次的存放庫。當發現候選發佈版本需要更新時,我們無法修改只能寫入一次的存放庫,因此我們被迫提高版本號。這就是為什麼所有 3.6 節奏發佈項目都標記為「3.6.3」的原因。因此,3.6.3 是 3.6.x 版本的第一個發佈版本。對於造成混淆,我們深感抱歉。
從今天開始,提供更新版本的 cordova
和 cordova-lib
。
若要更新您的工具
npm install -g cordova
這些版本僅包含一個小的函式變更,與最近發佈的 Cordova Android 3.5.1 有關。在今天的更新之前,將 Android 平台新增至專案時,預設會使用 Cordova Android 的 3.5.0 版本。為了取得最新的 3.5.1 版本 Cordova Android,您需要在 platform add
命令上手動指定 3.5.1 版本號。今天的更新變更了將 Android 平台新增至專案時使用的預設 Cordova Android 版本,因此您不再需要手動指定 3.5.1 版本號即可取得 3.5.1 版本。您現在預設會取得 3.5.1。
今天更新了以下外掛程式
值得注意的變更包括
這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
您可以移除任何外掛程式,然後重新新增它,即可更新該外掛程式。例如,要更新檔案外掛程式
cordova plugin rm org.apache.cordova.file
cordova plugin add org.apache.cordova.file
其他變更包括
在星期一,我們發佈了 Cordova Android 3.5.1,以解決幾個安全性問題。之後,與最初的研究人員交談後,我們發現發佈的安全性公告文字不太正確,因此我們已修改它。
您可以在這裡閱讀修改後的部落格文章。
CVE-2014-3502 中的問題在於,Cordova 應用程式預設會將它們無法載入的任何 URL 傳遞給 Android intent 系統進行處理。這可讓開發人員建構開啟電子郵件應用程式、地圖或傳送簡訊的 URL,甚至可以在系統瀏覽器中開啟網頁,但也允許惡意 URL 可能會開啟裝置上的其他應用程式。這表示如果有人可以在您的應用程式中執行自己的 JavaScript,他們可以使用裝置上的其他應用程式,將使用者的資料「傳回主機」。這就是為什麼我們建議所有 Android 開發人員升級到 Cordova 3.5.1 的原因。
已更新:2014-08-06(在發佈此文章之後,CVE-2014-3502 的文字已變更,以更好地解釋問題的範圍和解決問題的方法)
在 Cordova 的 Android 平台中發現了安全性問題。我們正在發佈 Cordova Android 的 3.5.1 版,以解決這些安全性問題。我們建議使用 Cordova 建置的所有 Android 應用程式都升級為使用 Cordova Android 的 3.5.1 版。其他 Cordova 平台(例如 iOS)不受影響,且沒有更新。
使用 Cordova CLI 時,使用 Cordova Android 的 3.5.1 版的命令是
cordova platform add android@3.5.1 --usenpm
安全性問題是 CVE-2014-3500、CVE-2014-3501 和 CVE-2014-3502。
為了您的方便,這裡包含這些 CVE 的文字。
新版本的 plugman
、cordova
和 cordova-lib
現在已上線!
若要更新您的工具
npm install -g cordova
npm install -g plugman
最值得注意的變更包括
cordova save plugins --experimental
cordova restore plugins --experimental
browserify
來封裝我們的 cordova.js
組建成品。這是我們工具的內部變更,目前仍然預設關閉。我們希望在未來的版本中預設開啟,因此我們希望收到意見反應。使用 plugman 試用它,如下所示plugman (un)install --browserify --project [PROJECT] --plugin [PLUGIN] --platform [ios|android]
其他變更包括
今天更新了以下外掛程式
值得注意的變更包括
navigator.contacts.pickContact
APInavigator.contacts.find
API 現在支援 desiredFields
,它指定要傳回的連絡人欄位這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
您可以移除任何外掛程式,然後重新新增它,即可更新該外掛程式。例如,要更新您的連絡人外掛程式
cordova plugin rm org.apache.cordova.contacts
cordova plugin add org.apache.cordova.contacts
其他變更包括
今天更新了以下外掛程式
值得注意的變更包括
cordova.file.*
(iOS 和 Android,請參閱文件) 的屬性公開。CONTRIBUTING.md
)這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
您可以移除任何外掛程式,然後重新新增它,即可更新該外掛程式。例如,要更新檔案外掛程式
cordova plugin rm org.apache.cordova.file
cordova plugin add org.apache.cordova.file
其他變更包括
我們很高興宣佈 Apache Cordova 3.5
已發佈!
最值得注意的變更包括
cordova-cli
和 cordova-plugman
之間的通用程式碼已移至名為 cordova-lib
的自有存放庫。package.json
檔案,並且已上傳至 npm
。未來對 cordova-cli
的更新將使用 npm
而不是 git
來載入平台。arm64
。新專案會建置為通用二進位檔(64 位元和 32 位元),且最低部署目標為 iOS 6.0。升級方式:(將 android
替換為您想要更新的平台)
npm install -g cordova
cd my_project
cordova platform update android
對於非 CLI 專案或 3.0 之前的專案,請參閱升級指南。
其他變更包括
今天更新了以下外掛程式
其中許多只是次要變更,或僅與幾個平台相關。但是,一些值得注意的變更包括
statusbar
現在是核心 Cordova 外掛程式,且現在包含對 Windows Phone 的支援splashscreen
現在包含對 Tizen 的支援file
在呼叫 .toURL
時,預設會產生與 WebView 相容的 URL (file:///)file
包含 file-system-roots
外掛程式的大部分功能,並允許存取裝置上的所有檔案(作業系統封鎖的檔案除外)clearcache
和 clearsessioncache
media-capture
中的幾個問題,這些問題阻止它與 file
外掛程式一起使用這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
例如,要更新您的檔案外掛程式
cordova plugin rm org.apache.cordova.file
cordova plugin add org.apache.cordova.file
其他變更包括
plugman
、cordova
和 cordova-ios
的新版本現已發佈!
若要更新您的工具
npm update -g cordova
npm update -g plugman
Cordova iOS 3.4.1 包含在 cordova
的最新更新中。
最值得注意的變更包括
.pbxproj
檔案arm64
plugin add
問題。cordova info
命令。其他變更包括
plugman
和 cordova
的新版本現已發佈!
若要更新您的工具
npm update -g cordova
npm update -g plugman
最值得注意的變更包括
plugman create
(CB-4886)cordova prepare
(CB-5647)cordova
現在會顯示建置和 Hook 腳本的輸出其他變更包括
今天更新了以下外掛程式
值得注意的變更包括
file
外掛程式的幾個錯誤修正file-transfer
的 trustAllHosts 的預設值(之前為 true,現在為 false)inappbrowser
中的惡意程式碼能夠在主機 UIWebView 中執行程式碼這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
例如,要更新您的檔案外掛程式
cordova plugin rm org.apache.cordova.file
cordova plugin add org.apache.cordova.file
其他變更包括
我們很高興地宣佈 Cordova 3.4
已發佈!
此版本針對我們所有支援的平台進行了各種錯誤修正。
我們在 Mozilla 的朋友撰寫了一篇關於開始使用 Cordova Firefox OS 的部落格文章。請參閱 https://hacks.mozilla.org/2014/02/building-cordova-apps-for-firefox-os/。
升級方式:(將 android
替換為您想要更新的平台)
npm install -g cordova
cd my_project
cordova platform update android
對於非 CLI 專案或 3.0 之前的專案,請參閱升級指南。
今天更新了以下外掛程式
此版本中最顯著的變更在 File 外掛程式中。它已改版為使用新的 URL 方案 cdvfile://127.0.0.1/<filesystemType>/<path to file>
。這些 URL 由所有檔案操作產生,並透過橋接傳遞到原生程式碼。(這與先前版本形成對比,先前版本在裝置檔案系統上傳遞絕對路徑)。
這些變更大多是為了使我們更符合 HTML 檔案系統標準,儘管它們也將允許我們擴展檔案系統抽象以涵蓋新的儲存類型,包括裝置內部和外部的儲存。
其他變更包括
自上次工具發佈以來已經過很長時間了,但這絕對不是停滯的跡象。今天的發佈內容豐富!
若要更新您的工具
npm update -g cordova
npm update -g plugman
此版本帶來了大量的錯誤修正以及一些新功能!尤其是
config.xml
現在預設位於專案根目錄(而不是在 www/
中)hooks
現在預設位於專案根目錄(而不是在 .cordova
中)--link-to
或 --copy-from
建立新專案時,指定要使用的 www/
cordova
和 plugman
使用 --searchpath
在本機搜尋外掛程式完整的發行說明清單
今天更新了以下外掛程式
在此版本中,外掛程式的說明文件已從 https://cordova.dev.org.tw/docs 移至外掛程式本身的 doc/
目錄中。最終,說明文件將透過 plugins.cordova.io 在線上提供。在那之前,它們將可透過 github 線上檢視。
除了說明文件之外,變更還包括
週五,Cordova 3.3
已在 npm 上發佈。太棒了!
此版本帶來了對 Ubuntu Touch 以及 Amazon Fire OS 的初始支援!
升級方式:(將 android
替換為您想要更新的平台)
npm install -g cordova
cd my_project
cordova platform update android
對於非 CLI 專案或 3.0 之前的專案,請參閱升級指南。
Apache Cordova 團隊剛發佈了 Cordova 3.3.0 的第一個候選版本!我們的目標是在下週末發佈最終版本!正好趕上節日駭客活動!
現在我們請求您,我們的社群,請下載並協助我們進行測試!
首次安裝 cordova
npm install -g cordova@3.3.0-rc.1
更新您目前的 cordova 版本
npm update -g cordova@3.3.0-rc.1
將您目前的 cordova android 專案更新為最新版本的範例
cd cordovaApp
cordova platform update android
問題可以在 https://issues.apache.org/jira/browse/CB 報告
我們將在正式發佈 3.3.0 版本時發佈變更日誌!
今天,我們正在發佈外掛程式以準備 Cordova 3.3.0。大多數外掛程式現在都支援我們即將推出的平台新增功能,Amazon Fire OS 和 Ubuntu!最值得注意的變更包括
這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
新的改良檔案外掛程式未在此次發佈中發佈。它需要更多的工作和測試。我們希望在下週發佈 3.3.0 之前將其發佈。
Apache Cordova 團隊剛發佈了 Cordova 3.2.0。太棒了!此版本對所有平台進行了各種錯誤修正和增強功能。
升級到 3.2 專案(將 android
替換為您要更新的平台)
npm install -g cordova
cd my_project
cordova platform update android
對於非 CLI 專案或 3.0 之前的專案,請參閱升級指南。
我們正在修正與 Android 4.4 (KitKat) 相關的錯誤。如果您想開發 KitKat,請閱讀我們的 KitKat 部落格文章。
可以在 CB-5398 和 CB-5294 找到兩個已知問題。
請在我們的問題追蹤器上報告任何錯誤。
Android KitKat 為系統 WebView 帶來了大規模更新。對於 Cordova 開發人員來說,這是個好消息,因為 初步 評論 給予了高度讚揚。
更新:以下內容實際上不正確。這是一個候選版本的問題,但不會在最終版本的 WebView 中出現。
然而,這次更新在以 3.1.0
之前的 Cordova 版本,或 2.9.1
版本建置的 Cordova 應用程式中引入了一個錯誤,該錯誤可能導致原生橋接回呼無法接收,直到進行另一次回呼(例如,在應用程式中切換)。我們強烈建議所有應用程式更新其 Cordova 版本,或直接將修復程式套用至 cordova-android 和 cordova-js。
Apache Cordova 團隊剛剛發布了 Cordova 3.2.0 的第一個候選版本!如果沒有任何問題,我們的目標是在本週稍後發布最終版本。現在,我們請求您,我們的社群,請下載並協助我們測試!我們希望這成為迄今為止最穩定的版本!
首次安裝 cordova
npm install -g cordova@3.2.0-rc.1
更新您目前的 cordova 版本
npm update -g cordova@3.2.0-rc.1
將您目前的 cordova android 專案更新為最新版本的範例
cd cordovaApp
cordova platform update android
問題可以在 https://issues.apache.org/jira/browse/CB 報告
我們將在正式發布 3.2.0 版本時,一同發布變更記錄!
Apache Cordova 團隊剛剛發布了 Cordova 2.9.1。等等,什麼?!你沒看錯!我們為尚未升級到 Cordova 3 系列的所有人,將一些錯誤修復程式移植回 Cordova 2 系列。萬歲!除了其他修復程式外,此版本還移植了 iOS 7 的支援。
使用者可以從 https://www.apache.org/dist/cordova/cordova-2.9.1-src.zip 下載原始碼壓縮檔
我們將在未來幾個月內繼續移植修復程式,但我們強烈建議升級到 Cordova 3 系列。
今天我們為了準備 Cordova 3.2.0,進行了外掛程式和工具的發布。最值得注意的變更包括
這些外掛程式已在我們的 plugins.cordova.io 註冊表中更新。
Cordova 3.0 發生了外掛程式的重大轉變。作為此轉變的一部分,我們正專注於使外掛程式易於使用,而且同樣重要的是,易於發現。應用程式開發人員想知道有哪些外掛程式可用於他們,而外掛程式開發人員則希望他們的外掛程式能被社群看見。
我們在之前的文章中提到過的解決方案是 Cordova 外掛程式註冊表。使用 Cordova CLI,應用程式開發人員可以使用單一命令將外掛程式新增至其專案中。
今天我們發布自上次發布以來已更新的外掛程式。我們也很高興宣布最近已新增到我們註冊表的三個新外掛程式。
新的外掛程式包括
此版本已更新下列外掛程式
這些外掛程式已在我們的註冊表 plugins.cordova.io 上更新。
Apache Cordova 團隊剛剛發布了 Cordova 3.1.0。萬歲!最值得注意的變更包括
若要升級 3.0 專案(將 android
替換為您要更新的平台)
npm install -g cordova
cd my_project
cordova platform update android
對於非 CLI 專案或 3.0 之前的專案,請參閱升級指南。
今天我們為了準備 Apache Cordova 3.1.0 進行外掛程式發布,該版本預計將在本週稍後發布。
此版本的主要變更是從外掛程式 ID 欄位中移除「core」。這樣做是為了簡化 3.1.0 中外掛程式的安裝。我們正轉換為使用外掛程式 ID 和我們的外掛程式註冊表進行外掛程式安裝,而不是直接從外掛程式 git URL 安裝。
這些外掛程式與 Cordova 3.0.0 相容。如果您等不及下週的 3.1.0,可以隨時升級您目前的外掛程式。請記住,在安裝這些更新的外掛程式後,如果您決定從專案中移除這些外掛程式,您將必須參考新的 ID,而不是我們文件中顯示的舊 ID。
例如,要更新您的相機外掛程式
cordova plugin rm org.apache.cordova.core.camera
cordova plugin add org.apache.cordova.camera
上週,Cordova 收到了來自 24 位不同作者的 83 個提交。沒有發布任何版本,但重點放在新增 Firefox OS 支援、翻譯文件和修復錯誤上。
上週,Cordova 收到了 39 個提交,plugman
版本達到 0.11.0
,而 CLI
版本達到 3.0.9
。
plugman
現在對 Windows Phone 有了初步支援,外掛程式 URL 現在可以指定 git 雜湊和子目錄,並且 <engine>
標籤現在已強制執行。在推出我們的外掛程式註冊表方面也取得了良好的進展。
Apache Cordova 正走向全球!世界各地的開發人員已經在使用 Apache Cordova,現在,我們很榮幸地宣布,Apache Cordova 文件將被翻譯成多種語言。但我們需要您的協助!在Crowdin(一個翻譯和在地化管理平台)的支援下,翻譯人員可以登入易於使用的工具,並根據自己的意願提供盡可能多的翻譯協助。如果您懂其他語言,請支援 Cordova 並貢獻一份力量。
http://crowdin.net/project/cordova
如需更多資訊,請寄電子郵件至 ldeluca@apache.org。
它已於週五上線!快照可在我們的下載頁面上取得,但在下載之前,請繼續閱讀以了解新功能,包括更多使用 Cordova 的方式!
Cordova 3 引入了新的統一專案結構,並附帶非常有限的 API 介面。現在,開發人員可以使用他們需要的 API 來組合一個版本的 Cordova。過去,Cordova 附帶了整個 API 大全,而大多數應用程式只需要其中一小部分。這導致了我們的社群進行混亂且往往不必要的升級。隨著 Cordova 3 的發布,您可以從非常輕量的核心開始,並且只新增您的應用程式所需的 API 介面。顯然,這意味著效能的提升,但真正的勝利在於維護和升級。我們將繼續維護「核心」API,這些 API 與您熟悉和喜愛的相同裝置 API 相同。
我們非常高興能分享兩個新的命令列工具:Cordova 和 Plugman。兩者都是使用 NodeJS
實作,因此透過 npm
發佈。cordova
命令列工具已經期待已久。它將所有平台整合到單一專案結構中,讓您可以輕鬆維護多個平台的單一程式碼庫。cordova
工具建立在我們的另一個新工具:plugman
之上,該工具提供了核心和自訂外掛程式的自動化探索、安裝和移除功能。
我們已經測試了幾個月,但請記住,這兩種工具都是新的。可能會發生錯誤,因此如果您發現錯誤,甚至只是對新功能有想法,請造訪我們的問題追蹤器。
Cordova 現在有一個部落格!在此查看以隨時了解專案的最新動態。即將推出一個主要版本 3.0 (2013 年 7 月 19 日),我們對此感到非常興奮!
請務必使用 RSS 訂閱