OptimizelySDKEventDispatcher 3.1.5

OptimizelySDKEventDispatcher 3.1.5

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

Optimizely FullStack 维护。



 
依赖项
OptimizelySDKShared= 3.1.5
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 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> 是您构建应用的平台。目前,我们支持 iOStvOS 平台。

**注意:如果您或其他框架使用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. 为了确保在存档应用时正确复制与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

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. 下载iOStvOS框架。

  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-UniversalOptimizelySDKTVOS-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 修改:否 分发:是 分发形式:二进制