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();
}
Remark
Google auth
Please be reminded that to create an Android oauth client and fill in SHA1 of your release keystore for release build variant.
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.