Objective-C SDK
此仓库包含用于 Optimizely Full Stack、Optimizely Rollouts for Mobile 和 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,那么您可能需要添加编译选项为thread safe 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构建脚本
- 在目标中添加一个新的 Run Script 阶段到其 Build Phase。
- 在脚本区域包括
/usr/local/bin/carthage copy-frameworks
- 将框架的路径添加到 输入文件 列表
$(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
- 将复制框架的路径添加到 输出文件 列表
$(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
iOS通用框架包括以下架构的构建
i386
x86_64
ARMv7
ARMv7s
ARM64
tvOS通用框架包括以下架构的构建
x86_64
ARM64
iOS和tvOS的通用框架都启用了Bitcode。
为了安装通用框架,请按照以下步骤操作
-
解压框架,然后将框架拖到Xcode中的项目中;Xcode应提示您选择一个目标。转到构建阶段,确保框架位于链接二进制与库部分。
-
转到常规选项卡并将框架添加到嵌入的二进制文件部分。如果嵌入的二进制文件部分不可见,请在复制文件部分添加框架(您可以在构建设置中添加此部分)。
-
如果您将通用框架安装在您的应用中,应用商店将拒绝您的应用,因为它包含模拟器二进制文件。因此,在您上传应用之前,需要运行一个删除额外二进制的脚本。为此,转到构建阶段,通过点击
+
符号添加一个Run Script
部分。复制并粘贴以下脚本(确保用正确的框架名称替换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 修改:否 分发:是 分发形式:二进制