AappZ | A to Z Application Functions in One Library

Description

AappZ library is an all in one A-Z library for android application.

Content

AappZ library offers convenient tools for android application:

• ActionBarZ: Some functions for customize ActionBar
• ActivityZ: Activity class extends AppCompatActivity
• DateZ: Date class for datetime and timestamp
• DayZ: Get current day state with custom 24 hours
• DelayZ: Create post delayed handler easily
• DeviceZ: Get identify installation/device ids
• DialogZ: Show dialog loading easily
• ExceptionZ: Some functions for handle exceptions
• EncryptZ: Simple customizable encryption and decryption
• IntentZ: Intent collections for any usage
• LocationZ: Simplified location and activity recognition
• LogZ: Log tools for debugging purpose
• NumberZ: Number converter and formatting tools
• PermissionZ: Some new runtime permissions functions
• PrefZ: Some functions for SharedPreferences
• TextZ: Text validation and formatting tools
• ThreadZ: Thread validation and limit tools
• ToastZ: Just toast for create any messages
• ViewZ: Some functions for view and layout

Bonus library:

• SDP: Library of a scalable size unit (for non-text views)
• SSP: Library of a scalable size unit (for text views)

Installation

If you already have jcenter() in your build.gradle. So, just add a dependency:

implementation 'io.github.fentonmartin:aappz:2.1.0'

Usage

Extend the AappZ in your base activity (recommended):

public class MainActivity extends AappZ...}

Or you could just extend ActivityZ instead:

public class MainActivity extends ActivityZ{...}

And that's it, now you can call any function directly:

setToast("Hello world!");

If want to use SDP or SSP, just call it from xml:

android:layout_height="@dimen/_120sdp"
android:textSize="@dimen/_16ssp"

If want to use PermissionZ, add this to your AndroidManifest.xml:

<activity android:name="io.github.fentonmartin.aappz.permission.PermissionActivity" />
Note: Remember to pass context using 'MainActivity.this', DO NOT pass 'getApplicationContext()'

---

RecyclerView Click and Snap Helper:

RecyclerItemClickListener (addOnItemTouchListener)
RecyclerViewSnapHelper (snapping any child view)

RecyclerView on Item View Click:

{
    if (view.getId() == R.id.some_layout_id) {
        ...
    }
}

If you only want to use basic functions (without it), just leave it. :)

Functions

ActionBarZ

• setActionBar
• setActionBar(boolean isMain)
• setActionBarHide()
• setActionBarFull()
• setTitle(int title)
• setTitle(String title)
• setSubtitle(int subtitle)
• setSubtitle(String subtitle)

DateZ

• getDateFrom(String pattern, String text)
• getDateTime()
• getDateTime(String pattern)
• getDateTimeFull()
• getDateTimeSimple()
• getDateHex()
• getDateHexFrom(String hex)
• getTimestamp()
• getTimestampString()
• getTimestamp(long timestamp)
• getTimestamp(String timestamp)
• getTimestamp(String pattern, long timestamp)
• getTimestamp(String pattern, String timestamp)
• getTimestampLongFrom(String pattern, String text)
• getTimestampStringFrom(String pattern, String text)
• getTimeRange(long timestamp)
• getTimeRange(String timestamp)
• getTimeRangeCheck(long timestamp, long limit)
• getTimeRangeCheck(String timestamp, long limit)
• getTimeRangeString(long timestamp)
• getTimeRangeString(String timestamp)
• getTimeRangeFrom(long time)
• getTimeRangeFrom(String time)
• getTimeRangeFrom(long time, String type)
• getTimeRangeFrom(String time, String type)
• getTimeRangeNowFrom(long timestamp)
• getTimeRangeNowFrom(String timestamp)
• getTimeRangeNowFrom(long timestamp, String type)
• getTimeRangeNowFrom(String timestamp, String type)

DayZ

• getCurrentDay()
• getCurrentDay(Calendar calendar)
• getCurrentDay(int morning, int afternoon, int evening, int night)
• getCurrentDay(Calendar calendar, int m, int a, int e, int n)
• getGreetDay(Calendar cal)
• getGreetDay(Calendar cal, String gr.., gre.., gr.., gr..)
• getGreetDay(Calendar cal, String name)
• getGreetDay(Calendar cal, String name, String gr.., gre.., gr.., gr..)

