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
本指南演示如何修改黑莓手機的專案從科爾多瓦的舊版本進行升級。 大多數這些說明適用于與舊集的前面的命令列工具創建的專案 cordova CLI 實用程式。 資訊，請參閱命令列介面如何更新的 CLI 版本。
對於非 CLI 的專案，請運行：
bin/update path/to/project
CLI 的專案：
更新 cordova CLI 版本。請參閱命令列介面。
在你現有的專案中運行 cordova platform update blackberry。
為創建的科爾多瓦 CLI 的專案：
更新 cordova CLI 版本。請參閱命令列介面。
運行 cordova platform update blackberry
對於不使用 CLI 科爾多瓦創建的專案，請運行：
bin/update <project_path>
創建一個新的 Apache 科爾多瓦 3.1.0 專案使用 CLI，科爾多瓦，所述的命令列介面。
添加您的平臺到科爾多瓦專案中，例如：cordova platform add blackberry10.
複製的原始專案內容 www 目錄到 www 目錄在您剛剛創建的科爾多瓦專案的根目錄。
複製或覆蓋原始專案中的任何本機資產 ( Resources ，等等.)
複製 config.xml 檔到 www 目錄中，並刪除任何外掛程式定義。您需要修改設置，在這裡，而不是平臺目錄內。
使用科爾多瓦 CLI 工具來安裝您需要的任何外掛程式。 注意 CLI 處理所有核心 Api 作為外掛程式，所以他們可能需要添加。 只有外掛程式標記 3.0.0 並且以上與 CLI 相容。
生成並測試。
請注意，CLI 完全支援 BlackBerry10 平臺。劇本和 BBOS，請參閱科爾多瓦版本 2.9.0 及以下。
創建新的 Apache 科爾多瓦 3.0.0 專案使用 CLI，科爾多瓦，如所述的命令列介面。
添加您的平臺到科爾多瓦專案中，例如：cordova platform add blackberry10.
複製的原始專案內容 www 目錄到 www 目錄在您剛剛創建的科爾多瓦專案的根目錄。
複製或覆蓋原始專案中的任何本機資產 ( Resources ，等等.)
複製 config.xml 檔到 www 目錄中，並刪除任何外掛程式定義。您需要修改設置，在這裡，而不是平臺目錄內。
使用科爾多瓦 CLI 工具來安裝您需要的任何外掛程式。請注意 CLI 處理所有核心 Api 作為外掛程式，所以他們可能需要添加。只有 3.0.0 外掛程式是與 CLI 相容。
生成並測試。
黑莓 10：
下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.9.0 源，例如到~/Cordova-2.9.0.
退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
創建一個新專案，黑莓手機殼工具指南中所述。這將成為您更新的專案的家中。
從舊專案複製您的專案源 / www 目錄到新的專案 / www 目錄。
科爾多瓦的腳本中的引用更新 www/index.html 檔 （以及包含該腳本引用的任何其他檔） 以指向新 cordova.js 檔。
為 BlackBerryOS/行動手冊：
下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.9.0 源，例如到~/Cordova-2.9.0.
退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
創建一個新專案，如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
複製 www/cordova.js 到新專案中的檔 www 目錄中，並刪除 www/cordova.js 檔。
科爾多瓦的腳本中的引用更新 www/index.html 檔 （以及包含該腳本引用的任何其他檔） 以指向新 cordova.js 檔。
複製 native 到現有專案中，並覆蓋舊從新專案目錄 native 目錄。
複製 lib 到現有專案中，並覆蓋舊從新專案目錄 lib 目錄。
複製 cordova 到現有專案中，並覆蓋舊從新專案目錄 cordova 目錄。
黑莓 10 使用新的 CLI 模具和管理核心作為外掛程式的 Api。 說明將您的專案遷移到新的專案，而不是更新現有的專案，由於更新一個舊的專案的複雜性。 此外注意到科爾多瓦 js 指令檔現在被稱為 ‘cordova.js’ 和不再包含版本的字串。
下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.8.0 源，例如到~/Cordova-2.8.0.
退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
創建一個新專案，黑莓手機殼工具指南中所述。這將成為您更新的專案的家中。
從舊專案複製您的專案源 / www 目錄到新的專案 / www 目錄。
科爾多瓦的腳本中的引用更新 www/index.html 檔 （以及包含該腳本引用的任何其他檔） 以指向新 cordova.js 檔。
為 BlackBerryOS/行動手冊：
下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.8.0 源，例如到~/Cordova-2.8.0.
退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
創建一個新專案，如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
複製 www/cordova.js 到新專案中的檔 www 目錄中，並刪除 www/cordova.js 檔。
科爾多瓦的腳本中的引用更新 www/index.html 檔 （以及包含該腳本引用的任何其他檔） 以指向新 cordova.js 檔。
複製 native 到現有專案中，並覆蓋舊從新專案目錄 native 目錄。
複製 lib 到現有專案中，並覆蓋舊從新專案目錄 lib 目錄。
複製 cordova 到現有專案中，並覆蓋舊從新專案目錄 cordova 目錄。
下載並解壓縮到硬碟上，例如對 ~/Cordova-2.7.0 的永久目錄位置的科爾多瓦 2.7.0 源.
退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
創建一個新專案，黑莓手機殼工具指南中所述。您需要從這個新的專案資產。
複製 www/cordova-2.7.0.js 到新專案中的檔 www 目錄中，並刪除 www/cordova-2.6.0.js 檔。
科爾多瓦的腳本中的引用更新 www/index.html 檔 （以及包含該腳本引用的任何其他檔） 以指向新 cordova-2.7.0.js 檔。
複製 native 到現有專案中，並覆蓋舊從新專案目錄 native 目錄。
複製 lib 到現有專案中，並覆蓋舊從新專案目錄 lib 目錄。
複製 cordova 到現有專案中，並覆蓋舊從新專案目錄 cordova 目錄。
更新 PhoneGap 下載目錄：
建議你下載整個目錄的新副本。
但是，在這裡是零敲碎打更新所需的新零件：
更新中的 cordova.blackberry.js 檔 Phonegap-2.6.0/lib/blackberry/javascript 目錄。
更新 ext ， ext-air ，和 ext-qnx 在 Phonegap-2.6.0/lib/blackberry/framework 目錄。
更新 build.xml 檔在 Phonegap-2.6.0/lib/blackberry 目錄。
更新 Phonegap-2.6.0/lib/blackberry/bin 目錄。
更新 VERSION 檔在 Phonegap-2.6.0/lib/blackberry 目錄。
更新示例 / 目錄或遷移現有的專案：
打開 www 目錄，其中包含該應用程式。
刪除和更新中的.jar 檔 ext/ 目錄。
更新的內容 ext-air/ 目錄。
更新的內容 ext-qnx/ 目錄。
複製新 cordova-2.6.0.js 到您的專案。
更新您的 html 代碼，使用新的 cordova-2.6.0.js 檔。
更新 PhoneGap 下載目錄：
建議你下載整個目錄的新副本。
但是，在這裡是零敲碎打更新所需的新零件：
更新中的 cordova.blackberry.js 檔 Phonegap-2.5.0/lib/blackberry/javascript 目錄。
更新 ext ， ext-air ，和 ext-qnx 在 Phonegap-2.5.0/lib/blackberry/framework 目錄。
更新 build.xml 檔在 Phonegap-2.5.0/lib/blackberry 目錄。
更新 Phonegap-2.5.0/lib/blackberry/bin 目錄。
更新 VERSION 檔在 Phonegap-2.5.0/lib/blackberry 目錄。
更新示例 / 目錄或遷移現有的專案：
打開 www 目錄，其中包含該應用程式。
刪除和更新中的.jar 檔 ext/ 目錄。
更新的內容 ext-air/ 目錄。
更新的內容 ext-qnx/ 目錄。
複製新 cordova-2.5.0.js 到您的專案。
更新您的 html 代碼，使用新的 cordova-2.5.0.js 檔。
更新只是 www 目錄：
打開 www 目錄，其中包含該應用程式。
刪除和更新中的.jar 檔 ext/ 目錄。
更新的內容 ext-air/ 目錄。
複製新 cordova-2.4.0.js 到您的專案。
playbook/ 目錄。qnx/ 目錄。更新您的 html 代碼，使用新的 cordova-2.4.0.js 檔。
更新 （即，更新使用 ant 工具） 的示例目錄：
打開 sample/lib/ 目錄。
更新中的.jar 檔 cordova.2.3.0/ext/ 目錄。
更新的內容 cordova.2.3.0/ext-air/ 目錄。
更新的內容 cordova.2.3.0/ext-qnx/ 目錄。
更新中的.js 檔 cordova.2.3.0/javascript/ 目錄。
打開 sample/lib/ 目錄和重命名 cordova.2.3.0/ 到目錄cordova.2.4.0/.
類型 ant blackberry build 或 ant playbook build 來更新 www 目錄與更新科爾多瓦。
打開 www 目錄和更新您的 html 代碼，使用新的 cordova-2.4.0.js 檔。
更新只是 www 目錄：
打開 www 目錄，其中包含該應用程式。
刪除和更新中的.jar 檔 ext/ 目錄。
更新的內容 ext-air/ 目錄。
複製新 cordova-2.3.0.js 到您的專案。
playbook/ 目錄。qnx/ 目錄。更新您的 html 代碼，使用新的 cordova-2.3.0.js 檔。
更新 （即，更新使用 ant 工具） 的示例目錄：
打開 sample/lib/ 目錄。
更新中的.jar 檔 cordova.2.2.0/ext/ 目錄。
更新的內容 cordova.2.2.0/ext-air/ 目錄。
更新的內容 cordova.2.2.0/ext-qnx/ 目錄。
更新中的.js 檔 cordova.2.2.0/javascript/ 目錄。
打開 sample/lib/ 目錄和重命名 cordova.2.2.0/ 目錄到cordova.2.3.0/.
類型 ant blackberry build 或 ant playbook build 來更新 www 目錄與更新的科爾多瓦。
打開 www 目錄並更新你的 html 代碼，使用新的 cordova-2.3.0.js 檔。
更新只是 www 目錄：
打開 www 目錄，其中包含該應用程式。
刪除和更新中的.jar 檔 ext/ 目錄。
更新的內容 ext-air/ 目錄。
複製新 cordova-2.2.0.js 到您的專案。
playbook/ 目錄。qnx/ 目錄。更新你的 html 代碼，使用新的 cordova-2.2.0.js 檔。
更新 （即，更新使用 ant 工具） 的示例目錄：
打開 sample/lib/ 目錄。
更新中的.jar 檔 cordova.2.1.0/ext/ 目錄。
更新的內容 cordova.2.1.0/ext-air/ 目錄。
更新的內容 cordova.2.1.0/ext-qnx/ 目錄。
更新中的.js 檔 cordova.2.1.0/javascript/ 目錄。
打開 sample/lib/ 目錄和重命名 cordova.2.1.0/ 到目錄cordova.2.2.0/.
類型 ant blackberry build 或 ant playbook build 來更新 www 目錄與更新科爾多瓦。
打開 www 目錄和更新您的 html 代碼，使用新的 cordova-2.2.0.js 檔。
更新只是 www 目錄：
打開 www 目錄，其中包含該應用程式。
刪除和更新中的.jar 檔 ext/ 目錄。
更新的內容 ext-air/ 目錄。
複製新 cordova-2.1.0.js 到您的專案。
playbook/ 目錄。更新您的 html 代碼，使用新的 cordova-2.1.0.js 檔。
更新 （即，更新使用 ant 工具） 的示例目錄：
打開 sample/lib/ 目錄。
更新中的.jar 檔 cordova.2.0.0/ext/ 目錄。
更新的內容 cordova.2.0.0/ext-air/ 目錄。
更新中的.js 檔 cordova.2.0.0/javascript/ 目錄。
打開 sample/lib/ 目錄和重命名 cordova.2.0.0/ 到目錄cordova.2.1.0/.
類型 ant blackberry build 或 ant playbook build 來更新 www 目錄與更新科爾多瓦。
打開 www 目錄和更新您的 html 代碼，使用新的 cordova-2.1.0.js 檔。
更新只是 www 目錄：
打開 www 目錄，其中包含該應用程式。
刪除和更新中的.jar 檔 ext/ 目錄。
更新的內容 ext-air/ 目錄。
複製新 cordova-2.0.0.js 到您的專案。
playbook/ 目錄。更新您的 html 代碼，使用新的 cordova-2.0.0.js 檔。
更新 www/plugins.xml 檔。兩個外掛程式更改其命名空間/服務標籤。更改為的捕獲和連絡人的外掛程式，從舊的條目：
<plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
自：
<plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
更新 （即，更新使用 ant 工具） 的示例目錄：
打開 sample/lib/ 目錄。
更新中的.jar 檔 cordova.1.9.0/ext/ 目錄。
更新的內容 cordova.1.9.0/ext-air/ 目錄。
更新中的.js 檔 cordova.1.9.0/javascript/ 目錄。
打開 sample/lib/ 目錄和重命名 cordova.1.9.0/ 到目錄cordova.2.0.0/.
類型 ant blackberry build 或 ant playbook build 來更新 www 目錄與更新科爾多瓦。
打開 www 目錄和更新您的 html 代碼，使用新的 cordova-2.0.0.js 檔。
打開 www 目錄和更新 plugins.xml 檔。兩個外掛程式更改其命名空間/服務標籤。更改為的捕獲和連絡人的外掛程式，從舊的條目：
<plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
自：
<plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
更新只是 www 目錄：
打開 www 目錄，其中包含該應用程式。
刪除和更新中的.jar 檔 ext/ 目錄。
更新的內容 ext-air/ 目錄。
複製新 cordova-1.8.0.js 到您的專案。
playbook/ 目錄。更新您的 html 代碼，使用新的 cordova-1.8.0.js 檔。
更新 www/plugins.xml 檔。兩個外掛程式更改其命名空間/服務標籤。更改為的捕獲和連絡人的外掛程式，從舊的條目：
<plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
自：
<plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
更新 （即，更新使用 ant 工具） 的示例目錄：
打開 sample/lib/ 目錄。
更新中的.jar 檔 cordova.1.7.0/ext/ 目錄。
更新的內容 cordova.1.7.0/ext-air/ 目錄。
更新中的.js 檔 cordova.1.7.0/javascript/ 目錄。
打開 sample/lib/ 目錄和重命名 cordova.1.7.0/ 到目錄cordova.1.8.0/.
類型 ant blackberry build 或 ant playbook build 來更新 www 目錄與更新科爾多瓦。
打開 www 目錄和更新您的 html 代碼，使用新的 cordova-1.8.0.js 檔。
打開 www 目錄和更新 plugins.xml 檔。兩個外掛程式更改其命名空間/服務標籤。更改為的捕獲和連絡人的外掛程式，從舊的條目：
<plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
自：
<plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>