SimpleAuth

A easy to use social authentication android library. (Facebook, Google, Twitter, Instagram)

Installation

In your project level build.gradle :

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

In your app level build.gradle :

dependencies {
    compile 'com.github.jaychang0917:SimpleAuth:{latest_version}'
}

Basic Usage

1. Configure the SimpleAuth

In your app level build.gradle, set up the configs. Leave the field empty if you don't need it, DON'T remove any fields.

android.defaultConfig.manifestPlaceholders = [
        facebookAppId        : "your facebook app id",
        googleWebClientId    : "your google web client id",
        twitterConsumerKey   : "your twitter consumer key",
        twitterConsumerSecret: "your twitter consumer secret",
        instagramClientId    : "your instagram client id",
        instagramClientSecret: "your instagram client secret",
        instagramRedirectUri : "your instagram redirect uri"
]

2. Connect it. Done!

void connectFacebook() {
  List<String> scopes = Arrays.asList("user_birthday", "user_friends");

  SimpleAuth.getInstance().connectFacebook(scopes, new AuthCallback() {
    @Override
    public void onSuccess(SocialUser socialUser) {
      Log.d(TAG, "userId:" + socialUser.userId)
      Log.d(TAG, "email:" + socialUser.email)
      Log.d(TAG, "accessToken:" + socialUser.accessToken)
      Log.d(TAG, "profilePictureUrl:" + socialUser.profilePictureUrl)
      Log.d(TAG, "username:" + socialUser.username)
      Log.d(TAG, "fullName:" + socialUser.fullName);
      Log.d(TAG, "pageLink:" + socialUser.pageLink)
    }

    @Override
    public void onError(Throwable error) {
      Log.d(TAG, error.getMessage());
    }

    @Override
    public void onCancel() {
      Log.d(TAG, "Canceled");
    }
  });
}

Advanced Usage

Disconnection

The active session will be cleared if the social app is installed in the device, otherwise app cookies will be cleared (i.e. user need to login again)

void disconnectFacebook() {
  SimpleAuth.getInstance().disconnectFacebook();
}

Revoke connected application

After revocation, the permissions authorization page should be shown again. Only facebook and google provide this function.

void revokeFacebook() {
  SimpleAuth.getInstance().revokeFacebook();
}

License

Copyright 2017 Jay Chang

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.