Salesforce.com iOS移动SDK

您已到达Salesforce Mobile SDK for iOS的源代码仓库。欢迎！从2.0版本开始，您现在有三种选择来与Mobile SDK一起工作

• 如果您想使用SDK本身的源代码，您来了正确的地点！您可以浏览示例应用程序源代码，并通过层次结构进行调试，以了解一切在幕后是如何工作的。请继续阅读有关如何在您的开发环境中入门SDK的说明。
• 如果您只是渴望开始开发您自己的新应用程序，最快速的方法是使用我们名为forceios的npm二进制分发包，该包托管在npmjs.org上。入门方法非常简单，只需安装npm包并启动模板应用程序即可。您可以在forceios包页面上找到更多详细信息。
• 如果您想将Mobile SDK组件添加到现有的原生应用程序中，请查看包含我们的二进制分发以及如何将其添加到您的原生应用程序的信息的SalesforceMobileSDK-iOS-Distribution仓库。

安装（请首先这样做——真的！）

使用此仓库需要使用git。任何将您留在一个具有此仓库存档的git clone的工作流程都应该使您成功。另一方面，从GitHub下载ZIP文件可能会让您陷入死胡同。

设置仓库

首先，克隆仓库

• 打开终端应用程序
• cd到仓库目录所在父目录
• git clone https://github.com/forcedotcom/SalesforceMobileSDK-iOS.git

克隆仓库后

• cd SalesforceMobileSDK-iOS
• ./install.sh

此脚本从GitHub拉取子模块依赖项，以最终设置工作区。然后，您可以打开Xcode中的SalesforceMobileSDK.xcworkspace以使用Mobile SDK。

有关生成二进制分发和应用程序模板的详细信息，请参阅build.md。

Salesforce Mobile SDK for iOS 要求 iOS 8.0 或更高版本。安装.sh 脚本会检查此要求，如果配置的 SDK 版本不正确则终止安装。使用 ant 1.8 禁止从命令行构建已经过测试。旧版本可能也能正常工作，但我们建议使用 ant 的最新版本。

如果构建任何项目时出现问题，请查看在线 常见问题答疑 获取故障排除技巧。

引言

4.0版新功能

库升级

• 现在完全支持 iOS 9 功能，包括位码。
• 将 Mobile SDK 所需的最小 iOS 版本提高到 8.0。
• 将 Cordova 库升级到 v3.9.2。
• 将 CocoaLumberjack 库升级到 v2.2.0。

库增强

• Mobile SDK 库已经被重构以支持更好的使用。以下是我们的库列表。
  • SalesforceSDKCore
  • SalesforceNetwork
  • SalesforceRestAPI
  • SmartStore
  • SmartSync
  • SalesforceHybridSDK
  • SalesforceReact
• 为我们的库添加了 Cocoa Touch 动态框架目标。未来这将成为推荐的使用 Mobile SDK 库的方式。
• 移除了对 SalesforceCommonUtils 的依赖。iOS 的 Mobile SDK 现在是完全开源的。
• SalesforceReact 库现在提供了使用 React Native 的功能。有关如何使用此功能的详细信息，请参阅 Mobile SDK 开发指南中的 React Native 章节内容。

其他技术改进

• 将 Mobile SDK 所需的最小 Xcode 版本提高到 Xcode 7。
• 改进了示例应用。
• 各种错误修复。

请访问 http://developer.force.com/mobilesdk 获取更多文章和教程。

原生应用

Salesforce Mobile SDK 为快速构建与 Salesforce 云平台交互的原生移动应用提供了必要的库。OAuth2 库将安全存储刷新令牌或在会话过期时获取新会话 ID 的复杂性抽象化。SDK 还提供了 Salesforce REST API 的 Objective-C 包装器，使检索和操作数据变得容易。

混合应用

HTML5 正迅速成为一种用于开发跨平台移动应用的有力技术。虽然开发者可以用 HTML5 和 JavaScript alone 创建复杂的应用程序，但仍存在一些重要的限制，特别是：会话管理和对相机、日历和通讯录等原生设备功能的通用访问。Salesforce Mobile Container（基于行业领先的 PhoneGap 实现）使得可以在一个轻薄的本地容器中嵌入存储在设备上或通过 Visualforce 交付的 HTML5 应用，从而产生混合应用。

应用模板

Mobile SDK 提供了从模板生成您的新应用程序的方式，以快速构建原生和混合应用的基础。这些应用程序包括一个完全功能演示应用，以及允许用户登出应用程序或在不同生产环境和沙箱组织之间切换的可配置设置包。有关如何生成和使用模板的更多信息，请参阅 build.md。

原生应用模板 对于需要访问 Salesforce REST API 的原生应用，请使用原生模板创建您的应用程序。该模板包括一个默认的 AppDelegate 实现，您可以对其进行自定义以执行任何特定于应用程序的交互。

混合应用模板 要创建使用Salesforce REST API或访问Visualforce页面的混合应用，请使用混合应用模板创建您的应用。通过为我们的基于PhoneGap的容器提供SalesforceOAuthPlugin，HTML5应用可以快速从JavaScript调用中直接利用OAuth令牌。此外，我们的SFSmartStorePlugin将允许您在设备上安全地存储应用数据。

文档

• Salesforce移动SDK开发指南
• Salesforce移动SDK for iOS参考

讨论

如果您有任何建议、问题或遇到任何问题，我们很愿意听取您的意见。在我们的Google+社区上发布您反馈的信息。