Objective-C SDK
此存储库包含用于与 Optimizely Full Stack 和 Optimizely Rollouts for Mobile and OTT 一起使用的 Objective-C SDK。
Optimizely Full Stack 是面向产品开发团队的 A/B 测试和功能标志管理工具。在任何应用程序中进行实验。将您的路线图上的每个功能转变为学习的机会。有关更多信息,请访问 https://www.optimizely.com/platform/full-stack/,或查看 文档。
Optimizely Rollouts 是为开发团队提供的免费功能标志。轻松地在任何应用程序中推出和回退功能,无需代码部署。降低路线图上每个功能的风险。有关更多信息,请访问 https://www.optimizely.com/rollouts/,或查看 文档。
入门
注意
对于新用户和升级 iOS 用户,建议使用我们完全用 Swift 编写的全新 Swift-SDK。Swift SDK 将成为我们未来的主要 iOS SDK。它与 Objective-C SDK 功能兼容,并提供了简化界面的扩展功能集。
现有的 Objective-C SDK 用户可以查看我们有关将数据迁移到新 Swift SDK 的 指南文档。
使用SDK
查阅安装iOS和tvOS SDK,了解如何设置Optimizely X项目并开始使用SDK。
要求
- iOS 8.0及以上 / tvOS 9.0及以上
安装SDK
请注意,以下示例中使用的 <platform> 表示您正在为该平台构建应用程序。目前,我们支持 iOS
和 tvOS
平台。
**注意:如果您或另一个框架正在使用sqlite,则可能需要为线程安全的sqlite添加编译选项:SQLITE_THREADSAFE=1 https://www.sqlite.org/threadsafe.html
Cocoapod
- 将以下行添加到 Podfile
use_frameworks!
pod 'OptimizelySDK<platform>', '~> 3.1.5'
- 运行以下命令
pod install
关于Cocoapods的进一步安装说明:https://guides.cocoapods.org.cn/using/getting-started.html
Carthage
- 将以下行添加到 Cartfile
github "optimizely/objective-c-sdk" ~> 3.1.5
-
运行以下命令
carthage update
-
将框架链接到您的项目。转到项目目标的 Link Binary With Libraries 并从 Carthage/Build/<platform> 文件夹拖动以下内容
OptimizelySDKCore.framework OptimizelySDKDatafileManager.framework OptimizelySDKEventDispatcher.framework OptimizelySDKShared.framework OptimizelySDKUserProfileService.framework OptimizelySDK<platform>.framework
-
为了确保归档应用程序时正确复制与bitcode相关的文件和dSYMs,您需要安装一个Carthage构建脚本
- 在目标中的 Build Phase 中添加一个新的 Run Script 阶段。
- 在脚本区域包括
/usr/local/bin/carthage copy-frameworks
- 将框架的路径添加到 Input Files 列表
$(SRCROOT)/Carthage/Build/<platform>/OptimizelySDKCore.framework
$(SRCROOT)/Carthage/Build/<platform>/OptimizelySDKDatafileManager.framework
$(SRCROOT)/Carthage/Build/<platform>/OptimizelySDKEventDispatcher.framework
$(SRCROOT)/Carthage/Build/<platform>/OptimizelySDKShared.framework
$(SRCROOT)/Carthage/Build/<platform>/OptimizelySDKUserProfileService.framework
$(SRCROOT)/Carthage/Build/<platform>/OptimizelySDK<platform>.framework
- 将复制的框架的路径添加到 Output Files 列表
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/OptimizelySDKCore.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/OptimizelySDKDatafileManager.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/OptimizelySDKEventDispatcher.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/OptimizelySDKShared.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/OptimizelySDKUserProfileService.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/OptimizelySDK<platform>.framework
- 在目标中的 Build Phase 中添加一个新的 Run Script 阶段。
Carthage的进一步安装说明: https://github.com/Carthage/Carthage
手动安装
通用框架可以在不使用第三方依赖管理器的情况下用于应用程序。通用框架打包了所有Optimizely X Mobile模块,包括
OptimizelySDKCore
OptimizelySDKShared
OptimizelySDKDatafileManager
OptimizelySDKEventDispatcher
OptimizelySDKUserProfileService
适用于以下架构的iOS通用框架构建
i386
x86_64
ARMv7
ARMv7s
ARM64
适用于以下架构的tvOS通用框架构建
x86_64
ARM64
iOS和tvOS的通用框架都开启了Bitcode。
为了安装通用框架,请按照以下步骤操作
-
解压框架,然后将框架拖到Xcode项目中;Xcode应会提示您选择目标。转到 构建阶段 并确保框架位于 与库链接 部分。
-
转到 常规 选项卡,并将框架添加到 嵌入二进制文件 部分。如果 嵌入二进制文件 部分不可见,请将框架添加到 复制文件 部分(您可以在 构建设置 中添加此部分)。
-
如果将通用框架安装为应用程序,Apple商店将拒绝您的应用,因为它包含模拟器二进制文件。因此,在您上传应用程序之前,需要运行一个移除额外二进制文件的脚本。为此,转到 构建阶段 并通过点击
+
符号添加一个 运行脚本 部分。复制并粘贴以下脚本(确保将FRAMEWORK_NAME
替换为正确的框架名称! )FRAMEWORK="FRAMEWORK_NAME" FRAMEWORK_EXECUTABLE_PATH="${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/$FRAMEWORK.framework/$FRAMEWORK" EXTRACTED_ARCHS=() for ARCH in $ARCHS do lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH" EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH") done lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}" rm "${EXTRACTED_ARCHS[@]}" rm "$FRAMEWORK_EXECUTABLE_PATH" mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"
如果您选择自己构建通用框架,可以运行OptimizelySDKiOS-Universal
或OptimizelySDKTVOS-Universal
方案。构建这些方案后,框架将输出在OptimizelySDKUniversal/generated-frameworks
文件夹中。
贡献
请参阅CONTRIBUTING。
鸣谢
第三方代码(在OptimizelySDKCore/,OptimizelySDKDatafileManager/,OptimizelySDKEventDispatcher/,OptimizelySDKiOS/,OptimizelySDKShared/,OptimizelySDKTVOS/,OptimizelySDKUniversal/,OptimizelySDKUserProfileService/等目录下)版权归Optimizely,Inc.和贡献者所有,许可协议为Apache 2.0。
附加代码
FMDB https://github.com/ccgus/fmdb
许可证 (MIT):: https://github.com/ccgus/fmdb/blob/master/LICENSE.txt 修改:是 分发:是 分发方式:二进制
SQLITE3 https://www.sqlite.org/index.html
许可证(公有领域):: https://www.sqlite.org/copyright.html 修改:是 分发:是 分发方式:二进制
JSONModel https://github.com/jsonmodel/jsonmodel
许可证(MIT):: https://github.com/jsonmodel/jsonmodel/blob/master/LICENSE 修改:是 分发:是 分发方式:二进制
murmur3 https://github.com/PeterScott/murmur3
许可证(公有领域):: https://github.com/PeterScott/murmur3 修改:否 分发:是 分发方式:二进制