DelayZ

• post(long millis, final Callback callback)
• post(long millis, Runnable runnable)
• cancel(Runnable runnable)
• cancel()

DeviceZ

• getAndroidID(Context context)
• getUUID()
• getIMEI(Context context)
• getMacAddress(Context context)
• getPseudoUniqueID()
• getPhoneModel()

DialogZ

• setViewDialogDismiss()
• setViewLoadingDialog(boolean isShow)
• setViewLoadingDialog(boolean isShow, String title)
• setViewNormalDialog(String message)
• setViewNormalDialog(String message, Callback callback)
• setViewNormalDialog(String title, String message)
• setViewNormalDialog(String title, String m, Callback callback)
• setViewNormalDialog(String title, String m, String b)
• setViewNormalDialog(String t, String m, b, Callback callback)
• setViewNormalDialog(String t, String m, b1, b2, Callback callback)
• setViewNormalDialog(String t, String m, b1, b2, b3, Callback callback)
• setViewInputDialog(String message, Callback callback)
• setViewInputDialog(String t, String m, Callback callback)
• setViewInputDialog(String t, String m, String b, Callback callback)
• hideKeyboard(View view)

ExceptionZ

• setDefaultUncaughtException(Class activity)
• setDefaultUncaughtException(UncaughtExceptionHandler..)
• setUncaughtExceptionHandler(Throwable throwable, Class activity)
• getRootException(Throwable exception)

EncryptZ

• encryptTo(String text, String key)
• decryptTo(String text, String key)

IntentZ

• setActivity(Class activity)
• setActivity(Class activity, int flag)
• setActivity(Class activity, boolean bool)
• setActivity(Class activity, String text)
• setActivity(Class activity, Bundle bundle)
• setActivityClear(Class activity)
• setActivityEmail(int email, int subject)
• setActivityEmail(String email, String subject)
• setActivityMarket(int id)
• setActivityMarket(String id)
• setActivityShare(int subject, int text)
• setActivityShare(String subject, String text)
• setActivityShare(int subject, int text, int chooser)
• setActivityShare(String subject, String text, String chooser)
• setActivityWebsite(int website)
• setActivityWebsite(String website)

LocationZ

• LocationZ.with(context).activity().start(..);
• LocationZ.with(context).activity().stop();
• LocationZ.with(context).geocoding().add(..).add(..).start(..);
• LocationZ.with(context).geocoding().direct(..);
• LocationZ.with(context).geocoding().reverse(..);
• LocationZ.with(context).geocoding().stop();
• LocationZ.with(context).location().start(..);
• LocationZ.with(context).location().oneFix().start(..);
• LocationZ.with(context).location().state().locationServicesEnabled();
• LocationZ.with(context).location().state().isAnyProviderAvailable();
• LocationZ.with(context).location().state().isGpsAvailable();
• LocationZ.with(context).location().state().isNetworkAvailable();
• LocationZ.with(context).location().state().isPassiveAvailable();
• LocationZ.with(context).location().state().isMockSettingEnabled();
• LocationZ.with(context).location(..).start(..);
• LocationZ.with(context).location().stop();

LogZ

• setLog(boolean isDebug)
• setLog(String log)
• setLog(Activity activity, String log)

NumberZ

• getRandom()
• toHex(int number)
• toHex(long number)
• toOctal(int number)
• toOctal(long number)
• toBinary(int number)
• toBinary(long number)
• fromHex(String number)
• fromOctal(String number)

PermissionZ

• check(Context context, String permission)
• check(Context context, String perms, PermissionHandler handler)
• check(Context context, String perms, String rat, PermissionHandler..)
• check(Context context, String perms, int ratId, PermissionHandler..)
• check(final Context c, String[] perms)
• check(final Context c, String[] perms, PermissionHandler..)
• check(final Context c, String[] perms, String rat, Options o, PermsH..)
• check(final Context c, String[] perms, int ratId, Options o, PermsH..)
• hasPermission(String... permissions)

