它在星期五上線了!快照版本可在我們的下載頁面取得,但在下載之前,請繼續閱讀以了解新功能,包括更多使用 Cordova 的方式!
輕量核心
Cordova 3 引入了新的統一專案結構,並僅提供非常有限的 API 介面。開發人員現在可以只使用他們需要的 API 來組成一個 Cordova 版本。過去,Cordova 提供了所有應用程式只需要一小部分 API 的完整功能。這導致我們社群進行混亂且常常不必要的升級。隨著 Cordova 3 的發布,您將從一個非常輕量級的核心開始,並且只添加應用程式所需的 API 介面。顯然,這意味著性能的提升,但真正的優勢在於維護和升級。我們將繼續維護「核心」API,這些 API 與您一直以來熟悉和喜愛的設備 API 相同。
新的命令列工具
我們很高興分享兩個新的命令列工具:Cordova 和 Plugman。兩者都是使用 NodeJS
實作,因此透過 npm
分發。cordova
命令列工具已經期待已久。它將所有平台統一到一個單一的專案結構中,使維護多個平台的單一程式碼庫變得容易。cordova
工具建構於我們的另一個新工具:plugman
,它提供核心外掛和自訂外掛的自動探索、安裝和移除功能。
我們已經測試了好幾個月,但請記住這兩個工具都是新的。錯誤難免發生,因此如果您發現錯誤,甚至只是對新功能有想法,請訪問我們的問題追蹤器。
安裝 > 下載
首先,請確保您已安裝 NodeJS,然後只需執行 npm install -g cordova
。從這裡開始,它是一個典型的命令列工具。透過建立一個 iOS 應用程式來開始使用!
cordova create MyFunkyApp
cd MyFunkyApp
cordova platform add ios
cordova emulate ios
Cordova 必須在第一次執行 create
時下載平台檔案,因此您建立的第一個應用程式可能會有點慢。只需使用 -d
標誌來查看進度。例如,cordova -d platform add ios
。第一次執行時,您可以喝杯啤酒放鬆一下。
現在讓我們新增 Android,cordova platform add android
。是的:就是這麼容易!
安裝外掛
如果您直接使用平台專案(透過 Cordova 平台的 bin/create
腳本而不是透過 cordova
工具建立的),則可以獨立使用 plugman
。再次,請確保您已安裝 NodeJS,然後只需執行 npm install -g plugman
。
cd MyFunkyApp
cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
您現在已經在專案中啟用了地理位置!
如果您直接使用原生專案,則可以獨立使用 plugman
。再次,請確保您已安裝 NodeJS,然後只需執行 npm install -g plugman
。
cd MyAndroidProject
plugman --platform android --project . --plugin https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
當然,您可以建立自己的外掛!(我們非常期待看到您能做到什麼。)您可以透過閱讀外掛開發指南來了解如何編寫外掛。我們將在未來撰寫更多關於此的文件。同時,您可以查看核心外掛來學習很多東西。
升級
我們已經為每個平台記錄了升級指南,以幫助您完成轉換。當然,請隨時在 freenode 上的 #cordova irc 頻道尋求幫助,或直接訪問我們的問題追蹤器。
已知問題
請記住,核心外掛在新專案中預設不再存在,您必須使用 plugman
或 cordova
手動新增它們。您知道我們會定期發布更新,因此您可以期待很快的更新,並且我們將像往常一樣為棄用留下一個很大的緩衝時間。另外請記住,這是一個開放原始碼專案,因此如果有任何不合您意的地方,您可以隨時加入並自行修復!
- 在使用基於
cordova
的專案時,各種原生 IDE 會顯示產生的檔案。請注意不要編輯它們,否則當下次執行cordova
時,您可能會遺失您的工作! - 白名單 (
<access>
標籤) 格式在不同平台上不一致 cordova
尚沒有「升級」命令。您現在需要移除並重新新增外掛/平台。- 並非所有平台都支援
cordova
。目前僅支援 iOS、Android、BB10 和 Windows Phone - 外掛探索儲存庫仍在建置中,將很快可用
衷心感謝
感謝所有 Cordova 的提交者、測試人員、開發人員和朋友,他們讓這一切成為可能!