cordova开发环境搭建

最近我在尝试了解跨平台技术的发展，首先则是想到了cordova。本文简单记录下cordova环境搭建的过程。

安装cordova

首先是要npm全局安装cordova

npm install -g cordova

创建应用

安装的cordova类似于create-react-app这种脚手架，可以通过命令行直接创建应用

cordova create myapp

添加平台支持

cordova可以支持ios, android, web三端。

cordova platform add ios
cordova platform add android
cordova platform add browser

进入android目录下，可以看到很多.java文件，而ios目录下是很多的object-c文件，browser目录下则是熟悉的web工程。

并且可以看到，每个平台下都有一个cordova目录，我初步猜想，这应该是负责和不同平台通讯交互的cordova核心。

运行App

Web

web端是最直观最简单的，直接运行如下命令即可。

cordova run browser

Android

对于Android和IOS，我们则需要先检查相关环境是否安装正常。

$ cordova requirements

Requirements check results for android:
Java JDK: installed 1.8.0
Android SDK: not installed
Failed to find ‘ANDROID_HOME’ environment variable. Try setting it manually.
Detected ‘adb’ command at C:\Windows\system32 but no ‘platform-tools’ directory found near.
Try reinstall Android SDK or update your PATH to include valid path to SDK\platform-tools directory.
Android target: not installed
android: Command failed with exit code ENOENT Error output:
‘android’ �����ڲ����ⲿ���Ҳ���ǿ����еij���
���������ļ���
Gradle: not installed
Could not find gradle wrapper within Android SDK. Could not find Android SDK directory.
Might need to install Android SDK or set up ‘ANDROID_HOME’ env variable.

Requirements check results for browser:

Requirements check results for ios:
Apple macOS: not installed
Cordova tooling for iOS requires Apple macOS
Some of requirements check failed

可以看到，我的电脑环境并不满足android和ios平台的要求。

首先我们来满足下android平台的环境要求。

JDK

首先是JDK，可以通过java和javac命令来检查下。

C:\>java -version
java version "1.8.0_201"
Java(TM) SE Runtime Environment (build 1.8.0_201-b09)
Java HotSpot(TM) 64-Bit Server VM (build 25.201-b09, mixed mode)

如果没安装，可以参考jdk下载与安装简明教程。

Gradle

Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化构建开源工具。

具体安装过程可以参考gradle环境搭建。

Android SDK

首先我们安装Android Studio。根据安装指引，我们会安装好Android SDK。

在此安装过程中，遇到了一个报错：

Android SDK Tools, SDK Patch Applier v4 and 5 more  SDK components were not installed

感谢这位大佬提供的解决方案，迅速解决了问题，这里顺便记下SDK的安装目录。

C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk

接着我们需要在环境变量-系统变量-Path中新增两项：

C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk\platform-tools
C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk\tools

并且新增一项系统变量ANDROID_HOME，变量值为：

C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk

试运行命令cordova run android，出现了如下警告

$ cordova run android
Checking Java JDK and Android SDK versions
ANDROID_SDK_ROOT=undefined (recommended setting)
ANDROID_HOME=C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk (DEPRECATED)
Starting a Gradle Daemon (subsequent builds will be faster)

于是我又新增了一项系统变量ANDROID_SDK_ROOT，变量值与ANDROID_HOME一样。

重新跑cordova run android命令，首先看到警告如下：

> Configure project :app
Checking the license for package Android SDK Platform 28 in C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk\licenses
Warning: License for package Android SDK Platform 28 not accepted.

上网一查，原来是没有同意相关协议。我们来到C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk\tools\bin目录下运行命令行，输入sdkmanager --licenses，然后就会弹出一堆协议，没办法，无脑输入y同意吧。

再次运行cordova run android，发现了新的报错信息：

No target specified and no devices found, deploying to emulator
No emulator images (avds) found.
1. Download desired System Image by running: "C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk\tools\android.bat" sdk
2. Create an AVD by running: "C:\Users\Jiang.Wenbin\AppData\Local\Android\Sdk\tools\android.bat" avd
HINT: For a faster emulator, use an Intel System Image and install the HAXM device driver

可以看到，是没有找到设备的原因。需要将手机连接到PC，并且打开开发者选项，允许USB调试。再次尝试，已经可以看到界面了。

Plugins

我们来试试调用一些原生API，比如调用原生Dialog， 调用相机等。我们先试下Dialog。

Dialog

首先需要插件：

cordova plugin add cordova-plugin-dialogs

接着我们在deviceready事件之后调用Dialog

document.addEventListener('deviceready', onDeviceReady, false);

function onDeviceReady() {
navigator.notification.alert(
‘欢迎欢迎!’, // message
alertDismissed, // callback
‘试下Dialog’, // title
‘好的’ // buttonName
);
}

function alertDismissed() {
// 点击按钮后的回调
}

调试后发现弹出的中文乱码了，需要在index.html加个meta

<meta charset="UTF-8">

Camera

接着我们试下调用相机，首先也是安装插件：

cordova plugin add cordova-plugin-camera

尝试调用相机拍照，并将得到的照片通过img元素显示出来：

// Application Constructor
initialize: function() {
    const _this = this;
    document.addEventListener('deviceready', this.onDeviceReady.bind(this), false);
    // 点击按钮打开相机
    document.querySelector('#btnOpenCamera').addEventListener('click', function() {
        _this.openCamera()
    })
},
openCamera: function() {
    const cameraOptions = {
        // 默认输出格式为base64
        destinationType: Camera.DestinationType.DATA_URL,
        // 输出png格式
        encodingType: Camera.EncodingType.PNG
    };
navigator.camera.getPicture(cameraSuccess, cameraError, cameraOptions);

<span class="hljs-comment">// 相机拍照成功</span>
<span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">cameraSuccess</span>(<span class="hljs-params">base64Str</span>) </span>{
    <span class="hljs-built_in">console</span>.log(base64Str)
    <span class="hljs-comment">// 给图片元素赋值src</span>
    <span class="hljs-built_in">document</span>.querySelector(<span class="hljs-string">'#captureImg'</span>).src = prefixBase64PNG(base64Str)
}

<span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">cameraError</span>(<span class="hljs-params">err</span>) </span>{
    <span class="hljs-built_in">console</span>.error(err)
}

<span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">prefixBase64PNG</span>(<span class="hljs-params">base64Str</span>) </span>{
    <span class="hljs-keyword">return</span> <span class="hljs-string">'data:image/png;base64,'</span> + base64Str;
}

}

效果如下：