PrefZ

• getAll()
• contains(final String key)
• remove(final String key)
• setInt(final String key, final int value)
• setBoolean(final String key, final boolean value)
• setLong(final String key, final long value)
• setDouble(final String key, final double value)
• setFloat(final String key, final float value)
• setString(final String key, final String value)
• setStringSet(final String key, final Set value)
• setStringSetOrdered(String key, Set value)
• getInt(final String key, final int defValue)
• getBoolean(final String key, final boolean defValue)
• getLong(final String key, final long defValue)
• getDouble(final String key, final double defValue)
• getFloat(final String key, final float defValue)
• getString(final String key, final String defValue)
• getStringSet(final String key, final Set defValue)
• getStringSetOrdered(String key, final Set defValue)

TextZ

• isEmailValid(String email)
• isPhoneValid(String phone)
• isTextLength(String text, int min)
• isTextLength(String text, int min, int max)
• isTextMatch(String text1, String text2)
• isTextContain(String text, String contain)
• getDecimalFormat(int number, int digits)
• getDecimalFormat(float number, int digits)
• getDecimalFormat(double number, int digits)
• getDecimalFormat(long number, int digits)
• getNumber(String number)
• getNumberFormat(String number)
• getNumberFormat(String number, boolean isUseDotSeparator)
• getNumberRandom()
• getMoneyFormat(String number)
• getMoneyFormat(String currency, String number)
• getMoneyFormat(String currency, String number, String postCurrency)
• getMoneyFormat(String number, boolean isUseDotSeparator)
• getMoneyFormat(String curr, String num, boolean isUseDotSeparator)
• getMoneyFormat(String curr, String num, String postCurr, boolean isDot)
• getFormatAll(String text)
• getFormatName(String name)
• getFormatSpace(String text)
• getFormatEnter(String text)
• getArrayCharFrom(String text)
• getArrayFrom(String text, int n)
• getArrayFrom(String text)
• getStringFrom(List list)
• getStringFrom(List list, String delimiter)
• getListFrom(String text)
• getListFrom(String text, String delimiter)

ThreadZ

• valid(long timestamp, Callback callback)
• valid(long timestamp, long limit, Callback callback)

ToastZ

• setToast(String message)
• setToast(CharSequence message)

ViewZ

• getValue(EditText editText)
• getValueBoolean(EditText editText)
• getValueInt(EditText editText)
• getValueLong(EditText text)
• getValueNumber(EditText text)
• setViewBounce(View view)
• setViewEnabled(View view, boolean isEnabled)
• setViewEnabled(View v, float alpha, boolean isEnabled)
• hideKeyboard(View view)
• showKeyboard(int id)
• showKeyboard(View view)

More information: AappZ's wiki

Components

ShadowLayout

ShadowLayout is a custom view group which wrap View and display shadow. ShadowLayout can draw square, rounded corner or circle shadow.

To draw shadow, Paint object with shadow layer is used. Bitmap is generated to set a background to ShadowLayout with padding, to prevent child view overlap shadow.

ShadowLayout Usage

<io.github.fentonmartin.aappz.view.ShadowLayout
        android:layout_marginTop="16dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:shadowRadius="4dp"
        app:shadowColor="#AA000000"
        app:dx="0dp"
        app:dy="0dp"
        app:cornerRadius="56dp">

    <ImageButton
            android:layout_width="56dp"
            android:layout_height="56dp"
            android:src="@drawable/ic_add_white"
            android:background="@drawable/fab_selector"
            tools:ignore="ContentDescription"/>

</io.github.fentonmartin.aappz.view.ShadowLayout>

Explanation:

• app:cornerRadius="56dp" - set corner radius to the same value as child view size to make it circle.
• app:dx="0dp" app:dy="0dp" - centered offset shadow.
• app:shadowColor="#AA000000"- set shadow color.
• app:shadowRadius="4dp"- shadow radius (shadow distance and bluer - works as elevation)

Alternative:

• app:dx="2dp" app:dy="2dp" - offset shadow to right and bottom for 2dp.

License

AappZ library by Fenton Martin is licensed under an Apache License 2.0.