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

概述

MobileFirst Foundation SDK 包含通过 CocoaPods 可用并且可添加到 Xcode 项目的 pod 集合。
pod 与核心函数和其他函数对应：

• IBMMobileFirstPlatformFoundation - 实现客户机到服务器连接，并处理认证和安全方面、资源请求和其他必需的核心函数。
• IBMMobileFirstPlatformFoundationJSONStore - 包含 JSONStore 框架。 有关更多信息，请查看针对 iOS 的 JSONStore 教程。
• IBMMobileFirstPlatformFoundationPush - 包含推送通知框架。 有关更多信息，请查看通知教程。
• IBMMobileFirstPlatformFoundationWatchOS - 包含对 Apple WatchOS 的支持。

在此教程中，了解如何使用 CocoaPods 将 MobileFirst 本机 SDK 添加到新的或现有的 iOS 应用程序。 您还可以了解如何配置 MobileFirst Server 以识别应用程序。

先决条件：

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

注：使用 XCode 8 的情况下在模拟器上运行 iOS 应用程序时必需密钥链共享功能。

跳转至：

• 添加 MobileFirst 本机 SDK
• 手动添加 MobileFirst 本机 SDK
• 添加对 Apple watchOS 的支持
• 更新 MobileFirst 本机 SDK
• 已生成 MobileFirst 本机 SDK 工件
• 位码和 TLS 1.2
• 接下来要学习的教程

添加 MobileFirst 本机 SDK

遵循下面的指示信息将 Mobile Foundation 本机 SDK 添加到新的或现有的 Xcode 项目，以将应用程序注册到 MobileFirst Server。

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

创建应用程序

创建 Xcode 项目或使用现有项目（Swift 或 Objective-C）。

添加 SDK

1. 通过 CocoaPods 提供 Mobile Foundation 本机 SDK。
   • 如果您的开发环境中已安装有 CocoaPods，请跳至步骤 2。
   • 如果未安装 CocoaPods，将按照如下进行安装：
     • 打开命令行窗口并浏览至 Xcode 项目的根目录。
     • 运行命令：sudo gem install cocoapods，然后运行命令 pod setup。 注：这些命令可能需要几分钟完成。
2. 运行命令：pod init。 这将创建 Podfile。
3. 使用您偏爱的代码编辑器打开 Podfile。
   • 注释掉或删除文件的内容。

   • 添加以下行并保存更改：

     use_frameworks!
     
     platform :ios, 8.0
     target "Xcode-project-target" do
         pod 'IBMMobileFirstPlatformFoundation'
     end
     

     • 将 Xcode-project-target 替换为 Xcode 项目目标的名称。

4. 返回到命令行窗口，运行命令 pod install，然后运行命令 pod update。 这些命令将添加 Mobile Foundation 本机 SDK 文件、添加 mfpclient.plist 文件并生成 Pod 项目。
   注：这些命令可能需要几分钟完成。

   要点：从此时开始，使用 [ProjectName].xcworkspace 文件在 Xcode 中打开项目。 请勿使用 [ProjectName].xcodeproj 文件。 基于 CocoaPods 的项目将作为包含应用程序（可执行程序）和库（CocoaPods 管理器提取的所有项目依赖关系）的工作空间进行管理。

手动添加 MobileFirst 本机 SDK

您还可以手动添加 Mobile Foundation SDK：

注册应用程序

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

2. 运行以下命令：

    mfpdev app register
   

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

   系统会要求您提供应用程序的 BundleID。 要点：BundleID 是区分大小写的。

mfpdev app register CLI 命令将先连接到 MobileFirst Server 以注册应用程序，然后在 Xcode 项目的根目录生成 mfpclient.plist 文件，并向该文件添加用来标识 MobileFirst Server 的元数据。

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

1. 装入 MobileFirst Operations Console。
2. 单击应用程序旁边的新建按钮以注册新应用程序，并遵循屏幕上的指示信息。
3. 注册应用程序之后，浏览至应用程序的配置文件选项卡，然后复制或下载 mfpclient.plist 文件。 遵循屏幕上指示信息将此文件添加到您的项目。

完成设置过程

在 Xcode 中，右键单击项目条目，单击将文件添加到 [ProjectName]，然后选择位于 Xcode 项目根目录的 mfpclient.plist 文件。

参考 SDK

无论何时您想要使用 Mobile Foundation 本机 SDK，都请确保导入 Mobile Foundation 框架：

Objective-C：

#import <IBMMobileFirstPlatformFoundation/IBMMobileFirstPlatformFoundation.h>

Swift：

import IBMMobileFirstPlatformFoundation

关于 iOS 9 及以上版本的注意事项：

从 Xcode 7 开始，缺省情况下会启用应用程序传输安全性 (ATS)。 要在开发期间运行应用程序，可以禁用 ATS（阅读更多）。

1. 在 Xcode 中，右键单击 [project]/info.plist 文件 → 打开方式 → 源代码
2. 粘贴以下内容：

     <key>NSAppTransportSecurity</key>
     <dict>
           <key>NSAllowsArbitraryLoads</key>
           <true/>
     </dict>

添加对 Apple watchOS 的支持

如果是为 Apple watchOS 2 和更高版本进行开发，那么 Podfile 必须包含与主要应用程序和 watchOS 扩展对应的部分。 请参阅下面针对 watchOS 2 的示例：

# Replace with the name of your watchOS application
xcodeproj 'MyWatchApp'

use_frameworks!

#use the name of the iOS target
target :MyWatchApp do
    platform :ios, 9.0
    pod 'IBMMobileFirstPlatformFoundation'
    end

#use the name of the watch extension target
target :MyWatchApp WatchKit Extension do
    platform :watchos, 2.0
    pod 'IBMMobileFirstPlatformFoundation'
end

验证 Xcode 项目是否已关闭，然后运行 pod install 命令。

更新 MobileFirst 本机 SDK

要使用最新发行版更新 Mobile Foundation 本机 SDK，请在命令行窗口中从 Xcode 项目的根文件夹运行以下命令：

pod update

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

已生成 MobileFirst 本机 SDK 工件

mfpclient.plist

此文件位于项目的根目录中，定义用于在 MobileFirst Server 上注册 iOS 应用程序的客户机端属性。

| 属性 | 描述 | 示例值 | |———————|———————————————————————|—————-| | protocol | 与 MobileFirst Server 的通信协议。 | http 或 https | | host | MobileFirst Server 的主机名。 | 192.168.1.63 | | port | MobileFirst Server 的端口。 | 9080 | | wlServerContext | MobileFirst Server 上应用程序的上下文根路径。 | /mfp/ | | languagePreferences | 为客户机 sdk 系统消息设置缺省语言。 | zh |

位码和 TLS 1.2

有关对位码和 TLS 1.2 的支持的信息，请参阅其他信息页面。

接下来要学习的教程

集成 Mobile Foundation 本机 SDK 之后，您现在可以：

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