- 文档
- Architectural overview of Cordova platform
- 创建你的第一个App
- Cordova平台支持
- Android平台指南
- Blackberry 10 Guides
- iOS Platform Guide
- OS X 平台指南
- Ubuntu Platform Guide
- Windows Platform Guide
- WP8 Guides
- 平台和插件版本管理
- 自定义app图标(Icon)
- 存储(Storage)
- 隐私指南
- 安全指南
- 白名单指南
- Plugin Development Guide
- Android Plugins
- BlackBerry 10 Plugins
- iOS Plugin Development Guide
- Windows Plugins
- Windows Phone 8 Plugins
- Using Plugman to Manage Plugins
- Embedding WebViews
- Next Steps
- Config.xml
- 事件
- CLI Reference
- Hooks Guide
- Plugin.xml reference documentation
- Battery Status
- Camera
- Console
- Contacts
- Device
- Device Motion
- Device Orientation
- Dialogs
- File
- File Transfer
- Geolocation
- Globalization
- Inappbrowser
- Media
- Media Capture
- Network Information
- Splashscreen
- Vibration
- Statusbar
- Whitelist
- Legacy Whitelist
创建你的第一个App
这个指南像你展示如何创建JS/HTMLCordova应用并发布他们到不同的原生移动平台通过使用cordova
命令行接口(CLI)。Cordova命令行详细参考查看[CLI参考]。
安装Cordova CLI
Cordova命令行工具作为npm包分发。
安装cordova
命令行工具,通过下面这些步骤:
下载和安装Node.js。安装完成后你可以在命令行中使用
node
和npm
。(可选)下载和安装git client, 如果你没有。安装成功后,你可以在命令行中使用
git
。 这个命令行使用下载git仓库中的资源。安装
cordova
模块使用Nodejs的npm
工具。cordova
模块会被npm
工具自动下载。
在OS X和Linux上:
$ sudo npm install -g cordova
在OS X和Linux上,
npm
命令加上前缀sudo
因为cordova
可能需要安装在其他的受限制目录比如/usr/local/share
。如果你使用可选工具nvm/nave或者具有安装目录的写权限,那么你可以省略sudo
前缀。这里有更多提示 可用在使用npm
没有sudo
前缀时,如果你想那么做。在Windows上:
C:\>npm install -g cordova
-g
标志是告诉 npm
我们全局安装 cordova
。否则我们将会安装在当前工作目录的 node_modules
子目录。
安装完成后,你应该能够在命令行中运行cordova
命令,在没有任何参数的时候会打印一些帮助信息。
创建App
跳转到你维护源代码的目录中,并创建你的cordova项目:
$ cordova create hello com.example.hello HelloWorld
这将会为你的cordova应用创造必须的目录。默认情况下,cordova create
命令生成基于web的应用程序的骨骼,项目的主页是 www/index.html
文件。
参看
- Cordova create 命令参考文档
- Cordova项目目录结构
添加平台
所有后续命令都需要在项目目录或者项目目录的任何子目录运行:
$ cd hello
给你的App添加目标平台。我们将会添加'ios'和'android'平台,并确保他们保存在了config.xml
中:
$ cordova platform add ios --save
$ cordova platform add android --save
检查你当前平台设置状况:
$ cordova platform ls
运行add或者remove平台的命令将会影响项目 platforms的内容,在这个目录中每个指定平台都有一个子目录。
注意:在你使用CLI创建应用的时候, 不要 修改
/platforms/
目录中的任何文件。当准备构建应用或者重新安装插件时这个目录通常会被重写。
参见
- Cordova平台命令参考文档
安装构建先决条件
要构建和运行App,你需要安装每个你需要平台的SDK。另外,当你使用浏览器开发你可以添加 browser
平台,它不需要任何平台SDK。
检测你是否满足构建平台的要求:
$ cordova requirements
Requirements check results for android:
Java JDK: installed .
Android SDK: installed
Android target: installed android-19,android-21,android-22,android-23,Google Inc.:Google APIs:19,Google Inc.:Google APIs (x86 System Image):19,Google Inc.:Google APIs:23
Gradle: installed
Requirements check results for ios:
Apple OS X: not installed
Cordova tooling for iOS requires Apple OS X
Error: Some of requirements check failed
参见
- Android平台的要求
- iOS平台的要求
- Windows平台的要求
构建App
默认情况下, cordova create
生产基于web应用程序的骨架,项目开始页面位于www/index.html
文件。任何初始化任务应该在www/js/index.js
文件中的deviceready事件的事件处理函数中。
运行下面命令为所有添加的平台构建:
$ cordova build
你可以在每次构建中选择限制平台范围 - 这个例子中是'ios':
$ cordova build ios
参见
- Cordova build 命令参考文档
测试App
移动平台的SDK通常会绑定模拟器,它是一个可执行的设备镜像,这样你就可以在主屏幕启动你的App,看看它在多个平台是如何交互的。 在命令行运行下面的命令,会重新构建App并可以在特定平台的模拟器上查看:
$ cordova emulate android
伴随着cordova emulate
命令,它会刷新模拟器镜像,用来展示最新的应用程序,现在你可以在主屏幕启动它:
或者,你可以将你的手机插入电脑,在手机上直接测试App:
$ cordova run android
在运行命令之前,你需要设置用于测试的设备,以下是每个平台的流程。
参见
- 设置Android模拟器
- Cordova run 命令参考文档
- Cordova emulate 命令参考文档
添加插件
你可以修改默认生成的App通过标准的web技术,但是App要接触设备级别的特性,就需要你添加插件了。
一个插件 通过JavascriptAPI暴露原生SDK功能。插件通常由npm分发,你可以搜索他们在 插件搜索页。一些关键的API由Apache Cordova开源项目提供并且这些插件是作为[核心插件API]的。你也可以使用CLI启动搜索页:
$ cordova plugin search camera
plugin要添加camera插件,我们需要指定camera的npm包名:
$ cordova plugin add cordova-plugin-camera
Fetching plugin "cordova-plugin-camera@~2.1.0" via npm
Installing "cordova-plugin-camera" for android
Installing "cordova-plugin-camera" for ios
插件也可以通过目录或者git仓库添加。
注意:CLI增加了适合各个平台的插件代码。如果你想伴随着低级别壳工具和平台SDK开发你可以看概述中讨论的, 你需要运行Plugman工具去给每个平台单独添加。 (要知道更多信息, 请看 使用Plugman管理插件.)
使用 plugin ls
(或者 plugin list
, 或者 plugin
自己)查看当前安装的插件。每个插件现实它的标识:
$ cordova plugin ls
cordova-plugin-camera 2.1.0 "Camera"
cordova-plugin-whitelist 1.2.1 "Whitelist"
参见
- Cordova plugin 命令参考文档
- Cordova plugin 搜索页
- [核心插件API]
使用 merges自定义每个平台
虽然Cordova允许你轻松的部署App在各个平台,但是有时我们需要在某些平台做一些自定义。在这种情况下, 你不要想去修改顶级platforms
目录下的www
目录,因为,通常会被顶级 www
目录的跨平台源码替换。
取而代之,顶级merges
目录提供了特定平台部署特定资源的地方。每个特定平台在merges
中的子目录反映了www
源代码树中的结构, 允许你重写和添加文件。例如,这是如何使用merges
来提供Android设备中的默认字体大小。:
编辑
www/index.html
文件,添加link标签来添加额外的css文件,overrides.css
在这种情况下:<link rel="stylesheet" type="text/css" href="css/overrides.css" />
(可选)创建一个空的
www/css/overrides.css
文件,适合所有非Android构建,来防止文件找不到的错误。在
merges/android
里面创建一个css
子目录,然后添加对应的overrides.css
文件。特定的CSS重写www/css/index.css
文件中的12px的默认大小,例子:body { font-size:14px; }
当你重写构建项目,Android具有自定义的字体大小,而其他平台的不变。
你也可以在merges
目录中添加www
目录中不存在的文件。例如,一个应用程序在iOS界面中要包含一个 后退按钮,存储在 merges/ios/img/back_button.png
,而Android版本则可以捕获后退按钮事件通过对应的硬件按钮。
更新Cordova和你的项目
在安装cordova
工具之后,你可以运行下面命令更新到最新版本:
$ sudo npm update -g cordova
用下面语法安装指定版本:
$ sudo npm install -g cordova@3.1.0-0.2.0
运行cordova -v
查看当前版本。要查找最新的cordova版本,可以运行:
$ npm info cordova version
更新完cordova后,更新目标项目的平台:
$ cordova platform update android --save
$ cordova platform update ios --save
...etc.
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论