适用于 iOS 的 LaunchDarkly SDK

Run CI SwiftPM compatible CocoaPods compatible Carthage compatible Platform

LaunchDarkly 概述

LaunchDarkly 是一个功能管理平台，每天为团队提供数万亿个功能标志，以帮助他们更快地构建更好的软件。 立即开始 使用 LaunchDarkly！

Twitter Follow

支持的 iOS 和 Xcode 版本

此版本的 LaunchDarkly SDK 已经在 iOS、macOS、watchOS 和 tvOS 设备上进行了测试。

LaunchDarkly iOS SDK 需要以下最低构建工具版本

工具 版本
Xcode 12.5+
Swift 5.3+

并支持以下设备平台

平台 版本
iOS 12.0
watchOS 4.0
tvOS 12.0
macOS 10.13

安装

LaunchDarkly 支持多种方法将库安装到项目中。安装完成后，请前往 SDK 文档 获取有关开始使用 SDK 的完整说明。

Swift Package Manager

Swift Package Manager 是一个集成到 swift 编译器和 Xcode 中的依赖项管理器。

要将 LaunchDarkly 集成到 Xcode 项目中，请转到项目编辑器，然后选择 Swift Packages。 从这里点击 + 按钮，并使用 https://github.com/launchdarkly/ios-client-sdk.git 作为 URL，按照提示操作。

要将 LaunchDarkly 包含在 Swift 包中，只需将其添加到 Package.swift 文件的 dependencies 部分。 并将 product "LaunchDarkly" 添加为 target 的依赖项。

dependencies: [
    .package(url: "https://github.com/launchdarkly/ios-client-sdk.git", .upToNextMajor(from: "9.12.3"))
]

CocoaPods

要使用 CocoaPods 依赖项管理器将 LaunchDarkly 集成到您的 Xcode 项目中，请在您的 Podfile 中指定它

use_frameworks!
target 'YourTargetName' do
  pod 'LaunchDarkly', '~> 9.12'
end

Carthage

要使用 Carthage 依赖项管理器将 LaunchDarkly 集成到您的 Xcode 项目中，请在您的 Cartfile 中指定它

要使用 Carthage 将 LaunchDarkly 集成到您的 Xcode 项目中，请在您的 Cartfile 中指定它

github "launchdarkly/ios-client-sdk" ~> 9.12

手动安装

如果您不想使用上述依赖项管理器，也可以手动集成 SDK。

  1. 在项目的根文件夹中，通过以下任一方式检索 SDK
    • 使用 git submodule add https://github.com/launchdarkly/ios-client-sdk.git 将 SDK 添加为 git 子模块。
    • 或者使用 git clone https://github.com/launchdarkly/ios-client-sdk.git 克隆 SDK。
  2. 打开新的 ios-client-sdk 文件夹，并将 LaunchDarkly.xcodeproj 拖到应用程序 Xcode 项目的项目导航器中。 它应该嵌套在应用程序的蓝色项目图标中。
  3. 在项目导航器（蓝色图标）中选择您的应用程序项目，然后在侧边栏的“Targets”标题下选择您的应用程序目标。 如果您有多个目标，请为每个目标执行以下步骤。
  4. 选择“General”选项卡，并在必要时展开子部分“Frameworks, Libraries, and Embedded Content”。
  5. 单击展开的子部分中的“+”按钮。 在对话框中的“LaunchDarkly”下，您将看到 4 个框架，为 iOS 选择 LaunchDarkly.framework，或者为其他平台选择 LaunchDarkly_<platform>。

了解更多

阅读我们的文档，获取有关配置和使用 LaunchDarkly 的详细说明。 您也可以直接转到此 SDK 的完整参考指南。

测试

我们使用集中式测试工具为所有 SDK 运行集成测试。 这种方法使我们能够测试 SDK 之间的一致性，并测试长时间运行的应用程序中的网络行为。 这些测试涵盖了 SDK 中的每个方法，并验证了事件发送、标志评估、流重新连接以及 SDK 的其他方面是否都表现正确。

隐私

在 WWDC23 上，Apple 引入了隐私清单的概念。 SDK 随附的隐私清单描述了我们在数据收集方面的数据使用情况（以最小的情况为例）。 如果您使用该 SDK，如果您选择在您的实现中收集比我们的 SDK 运行所需的最小值更多的数据，您将必须更新您自己的隐私清单。

要了解有关隐私清单的更多信息，请参阅 Apple Developer Documention。

贡献

我们鼓励来自社区的 pull request 和其他贡献。 查看我们的贡献指南，了解如何为此 SDK 做出贡献的说明。

关于 LaunchDarkly