PhoneGap 命令列介面

转载 2013年12月03日 11:43:07

命令列介面

本指南演示如何創建應用程式並將它們部署到各種本機移動平臺,使用 cordova 命令列介面 (CLI)。 此工具允許您創建新專案、 建立他們在不同平臺上,和在模擬器中運行它們。 此外可以使用 CLI 來初始化後,您使用各種平臺 Sdk 來進一步發展他們的專案代碼。

系統必備元件

在運行任何命令列工具之前, 您需要為每個您想要的目標的平臺安裝 Sdk。(參見平臺指南更多詳細資訊。

若要添加支援或重建任何平臺的一個專案,您需要從支援的平臺 SDK 的同一台電腦上運行命令列介面。CLI 支援以下組合:

  • iOS (Mac)
  • Android (Mac、 Linux)
  • 黑莓 10 (Mac、 Linux、 Windows)
  • Windows Phone 7 (Windows)
  • Windows Phone 8 (Windows)
  • Windows 8 (Windows)
  • 火狐瀏覽器作業系統 (Mac、 Linux、 Windows)

在 Mac 上,命令列是可通過終端應用的。在 PC 上,它是可作為命令提示符配件.

就越有可能是你在 CLI 運行從不同的機器,更加意義保持遠端原始程式碼儲存庫,你拉下到本地工作目錄的資產。

若要安裝 cordova 命令列工具,請按照這些步驟操作:

  1. 下載並安裝Node.js。安裝完成後,您應該能夠調用 nodenpm 在命令列上。

  2. 安裝 cordova 實用程式。在 Unix 中,首碼的額外 sudo 命令可能需要安裝開發實用程式中以其他方式限制目錄:

    $ sudo npm install -g cordova
    

    安裝日誌可能會產生錯誤的任何已卸載平臺 Sdk。安裝完成後,您應該能夠運行 cordova 命令列上。

創建應用程式

轉至目錄位置您維護您的原始程式碼,並運行以下命令:

    $ cordova create hello com.example.hello HelloWorld

它可能需要一些時間完成的命令,有耐心。運行 cordova -d ,請參閱有關進展的資訊。

第一個參數指定要為您的專案生成的你好目錄。 其 www 子目錄的房子您應用程式的主頁上,與各種資源下 cssjs ,和 img ,其中遵循共同 web 發展的命名約定。 config.xml檔包含生成和分發應用程式所需的重要的中繼資料

其他的兩個參數都是可選的: com.example.hello 參數提供您的專案具有反向域樣式識別碼和 HelloWorld 提供了應用程式的顯示文本。 您可以編輯這兩以後這些值在 config.xml

添加平臺

後面的所有命令都需要在專案的目錄或在其範圍內的任何子目錄內運行:

    $ cd hello

您可以生成專案之前,您需要指定一組的目標平臺。 您運行這些命令的能力取決於您的電腦是否支援每個 SDK,是否你已經安裝每個 SDK。 運行任何這些從 Mac:

    $ cordova platform add ios
    $ cordova platform add android
    $ cordova platform add blackberry10
    $ cordova platform add firefoxos

運行的這些 Windows 機器上,從任何地方wp指的是不同版本的 Windows Phone 作業系統:

    $ cordova platform add wp7
    $ cordova platform add wp8
    $ cordova platform add windows8
    $ cordova platform add android
    $ cordova platform add blackberry10
    $ cordova platform add firefoxos

運行此檢查當前設置的平臺:

    $ cordova platforms ls

(請注意 platformplatforms 命令是同義語.)

請運行下列同義命令來刪除一個平臺之一:

    $ cordova platform remove blackberry10
    $ cordova platform rm android

運行命令來添加或刪除平臺影響專案的平臺目錄的內容每個指定的平臺作為一個子目錄中的顯示位置Www原始目錄轉載內每個平臺的子目錄中,例如出現在 platforms/ios/wwwplatforms/android/assets/www 。 預設情況下,每個平台佈建設置,以便能夠訪問所有的科爾多瓦的 Api。

如果您願意,您可以使用 SDK 在此時打開你創建的專案。 但是,所做的任何編輯你到內 SDK 影響衍生專案設置的資產,不是原始的跨平臺原始程式碼。 如果你只是想要初始化一個專案,請使用此方法。 (見如何開發應用程式內每個 SDK 平臺指南的資訊)如果您想使用命令列工具的整個開發週期,請繼續閱讀。

構建應用程式

預設情況下, cordova create 腳本生成骨骼肌的以基於 web 的應用,其主頁是該專案的 www/index.html 。 編輯此應用程式,但是你想要但應作為的一部分指定的任何初始化 deviceready 事件處理常式中,從預設的引用 www/js/index.js

運行以下命令以反覆運算方式生成專案:

    $ cordova build

這將生成特定于平臺代碼內專案的 platforms 子目錄。你可以選擇限制到特定的平臺每個生成的範圍:

    $ cordova build ios

cordova build命令是以下,而在此示例中還針對的是一個單一的平臺的簡寫形式:

    $ cordova prepare ios
    $ cordova compile ios

在這種情況下,一次您運行 prepare ,你可以作為備用使用蘋果公司的 Xcode SDK 修改和編譯科爾多瓦在範圍內生成的特定于平臺代碼 platforms/ios 。 您可以使用相同的方法與其他平臺的 Sdk。

測試模擬器或設備上的應用程式

移動平臺 Sdk 經常與捆綁在一起執行設備的圖像,以便您可以啟動該應用程式從主畫面並看看它如何與許多平臺功能交互的模擬程式。 運行如下命令來重新生成應用程式並查看它在特定的平臺模擬器內:

    $ cordova emulate android

一些移動平臺類比特定設備預設情況下,iPhone 的 iOS 專案等。 對於其他平臺,您可能需要首先將設備模擬程式與相關聯。 (見平臺指南的詳細資訊)。例如,您可能會首先運行 android 命令以啟動 Android SDK,然後運行一個特定的設備圖像,啟動它根據其預設行為:

跟進與 cordova emulate 命令刷新顯示的最新應用,現已從主畫面發射的模擬程式圖像:

或者,可以將手機插入您的電腦和直接測試應用程式:

    $ cordova run android

在運行此命令之前, 您需要設置的設備進行測試,之後會發生變化,為每個平臺的程式。 在 Android 的情況下,你將必須啟用設備上的USB 調試的選項和或許添加 USB 驅動程式根據您發展導讀工作。 每個平臺的要求的詳細資訊,請參閱平臺指南

添加功能

生成和查看一個新專案時,將顯示預設的應用程式不會很多。 您可以修改該應用程式在許多方面,利用標準的 web 技術,但應用程式緊密的聯繫,與各種設備級功能,您需要添加外掛程式,提供對核心科爾多瓦 Api 的訪問。

外掛程式是有點的載入項代碼的提供的本機組件的介面。 您可以設計您自己的外掛程式介面,例如,設計一個混合應用程式,與本機組件混合科爾多瓦 web 視圖時。 (請參閱嵌入 WebViews 和外掛程式開發指南的詳細資訊。更常見的是,您將添加外掛程式,使科爾多瓦的基本設備級功能之一 XREF 詳細的 API Reference 中。

cordova plugin add命令需要您指定的外掛程式代碼的存儲庫。以下是您可能會添加的功能的示例:

  • 基本設備資訊 (設備 API):

    $ cordova plugin add org.apache.cordova.device
    
  • 網路連接和電池事件

    $ cordova plugin add org.apache.cordova.network-information
    $ cordova plugin add org.apache.cordova.battery-status
    
  • 加速度計、 指南針、 和地理定位

    $ cordova plugin add org.apache.cordova.device-motion
    $ cordova plugin add org.apache.cordova.device-orientation
    $ cordova plugin add org.apache.cordova.geolocation
    
  • 相機、 媒體重播和捕獲

    $ cordova plugin add org.apache.cordova.camera
    $ cordova plugin add org.apache.cordova.media-capture
    $ cordova plugin add org.apache.cordova.media
    
  • 訪問設備或網路 ( API) 上的

    $ cordova plugin add org.apache.cordova.file
    $ cordova plugin add org.apache.cordova.file-transfer
    
  • 通過對話方塊或振動發出通知

    $ cordova plugin add org.apache.cordova.dialogs
    $ cordova plugin add org.apache.cordova.vibration
    
  • 連絡人

    $ cordova plugin add org.apache.cordova.contacts
    
  • 全球化

    $ cordova plugin add org.apache.cordova.globalization
    
  • 閃屏

    $ cordova plugin add org.apache.cordova.splashscreen
    
  • 打開新的瀏覽器視窗 (InAppBrowser):

    $ cordova plugin add org.apache.cordova.inappbrowser
    
  • 調試主控台:

    $ cordova plugin add org.apache.cordova.console
    

使用 plugin ls (或 plugin list ,或 plugin 本身) 查看當前已安裝的外掛程式。每個顯示由其識別碼:

    $ cordova plugin ls    # or 'plugin list'
    [ 'org.apache.cordova.console' ]

若要刪除某個外掛程式,它通過引用相同的識別碼出現在該清單中。例如,這裡是你會怎麼移除調試主控台支援從一個發佈版本:

    $ cordova plugin rm org.apache.cordova.console        
    $ cordova plugin remove org.apache.cordova.console    # same

你可以大量刪除或添加的外掛程式通過指定多個參數的每個命令。

自訂每個平臺

而科爾多瓦允許您輕鬆地部署許多不同平臺的應用程式,有時需要添加自訂項。 在這種情況下,你不想修改中各項的原始程式碼 www 內的頂級目錄 platforms 目錄,,因為他們定期更換與頂級 www 目錄的跨平臺源。

相反,頂級 merges 目錄提供了一個指定資產在特定平臺上部署的地方。 每個特定于平臺的子目錄內 merges 鏡像的目錄結構的 www 源樹中,從而允許您重寫或根據需要添加的。 例如,在這裡是如何你可能會使用 merges 來提振的 Android 設備的預設字型大小:

  • 編輯 www/index.html ,添加一個連結到一個額外的 CSS 檔,該 overrides.css 在這種情況下:

    <link rel="stylesheet" type="text/css" href="css/overrides.css" />
    
  • (可選) 創建一個空的 www/css/overrides.css ,將適用于所有非 Android 生成,防止丟失錯誤。

  • 創建 css 中的子目錄 merges/android ,然後添加相應的 overrides.css 。 指定將覆蓋 12 點預設的字體大小範圍內指定的 CSS www/css/index.css ,例如:

    body { font-size:14px; }
    

當你重新生成專案時,Android 版本功能自訂字體大小,而其他人保持不變。

您還可以使用 merges 添加中原物不存在的 www 目錄。 例如,一個應用程式可以納入後退按鈕圖形的 iOS 介面,存儲merges/ios/img/back_button.png ,而 Android 版本可以改為捕獲 backbutton 從相應的硬體按鈕的事件

更新科爾多瓦

安裝後 cordova 實用程式,您可以始終進行更新到最新版本通過運行以下命令:

    $ sudo npm update -g cordova

使用此語法來安裝特定的版本:

    $ sudo 故宮安裝-g cordova@3.1.0

運行 cordova -v ,查看當前運行的版本。 運行 npminfo 命令長清單,其中包含當前版本以及其他可用的版本號:

    $ npm info cordova

科爾多瓦 3.0 是要支援這一節中描述的命令列介面的第一個版本。 如果您正在從 3.0 以前的版本更新,您需要創建一個新專案,如以上所述,然後將舊應用程式的資源複製到頂級 www 目錄。 在適用的情況,進一步有關升級到 3.0 的詳細資訊是可用的平臺指南中。 一旦你升級到 cordova命令列介面和使用 npm update 待當前,那裡所描述的更耗時過程不再相關。

相关文章推荐

设定网路介面命令--ifconfig(包含txqueuelen参数说明)

一. ifconfig 指令.      ifconfig 指令用来设定网路介面, 并可查询目前网路介面的设定情形.      语法:      1. ifconfig [介面]  ...

PhoneGap2.X及3.X项目工程命令行创建方法(Android)

PhoneGap2.X及3.X项目工程命令行创建方法(Android)        由于2.X和3.X的版本有所不同,特别是在插件的架构方面,有很大的不同,所以在命令行的创建方式上也所有不同。最大的...

phonegap3.0 本地android 环境命令配置

继续上篇,因为phonegap官网文档没有详细说明,由于学业压力,只能搞下blackberry和android平台了,android平台搭建首先是jdk ,adt(就是谷歌帮你弄好的,不需要eclip...

前端学习总结(十一)Cordova(Phonegap)常用命令与基础

一 常用的Cordova命令1.创建新项目cordova create 项目文件夹所在目录 包名(项目的唯一标示) 项目名(即入口类) 如:cordova create /users/chenhaoa...

phonegap3.0 本地blackberry(bb10) 环境命令配置

就上次再说,首先下载SDK,黑莓的NDK,http://developer.blackberry.com/安装好NDK,其实就是个eclipse,更器其sdk。不熟悉命令的请先看phonegap的命令...

PhoneGap 2.0.0安装,命令行构建,编译BlackBerry项目,并部署到手机上

Q: 问什么命令行编译啊,不online编译,不用Ripple编译?A:  PhoneGap 2.0.0版本在2012.07.20发布,build.phonegap.com目前只支持到1.9.0,Ri...

建置一個 WINCE 下的 XML BASE 的人機介面引擎 ---- 繪圖引擎篇 (1)

本BLOG所有原創之原始程式碼皆為本人創作,非經本人同意不得轉載,非經本人授權不得使用在營利用途 前言 由於我本身的工作一直和寫引擎級的程式有不解之緣,每至一家公司在離開之前 至少都會留下一套引...

links lynx linux 字符介面网页浏览

转自 : 鳥哥的Linux 私房菜 什么? 文字界面竟然有浏览器! 别逗了好不好? 呵呵! 谁有那个时间在逗你呦! 真的啦! 有这个东西, 是在文字界面下上网浏览的好工具! 分别是link...

深刻解析 Android 的 AIDL 介面

深刻解析 Android 的 AIDL 介面 在Android應用框架裡,應用層級的軟體大多是Java類別,而系統層級的軟體大多是C或 C++類別。Android使用JNI介面來達成這個目標。例...
  • myspor
  • myspor
  • 2011年03月30日 19:17
  • 573

NI推出Single-BoardRIO嵌入式介面卡

NI美商国家仪器发表新的4款NISingle-BoardRIO机板层级嵌入式介面卡,搭载1组Real-Time处理器、Spartan-6FPGA、类比与数位I/O,同时内建更多周边设备,适合客制化的嵌...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:PhoneGap 命令列介面
举报原因:
原因补充:

(最多只允许输入30个字)