Any kinds of contributions including pull requests, writing issues, email me personally are always welcome. Let me know if you have any idea about basic utils for Android development.
- Get started
- Utils
- Upcoming utils
- AgeUtil
- AudioManagerUtil
- AwakeUtil
- BitmapUtil
- DateUtil
- EmailUtil
- FileUtil
- LanguageDetector
- NetworkUtil
- PhotoUtil
- RippleUtil
- Validator
- Contributors
- License
Release is in process...
buildscript {
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
}
apply plugin: 'com.neenbedankt.android-apt'
dependencies {
compile 'com.thefinestartist:utils:0.8.3'
apt 'com.thefinestartist:compilers:0.8.3'
}Call Base.initialize(context) within your Application onCreate() method.
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
Base.initialize(this);
}
}Base helps to get Context, Resources, Assets, Configuration and DisplayMetrics in any class.
void Base.initialize(Context context);
Context Base.getContext();
Resources Base.getResources();
Theme Base.getTheme();
AssetManager Base.getAssets();
Configuration Base.getConfiguration();
DisplayMetrics Base.getDisplayMetrics();ContextUtil helps to use Context conveniently.
boolean bindService(Intent service, ServiceConnection conn, int flags);
int checkCallingOrSelfPermission(String permission);
int checkSelfPermission(@NonNull String permission);
void enforceCallingOrSelfPermission(String permission, String message);
void enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message);
ApplicationInfo getApplicationInfo();
File getCacheDir();
File getExternalCacheDir();
File getExternalFilesDir(String type);
Looper getMainLooper();
Object getSystemService(String name);
void sendBroadcast(Intent intent, String receiverPermission);
void sendBroadcast(Intent intent);
boolean startActivities(Intent[] intents, Bundle options);
boolean startActivities(Intent[] intents);
void startActivity(@NonNull Intent intent);
void startActivity(Intent intent, Bundle options);
ComponentName startService(Intent service);
boolean stopService(Intent service);
void unbindService(ServiceConnection conn);
// and so on...ResourcesUtil helps to use Resources conveniently.
XmlResourceParser getAnimation(@AnimRes int animRes);
boolean getBoolean(@BoolRes int boolRes);
int getColor(@ColorRes int colorRes);
int getColor(@ColorRes int colorRes, Resources.Theme theme);
ColorStateList getColorStateList(@ColorRes int colorRes);
ColorStateList getColorStateList(@ColorRes int colorRes, Resources.Theme theme);
float getDimension(@DimenRes int dimenRes);
int getDimensionPixelOffset(@DimenRes int dimenRes);
int getDimensionPixelSize(@DimenRes int dimenRes);
DisplayMetrics getDisplayMetrics();
Drawable getDrawable(@DrawableRes int drawableRes);
int getIdentifier(String name, String defType, String defPackage);
int[] getIntArray(@ArrayRes int arrayRes);
int getInteger(@IntegerRes int integerRes);
XmlResourceParser getLayout(@LayoutRes int layoutRes);
String getQuantityString(int id, int quantity, Object... formatArgs);
CharSequence getQuantityText(int id, int quantity);
String getResourceEntryName(@AnyRes int anyRes);
String getResourceName(@AnyRes int anyRes);
String getResourcePackageName(@AnyRes int anyRes);
String getResourceTypeName(@AnyRes int anyRes);
String getString(@StringRes int stringRes);
String getString(@StringRes int stringRes, Object... formatArgs);
String[] getStringArray(@ArrayRes int arrayRes);
CharSequence getText(@StringRes int stringRes, CharSequence def);
CharSequence getText(@StringRes int stringRes);
CharSequence[] getTextArray(@ArrayRes int arrayRes);
void getValue(String name, TypedValue outValue, boolean resolveRefs);
void getValue(@AnyRes int anyRes, TypedValue outValue, boolean resolveRefs);
void getValueForDensity(@AnyRes int anyRes, int density, TypedValue outValue, boolean resolveRefs);
XmlResourceParser getXml(@XmlRes int xmlRes);
TypedArray obtainAttributes(AttributeSet set, int[] attrs);
TypedArray obtainTypedArray(@ArrayRes int anyRes);
InputStream openRawResource(@RawRes int rawRes);
AssetFileDescriptor openRawResourceFd(@RawRes int rawRes);
int[] getColorArray(@ArrayRes int array);
// and so on...Simply call ExtrasBinder.bind(this) in your Activity or Fragment. ExtrasBinder binds data from Intent or Bundle to matching variable. ExtrasBinder will consider annotation variable as key. If there is no annotation variable, it will consider variable name as key.
// Start YourActivity with extras
Intent intent = new Intent(this, YourActivity.class);
intent.putExtra(YourActivity.EXTRA_TITLE, "Activity title");
intent.putExtra("ids", new ArrayList<Integer>());
startActivity(intent);public class YourActivity extends AppCompatActivity {
public static final String EXTRA_TITLE = "TITLE";
@Extra(EXTRA_TITLE) String title;
@Extra ArrayList<Integer> ids;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ExtrasBinder.bind(this);
// do something...
}
}// Show YourFragment with extras
YourFragment fragment = new YourFragment();
Bundle bundle = new Bundle();
bundle.putString("Name", "Fragment name");
fragment.setArguments(bundle);public class YourFragment extends Fragment {
@Extra("NAME") String name;
@Nullable
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
ExtrasBinder.bind(this);
// do something...
}
}Proguard
-keep class com.thefinestartist.annotations.** { *; }
-keep class **$$ExtraBinder { *; }
-keepclasseswithmembernames class * {
@com.thefinestartist.annotations.Extra <fields>;
}KeyboardUtil helps to show and hide keyboard conveniently.
void KeyboardUtil.show(View);
void KeyboardUtil.showImmediately(View); // Call this method if your activity or fragment is resumed.
void KeyboardUtil.hide(View);
void KeyboardUtil.hide(Activity);
void KeyboardUtil.hide(Fragment);
void KeyboardUtil.hide(Dialog);UnitConverter helps to convert dp or sp size into pixel.
float UnitConverter.dpToPx(float dp);
int UnitConverter.dpToPx(int dp);
float UnitConverter.pxToDp(float px);
int UnitConverter.pxToDp(int px);
float UnitConverter.spToPx(float sp);
int UnitConverter.spToPx(int sp);
float UnitConverter.pxToSp(float px);
int UnitConverter.pxToSp(int px);APILevel helps to check device API Build.VERSION conveniently.
boolean APILevel.require(int level); // Build.VERSION.SDK_INT >= level
boolean APILevel.requireCupcake();
boolean APILevel.requireDonut();
boolean APILevel.requireEclair();
boolean APILevel.requireFroyo();
boolean APILevel.requireGingerbread();
// and so on...
boolean APILevel.depecatedAt(int level); // Build.VERSION.SDK_INT < level
boolean APILevel.depecatedAtCupcake();
boolean APILevel.depecatedAtDonut();
boolean APILevel.depecatedAtEclair();
boolean APILevel.depecatedAtFroyo();
boolean APILevel.depecatedAtGingerbread();
// and so on...DisplayUtil helps to calculate screen size conveniently.
int DisplayUtil.getWidth();
int DisplayUtil.getHeight();
Rotation DisplayUtil.getRotation();
boolean DisplayUtil.isDisplayPortrait();
boolean DisplayUtil.isDisplayLandscape();
int DisplayUtil.getStatusBarHeight();
int DisplayUtil.getToolbarHeight();
int DisplayUtil.getActionBarHeight();
int DisplayUtil.getNavigationBarHeight(); // Navigation bar is located bottom of device for `back`, `home` and `menu` buttons.ViewUtil helps to set background drawable conveniently.
void ViewUtil.setBackground(View view, Drawable drawable);
void ViewUtil.setBackground(View view, int drawableRes);ServiceUtil helps to get Android system service conveniently.
Object ServiceUtil.getSystemService(Context.ServiceName);
AccessibilityManager ServiceUtil.getAccessibilityManager();
CaptioningManager ServiceUtil.getCaptioningManager();
AccountManager ServiceUtil.getAccountManager();
ActivityManager ServiceUtil.getActivityManager();
AlarmManager ServiceUtil.getAlarmManager();
AudioManager ServiceUtil.getAudioManager();
MediaRouter ServiceUtil.getMediaRouter();
// and so on...ThemeUtil helps to use Theme conveniently.
void applyStyle(int resId, boolean force);
void dump(int priority, String tag, String prefix);
int getChangingConfigurations();
Drawable getDrawable(@DrawableRes int drawableRes);
Resources getResources();
TypedArray obtainStyledAttributes(@StyleableRes int[] attrs);
TypedArray obtainStyledAttributes(@StyleRes int resid, @StyleableRes int[] attrs);
TypedArray obtainStyledAttributes(AttributeSet set, @StyleableRes int[] attrs, @AttrRes int defStyleAttr, @StyleRes int defStyleRes);
boolean resolveAttribute(int resid, TypedValue outValue, boolean resolveRefs);
void setTo(Resources.Theme other);ActivityBuilder helps to build Activity Intent and start Activity.
Constructor ActivityBuilder(@NonNull Class<C> clazz);
ActivityBuilder set(@NonNull String key, T value);
ActivityBuilder set(@NonNull String key, Parcelable value);
ActivityBuilder set(@NonNull String key, Parcelable[] value);
ActivityBuilder set(@NonNull String key, ArrayList<T> value);
ActivityBuilder remove(@NonNull String key);
ActivityBuilder setFlags(int flags);
ActivityBuilder addFlags(int flags);
Intent buildIntent();
void start();
void startForResult(@NonNull Activity activity, int requestCode);
void startForResult(@NonNull Activity activity, int requestCode, @Nullable Bundle options);new ActivityBuilder(YourActivity.class)
.set(YourActivity.TITLE, "Title")
.set(YourActivity.CONTENT, 1)
.set("values", new int[]{1, 2, 3})
.set(YourActivity.ARRAY_LIST, list)
.start();BundleBuilder helps to build Bundle conveniently.
BundleBuilder set(String key, T value);
T get(String key);
Bundle build();Bundle bundle = new BundleBuilder()
.set("values", new int[]{1, 2, 3})
.build();PackageUtil helps to handle methods related to package.
boolean isInstalled(String packageName);
String getPackageName();
void openPlayStore();
void openPlayStore(String packageName);VibratorUtil helps to use Vibrator conveniently.
void VibratorUtil.vibrate(); // vibrate device for 200 milliseconds
void VibratorUtil.vibrate(milliseconds);
// and more...ClipboardManagerUtil helps to use ClipboardManager conveniently.
void ClipboardManagerUtil.setText(CharSequence text);
boolean ClipboardManagerUtil.hasText();
CharSequence ClipboardManagerUtil.getText();TypedValueUtil helps to use TypedValue class conveniently.
float TypedValueUtil.applyDimension(int unit, float value);
float TypedValueUtil.complexToDimension(int data);
int TypedValueUtil.complexToDimensionPixelOffset(int data);
int TypedValueUtil.complexToDimensionPixelSize(int data);WindowManagerUtil helps to use Android {@link WindowManager} conveniently.
Display WindowManagerUtil.getDefaultDisplay();
void WindowManagerUtil.removeViewImmediate(View view);IntArrayUtil helps to deal with IntArray conveniently.
boolean contains(int[] array, int value);
int[] add(int[] array, int value);SparseArrayUtil helps to deal with SparseArray conveniently.
ArrayList<C> asArrayList(SparseArray<C> sparseArray);ThreadUtil helps to deal with thread conveniently.
boolean isMain();Leonardo Taehwan Kim
Marcos Trujillo
Min Kim
The MIT License (MIT)
Copyright (c) 2016 The Finest Artist
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.