OptimizelySDKCore 3.1.5

OptimizelySDKCore 3.1.5

×

测试已测试✓
Lang语言 Obj-CObjective C
许可证 Apache-2.0
发布最新发布2020年10月

由Optimizely FullStack维护。

OptimizelySDKCore 3.1.5

  • 由
  • Optimizely

Objective-C SDK

Build Status Apache 2.0 Carthage compatible Coveralls Platforms Podspec Platforms Podspec

此仓库包含用于与 Optimizely Full Stack 以及 Optimizely Rollouts（移动和 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

  1. 将以下行添加到Podfile
    use_frameworks!
pod 'OptimizelySDK<platform>', '~> 3.1.5'
  1. 运行以下命令
    pod install

Cocoapods的进一步安装说明： https://guides.cocoapods.org.cn/using/getting-started.html

Carthage

  1. 将以下行添加到Cartfile
    github "optimizely/objective-c-sdk" ~> 3.1.5

  1. 运行以下命令

    carthage update

  2. 将框架链接到您的项目中。转到您项目目标的Link Binary With Libraries，并从Carthage/Build/<platform>文件夹中拖动以下内容

    OptimizelySDKCore.framework
OptimizelySDKDatafileManager.framework
OptimizelySDKEventDispatcher.framework
OptimizelySDKShared.framework
OptimizelySDKUserProfileService.framework
OptimizelySDK<platform>.framework

  3. 为确保存档应用程序时复制适当的位代码相关文件和dSYMs，您需要安装Carthage构建脚本

    • 在目标中的添加一个新按钮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

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。

要安装通用框架，请按照以下步骤操作

  1. 下载iOS或tvOS框架。

  2. 解压框架，然后将框架拖到Xcode项目中进行操作；Xcode应提示您选择目标。转到构建阶段，确保框架位于链接二进制与库部分。

  3. 转到通用选项卡，并将框架添加到嵌入的二进制文件部分。如果“嵌入的二进制文件”部分不可见，请在复制文件部分添加框架（您可以在构建设置中添加此部分）。

  4. 由于通用框架包括了模拟器二进制文件，苹果商店将拒绝您的应用程序。因此，您需要在上传应用程序之前运行一个删除额外二进制的脚本。为此，转到构建阶段，并点击+符号添加一个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 修改：否 分发：是 分发：二进制