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 SDKs来了解如何设置Optimizely X项目并开始使用SDK。
要求
- iOS 8.0+ / tvOS 9.0+
安装SDK
请注意以下内容,其中 <platform> 用于表示您正在构建应用程序的平台。目前,我们支持 iOS
和 tvOS
平台。
**注意**:如果您或其他框架正在使用sqlite,则应添加编译器选项用于线程安全的sqlite:SQLITE_THREADSAFE=1 https://www.sqlite.org/threadsafe.html
CocoaPods
- 将以下行添加到 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构建脚本
- 在目标中添加一个新的 Run Script 阶段到 Build Phase。
- 在脚本区域包括
/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
- 在目标中添加一个新的 Run Script 阶段到 Build Phase。
Carthage的进一步安装说明:https://github.com/Carthage/Carthage
手动安装
通用的框架可以在需要时用于应用程序而不必第三方依赖管理器。通用框架打包了所有Optimizely X Mobile模块,包括
OptimizelySDKCore
OptimizelySDKShared
OptimizelySDKDatafileManager
OptimizelySDKEventDispatcher
OptimizelySDKUserProfileService
iPhone通用框架包括以下架构的构建
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
文件夹。
贡献
请参阅贡献。
致谢
一方的代码(位于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 是否修改:否 是否分发:是 分发形式:二进制