Rx is a generic abstraction of computation expressed through
This is a Swift version of Rx.
It tries to port as many concepts from the original version as possible, but some concepts were adapted for more pleasant and performant integration with iOS/macOS environment.
Cross platform documentation can be found on ReactiveX.io.
Like the original Rx, its intention is to enable easy composition of asynchronous operations and event/data streams.
KVO observing, async operations and streams are all unified under abstraction of sequence. This is the reason why Rx is so simple, elegant and powerful.
I came here because I want to ...
- why use rx?
- the basics, getting started with RxSwift
- traits - what are
ControlProperty... and why do they exist?
- tips and common errors
- the math behind Rx
- what are hot and cold observable sequences?
- Integrate RxSwift/RxCocoa with my app. Installation Guide
... hack around
- All of this is great, but it would be nice to talk with other people using RxSwift and exchange experiences.
Join Slack Channel
- Report a problem using the library. Open an Issue With Bug Template
- Request a new feature. Open an Issue With Feature Request Template
- Help out Check out contribution guide
... understand the structure
RxSwift comprises five separate components depending on eachother in the following way:
┌──────────────┐ ┌──────────────┐ │ RxCocoa ├────▶ RxRelay │ └───────┬──────┘ └──────┬───────┘ │ │ ┌───────▼──────────────────▼───────┐ │ RxSwift │ └───────▲──────────────────▲───────┘ │ │ ┌───────┴──────┐ ┌──────┴───────┐ │ RxTest │ │ RxBlocking │ └──────────────┘ └──────────────┘
- RxSwift: The core of RxSwift, providing the Rx standard as (mostly) defined by ReactiveX. It has no other dependencies.
- RxCocoa: Provides Cocoa-specific capabilities for general iOS/macOS/watchOS & tvOS app development, such as Binders, Traits, and much more. It depends on both
- RxRelay: Provides
BehaviorRelay, two simple wrappers around Subjects. It depends on
- RxTest and RxBlocking: Provides testing capabilities for Rx-based systems. It depends on
... find compatible
... see the broader vision
- Does this exist for Android? RxJava
- Xcode 10.2
- Swift 5.0
For Xcode 10.1 and below, use RxSwift 4.5.
Rx doesn't contain any external dependencies.
These are currently the supported options:
Open Rx.xcworkspace, choose
RxExample and hit run. This method will build everything and run the sample app
# Podfile use_frameworks! target 'YOUR_TARGET_NAME' do pod 'RxSwift', '~> 5' pod 'RxCocoa', '~> 5' end # RxTest and RxBlocking make the most sense in the context of unit/integration tests target 'YOUR_TESTING_TARGET' do pod 'RxBlocking', '~> 5' pod 'RxTest', '~> 5' end
YOUR_TARGET_NAME and then, in the
Podfile directory, type:
$ pod install
Officially supported: Carthage 0.33 and up.
Add this to
github "ReactiveX/RxSwift" ~> 5.0
$ carthage update
Carthage as a Static Library
Carthage defaults to building RxSwift as a Dynamic Library.
If you wish to build RxSwift as a Static Library using Carthage you may use the script below to manually modify the framework type before building with Carthage:
carthage update RxSwift --platform iOS --no-build sed -i -e 's/MACH_O_TYPE = mh_dylib/MACH_O_TYPE = staticlib/g' Carthage/Checkouts/RxSwift/Rx.xcodeproj/project.pbxproj carthage build RxAlamofire --platform iOS
// swift-tools-version:5.0 import PackageDescription let package = Package( name: "RxTestProject", dependencies: [ .package(url: "https://github.com/ReactiveX/RxSwift.git", from: "5.0.0") ], targets: [ .target(name: "RxTestProject", dependencies: ["RxSwift", "RxCocoa"]) ] )
$ swift build
To build or test a module with RxTest dependency, set
$ TEST=1 swift test
Manually using git submodules
- Add RxSwift as a submodule
$ git submodule add [email protected]:ReactiveX/RxSwift.git
Rx.xcodeprojinto Project Navigator
- Go to
Project > Targets > Build Phases > Link Binary With Libraries, click
- Reactive Extensions GitHub (GitHub)
- RxSwift RayWenderlich.com Book
- Boxue.io RxSwift Online Course (Chinese
- Erik Meijer (Wikipedia)
- Expert to Expert: Brian Beckman and Erik Meijer - Inside the .NET Reactive Framework (Rx) (video)
- Reactive Programming Overview (Jafar Husain from Netflix)
- Subject/Observer is Dual to Iterator (paper)
- Rx standard sequence operators visualized (visualization tool)