license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
本指南演示如何修改 Android 專案從科爾多瓦的舊版本進行升級。 大多數這些說明適用于與舊集的前面的命令列工具創建的專案 cordova CLI 實用程式。 資訊，請參閱命令列介面如何更新的 CLI 版本。
對於非 CLI 的專案，請運行：
bin/update path/to/project
CLI 專案：
更新 cordova CLI 版本。請參閱命令列介面。
在你現有的專案中運行 cordova platform update android。
按照關於 3.2.0 相同的說明.
入手 3.3.0，科爾多瓦運行時現在被編譯為 Android 的庫，而不是一個罐子裡。 這都不應該影響為命令列用法，但 IDE 使用者將需要新增的 MyProject-CordovaLib 專案導入到他們的工作區。
為專案創建的科爾多瓦 CLI：
更新 cordova CLI 版本。請參閱命令列介面。
運行cordova platform update android
對於不使用 CLI 科爾多瓦創建的專案，請運行：
bin/update <project_path>
**警告：**關於 Android 4.4-Android 4.4.3，創建檔輸入具有類型的元素 =“檔”將不會打開檔選取器對話方塊。 這是鉻對 Android 的回歸和能重現該問題在 Android 上獨立 Chrome 瀏覽器 （見 HTTP://code.google.com/p/android/issues/detail?id=62220） 建議的解決方法是使用的檔案傳輸和檔的外掛程式為 Android 4.4。您可以偵聽 onClick 事件從輸入類型 =“檔”，然後彈出一個檔選擇器 UI。 為了打領帶表單資料的上傳，你可以使用 JavaScript 將表單值附加到多個部分的 POST 請求所使。
為專案創建的科爾多瓦 CLI：
更新 cordova CLI 版本。請參閱命令列介面。
運行cordova platform update android
對於不使用 CLI 科爾多瓦創建的專案，請運行：
bin/update <project_path>
創建新的 Apache 科爾多瓦 3.0.0 專案使用 CLI，科爾多瓦，如所述的命令列介面。
添加您的平臺的科爾多瓦的專案，例如： cordova platform add android.
將您的專案 www 目錄中的內容複寫到您剛剛創建的科爾多瓦專案根本 www 目錄。
將本機的任何資產從舊專案複製到相應的目錄下 平臺/android： 此目錄是您的本機科爾多瓦 android 專案所在。
使用科爾多瓦 CLI 工具來安裝您需要的任何外掛程式。請注意 CLI 處理所有核心 Api 作為外掛程式，所以他們可能需要添加。只有 3.0.0 外掛程式是與 CLI 相容。
創建一個新的 Apache 科爾多瓦 Android 專案。
將 www 目錄中的內容複寫到新專案中。
將任何原生的 Android 資產從 res 目錄複寫到新的專案。
複製您安裝到新專案的 src 子目錄中的任何外掛程式。
請務必升級任何棄用 <plugin> 從你舊的 config.xml 檔到新的 <feature> 規範的引用。
更新到 org.apache.cordova.api 包是 org.apache.cordova 的任何引用.
注： 所有的核心 Api 已被刪除，並且必須作為外掛程式安裝。請有關詳細資訊，參閱使用 Plugman 管理外掛程式指南。
bin/update <project_path>.從專案的 libs 目錄刪除 科爾多瓦 2.7.0.jar。
將 科爾多瓦 2.8.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案和做清潔。
將新的 cordova.js 複製到您的專案。
更新你的 html 代碼，使用新的 cordova.js 檔。
要匹配 framework/res/xml/config.xml 的 res/xml/config.xml 檔的副本.
更新 framework/res/xml/config.xml 以前一樣有類似的設置。
將檔從複製 bin/templates/cordova 到專案的 cordova 目錄。
從專案的 libs 目錄刪除 科爾多瓦 2.6.0.jar。
將 科爾多瓦 2.7.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新的 科爾多瓦 2.7.0.js 複製到您的專案。
更新你的 html 代碼，使用新的 cordova-2.7.0.js 檔。
複製 res/xml/config.xml 以匹配framework/res/xml/config.xml.
更新 framework/res/xml/config.xml 以前一樣有類似的設置。
將檔從複製 bin/templates/cordova 到專案中的 cordova 目錄。
從專案的 libs 目錄刪除 科爾多瓦 2.5.0.jar。
將 科爾多瓦 2.6.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-2.6.0.js 到您的專案。
更新你的 html 代碼，使用新的 cordova-2.6.0.js 檔。
複製 res/xml/config.xml 以匹配framework/res/xml/config.xml.
更新 framework/res/xml/config.xml 以前一樣有類似的設置。
將檔從複製 bin/templates/cordova 到專案中的 cordova 目錄。
科爾多瓦原始目錄中列出的專案路徑與運行 bin/更新 < 專案 >。
從專案的 libs 目錄刪除 科爾多瓦 2.4.0.jar。
將 科爾多瓦 2.5.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-2.5.0.js 到您的專案。
更新你的 html 代碼，使用新的 cordova-2.5.0.js 檔。
複製 res/xml/config.xml 以匹配framework/res/xml/config.xml.
更新 framework/res/xml/config.xml 以前一樣有類似的設置。
將檔從複製 bin/templates/cordova 到專案的 cordova 目錄。
從專案的 libs 目錄刪除 科爾多瓦 2.3.0.jar。
將 科爾多瓦 2.4.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-2.4.0.js 到您的專案。
更新你的 html 代碼，使用新的 cordova-2.4.0.js 檔。
複製 res/xml/config.xml 以匹配framework/res/xml/config.xml.
將檔從複製 bin/templates/cordova 到專案中的 cordova 目錄。
從專案的 libs 目錄刪除 科爾多瓦 2.2.0.jar。
將 科爾多瓦 2.3.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-2.3.0.js 到您的專案。
更新你的 html 代碼，使用新的 cordova-2.3.0.js 檔。
複製 res/xml/config.xml 以匹配framework/res/xml/config.xml.
將檔從複製 bin/templates/cordova 到專案中的 cordova 目錄。
從專案的 libs 目錄刪除 科爾多瓦 2.1.0.jar。
將 科爾多瓦 2.2.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-2.2.0.js 到您的專案。
更新你的 html 代碼，使用新的 cordova-2.2.0.js 檔。
複製 res/xml/config.xml 以匹配framework/res/xml/config.xml.
將檔從複製 bin/templates/cordova 到專案中的 cordova 目錄。
從專案的 libs 目錄刪除 科爾多瓦 2.0.0.jar。
將 科爾多瓦 2.1.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-2.1.0.js 到您的專案。
更新你的 html 代碼，使用新的 cordova-2.1.0.js 檔。
複製 res/xml/config.xml 以匹配framework/res/xml/config.xml.
將檔從複製 bin/templates/cordova 到專案的 cordova 目錄。
從專案的 libs 目錄刪除 科爾多瓦 1.9.0.jar。
將 科爾多瓦 2.0.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-2.0.0.js 到您的專案。
更新你的 html 代碼，使用新的 cordova-2.0.0.js 檔。
複製 res/xml/config.xml 相匹配framework/res/xml/config.xml.
在 2.0.0 釋放，config.xml 檔相結合，並取代了 cordova.xml 和 plugins.xml。 舊的檔已被否決，和當他們仍然在 2.0.0，工作就會停止工作在將來的版本中。
刪除 cordova-1.8.0.jar 從專案的 libs 目錄。
將 科爾多瓦 1.9.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新的 科爾多瓦 1.9.0.js 複製到您的專案。
更新你的 html 代碼，使用新的 科爾多瓦 1.9.0.js 檔。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
由於引入了 CordovaWebView 在 1.9.0 釋放，協力廠商外掛程式可能無法工作。 這些外掛程式需要從 CordovaInterface 使用 getContext() 或 getActivity() 獲取上下文。 如果你不是一個經驗豐富的 Android 開發者，請聯繫外掛程式的維護者，並將該任務添加到其 bug 追蹤器。
刪除 cordova-1.8.0.jar 從專案的 libs 目錄。
將 科爾多瓦 1.8.1.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新的 科爾多瓦 1.8.1.js 複製到您的專案。
更新你的 html 代碼，使用新的 科爾多瓦 1.8.1.js 檔。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
刪除 cordova-1.7.0.jar 從專案的 libs 目錄。
添加 cordova-1.8.0.jar 到專案中的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-1.8.0.js 到您的專案。
更新您的 html 代碼，使用新的 cordova-1.8.0.js 檔。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
刪除 cordova-1.7.0.jar 從專案的 libs 目錄。
添加 cordova-1.8.0.jar 到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
複製新 cordova-1.8.0.js 到您的專案。
更新你的 html 代碼，使用新的 cordova-1.8.0.js 檔。
更新 res/xml/plugins.xml 相匹配framework/res/xml/plugins.xml.
從專案的 libs 目錄刪除 科爾多瓦 1.6.1.jar。
將 科爾多瓦 1.7.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新的 科爾多瓦 1.7.0.js 複製到您的專案。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
從專案的 libs 目錄刪除 科爾多瓦 1.6.0.jar。
將 科爾多瓦 1.6.1.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新的 科爾多瓦 1.6.1.js 複製到您的專案。
更新 res/xml/plugins.xml 相匹配framework/res/xml/plugins.xml.
從專案的 libs 目錄刪除 科爾多瓦 1.5.0.jar。
將 科爾多瓦 1.6.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案和做清潔。
將新的 科爾多瓦 1.6.0.js 複製到您的專案。
更新你的 html 代碼，使用新的 科爾多瓦 1.6.0.js 檔。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
替換 res/xml/phonegap.xml 與 res/xml/cordova.xml 進行匹配framework/res/xml/cordova.xml.
從專案的 libs 目錄刪除 phonegap 1.4.0.jar。
將 科爾多瓦 1.5.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新的 科爾多瓦 1.5.0.js 複製到您的專案。
更新你的 html 代碼，使用新的 科爾多瓦 1.5.0.js 檔。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
替換 res/xml/phonegap.xml 與 res/xml/cordova.xml 相匹配framework/res/xml/cordova.xml.
從專案的 libs 目錄刪除 phonegap 1.3.0.jar。
將 phonegap 1.4.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新 phonegap 1.4.0.js 複製到您的專案。
更新你的 html 代碼，使用新的 phonegap 1.4.0.js 檔。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
更新 res/xml/phonegap.xml 以匹配framework/res/xml/phonegap.xml.
從專案的 libs 目錄刪除 phonegap 1.2.0.jar。
將 phonegap 1.3.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新 phonegap 1.3.0.js 複製到您的專案。
更新您的 html 代碼，使用新的 phonegap-1.2.0.js 檔。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
更新 res/xml/phonegap.xml 以匹配framework/res/xml/phonegap.xml.
從專案的 libs 目錄刪除 phonegap 1.1.0.jar。
將 phonegap 1.2.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新 phonegap 1.2.0.js 複製到您的專案。
更新你的 html 代碼，使用新的 phonegap-1.2.0.js 檔。
更新 res/xml/plugins.xml 以匹配framework/res/xml/plugins.xml.
更新 res/xml/phonegap.xml 相匹配framework/res/xml/phonegap.xml.
從專案的 libs 目錄刪除 phonegap 1.0.0.jar。
將 phonegap 1.1.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案，做清潔。
將新 phonegap 1.1.0.js 複製到您的專案。
更新你的 html 代碼，使用新的 phonegap 1.1.0.js 檔。
更新 res/xml/plugins.xml 相匹配framework/res/xml/plugins.xml.
從專案的 libs 目錄刪除 phonegap 0.9.6.jar。
將 phonegap 1.0.0.jar 添加到專案的 libs 目錄。
如果您使用 Eclipse，請刷新您的 Eclipse 專案和做清潔。
將新 phonegap 1.0.0.js 複製到您的專案。
更新你的 html 代碼，使用新的 phonegap 1.0.0.js 檔。
添加 res/xml/plugins.xml 以匹配 framework/res/xml/plugins.xml.