Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/michael-rapp/androidutil
Contains various utility classes for use in Android app development.
https://github.com/michael-rapp/androidutil
android utility
Last synced: about 2 months ago
JSON representation
Contains various utility classes for use in Android app development.
- Host: GitHub
- URL: https://github.com/michael-rapp/androidutil
- Owner: michael-rapp
- License: apache-2.0
- Created: 2015-10-13T21:25:38.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-12-28T01:07:41.000Z (about 5 years ago)
- Last Synced: 2024-02-26T19:49:10.486Z (10 months ago)
- Topics: android, utility
- Language: Java
- Homepage:
- Size: 3.73 MB
- Stars: 11
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# AndroidUtil - README
[](https://android-arsenal.com/api?level=14) [](https://opensource.org/licenses/Apache-2.0) [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=X75YSLEJV3DWE)
"AndroidUtil" is an Android-library, which provides various utility classes for use in Android app development. The library currently provides the following features:
- The class `BitmapUtil` provides methods, which allow to create and edit bitmaps, e.g. clipping them.
- The class `DisplayUtil` provides methods, which are related to a device's display metrics, e.g. converting DP values to pixel values and vice versa.
- The class `ElevationUtil` provides methods, which can be used to emulate elevations of views on pre-Lollipop devices. The view `ElevationShadowView` can be used to easily visualize such an elevation within a layout.
- The class `AppUtil` provides methods, which allow to start system apps.
- The class `PermissionUtil` provides methods, which allow to handle runtime permissions.
- The class `ViewUtil` provides methods, which allow to handle views.
- The class `FileUtil` provides methods, which allow to handle files.
- The class `ThreadUtil` provides methods, which allow to handle threads.
- The class `ArrayUtil` provides methods, which allow to handle arrays.
- The view `UnfocusableToolbar` extends the AppCompat support library's `Toolbar` to enable touch events to be passed to other views in the event processing chain.
- The view `SquareImageView` implements an `ImageView` whose height is enforced to be equal to its width.
- The view `ScrimInsetsLayout` implements a layout, which allows to show a `Drawable` in the insets, which are passed to its `fitSystemWindows`-method. This can for example be used to implement a navigation drawer, which appears to be located behind the device's status bar.
- The view `HeaderAndFooterGridView` extends the Android SDK's `GridView` with the functionality to add header and footer views.
- The view `ExpandableGridView` extends the `HeaderAndFooterGridView` with the ability to show multiple groups, which can be expanded to show their children.
- The view `HeaderAndFooterRecyclerView` extends the RecyclerView Support library's `RecyclerView` with the functionality to add header and footer views.
- The class `AbstractSavedState` can be used as a base class for storing the state of views. It is identical to the Android SDK's class `android.view.AbsSavedState`, but uses a custom class loader and is therefore suited for being used in library projects.
- The class `Logger` allows to write log messages to Logcat. By applying a log level, log messages can be filtered depending on their priority.
- The class `ViewHolder` and `AbstractViewHolderAdapter` allow to use the view holder pattern in custom adapter implementations.
- The class `DragHelper` allows to measure the distance and speed of drag gestures.
- The classes `ViewRecycler` and `AttachedViewRecycler` allow to cache views in order to reuse them instead of inflating new instances.
- The class `AbstractDataBinder` allows to asynchronously load data in order to display it by using recyclable views.
This library depends on the library [JavaUtil](https://github.com/michael-rapp/JavaUtil) that provides additional utility classes.
## License Agreement
This project is distributed under the Apache License version 2.0. For further information about this license agreement's content please refer to its full version, which is available at http://www.apache.org/licenses/LICENSE-2.0.txt.
Prior to version 1.4.3 this library was distributed under the GNU Lesser General Public License version 3.0 (GLPLv3).
## Download
The latest release of this library can be downloaded as a zip archive from the download section of the project's Github page, which is available [here](https://github.com/michael-rapp/AndroidUtil/releases). Furthermore, the library's source code is available as a Git repository, which can be cloned using the URL https://github.com/michael-rapp/AndroidUtil.git.
Alternatively, the library can be added to your Android app as a Gradle dependency by adding the following to the module's `build.gradle` file:
```groovy
dependencies {
compile 'com.github.michael-rapp:android-util:2.1.0'
}
```
## Contact information
For personal feedback or questions feel free to contact me via the mail address, which is mentioned on my [Github profile](https://github.com/michael-rapp). If you have found any bugs or want to post a feature request, please use the [bugtracker](https://github.com/michael-rapp/AndroidUtil/issues) to report them.