Salesforce.com 移动 SDK for iOS
您已到达 Salesforce Mobile SDK for iOS 的源代码仓库。欢迎!从我们的 2.0 版本开始,现在有三种方式您可以选择与 Mobile SDK 配合使用
- 如果您想使用 SDK 的源代码本身,您已经找到正确的位置了!您可以浏览示例应用程序的源代码并深入调试以理解所有一切都是如何在内幕工作的。请继续阅读以获取在开发环境中开始使用 SDK 的说明。
- 如果您急于开始开发自己的新应用程序,最快捷的方式是使用我们的 npm 二进制分发包,称为 forceios,该包托管在 npmjs.org 上。开始使用只需安装 npm 包并启动模板应用程序即可。更多关于 forceios 包的详细信息,请参阅该包页面。
安装(这正是您需要做的)
在此仓库中工作需要使用 git。任何将您设置为一个可用的 git clone 的工作流程都应设置您成功。另一方面,从 GitHub 下载 ZIP 文件可能会让您走到死胡同。
设置仓库
首先,克隆仓库
- 打开终端应用程序
cd
到仓库目录将要存在的父目录git clone https://github.com/forcedotcom/SalesforceMobileSDK-iOS.git
克隆仓库后
cd SalesforceMobileSDK-iOS
./install.sh
本脚本从GitHub拉取子模块依赖,以完成工作区的设置。然后您可以从Xcode中打开SalesforceMobileSDK.xcworkspace
来使用移动SDK。
有关生成二进制分布和应用程序模板的信息,请参阅building.md。
Salesforce Mobile SDK for iOS需要iOS 10.0或更高版本。 install.sh脚本会检查这一点,如果配置的SDK版本不正确,则会终止。使用抗生1.8测试过从命令行构建。旧版本可能可以使用,但我们建议使用最新的ants版本。
如果您在构建任何项目时遇到问题,请查看在线FAQ以获取故障排除提示。
简介
6.2版本的新特性
库升级
- 我们已将React Native更新到版本0.55.4。
工具版本升级
- 我们现在需要Cordova CLI 8.0.0。
SmartSync数据框架增强
- 当记录无法同步时,SmartSync数据框架现在会保存返回的错误。
- 一个新的实用工具
SFMetadataSyncManager
利用SmartSync数据框架的力量来查询Salesforce对象元数据。 - 另一个新的实用工具
SFLayoutSyncManager
利用SmartSync数据框架的力量来查询Salesforce对象布局。
其他技术改进
- 现在可用我们的原生演示应用程序
RestAPIExplorer
的Swift版本。 - 我们的原生演示应用程序
SmartSyncExplorer
的Swift版本现在可作为模板在模板存储库中找到。 - 我们对“切换用户”界面进行了更新。
- 我们将模板合并到一个单独的存储库中。
- 改进了示例应用程序。
- 各种错误修复。
弃用
SFSmartSyncMetadataManager
现在已弃用,将在Mobile SDK 7.0中删除。使用SFMetadataSyncManager
和SFLayoutSyncManager
替代。SFSmartSyncCacheManager
现在已弃用,将在Mobile SDK 7.0中删除。离线缓存现在由SmartSync数据框架自动处理。SFObjectType
现在已弃用,将在Mobile SDK 7.0中删除。使用SFMetadata
替代。SFObjectTypeLayout
现在已弃用,将在Mobile SDK 7.0中删除。使用SFLayout
替代。
查看http://developer.force.com/mobilesdk以获取更多文章和教程。
原生应用程序
The Salesforce Mobile SDK提供了构建与Salesforce云平台交互的本地移动应用所需的必要库。OAuth2库抽象了安全存储刷新令牌或在会话ID到期时获取新的会话ID的复杂性。SDK还提供了Salesforce REST API的Objective-C封装,使检索和操作数据变得容易。
混合应用
HTML5正迅速成为一种用于开发跨平台移动应用的有力技术。虽然开发者仅使用HTML5和JavaScript就可以创建复杂的应用程序,但一些重要的限制仍然存在,具体包括:会话管理和访问如摄像头、日历和通讯录等原生设备功能的通用访问。Salesforce Mobile Container(基于行业领先的PhoneGap实现)使将存储在设备上的HTML5应用程序或通过Visualforce交付的应用程序嵌入到薄原生容器中成为可能,从而产生混合应用。
应用程序模板
Mobile SDK提供了一种从模板生成您的新应用的方法,以快速构建原生和混合应用的基础。这些应用程序包括一个完全功能的演示应用程序,以及允许用户注销应用程序或在不同生产环境和沙盒组织中切换的可配置设置包。有关如何生成和使用这些模板的更多信息,请参阅build.md。
原生应用程序模板 对于需要访问Salesforce REST API的原生应用程序,请使用原生模板创建您的应用程序。模板包括一个默认的AppDelegate实现,您可以根据需要自定义它以执行任何应用程序特定的交互。
混合应用程序模板 为了创建使用Salesforce REST API或访问Visualforce页面的混合应用程序,请使用混合应用程序模板创建您的应用程序。通过为我们的基于PhoneGap的容器提供SalesforceOAuthPlugin,HTML5应用程序可以快速利用JavaScript调用直接利用OAuth令牌。此外,我们的SFSmartStorePlugin将允许您在设备上安全地存储应用程序数据。
文档
- SalesforceAnalytics库参考
- SalesforceSDKCore库参考
- SmartStore库参考
- SmartSync库参考
- SalesforceHybridSDK库参考
- SalesforceReact库参考
- SalesforceSwiftSDK库参考
- 移动SDK开发指南 -- PDF | HTML
- 移动SDK沙箱
讨论
如果您有任何建议、疑问或遇到任何问题,我们都非常欢迎您提供反馈。请在我们的 Google+ 社群 发贴。