Github url

RxAndroid

by ReactiveX

ReactiveX /RxAndroid

RxJava bindings for Android

19.1K Stars 3.0K Forks Last release: 6 months ago (3.0.0) Apache License 2.0 510 Commits 19 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

RxAndroid: Reactive Extensions for Android

Android specific bindings for RxJava 3.

This module adds the minimum classes to RxJava that make writing reactive components in Android applications easy and hassle-free. More specifically, it provides a

Scheduler

that schedules on the main thread or any given

Looper

.

Communication

Since RxAndroid is part of the RxJava family the communication channels are similar:

Binaries

allprojects { repositories { maven { url "https://oss.jfrog.org/libs-snapshot" } } } dependencies { implementation 'io.reactivex.rxjava3:rxandroid:3.0.0' // Because RxAndroid releases are few and far between, it is recommended you also // explicitly depend on RxJava's latest version for bug fixes and new features. // (see https://github.com/ReactiveX/RxJava/releases for latest 3.x.x version) implementation 'io.reactivex.rxjava3:rxjava:3.0.0' }
  • RxAndroid:
  • RxJava:

Additional binaries and dependency information for can be found at search.maven.org.

Build

To build:

$ git clone [email protected]:ReactiveX/RxAndroid.git $ cd RxAndroid/ $ ./gradlew build

Further details on building can be found on the RxJava Getting Started page of the wiki.

Sample usage

A sample project which provides runnable code examples that demonstrate uses of the classes in this project is available in the

sample-app/

folder.

Observing on the main thread

One of the most common operations when dealing with asynchronous tasks on Android is to observe the task's result or outcome on the main thread. Using vanilla Android, this would typically be accomplished with an

AsyncTask

. With RxJava instead you would declare your

Observable

to be observed on the main thread:

Observable.just("one", "two", "three", "four", "five") .subscribeOn(Schedulers.newThread()) .observeOn(AndroidSchedulers.mainThread()) .subscribe(/\* an Observer \*/);

This will execute the

Observable

on a new thread, and emit results through

onNext

on the main thread.

Observing on arbitrary loopers

The previous sample is merely a specialization of a more general concept: binding asynchronous communication to an Android message loop, or

Looper

. In order to observe an

Observable

on an arbitrary

Looper

, create an associated

Scheduler

by calling

AndroidSchedulers.from

:

Looper backgroundLooper = // ... Observable.just("one", "two", "three", "four", "five") .observeOn(AndroidSchedulers.from(backgroundLooper)) .subscribe(/\* an Observer \*/)

This will execute the Observable on a new thread and emit results through

onNext

on whatever thread is running

backgroundLooper

.

Bugs and Feedback

For bugs, feature requests, and discussion please use GitHub Issues. For general usage questions please use the mailing list or StackOverflow.

LICENSE

Copyright 2015 The RxAndroid authors Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.