Cordova: 仅使用HTML/JS即可制作一个Android或者iOS的App

cordova

Cordova是什么

关于这个问题,还是看看官网是怎么说的吧:

Cordova wraps your HTML/JavaScript app into a native container which can access the device functions of several platforms. These functions are exposed via a unified JavaScript API, allowing you to easily write one set of code to target nearly every phone or tablet on the market today and publish to their app stores.

翻译一下:

Cordova包装你的HTML/JavaScript app到原生app容器中,可以让你访问每个平台设备的功能。这些功能通过统一的JavaScript API提供,让你轻松的编写一组代码运行在几乎市面上的所有手机和平板上,并可以发布到相应的app商城中。

听上去蛮不错的,那么我们就开始用它来做一个app吧!

PS: 因为本人没有Mac设备,所以此次演示仅限在Windows上模拟Android应用,Mac上可类似完成。

搭建环境

如果模拟iOS应用,那么请使用Mac并安装XCode, https://developer.apple.com/xcode/

npm install -g cordova

环境坑一

创建应用

cordova create MyApp

如果按照Cordova(http://cordova.apache.org/)官网所述,直接用npm全局安装cordova,并创建应用,你可能遇到以下错误:

Error: Uncaught, unspecified "error" event. (  Error from Cordova Fetch: Error:
cmd: Command failed with exit code 4294963238 Error output:
npm ERR! not a package C:\Users\Administrator\AppData\Roaming\npm\node_modules\c
ordova\node_modules\.3.12.0@cordova-app-hello-world\index.js
npm ERR! addLocal Could not install C:\Users\Administrator\AppData\Roaming\npm\n
ode_modules\cordova\node_modules\.3.12.0@cordova-app-hello-world\index.js
npm ERR! Windows_NT 6.1.7601
npm ERR! argv "C:\\Program Files\\nodejs\\node.exe" "C:\\Program Files\\nodejs\\
node_modules\\npm\\bin\\npm-cli.js" "install" "C:\\Users\\Administrator\\AppData
\\Roaming\\npm\\node_modules\\cordova\\node_modules\\.3.12.0@cordova-app-hello-w
orld\\index.js"
npm ERR! node v6.10.1
npm ERR! npm  v3.10.10
...

此时不要紧张,卸载cordova,使用yarn重新安装一下,猜测可能和npm版本不兼容。

yarn是facebook出品,功能类似npm的包管理器,可完全替代npm

npm uninstall -g cordova 
npm install -g yarn
yarn config set registry https://registry.npm.taobao.org
yarn global add cordova

环境坑二

安装好yarncordova之后,使用cli命令cordova create MyApp创建project,此时你可能会遇到以下错误:

'cordova' 不是内部或外部命令,也不是可运行的程序或批处理文件。

这是什么原因呢?

原来我们没有将yarn的bin目录加入到环境变量path,作为一个Windows僵尸粉,判断出这点还是不难的。执行以下命令,找到yarn的bin目录所在:

> yarn global bin
d:\Users\gy.wang\AppData\Local\Yarn\bin

d:\Users\gy.wang\AppData\Local\Yarn\bin此目录添加到windows环境变量path

20170907134114.png

配置好环境,重新打开CLI窗口,我们终于可以顺利地创建cordova应用,cordova使用默认模板创建好一个Project。

> cordova create MyApp
Creating a new cordova project.

> tree
├─hooks
├─platforms
├─plugins
├─res
│  ├─icon
│  │  ├─android
│  │  ├─bada
│  │  ├─bada-wac
│  │  ├─blackberry
│  │  ├─blackberry10
│  │  ├─ios
│  │  ├─tizen
│  │  ├─webos
│  │  └─windows-phone
│  └─screen
│      ├─android
│      ├─bada
│      ├─bada-wac
│      ├─blackberry
│      ├─blackberry10
│      ├─ios
│      ├─tizen
│      ├─webos
│      └─windows-phone
└─www
    ├─css
    ├─img
    └─js

在Mac和Linux系统下,环境变量的配置请自行google一下

环境坑三

添加Android平台

d:\cordova-app\MyApp>cordova platform add android
Using cordova-fetch for cordova-android@~6.2.2
Adding android project...
Creating Cordova project for the Android platform:
        Path: platforms\android
        Package: io.cordova.hellocordova
        Name: HelloCordova
        Activity: MainActivity
        Android target: android-25
Subproject Path: CordovaLib
Android project created with cordova-android@6.2.3
Installing "cordova-plugin-whitelist" for android

               This plugin is only applicable for versions of cordova-android greater than 4.0. If you have a previous platform version, you do *not* ne
ed this plugin since the whitelist will be built in.

--save flag or autosave detected
Saving android@~6.2.3 into config.xml file ...

注意这里的 Android target: android-25

在项目根目录下,运行命令cordova build android来编译你的项目,你可能遇到以下错误:

Error: cmd: Command failed with exit code 1 Error output:
FAILURE: Build failed with an exception.

* What went wrong:
A problem occurred configuring root project 'android'.
> You have not accepted the license agreements of the following SDK components:
[Android SDK Platform 25].
Before building your project, you need to accept the license agreements and complete the installation of the missing components using the Android Studio SDK Mana
ger.
Alternatively, to learn how to transfer the license agreements from one workstation to another, go to http://d.android.com/r/studio-ui/export-licenses.html

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.

原因是啥呢?当前cordova要求的Android版本比较高,需要安装Android SDK Platform 25才能顺利编译,怎么办? 装!

打开Android Studio, 安装SDK

20170907141602.png

安装成功之后,执行命令cordova build android,这次终于成功了!

......
BUILD SUCCESSFUL

Total time: 1 mins 28.925 secs
Built the following apk(s):
        D:/cordova-app/MyApp/platforms/android/build/outputs/apk/android-debug.apk

APK包成功打好,这次我们运行一下,执行命令:

cordova run android

这次我们会遇到环境坑四

环境坑四

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

不急,仔细看报错信息的意思是没有可用的设备或模拟器。这个简单,打开Android Studio添加一个:

20170907145702.png

再次运行cordova run android, 哈! 这次成功了!

Total time: 2.737 secs
Built the following apk(s):
        D:/cordova-app/MyApp/platforms/android/build/outputs/apk/android-debug.apk
ANDROID_HOME=d:\Users\gy.wang\AppData\Local\Android\sdk
JAVA_HOME=C:\Program Files\Java\jdk1.8.0
No target specified and no devices found, deploying to emulator
Skipping build...
Built the following apk(s):
        D:/cordova-app/MyApp/platforms/android/build/outputs/apk/android-debug.apk
Using apk: D:/cordova-app/MyApp/platforms/android/build/outputs/apk/android-debug.apk
Package name: io.cordova.hellocordova
INSTALL SUCCESS
LAUNCH SUCCESS

环境坑五

什么!闪退!WTF!

运行命令cordova run android,将APK包安装到模拟器上结果又报错了!

20170907170538.png

离成功就差一步了,别泄气!我们慢慢查找原因~

  • step-1, 查看cordova所使用的android版本

    "android": "6.2.3"
    

    对应 Android SDK Platform 25

  • step-2, 查看模拟器使用的android版本

    "android": "6.0"
    

    对应 Android SDK Platform 23

20170907175129.png
  • step-3, 分析:模拟器上的Android版本低于cordova打包时用的Android版本,相应的SDK版本也要低

    此时怎么办呢?

    • Plan A: 降版本!删除原有cordova默认下载的android版本,然后安装和模拟器上一样的android版本。
    • Plan B: 升版本!通过Android Studio将模拟器升级到最新的版本
    • Plan C: 用真机来调试!
  • step-4, 我是通过 Plan C解决了上述问题

20170907212728.jpg

至此,APP终于搞定了!

总结

  • 本篇仅仅展示了如何利用Cordova制作一个Android App, 其实我们还可以利用Cordova制作H5应用,chrome应用等等,它们更加简单,有兴趣的同学可以自己尝试。
  • Cordova是前端人员走近APP世界的一条捷径,相比React Native,它更容易上手,因为说到底,它还是运行在浏览器中的,我们不需要深入了解原生API,我们只需写好HTML/CSS/JS即可。
  • 有人说它性能不好,我想说,这事得分场景看,除了游戏类的应用,绝大多数应用都不需要太高的性能,随着前端技术的发展,差距会越来越小,因此,我非常看好它的前景。
  • 作为一个独立开发者或者一个创业团队使用Cordova去完成一个APP,无疑是一个非常好的选择。
  • Cordova: 跨平台,一次编写,多处运行。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,425评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,058评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,186评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,848评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,249评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,554评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,830评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,536评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,239评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,505评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,004评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,346评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,999评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,060评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,821评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,574评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,480评论 2 267

推荐阅读更多精彩内容