Skip to content

Latest commit

 

History

History
178 lines (127 loc) · 5.54 KB

cordova.md

File metadata and controls

178 lines (127 loc) · 5.54 KB

Cordova

为 Web 提供与原生交互的能力

文件/文件夹说明

目录

  • config.xml 是一些跨平台的通用配置
  • merges/ 不同平台要分开处理时,在这里分平台写代码
  • platforms/<platform>/platform_www/ 平台相关的 Web 内容
  • platforms/<platform>/www 自定义的 Web 内容 + platform_www/ 中的内容

开发方式

  1. Cross-platform(CLI) workflow : CLI是一个High-Level的工具,可以允许你在多个平台上只建立一次工程。
  2. Platform-centered workflow : 以Native为中心,使用WebView的形式嵌入。

Cross-platform (CLI) workflow

参考 Create your first Cordova app

npm install -g cordova
# cordova create <PATH> [ID [NAME [CONFIG]]] [options]
ordova create hello com.example.hello HelloWorld
cd hello
cordova platform add ios --save
cordova platform add android@6.2 --save # 6.2 以下的有 Bug
cordova platform add browser --save
cordova platform ls
# 拷贝相应文件到各个平台
cordova prepare
# 检查依赖
cordova requirements
# 编译
cordova compile

安装插件

cordova plugin add cordova-plugin-device --save

编译、运行 建议在各个平台用对应 IDE 完成

Android

# 拷贝 local.properties 到 Android 平台
cp local.properties ./
# 安装全局 gradle
sdk install gradle
# 安装当前工程的 wrapper
gradle wrapper
# 安装当前工程对应版的 gradle,并编译
./gradlew

iOS

Platform-centered workflow

iOS 集成

PhoneGap 文档写的比较详细,请参考 Embedding the Webview - iOS

方法一

1. 创建原生工程;pod 引入 Cordova
2. 使用Cordova-CLI创建Cordova工程;
3. 从“Cordova工程”的“原生平台工程”中,提取需要的文件,主要是以下几部分:
    config.xml
    ios.json 或 android.json
    platform_www 文件夹
    插件的原生部分代码
4. 加入到之前创建的原生工程中。

方法二

1. 创建原生工程;pod 引入 Cordova 和 plugins
2. 使用Cordova-CLI创建Cordova工程;
3. Cordova工程写代码
3. 从“Cordova工程”的“原生平台工程”中,拷贝 www 到原生工程中。

方法三 plugman 管理插件

安装 cordova 插件

plugman install --platform ios --project . --plugin cordova-plugin-device

Android 集成

PhoneGap 文档写的比较详细,请参考 Embedding the Webview - Android

Android Studio 安装 cordova 插件 PhoneGap/Cordova Plugin

安装 cordova 插件

plugman install --platform android --project . --plugin cordova-plugin-device

使用

  1. 创建工程
  2. 在工程根目录下的 www 目录下写代码
  3. cordova prepare wwwplugins 目录下文件会编译到 platforms
  4. cordova compile <platform> 编译 platforms 下对应平台
  5. cordova run <platform> 指定平台运行

其它

  • build -> cordova prepare && cordova compile
  • emulate -> cordova run --emulator
  • 不要直接改 platforms/ 下的文件,因为 prepare 的时候会被覆盖

Android 使用 X5 内核

插件

写插件

  • 创建插件工程
  • cordova plugin add --link ../cordova-plugin-example
  • 运行对应 platform 工程