WPP-Public/Login-Android

Drop in layout element for Android that implements common UI login patterns

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.VML:Login-Android:'
	}

	dependencies {
		implementation("com.github.VML:Login-Android:")
	}

	<dependency>
	    <groupId>com.github.VML</groupId>
	    <artifactId>Login-Android</artifactId>
	    <version></version>
	</dependency>


                            
    libraryDependencies += "com.github.VML" % "Login-Android" % ""


                            
    :dependencies [[com.github.VML/Login-Android ""]]

Readme

Drop in layout element that implements common UI login patterns. Includes:

Login with email and password
Create account from email and password
Reset password from email
Save and auto-fill email/password with SmartLock
Login with Google
Login with Facebook
Login with email only (no password)

Usage

Add the layout element to any activity layout file:

    <com.vml.login.LoginLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/login_view"
        app:showFacebookLogin="false"
        app:showPasswordLogin="true"
        app:showGoogleLogin="false"
        app:showSmartLock="true"/>

In your activity's onCreate method, find your LoginLayout and set a FormListener:

    LoginLayout loginLayout = (LoginLayout) findViewById(R.id.login_view);

    loginLayout.setFormListener(new FormListener() {
        @Override
        public void onLoginFormSubmitted(String email, String password) {
            //do custom authentication here, then...
            loginLayout.loginSucceeded(new LoginData(...));
        }

        @Override
        public void onCreateAccountFormSubmitted(String email, String password) {
            //create account
            //log user in
            loginLayout.loginSucceeded(new LoginData(...));
        }

        @Override
        public void onForgotPasswordFormSubmitted(String email) {
            //send password reset email
        }

        @Override
        public boolean onViewCreateAccountButtonClicked() {
            return false;
        }

        @Override
        public boolean onViewForgotPasswordButtonClicked() {
            return false;
        }

        @Override
        public void onLoginCompleted(LoginData loginData) {
            LoginDataStore.of(getApplicationContext()).put(loginData);
            finish();
        }
    });

Then add the following hooks to your activity's lifecycle methods:

    @Override
    protected void onDestroy() {
        loginLayout.onDestroy();
        super.onDestroy();
    }

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

See full examples here.

Install

Add jitpack to your root build.gradle:

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

Add dependency to your module build.gradle:

dependencies {
    compile 'com.github.VML:Login-Android:X.X.X'
}



License
-------

    Copyright 2016-Present VML

    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.