Android-Utils: A Collection of Android Utils

1. Introcution

This project is mainly used to collect utils classes useful in Android development, for example, log, crash collection, resources, attr, runtime permission, toast etc so that to accelerate your Android evelopment.

2. Use in your project

2.1 Add dependency

This project is published to jCenter, so you can easily use it in your project.

First, you need to add jcenter in your project:

repositories { mavenCentral() }

then, add dependencies in your project:

implementation "com.github.Shouheng88:utils-core:$latest-version"

If you want to use the kotlin extension based on utils classes, use the dependency below:

implementation "com.github.Shouheng88:utils-ktx:$latest-version"

2.2 Initialize

You need initialize utils in your application. This is mainly used to get a global context to make utils methods more convenient, and it will cost too much time of launching your App.

public class SampleApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        // initialize your library
        UtilsApp.init(this);
    }
}

2.2 Fetures and functions

The utils classes was divided into multiple groups:

2.3 Use Utils-ktx

utils-ktx is a kotlin extension based on Android-Utils, which is used to simplify usages of utils classes. For example, if you want to get a drawable, tint it and then display it in ImageView. One line is enough:

iv.icon = drawableOf(R.drawable.ic_add_circle).tint(Color.WHITE)

If you want to request runtime permission in Activity, what you need to do is only writing one line below,

checkStoragePermission {  /* got permission */ }

As for avoding continous click, you only need one line,

btnRateIntro.onDebouncedClick { /* do something */ }

All in all, by utils-ktx you can significantly lower the difficulty of development.

2.3 Proguard rules

# Add MMKV classname
-keepnames class com.tencent.mmkv.MMKV

3、About

3.1 Change log

Log

License

Copyright (c) 2019-2021 wsh.

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.