将 MobileFirst Foundation SDK 添加到 Cordova 应用程序

概述

在此教程中，了解如何将 MobileFirst SDK 添加到新的或现有的使用 Apache Cordova、Ionic 或其他第三方工具创建的 Cordova 应用程序。您还可以了解如何配置 MobileFirst Server 以识别应用程序，以及查找有关在项目中更改的 MobileFirst 配置文件的信息。

MobileFirst Cordova SDK 作为一组 Cordova 插件提供，并且在 NPM 上注册。
可用插件包括：

• cordova-plugin-mfp - 核心 SDK 插件
• cordova-plugin-mfp-push - 提供推送通知支持
• cordova-plugin-mfp-jsonstore - 提供 JSONStore 支持
• cordova-plugin-mfp-fips - 仅限 Android。提供 FIPS 支持
• cordova-plugin-mfp-encrypt-utils - 仅限 iOS。提供加密和解密支持

支持级别

MobileFirst 插件支持的 Cordova 平台版本包括：

• cordova-ios：>= 4.1.1 以及 < 5.0
• cordova-android：>= 6.1.2 以及 < 7.0
• cordova-windows：>= 4.3.2 以及 < 6.0

跳转至：

• Cordova SDK 组件
• 添加 MobileFirst Cordova SDK
• 更新 MobileFirst Cordova SDK
• 已生成 MobileFirst Cordova SDK 工件
• 接下来要学习的教程

注：使用 Xcode 8 的情况下在 iOS Simulator 中运行 iOS 应用程序时，密钥链共享功能是必需的。必须在构建 Xcode 项目之前手动启用此功能。

Cordova SDK 组件

cordova-plugin-mfp

cordova-plugin-mfp 插件是针对 Cordova 的核心 MobileFirst 插件，且此插件是必需的。如果安装任何其他 MobileFirst 插件，并且 cordova-plugin-mfp 插件尚未安装，那么也将自动安装此插件。

以下 Cordova 插件将作为 cordova-plugin-mfp 的依赖项进行安装：

• cordova-plugin-device
• cordova-plugin-dialogs
• cordova-plugin-globalization
• cordova-plugin-okhttp

cordova-plugin-mfp-jsonstore

cordova-plugin-mfp-jsonstore 插件使您的应用程序能够使用 JSONstore。有关 JSONstore 的更多信息，请参阅 JSONStore 教程。

cordova-plugin-mfp-push

cordova-plugin-mfp-push 插件提供必需的许可权，以对 Android 应用程序使用来自 MobileFirst Server 的推送通知。必需其他设置以使用推送通知。有关推送通知的更多信息，请参阅推送通知教程。

cordova-plugin-mfp-fips

cordova-plugin-mfp-fips 插件为 Android 平台提供 FIPS 140-2 支持。有关更多信息，请参阅 FIPS 140-2 支持。

cordova-plugin-mfp-encrypt-utils

cordova-plugin-mfp-encrypt-utils 插件为使用 iOS 平台的 Cordova 应用程序提供用于加密的 iOS OpenSSL 框架。有关更多信息，请参阅为 Cordova iOS 启用 OpenSSL。

先决条件：

• Apache Cordova CLI 6.x 和 MobileFirst CLI 已安装在开发人员工作站上。
• MobileFirst Server 的本地或远程实例正在运行。
• 阅读设置您的 MobileFirst 开发环境和设置您的 Cordova 开发环境教程。

添加 Mobile Foundation Cordova SDK

遵循下面的指示信息将 Mobile Foundation Cordova SDK 添加到新的或现有的 Cordova 项目，然后在 MobileFirst Server 中进行注册。

在您开始之前，确保 MobileFirst Server 正在运行。
如果使用本地安装的服务器：从命令行窗口，浏览至服务器的文件夹，然后运行命令：./run.sh。

注：如果要将 SDK 添加到现有的 Cordova 应用程序，那么插件将覆盖 MainActivity.java 文件（针对 Android）和 Main.m 文件（针对 iOS）。

添加 SDK

考虑使用 MobileFirst Cordova 应用程序模板创建项目。此模板会将必需的特定于 MobileFirst 的插件条目添加到 Cordova 项目的 config.xml 文件，并提供特定于 MobileFirst 并针对 MobileFirst 应用程序开发进行了调整的现成可用的 index.js 文件。

新建应用程序

1. 创建 Cordova 项目：cordova create projectName applicationId applicationName --template cordova-template-mfp。
   例如：

   cordova create Hello com.example.helloworld HelloWorld --template cordova-template-mfp
   

   • “Hello”是应用程序的文件夹名称。
   • “com.example.helloworld”是应用程序的标识。
   • “HelloWorld”是应用程序的名称。
   • –template 将使用特定于 MobileFirst 的新增项来修改应用程序。

   模板化的 index.js 使您能够使用其他 MobileFirst 功能，如多语言应用程序翻译和初始化选项（请参阅用户文档以获取更多信息）。

