npm 包 gulp-cordova-builder 使用教程

阅读时长 9 分钟读完

前言

随着移动端应用的快速发展,开发者们也不得不追逐时代的步伐,采用前沿的技术进行应用的开发。针对 Cordova 应用开发者们,gulp-cordova-builder 包的出现无疑是一件利好消息。本文将介绍该 npm 包的使用教程。

gulp-cordova-builder 的概述

gulp-cordova-builder 是一个用于构建 Cordova 应用的 gulp 插件。它提供了一系列的任务,可以自动化执行构建 Cordova 应用的流程。包括生成 apk、ipa 文件、修改应用图标、签名发布等。这个插件,一定程度上减轻了 Cordova 应用开发者的压力,减少了人为操作因素造成的误差。

安装

该插件可以通过 npm 进行安装,只需要在命令行执行下面的命令:

任务

gulp-cordova-builder 插件共包含了 8 个任务,这些任务都符合 gulp 的基本使用方法和任务模块的要求。

根据参数生成 apk 文件

该任务通过执行 cordova build android (注意如果没有使用 -c 则会向开发模式构建,线上使用 ),调用 Cordova 命令行工具自动构建 apk 文件。

-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - --------------------------------

-------------------------- -- -- -
  ------ ----------------------
    ----------------------
      --------- ----------
      -------- ---------
      ----- -----------
    ---
    --------------------------
---

根据参数生成 ipa 文件

该任务通过执行 cordova build ios (会构建 ipa 文件 ),调用 Cordova 命令行工具自动构建 ipa 文件。

-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - --------------------------------

---------------------- -- -- -
  ------ ----------------------
    ----------------------
      --------- ------
      -------- ---------
      ----- -----------
    ---
    --------------------------
---

根据参数打包 Cordova 应用

该任务通过执行 cordova build/prepare (会生成 www 文件夹 ,然后用 www 文件夹重构 cordova 工程 ),调用 Cordova 命令行工具自动构建 Cordova 应用。

-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - --------------------------------

-------------------------- -- -- -
  ------ ----------------------
    ----------------------
      --------- --------------
      -------- ---------
      ----- -----------
    ---
    ---------------------------
---

替换 Cordova 应用图标

该任务用于替换 Cordova 应用的图标。

-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - --------------------------------

----------------- -- -- -
  ------ --------------------------
    ----------------------
      ------- -------
      ----- -----------
    ----
---

为 Cordova 应用签名并生成 apk 文件

该任务为 Cordova 应用签名,并生成 apk 文件。

-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - --------------------------------

----------------------- -- -- -
  ------ ----------------------
    ----------------------
      --------- ----------
      -------- ---------
      --------------- ---------------
      ------------------ ------------------
      -------------- --------------------------------
      ----------- -----
      ----- -----------
    ---
    ---------------------------
---

为 Cordova 应用签名并生成 ipa 文件

该任务为 Cordova 应用签名,并生成 ipa 文件。

-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - --------------------------------

----------------------- -- -- -
  ------ ----------------------
    ----------------------
      --------- ------
      -------- ---------
      --------------- ---------------------------------------------
      --------- ------- ------------- --------- ---- ------
      ----------- -----
      ----- -----------
    ---
    ---------------------------
---

根据参数打包 Cordova 应用并签名

该任务通过执行 cordova build (该命令会构建平台,然后签名)并进行签名,以此来生成 Cordova 应用。注意:该任务需要配置签名证书信息。

-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - --------------------------------

----------------------- -- -- -
  ------ ----------------------
    ----------------------
      --------- --------------
      -------- ---------
      --------------- ---------------
      ------------------ ------------------
      -------------- --------------------------------
      --------------- ---------------------------------------------
      --------- ------- ------------- --------- ---- ------
      ----- -----------
    ---
    ---------------------------
---

为 Cordova 应用添加插件

该任务用于为 Cordova 应用添加插件。

-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - --------------------------------

------------------------ -- -- -
  ------ -------------------------
    ----------------------
      ------- ------
      ------- ----------------
      ----- -----------
    ----
---

参数

gulp-cordova-builder 包中的这些任务,都可以在参数中设置自己要的选项。每个任务的参数详细说明如下:

  • platform: 执行命令的平台。可以为:'ios', 'android', 'browser', 'blackberry10', 'wp8', 'firefoxos', 'ubuntu', 'amazon-fireos'。多个平台使用逗号分隔(例如 'ios,android')。
  • version: 选择某个平台的版本。例如 Cordova 版本为 10.0.0
  • keystore_alias: 指定签名的 alias。
  • keystore_password: 指定签名的密码。
  • keystore_path: 指定签名的路径。
  • provision_file: 用于签名 ipa 文件的配置文件。
  • identity: 用于签名 ipa 文件的证书标识符。
  • signed_apk: 是否签名 apk 文件。默认为 false
  • signed_ipa: 是否签名 ipa 文件。默认为 false
  • path: 用于指定 Cordova 应用的路径。默认为 ./cordova
  • action: 用于指定操作类型。可以为:'add', 'rm', 'list', 'icon', 'splash'
  • plugin: 用于指定插件名称。

结尾

我们通过本文详细讲解了 gulp-cordova-builder 的使用教程,现在你已经掌握了该插件的基础知识和使用方法。未来,在您的 Cordova 应用开发过程中,该插件将成为您不可或缺的重要工具。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005539681e8991b448d0caf

纠错
反馈