部落格 RSS 訂閱

地理位置外掛程式 5.0.0 版本發佈！
作者：Norman Breau
2023 年 9 月 21 日

我們很高興宣布，我們剛發布了 cordova-plugin-geolocation 的更新！

升級方式

cordova plugin remove cordova-plugin-geolocation
cordova plugin add cordova-plugin-geolocation@5.0.0

版本重點

重大變更

  • 現代 JavaScript

此外掛程式的 JavaScript 已升級為使用 ES6 功能，例如 let 和 const。

注意：此版本未能升級所需的引擎。儘管已宣告要求 cordova-android >= 6.3.0，且未宣告對 iOS 的要求，新的最低要求將會是

  • cordova-ios 6 或更高版本
  • cordova-android 10 或更高版本

這些平台的早期版本可能無法如預期運作。一如既往，建議使用可用的最新版本。引擎可能會在稍後的修補程式版本中修正。

  • 放棄 Cordova Windows 支援

此版本已放棄並完全移除對已棄用的 cordova-windows 平台之支援。

重要修復

  • 在 iOS 上進行地理位置序列化的健全性檢查

    Infinity 值的罕見情況會在 iOS 上的 JSON 序列化期間導致當機。現在已捕獲此情況，並將會正常產生「位置不可用」錯誤。

  • 改進的 Android 權限處理

    Android 已針對處理粗略與精確位置權限進行修復，以提高在 Android 12+ 裝置上的相容性。Android 現在將處理以下情況：

    1. 僅包含 COARSE 位置的權限請求。
    2. 包含 COARSE 和 FINE（高精確度）位置的權限請求。
    3. 當授予 COARSE 但需要 FINE 時的權限升級。

有關這些變更的更多詳細資訊，請參閱 PR。

  • 改進的 W3C 相容性

已對 heading 和 speed 進行修復，以更好地符合 W3C 地理位置 API 規範。如果這些值的其中一個未被確定為預期的有效範圍，則現在將返回 null，以便在 Cordova 和其他 Web 環境之間提供更好的一致性。

請按照此 如何回報錯誤 指南回報您發現的任何問題！

變更記錄

重大變更

  • GH-260 chore(eslint)：設定升級至 5.0.0 (#260)
  • GH-267 chore(windows)!：移除 Windows 平台 (#267)

修復

  • GH-270 fix：heading speed w3c 規範 (#270)
  • GH-250 (android) fix：在檢查/請求 Android 12+ 權限時，尊重要求的位置精確度。解決當請求 COARSE 權限導致 TIMEOUT 錯誤時，API < 32 上的錯誤。
  • GH-231 (ios) fix：檢查從原生 CLLocation 資料建構的 NSDictionary 在嘗試轉換之前是否對於轉換為 JSON 有效。防止由於對 JSON 轉換無效的值（例如 INFINITY）而導致當機。

其他變更

  • GH-247 ci(android)：更新 cordova-android@11 的 java 要求 (#247)
  • GH-241 ci(ios)：使用 iOS 15 更新工作流程 (#241)
  • GH-239 ci：新增 action-badge (#239)
  • GH-238 ci：移除 travis & appveyor (#238)
  • GH-236 chore：npmrc (#236)
  • GH-234 ci：新增 gh-actions 工作流程 (#234)
  • GH-217 ci：將 node-14.x 新增至工作流程 (#217)
  • GH-251 ci：將工作流程與 paramedic 同步 (#251)
  • GH-249 dep(npm)：使用重建來更新 package-lock v2 (#249)
  • GH-268 ci(gh-action)：與 paramedic 設定同步 (#268)
  • GH-261 ci：與 paramedic 同步。移除 API 22 和 31，新增 API 24 和 API 33 (#261)
  • GH-265 chore：package-lock (#265)
  • GH-269 test(windows)：從測試中移除 window 平台參考 (#269)