Skip to content

Cordova - 环境搭建

搭建开发环境是构建 Cordova 应用程序的第一步。这包括安装 Node.js、Cordova CLI 以及您计划构建目标平台的平台专属 SDK(Software Development Kits)。

软件描述
Node.js 和 npmNode.js 是一个 JavaScript 运行时(runtime)。Cordova 使用它来执行其 CLI(命令行界面)和构建(build)过程。npm(Node Package Manager,Node 包管理器)随 Node.js 一起提供,用于安装 Cordova 及其他软件包。从 nodejs.org 下载。
Cordova CLI用于创建、构建和管理 Cordova 项目的命令行工具。通过 npm 安装。

要为特定的移动平台(platforms)开发和构建(build),您需要它们各自的 SDK(Software Development Kits):

平台SDK 及要求
AndroidAndroid SDK。通常随 Android Studio 一起提供。您需要安装 SDK,配置环境变量(environment variables)(例如 ANDROID_HOME 或 ANDROID_SDK_ROOT),并确保 adb 和其他工具位于系统的 PATH 路径中。请参考官方 Android 开发者文档。
iOS(仅限 macOS)Xcode,包含 iOS SDK、命令行工具(command-line tools)和模拟器(simulator)。Xcode 可从 Mac App Store 获取。您可能还需要一些工具,例如 ios-deploy(通过 npm 安装),用于部署(deploying)到设备。

从 nodejs.org 下载并安装 Node.js LTS(长期支持)版本。这将同时安装 npm。

通过打开一个新的终端(terminal)或命令提示符(command prompt)并输入以下命令来验证安装:

node -v
npm -v

这些命令应显示已安装的 Node.js 和 npm 版本。

Cordova 在后台使用 Git 来获取和管理插件(plugins),特别是那些来自 Git URL 的插件。即使您不直接为项目使用 Git,最好也安装它。从 git-scm.com 下载。

确保在安装过程中将 Git 添加到系统的 PATH 路径中。您可以在终端中输入 git --version 来验证。

使用 npm 全局安装 Cordova CLI。打开您的终端(terminal)或命令提示符(command prompt)并运行:

npm install -g cordova

在 macOS 和 Linux 上,如果您遇到权限错误(permission errors),可能需要在命令前加上 sudo:sudo npm install -g cordova。

通过运行以下命令来验证 Cordova 安装:

cordova -v

这应该显示已安装的 Cordova CLI 版本。

按照官方文档安装您想要面向的平台(platforms)的 SDKs:

  • **Android:**安装 Android Studio,然后使用 Android Studio 内的 SDK 管理器(SDK Manager)安装所需的 Android SDK 平台和构建工具(build tools)。设置环境变量(environment variables),例如 ANDROID_HOME(或 ANDROID_SDK_ROOT),并将 platform-tools 和 command-line tools 添加到您的 PATH 路径中。请参阅 Cordova 的 Android 平台指南。
  • **iOS(仅限 macOS):**从 Mac App Store 安装 Xcode。这将安装 iOS SDK 和相关工具。您可能还需要安装命令行工具(command-line tools)(xcode-select --install)以及可能需要安装 ios-deploy(npm install -g ios-deploy)。请参阅 Cordova 的 iOS 平台指南。

安装完所有内容后,您可以检查 Cordova 是否已准备好构建(build)特定平台。导航到 Cordova 项目目录(或者使用 cordova create myApp 创建一个新项目)并运行:

cordova requirements

此命令将检查所有已安装平台所需(platforms)的 SDKs 和工具,并报告任何问题。

环境搭建完成后,您就可以创建您的第一个 Cordova 应用程序了!