1. Cordova

官网
官方文档
cordova-tutorial
cordova-plugman platform-centered workflow 方式开发时的 Cordova 插件管理工具

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

Cordova

1.1. 文件/文件夹说明

Directory structure 各目录作用
Cordova那些事儿（一）——Cordova相关目录结构

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

1.2. 开发方式

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

1.2.1. 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

Android Platform Guide

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

iOS

iOS Platform Guide

1.2.2. Platform-centered workflow

Embedding WebViews

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 集成

Android WebViews

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

Android Studio 安装 cordova 插件 PhoneGap/Cordova Plugin

安装 cordova 插件

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

1.3. 使用

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

其它

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

1.3.1. Android 使用 X5 内核

offbye/cordova-plugin-x5engine-webview

1.4. 插件

Plugin Development Guide

1.4.1. 写插件

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

Cordova