cordova开发环境搭建

cordova开发环境搭建

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

安装cordova

首先是要npm全局安装cordova

1
npm install -g cordova

创建应用

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

1
cordova create myapp

添加平台支持

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

1
2
3
cordova platform add ios
cordova platform add android
cordova platform add browser

cordova platforms

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

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

运行App

Web

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

1
cordova run browser

Android

对于AndroidIOS,我们则需要先检查相关环境是否安装正常。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
$ 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

可以看到,我的电脑环境并不满足androidios平台的要求。

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

JDK

首先是JDK,可以通过javajavac命令来检查下。

1
2
3
4
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

在此安装过程中,遇到了一个报错:

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

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

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

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

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

并且新增一项系统变量ANDROID_HOME,变量值为:

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

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

1
2
3
4
5
$ 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命令,首先看到警告如下:

1
2
3
> 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,发现了新的报错信息:

1
2
3
4
5
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调试。再次尝试,已经可以看到界面了。

cordova app界面

Plugins

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

Dialog

首先需要插件:

1
cordova plugin add cordova-plugin-dialogs

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
document.addEventListener('deviceready', onDeviceReady, false);

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

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

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

1
<meta charset="UTF-8">

cordova_dialog

Camera

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

1
cordova plugin add cordova-plugin-camera

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// 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);

// 相机拍照成功
function cameraSuccess(base64Str) {
console.log(base64Str)
// 给图片元素赋值src
document.querySelector('#captureImg').src = prefixBase64PNG(base64Str)
}

function cameraError(err) {
console.error(err)
}

function prefixBase64PNG(base64Str) {
return 'data:image/png;base64,' + base64Str;
}
}

效果如下:

cordova_camera

IOS

还没钱买IOS设备,尴尬。。。


扫一扫下方小程序码或搜索Tusi博客,即刻阅读最新文章!

Tusi博客

评论

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×