extrainteger/android-identitas-client

Android Oauth 2 client for Identitas

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.extrainteger:android-identitas-client:0.3.5'
	}

	dependencies {
		implementation("com.github.extrainteger:android-identitas-client:0.3.5")
	}

	<dependency>
	    <groupId>com.github.extrainteger</groupId>
	    <artifactId>android-identitas-client</artifactId>
	    <version>0.3.5</version>
	</dependency>


                            
    libraryDependencies += "com.github.extrainteger" % "android-identitas-client" % "0.3.5"


                            
    :dependencies [[com.github.extrainteger/android-identitas-client "0.3.5"]]

Readme

Android Oauth 2 client for Symbolic: Login button library

"Symbolic" is a project for centralizing peoples identity so people can easily use their identities to access various apps in the future. This library are part of that whole project, serves as oAuth in the project.

This library written in Kotlin. Sorry for inconsistency or dirty code, please give feedback to make this library better.

Get started

Add the following code to root-level build.gradle

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io' }
    }
}

next, add the following code to app-level build.gradle

dependencies {
    implementation 'com.github.extrainteger:android-identitas-client:[latest_version]'
}

Usage

I created this library as close as possible with existing usage like twitter and facebook. So, you should haven't too much problem to implement this library to your project.

First

Put this element to your activity_login.xml

    <com.extrainteger.symbolic.ui.SymbolicLoginButton
            android:id="@+id/loginButton"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />

Next step

Initialize a config in onCreate() method to setting up the login button in your LoginActivity.java

    String client_id = "your_client_id";
    String client_secret = "your_client_secret";
    String redirect_uri = "your_client_id";
    String base_url = "your_base_url"
    List<String> scopes = new ArrayList<>(); //you can leave it with empty data
    scopes.add(SymbolicScope.Companion.getPUBLIC()); // this addition just an example

    SymbolicConfig config = 
            new SymbolicConfig(context, base_url, client_id, client_secret, redirect_uri, scopes);
    
    loginButton.configure(config);

Next step

Set callback for the Login Button

    loginButton.setCallback(new Callback<SymbolicToken>() {
            @Override
            public void success(@NotNull Result<SymbolicToken> result) {
                //do some action after this login authorized and got some token
            }

            @Override
            public void failure(@NotNull SymbolicException exception) {
                //do some handle when this login got error
            }
        });

Next step

Implement onActivityResult() method in your activity, do something like written below

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

Note:

Once you've done with Symbolic, don't forget to logout Symbolic, here's the code:

    SymbolicLoginButton.logOut(context);

Library

Retrofit

Gson

Okhttp

License

Copyright 2017 Extra Integer

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.