OpenCombine

Apple的Combine框架的开源实现，用于处理随时间变化的值。

这个项目的主要目标是提供一个兼容、可靠和高效的实现，可以在macOS 10.15和iOS 13之前的Apple操作系统上使用，以及Linux、Windows和WebAssembly上使用。

CI状态

安装

OpenCombine包含三个公共目标：OpenCombine、OpenCombineFoundation和OpenCombineDispatch（第四个COpenCombineHelpers被视为私有，不要在你的项目中导入它）。

OpenCombine本身没有任何依赖，甚至不依赖Foundation或Dispatch。如果你想将OpenCombine与Dispatch一起使用（例如，将DispatchQueue作为Scheduler用于debounce、receive(on:)等操作符），你需要同时导入OpenCombine和OpenCombineDispatch。Foundation也是如此：如果你想使用例如NotificationCenter或URLSession发布者，你还需要导入OpenCombineFoundation。

如果你为多个平台开发代码，你可能会发现导入OpenCombineShim模块更方便。它在Apple平台上有条件地重新导出Combine（如果可用），在其他平台上导出所有OpenCombine模块。你只能在使用SwiftPM时导入OpenCombineShim。它目前不适用于CocoaPods。

Swift包管理器

Swift包

要将OpenCombine添加到你的SwiftPM包中，请在你的Package.swift文件中的包和目标依赖列表中添加OpenCombine包。OpenCombineDispatch和OpenCombineFoundation产品目前不支持WebAssembly。如果你的项目专门针对WebAssembly，你应该将它们从依赖列表中省略。如果它针对包括WebAssembly在内的多个平台，则仅在非WebAssembly平台上依赖它们，使用条件目标依赖。

dependencies: [
    .package(url: "https://github.com/OpenCombine/OpenCombine.git", from: "0.14.0")
],
targets: [
    .target(
        name: "MyAwesomePackage",
        dependencies: [
            "OpenCombine",
            .product(name: "OpenCombineFoundation", package: "OpenCombine"),
            .product(name: "OpenCombineDispatch", package: "OpenCombine")
        ]
    ),
]

Xcode

OpenCombine也可以直接在你的Xcode项目中作为SwiftPM依赖添加（需要Xcode 11及以上版本）。

要这样做，打开Xcode，使用文件 → Swift包 → 添加包依赖…，输入仓库URL，选择最新可用版本，并激活复选框：

<p align="center"> <img alt="选择OpenCombine和OpenCombineDispatch目标" src="https://user-images.githubusercontent.com/16309982/67618468-bd379f80-f7f8-11e9-917f-e76e878a1aee.png" width="70%"> </p>

CocoaPods

要将OpenCombine添加到使用CocoaPods的项目中，在你的Podfile中的目标依赖列表中添加OpenCombine和OpenCombineDispatch。

pod 'OpenCombine', '~> 0.14.0'
pod 'OpenCombineDispatch', '~> 0.14.0'
pod 'OpenCombineFoundation', '~> 0.14.0'

调试器支持

文件opencombine_lldb.py定义了一些lldb类型摘要，以便更容易进行调试。这些类型摘要改善了lldb和Xcode显示某些OpenCombine值的方式。

要使用opencombine_lldb.py，请找出其完整路径。假设完整路径是~/projects/OpenCombine/opencombine_lldb.py。然后将以下语句添加到你的~/.lldbinit文件中：

command script import ~/projects/OpenCombine/opencombine_lldb.py

目前，opencombine_lldb.py为以下类型定义了类型摘要：

• Subscribers.Demand
• 目前就这些。

贡献

请参阅CONTRIBUTING.md。