Parse Android SDK

The Parse community provides several specialized libraries to extend functionality:

• ParseGoogleUtils: Google login/signup.
• ParseFacebookUtils: Facebook login/signup.
• ParseTwitterUtils: Twitter login/signup.
• Parse FCM: Firebase Cloud Messaging support for push notifications.
• Parse KTX: Kotlin extensions for ease of use.
• Parse Coroutines: Kotlin Coroutines support for async operations.
• Parse RxJava: Transform Parse Tasks to RxJava Completables and Singles.
• ParseLiveQuery: Realtime query subscription.
• ParseUI: Prebuilt UI elements.

The KTX module provides property delegates to eliminate the boilerplate of writing manual get() and set() methods for ParseObject attributes. Instead of manually calling getString(), put(), or getInt(), you can use delegates like stringAttribute() and intAttribute() directly on your class properties.

@ParseClassName("Cat")
class Cat : ParseObject() {

    var name: String by stringAttribute() // That's it
    var legs: Int by intAttribute("cat-legs")

}

To use RxJava 3 support with the Parse Android SDK, add the following dependency to your build.gradle file. Ensure you have JitPack configured in your project first.

dependencies {
    implementation "com.github.parse-community.Parse-SDK-Android:rxjava:latest.version.here"
}

To use Parse Google Utils for Android, add the following dependency to your build.gradle file. Ensure you have JitPack included in your project repositories.

dependencies {
    implementation "com.github.parse-community.Parse-SDK-Android:google:latest.version.here"
}

Call ParseFacebookUtils.initialize(context) during your application startup (e.g., in Application.onCreate()) to prepare the utility library.

// in Application.onCreate(); or somewhere similar
ParseFacebookUtils.initialize(context);

RxJava support is provided as extension methods on any Task. You can convert a Task<T> into a Single<T> or a Task<Void> into a Completable.

// Converting a Task<ParseUser> to a Single
ParseTwitterUtils.logInInBackground(this)
    .toSingle()
    .subscribeOn(Schedulers.io())
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe({
        Timber.d("Logged in with user ${it.objectId}")
    }, {
        Timber.e(it)
    })

// Converting a Task<Void> to a Completable
val user = ParseUser.getCurrentUser()
user.put("lastLoggedIn", System.currentTimeMillis())
user.saveInBackground().toCompletable()
    .subscribeOn(Schedulers.io())
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe({
        Timber.d("user saved")
    }, {
        Timber.e(it)
    })

In the Activity where the user performs the login, you must override onActivityResult and pass the result to ParseFacebookUtils.onActivityResult to ensure the Facebook SDK processes the login response correctly.

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  ParseFacebookUtils.onActivityResult(requestCode, resultCode, data);
}

To use Kotlin extension functions and property delegation for ParseObject subclasses, add the KTX module to your Gradle dependencies. Ensure you have JitPack configured in your project first.

dependencies {
    implementation "com.github.parse-community.Parse-SDK-Android:ktx:latest.version.here"
}