环境:windows + android
1.安装Cordova CLI
安装cordova命令行工具,通过下面这些步骤:
- 下载和安装Node.js。安装完成后你可以在命令行中使用node 和 npm 。
- (可选)下载和安装git client, 如果你没有。安装成功后,你可以在命令行中使用git。 这个命令行使用下载git仓库中的资源。
- 安装cordova 模块使用Nodejs的npm工具。cordova模块会被npm工具自动下载。
- 在Windows上(-g代表全局安装): npm install -g cordova
2.创建App
跳转到你想要创建源代码的目录中,并创建你的cordova项目:
cordova create hello com.example.hello HelloWorld
3.添加平台
所有后续命令都需要在项目目录或者项目目录的任何子目录运行:
cd hello
给你的App添加目标平台。我们将会添加'android'平台,并确保他们保存在了config.xml中:
cordova platform add android --save
检查你当前平台设置状况:
cordova platform ls
注意:在你使用CLI创建应用的时候, 不要 修改/platforms/目录中的任何文件。当准备构建应用或者重新安装插件时这个目录通常会被重写。
4.安装构建先决条件
要构建和运行App,你需要安装每个你需要平台的SDK。另外,当你使用浏览器开发你可以添加 browser平台,它不需要任何平台SDK。
检测你是否满足构建平台的要求:
cordova requirements
Requirements check results for android:
Java JDK: installed 1.8.0
Android SDK: installed true
Android target: installed android-28
Gradle: installed C:\Program Files\Android\Android Studio\gradle\gradle-5.1.1\bin\gradle
Android平台的要求:http://cordova.axuer.com/docs/zh-cn/latest/guide/platforms/android/index.html
4.1安装Android Studio
Cordova支持Android需要Android SDK,因此我们需要先安装JDK;
当在Windows上安装的时候需要根据JDK路径设置JAVA_HOME环境变量;
首先下载和安装 Android Studio,国内用户可能无法打开官方链接,请自行使用搜索引擎搜索可用的下载链接。安装界面中选择"Custom"选项,确保选中了以下几项:
Android SDK
Android SDK Platform
Performance (Intel ® HAXM) (AMD 处理器在后续需要开启虚拟化)
Android Virtual Device
然后点击"Next"来安装选中的组件。
4.2安装Android SDK
安装完成后,看到欢迎界面时,就可以安装Android SDK了。
- 你可以在 Android Studio 的欢迎界面中找到 SDK Manager。点击"Configure",然后就能看到"SDK Manager"。
- 在 SDK Manager 中选择"SDK Platforms"选项卡,然后在右下角勾选"Show Package Details"。展开Android 9 (Pie)选项,确保勾选了下面这些组件:
Android SDK Platform 28
Intel x86 Atom_64 System Image(官方模拟器镜像文件,使用非官方模拟器不需要安装此组件)
3.然后点击"SDK Tools"选项卡,同样勾中右下角的"Show Package Details"。展开"Android SDK Build-Tools"选项,确保选中了 28.0.3版本。你可以同时安装多个版本。
4.最后点击"Apply"来下载和安装这些组件。
4.3配置 ANDROID_HOME 环境变量
打开控制面板 -> 系统和安全 -> 系统 -> 高级系统设置 -> 高级 -> 环境变量 -> 新建,创建一个名为ANDROID_HOME的环境变量(系统或用户变量均可),指向你的 Android SDK 所在的目录(具体的路径可能和下图不一致,请自行确认):
你可以在 Android Studio 的"Preferences"菜单中查看 SDK 的真实路径,具体是Appearance & Behavior → System Settings → Android SDK。
你需要关闭现有的命令符提示窗口然后重新打开,这样新的环境变量才能生效。
4.4把 platform-tools 目录添加到环境变量 Path 中
打开控制面板 -> 系统和安全 -> 系统 -> 高级系统设置 -> 高级 -> 环境变量,选中Path变量,然后点击编辑。点击新建然后把 platform-tools 目录路径添加进去。
此目录的默认路径为:
c:\Users\你的用户名\AppData\Local\Android\Sdk\platform-tools
5.构建App
默认情况下, cordova create生产基于web应用程序的骨架,项目开始页面位于www/index.html 文件。任何初始化任务应该在www/js/index.js文件中的deviceready事件的事件处理函数中。
运行下面命令为所有添加的平台构建:
$ cordova build
至此,Cordova项目的环境搭建就结束了,构建出的apk就是我们的app。
6.调测运行app
移动平台的SDK通常会绑定模拟器,它是一个可执行的设备镜像,这样你就可以在主屏幕启动你的App,看看它在多个平台是如何交互的。 在命令行运行下面的命令,会重新构建App并可以在特定平台的模拟器上查看:
$ cordova emulate android
或者,你可以将你的手机插入电脑,在手机上直接测试App:
$ cordova run android