A collection of static methods to perform various operations including color, device, drawable, package and SDK on Android 2.3 (API 9) and above devices.
Since v0.4.0, it uses 26.x.x support libraries so, minimum SDK will be Android 4.0 (API 14).
Since v2.0.0, it uses AndroidX so, first migrate your project to AndroidX.
It can be installed by adding the following dependency to your build.gradle file:
dependencies {
// For AndroidX enabled projects.
implementation 'com.pranavpandey.android:dynamic-utils:3.0.2'
// For legacy projects.
implementation 'com.pranavpandey.android:dynamic-utils:1.3.0'
}It is divided into different classes according to their category for easy understanding and usage. This library is fully commented so I am highlighting some of the functions below, keep exploring for more hidden features.
For complete reference, please read the documentation.
Helper class to perform animation related operations.
void playAnimation(view, animator)- Play an animator animation on a view.
Helper class to perform bitmap operations.
-
Bitmap getBitmapFormDrawable(drawable)- Get bitmap from the supplied drawable. -
Bitmap resizeBitmap(bitmap, newWidth, newHeight)- Resize bitmap to the new width and height. -
Bitmap applyColorFilter(bitmap, colorFilter)- Apply color filter on the supplied bitmap. -
Bitmap applyColorFilter(bitmap, color)- Apply monochrome color filter on the supplied bitmap. -
@ColorInt int getDominantColor(bitmap)- Extract the dominant color form the supplied bitmap.
Helper class to change colors dynamically.
-
@ColorInt int adjustAlpha(color, factor)- Adjust alpha of a color according to the given parameter. -
@ColorInt int calculateContrast(color1, color2)- Calculate color contrast difference between two colors based on luma value according to XYZ color space. -
@ColorInt int getAccentColor(color)- Calculate accent color based on the given color for dynamic theme generation. -
@ColorInt int getColorDarkness(color)- Calculate darkness of a color. -
@ColorInt int getContrastColor(color, contrastWithColor)- Calculate contrast of a color based on the given base color so that it will be visible always on top of the base color. -
@ColorInt int getLessVisibleColor(color)- Calculate less visible color of a given color. -
@ColorInt int getTintColor(color)- Calculate tint based on a given color for better readability. -
boolean isColorDark(color)- Detect light or dark color. -
@ColorInt int shiftColor(color, by)- Shift a color according to the given parameter.
Helper class to detect device specific features like Telephony, etc.
boolean hasTelephony(context)- To detect if device has telephony feature or not by using PackageManager.
Helper class to perform drawable operations.
-
void colorizeDrawable(drawable, wrap, color, mode)- Colorize and return the mutated drawable so that, all other references do not change. -
Drawable setBackground(view, drawable)- Set background of a given view in an efficient way by detecting the Android SDK at runtime.
A collection of functions to perform various operations on the URL or to generate intents.
-
void shareApp(context, title, message)- Share application via system default share intent so that user can select from the available apps if more than one apps are available. -
void viewInGooglePlay(context, packageName)- View app in the Google Play or Android Market. -
void rateApp(context)- View app in the Google Play or Android Market. -
void moreApps(context, publisher)- View other apps of a Publisher in the Google Play or Android Market. -
void viewUrl(context, url)- View any URL in the available app or browser. -
void report(context, appName, email)- Ask questions or submit bug report to the developer via email.
Helper class to get package or app related information.
-
ComponentName getComponentName(context)- Get component name from the given context. -
CharSequence getAppLabel(context)- Get application label from the given context. -
String getAppVersion(context)- Get application version name from the given context. -
Drawable getAppIcon(context)- Load application icon from the given context. -
boolean isSystemApp(applicationInfo)- To detect the given ApplicationInfo is a system app or not.
Helper class to perform unit conversions.
-
int convertDpToPixels(dp)- To convert DP into pixels. -
int convertPixelsToDp(pixels)- To convert pixels into DP. -
int convertSpToPixels(sp)- To convert SP into pixels. -
int convertPixelsToSp(pixels)- To convert pixels into SP.
Helper class to detect the Android SDK version at runtime so that we can provide the user
experience accordingly. Pass true in the alternate method to check for equality.
-
boolean is14()- To detect if the current API version is 14 (Android 4.0) or above. -
boolean is14(equals)- To detect if the current API version is 14 (Android 4.0) or above.
...
-
boolean is29()- To detect if the current API version is 29 (Android 10) or above. -
boolean is29(equals)- To detect if the current API version is 29 (Android 10) or above.
Helper class to perform view operations.
-
void setLightStatusBar(view, isLight)- Set light status bar if we are using light primary color on Android M or above devices. -
void setLightNavigationBar(view, isLight)- Set light navigation bar if we are using light primary color on API 26 and above devices.
Helper class to perform window operations and to detect system configurations at runtime.
-
Point getAppUsableScreenSize(context)- Get the app usable screen size. -
Point getRealScreenSize(context)- Get the real screen size. -
Point getNavigationBarSize(context)- Get the on-screen navigation bar size. -
boolean isNavigationBarPresent(context)- Detect if on-screen navigation bar is present or not. -
boolean isNavigationBarThemeSupported(context)- Detect support for navigation bar theme.
- German (de) - Flubberlutsch
- Hindi (hi) - Siddh Narhari
- Indonesian (in) - Gamal Kevin A
- Italian (it) - Nicola
- Spanish (es) - Dave
- Turkish (tr) - Fatih Fırıncı
- Chinese (Simplified) (zh-rCN) - John Canny
Pranav Pandey
Copyright 2019 Pranav Pandey
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.