BaseAuth
Easily set up phone authentication leveraging on different auth platforms (like firebase, sinch and many more to be added) of your choice. With a simple User Interface that can be styled to blend with the theme of your app, you can focus more on other functional requirement of the app other than the authentication process
Current Support
compile 'xyz.belvi.auth:baseauth-firebase:1.0.5' compile 'xyz.belvi.auth:baseauth-sinch:1.0.5' compile 'xyz.belvi.auth:baseauth-nexmo:1.0.5'Sample
Adding as a dependency
add jcenter({
url "http://dl.bintray.com/kingsmentor/maven"
}
) to your project / root build.gradle like so:
... allprojects {
repositories {
jcenter({
url "http://dl.bintray.com/kingsmentor/maven"
}
)
}
}
...Core
Not Available in 1.0.5
core provides access to other underlying auth platform. Only use core if you intend to perform phone number authetication using multiple auth providers.
dependencies {
compile 'xyz.belvi.auth:baseauth-core:1.0.3'
}
Firebase
This module handles phone number authentication using firebase.
dependencies {
compile 'xyz.belvi.auth:baseauth-firebase:1.0.5'
}
Sinch
This module handles phone number authentication using sinch.
dependencies {
compile 'xyz.belvi.auth:baseauth-sinch:1.0.5'
}
Using the Library:
As Firebase :
FireAuthActivity.startFirebasePhoneAuth(this, new FirebaseAuthListener() {
@Override
public void authIgnored() {
// user existed without autheticating
}
@Override
public void helpClicked(Context context) {
// Help icon is cliced. You might want to do something here.
}
@Override
public void onAuthCompleted(PhoneAuthCredential credential, String phoneNumber) {
// do something with Firebase PhoneAuthCredential and the autheticated phone number
}
}
, R.style.BaseAuthStyle);
As Sinch :
SinchAuthActivity.startSinchAuth(this, new SinchAuthListener() {
public void onAuthCompleted(String phoneNumber) {
}
public void authIgnored() {
}
public void helpClicked(Context activity) {
}
}
, "API_KEY", R.style.BaseAuthStyle);
As Nemo :
NexmoAuthActivity.startNexmoAuth(this, new NexmoAuthListener() {
public void onAuthCompleted(String phoneNumber) {
Toast.makeText(MainActivity.this, phoneNumber, Toast.LENGTH_LONG).show();
}
public void authIgnored() {
}
public void helpClicked(Context activity) {
}
}
, new NexmoAuth("YOUR_API_ID", "YOUR_SHARED_SECRET", PIN_LENGTH), R.style.BaseAuthStyle);
Styling and Theming
define style in styles.xml
<style name="BaseAuthStyle">
<item name="ba_show_help">true</item>
</style>ba_show_help determines if the help icon will be shown or not.
layout resources are referenced in corresponding resource xml files.
you can override any of the resource to suit your need.
color.xml
<resources>
<color name="ba_colorPrimary">#42a5f5</color>
<color name="ba_colorPrimaryDark">#253493</color>
<color name="ba_colorAccent">#FF4081</color>
<color name="ba_txt_error">#FF4081</color>
<color name="ba_blue">#42a5f5</color>
<color name="ba_background">#fcfcfc</color>
<color name="ba_btn_disabled">#dfdfdf</color>
<color name="ba_btn_enabled">#ffffff</color>
<color name="ba_txt_grey">#696969</color>
<color name="ba_auth_code">#42a5f5</color>
<color name="ba_white">#FFFFFF</color>
<color name="ba_country_selector_code_color">#787878</color>
<color name="ba_country_selector_bg_color">#FFFFFF</color>
<color name="ba_country_selector_name_color">#000000</color> </resources> strings.xml
<resources>
<string name="app_name">BaseAuth</string>
<string name="help">Help</string>
<string name="select_country">Select your country</string>
<string name="type_in">Please type in the verification code sent to %s</string>
<string name="verify_number">Verify your number</string>
<string name="phone_hint">Your phone number</string>
<string name="cc_hint">Your country code</string>
<string name="btn_next_title">Next</string>
<string name="verification_code">Verification Code</string>
<string name="received_question">Didn\'t receive code ?</string>
<string name="wait_field">Please wait</string>
<string name="help_link">http://www.example.com</string>
<string name="charges_desc">We will send you a one-off SMS message. Carrier charges may apply.</string>
<string name="details_desc">Enter your country code and phone number for verification</string> </resources> dimens.xml
<resources>
<dimen name="ba_layout_padding">32dp</dimen>
<dimen name="verification_code_text_size">24sp</dimen>
<dimen name="vc_txt_size">18sp</dimen>
<dimen name="type_in_desc_txt_size">16sp</dimen>
<dimen name="type_in_desc_margin_top">32dp</dimen>
<dimen name="type_in_desc_margin_bottom">16dp</dimen>
<dimen name="verification_layout_padding">32dp</dimen>
<dimen name="verification_code_width">42dp</dimen>
<dimen name="details_desc">16sp</dimen>
<dimen name="details_margin_top">16dp</dimen>
<dimen name="phone_field_text_size">18sp</dimen>
<dimen name="next_btn_txt_size">14sp</dimen>
<dimen name="next_btn_padding">16dp</dimen>
<dimen name="wait_field_txt_size">16sp</dimen>
<dimen name="wait_field_top_margin">8dp</dimen>
<dimen name="receive_code_confirmation">14sp</dimen>
<dimen name="receive_code_confirmation_top_margin">16dp</dimen>
<dimen name="verification_status_text_size">12sp</dimen>
<dimen name="verification_status_top_margin">16dp</dimen> </resources>