Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tunjid/android-extensions
An Android library with modules to quickly bootstrap an Android application.
https://github.com/tunjid/android-extensions
android android-animation android-application android-extensions android-library android-navigation constraintlayout data-table floating-action-button fragments kotlin kotlin-android material material-design material-design-android recyclerview recycleview speed-dial table tableview
Last synced: 3 months ago
JSON representation
An Android library with modules to quickly bootstrap an Android application.
- Host: GitHub
- URL: https://github.com/tunjid/android-extensions
- Owner: tunjid
- License: mit
- Archived: true
- Created: 2017-04-30T11:59:17.000Z (over 7 years ago)
- Default Branch: develop
- Last Pushed: 2023-01-16T10:04:34.000Z (almost 2 years ago)
- Last Synced: 2024-10-01T02:42:57.731Z (3 months ago)
- Topics: android, android-animation, android-application, android-extensions, android-library, android-navigation, constraintlayout, data-table, floating-action-button, fragments, kotlin, kotlin-android, material, material-design, material-design-android, recyclerview, recycleview, speed-dial, table, tableview
- Language: Kotlin
- Size: 3.45 MB
- Stars: 593
- Watchers: 10
- Forks: 60
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: license.txt
Awesome Lists containing this project
README
# Android Extensions
Please note, this is not an official Google or Android repository and has no affiliation with the aforementioned parties.
It is merely a fairly long lived, albeit well maintained side project. Caveat emptor.
This repository is a collection of modules to help bootstrap an Android Application.
There are 10 modules:
| | Name | Description | | |
| ------------| ------------ | ------------ | ------------ | ------------ |
| 1 | App | A sample app demoing the modules in the repository. | | |
| 2 | [](https://github.com/tunjid/Android-Extensions/blob/develop/core/README.md) | A few added utilities to the core Android KTX libraries. Includes extension methods on objects to side step ContextCompat, DrawableCompat, and a fluent SpannableString API |  |  |
| 3 | [](https://github.com/tunjid/Android-Extensions/blob/develop/navigation/README.md) | Interfaces and implementations of Fragment based Navigators, including single and multiple stacks. The APIs allow for hooking into the raw `FragmentTransactions` that run allow you to customize it to your heart's content. Suspending APIs are also available to preform navigation actions sequentially without having to deal with the asynchrosity of the `FragmentManager`.|  |  |
| 4 | [](https://github.com/tunjid/Android-Extensions/blob/develop/view/README.md) | A module containing UI building blocks, like animators and helper methods for views. Built mostly around the `SpringAnimation` from the Jetpack `DynamicAnimation` library. In the example to the right, it is responsible for animating the margin, and padding of the container views, and the hiding and showing of bouncing FABs.|  | |
| 5 | [](https://github.com/tunjid/Android-Extensions/blob/develop/recyclerview/README.md) | Utility classes for the ```RecyclerView``` ```ViewGroup``` like drag and drop, swipe gestures, endless scrolling, a composable adapter, diffing, tables and much more. |  |  |
| 6 | [](https://github.com/tunjid/Android-Extensions/blob/develop/viewpager2/README.md) | Utility classes for the ```ViewPager2``` ```ViewGroup``` particularly diff util for dispatching updates |  | |
| 7 | [](https://github.com/tunjid/Android-Extensions/blob/develop/material/README.md) | Utility classes around Google's Material Design components including an expandable floating action button. |  | |
| 8 | [](https://github.com/tunjid/Android-Extensions/blob/develop/communications/README.md) | Utility classes for Near Service Discovery (NSD) and Bluetooth Low Energy (BLE) communication. | | |
| 9 | [](https://github.com/tunjid/Android-Extensions/blob/develop/savedstate/README.md) | Delegated implementation of Android Jetpack's Saved State Registry for Components that also have a lifecycle. | | |
| 10 | [ConstraintLayout (Unmaintained, MotionLayout is here)](https://github.com/tunjid/Android-Extensions/blob/develop/constraintlayout/README.md) | Utility classes for the ```ConstraintLayout``` ```ViewGroup```. | | |
| 11 | [Test (Unmaintained)](https://github.com/tunjid/Android-Extensions/blob/develop/test/README.md) | Testing utilities built mostly around Espresso. | | |
build.gradle lines
The built artifacts are hosted on Jcenter (pending the looming shutdown) and Maven Central:
```
allprojects {
repositories {
// Pre jcenter shutdown
Jcenter()
// Now or post Jcenter shutdown
mavenCentral()
}
}
implementation 'com.tunjid.androidx:module:x.x.x'
```
Refer to the table above for the latest version information.
If you so desire, you can fork the repo and host the artifacts your self using github packages.
Refer to publishing information below for more details.
Projects that use This library include:
1. [DigiLux Fingerprint gestures app](https://play.google.com/store/apps/details?id=com.tunjid.fingergestures)
2. [BluetoothRcSwitch IOT Github project](https://github.com/tunjid/BluetoothRcSwitch)
## Core
Read more about the core module, classes and components [here](https://github.com/tunjid/Android-Extensions/blob/develop/core/README.md).
A medium post with some of it's offerings can be read [here](https://medium.com/@Tunji_D/i-want-it-all-owning-the-system-window-and-consuming-insets-718b7e19960)
and [here](https://medium.com/@Tunji_D/concatenating-arbitrary-text-spans-in-android-90305ebb8e9b) .
## View
Read more about the view module, classes and components [here](https://github.com/tunjid/Android-Extensions/blob/develop/view/README.md).
A medium post with some of it's offerings can be read [here](https://proandroiddev.com/creating-an-expandable-floating-action-button-in-android-6626b968559e).
## RecyclerView
Read more about the RecyclerView module, classes and components [here](https://github.com/tunjid/Android-Extensions/blob/develop/recyclerview/README.md).
A medium post with some of it's offerings can be read [here](https://medium.com/@Tunji_D/composing-attributes-of-a-dynamic-recyclerview-with-functions-300064990bd4).
## ConstraintLayout
Read more about the ConstraintLayout module, classes and components [here](https://github.com/tunjid/Android-Extensions/blob/develop/constraintlayout/README.md).
A medium post with some of it's offerings can be read [here](https://proandroiddev.com/sliding-along-composing-a-dynamic-reusable-viewpager-indicator-animator-f7c46d559a21).
## Material
Read more about the Material module, classes and components [here](https://github.com/tunjid/Android-Extensions/blob/develop/material/README.md).
A medium post with some of it's offerings can be read [here](https://proandroiddev.com/creating-an-expandable-floating-action-button-in-android-6626b968559e).
## Communications
Read more about the communications module, classes and components [here](https://github.com/tunjid/Android-Extensions/blob/develop/communications/README.md).
A project using it can be seen [here](https://github.com/tunjid/BluetoothRcSwitch).
## Test
Warning, here be dragons, I haven't updated this in a bit; move fast, break things and all that.
I mean, yeah I could test more, but thank Heavens for QA, amirite? 🙃
You can read more about the testing module and classes [here](https://github.com/tunjid/Android-Extensions/blob/develop/test/README.md).
Image attribution
App icon made by [Freepik](https://www.freepik.com/?__hstc=57440181.7a5d7d3cc018b38de5851a6c095932c9.1558869007278.1558869007278.1558869007278.1&__hssc=57440181.5.1558869007279&__hsfp=1983466168 "Freepik") from [www.flaticon.com](https://www.flaticon.com/ "Flaticon") is licensed by [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0/ "Creative Commons BY 3.0"
## Publishing
Publishing is done with the `maven-publish` plugin.
To publish, run:
`./gradlew incrementalPublish`
This will publish the latest version of every module, and will not override existing versions.
The version of the module is determined by the version.properties file. To bump a module version, bump it in version.properties.
Publishing configuration is done by using a `publishInfo.json` file in the project root directory.
A sample `publishInfo.json` looks like:
```
{
"signArtifacts": true,
"signingPassword": "mySigningPassword",
"signingKey": "-----BEGIN PGP PRIVATE KEY BLOCK-----ADD YOUR GPG KEY HERE-----END PGP PRIVATE KEY BLOCK-----\n",
"versionSuffix": "myVersionSuffix",
"repositories": [
{
"name": "TunjiGithub",
"publishUrl": "https://maven.pkg.github.com/tunjid/Android-Extensions",
"downloadUrl": "https://maven.pkg.github.com/tunjid/Android-Extensions",
"credentials": {
"username": "tunjid",
"password": "githubAuthToken"
}
},
{
"name": "TunjiMavenCentral",
"publishUrl": "https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/",
"downloadUrl": "https://repo1.maven.org/maven2",
"credentials": {
"username": "myMavenCentralUsername",
"password": "myMavenCentralPassword"
}
}
]
}
```
`signArtifacts`, `signingPassword`, `signingKey` and `versionSuffix` properties are not necessary and may be omitted;
in fact, I personally only need to sign my artifacts when uploading to maven central.
Note that the repository name *NEEDS* to be camel cased as it's used when finding the gradle task to publish the artifact.
You do however need to specify at least 1 maven repository to publish to if you intend to publish artifacts.
If you intend to host your own version of the artifacts on github packages after forking the repository, you will need to add a secret to your github action pipeline.
The secret key is `PUBLISH_INFO_JSON`, and the value is the `publishInfo.json` described above, substituting the values of `publishUrl` and `downloadUrl`
to match the url of your github fork and the credentials matching your username and github auth token.