2. 将目录更改为 Cordova 项目的根目录：cd hello

3. 使用 Cordova CLI 命令将一个或多个受支持的平台添加到 Cordova 项目：cordova platform add ios|android|windows。例如：

   cordova platform add ios
   

   注：由于已使用 MobileFirst 模板配置应用程序，因此将自动添加 MobileFirst 核心 Cordova 插件，因为已在步骤 3 中添加平台。

4. 通过运行 cordova prepare 命令来准备应用程序资源：

   cordova prepare
   

现有应用程序

1. 浏览至现有 Cordova 项目的根目录并添加 MobileFirst 核心 Cordova 插件：

   cordova plugin add cordova-plugin-mfp
   

2. 浏览至 www\js 文件夹并选择 index.js 文件。

3. 添加以下函数：

   function wlCommonInit() {
   
   }
   

在装入 MobileFirst 客户机 SDK 之后，MobileFirst API 方法将可用。然后将调用 wlCommonInit 函数。
使用此函数调用各种 MobileFirst API 方法。

注册应用程序

1. 打开命令行窗口并浏览至 Cordova 项目的根目录。

2. 向 MobileFirst Server 注册此应用程序：

   mfpdev app register
   

   • 如果使用的是远程服务器，请使用命令 mfpdev server add 进行添加。

mfpdev app register CLI 命令将先连接到 MobileFirst Server 以注册应用程序，然后使用标识 MobileFirst Server 的元数据更新 Cordova 项目根目录的 config.xml 文件。

会在 MobileFirst Server 中将每个平台注册为应用程序。

提示：您还可以从 MobileFirst Operations Console 注册应用程序：

1. 装入 MobileFirst Operations Console。
2. 单击应用程序旁边的新建按钮以注册新应用程序，并遵循屏幕上的指示信息。

使用 SDK

在装入 MobileFirst 客户机 SDK 之后，MobileFirst API 方法将可用。然后将调用 wlCommonInit 函数。
使用此函数调用各种 MobileFirst API 方法。

更新 MobileFirst Cordova SDK

要使用最新发行版更新 MobileFirst Cordova SDK，请除去 cordova-plugin-mfp 插件：运行 cordova plugin remove cordova-plugin-mfp 命令，然后运行 cordova plugin add cordova-plugin-mfp 命令以重新添加。

可以在 SDK 的 NPM 存储库中找到 SDK 发行版。

已生成 MobileFirst Cordova SDK 工件

config.xml

Cordova 配置文件是包含应用程序元数据的必需 XML 文件，存储在应用程序的根目录中。
将 MobileFirst Cordova SDK 添加到项目之后，Cordova 生成的 config.xml 文件会接收一组使用名称空间 mfp: 标识的新元素。添加的元素包含与 MobileFirst 功能和 MobileFirst Server 相关的信息。

添加到 config.xml 文件的 MobileFirst 设置示例

<?xml version='1.0'encoding='utf-8'?>
<widget id="..." xmlns:mfp="http://www.ibm.com/mobilefirst/cordova-plugin-mfp">
    <mfp:android>
        <mfp:sdkChecksum>3563350808</mfp:sdkChecksum>
        <mfp:appChecksum>0</mfp:appChecksum>
        <mfp:security>
            <mfp:testWebResourcesChecksum enabled="false" ignoreFileExtensions="png, jpg, jpeg, gif, mp4, mp3" />
        </mfp:security>
    </mfp:android>
    <mfp:windows>
        <mfp:sdkChecksum>3563350808</mfp:sdkChecksum>
       <mfp:windows10>
          <mfp:sdkChecksum>...</mfp:sdkChecksum>          
          <mfp:security>
             <mfp:testWebResourcesChecksum/>
          </mfp:security>
    </mfp:windows>
    <mfp:platformVersion>8.0.0.00-20151214-1255</mfp:platformVersion>
    <mfp:clientCustomInit enabled="false" />
    <mfp:server runtime="mfp" url="http://10.0.0.1:9080" />
    <mfp:directUpdateAuthenticityPublicKey>the-key</mfp:directUpdateAuthenticityPublicKey>
    <mfp:languagePreferences>en</mfp:languagePreferences>
</widget>

编辑 config.xml 文件中的 MobileFirst 设置

您可以使用 MobileFirst CLI 通过运行命令来编辑上面的设置：

mfpdev app config

接下来要学习的教程

集成 MobileFirst Cordova SDK 之后，您现在可以：

• 查看使用 Mobile Foundation SDK 教程
• 查看适配器开发教程
• 查看认证和安全教程
• 查看通知教程
• 查看所有教程