Splitties

Splitties is a collection of small independent Android libraries that aims to make developing apps and libraries for Android (including Wear, TV, Things, Auto and ChromeOS targeted) easier and more fun.

Some modules are similar to what Anko provides.

This project is named "Splitties" because it is split in small modules, distributed as independent Android libraries, so you can add only the ones you need to your project/module, helping reduce the size of the final apk.

Each module has been designed to have a small footprint and be as efficient as possible.

All the splits

Activities: Start activities with minimal boilerplate.
Alert Dialog: Create simple alert dialogs with simple code.
Alert Dialog AppCompat: AppCompat version of Alert Dialog.
App Context: Always have your application Context at hand with appCtx.
Arch Lifecycle: Extensions to get ViewModels, use LiveData and observe Lifecycles.
Arch Room: Room helpers to instantiate your DB and perform transactions in Kotlin.
Bit Flags: hasFlag, withFlag and minusFlag extensions on Long, Int, Short and Byte.
Bundle: BundleSpec to use Bundle with property syntax for Intent extras and more.
Collections: forEach for Lists without Iterator allocation.
Checked Lazy: uiLazy that checks property access on UI thread, and checkedLazy to make your own variant.
Dimensions: Android dp extensions for View and Context. Particularly handy when using View DSL.
Exceptions: illegal(…) and similar functions that return Nothing, handy for impossible or illegal when branches.
Fragments: Start activities from fragments and do transactions with minimal boilerplate.
Fragment Args: Fragment arguments without ceremony thanks to delegated properties.
Init Provider: Base class for ContentProviders used for automatic initialization purposes.
Intents: Transform companion objects into powerful typesafe intent specs.
Main Handler: Top-level mainHandler property to stop allocating multiple Handlers for main Looper.
Material Colors: 2014 Material Design color palettes as color resources.
Material Lists: List item Views implementing Material Design guidelines (perfect for usage in a RecyclerView).
Preferences: Property syntax for Android's SharedPreferences.
Resources: Extensions to get resources like strings, colors or drawables easily, with support for themed attributes.
Selectable Views: Selectable Views with foreground property before API 23.
Selectable Views AppCompat: Selectable Views for AppCompatTextView.
Selectable Views ConstraintLayout: Selectable Views for ConstraintLayout.
Snackbar: Grab a snack without ceremony with snack(…) and longSnack(…).
Stetho init: Have Stetho for your debug builds, without writing any code!
System Services: No more context.getSystemService(NAME_OF_SERVICE) as NameOfManager.
Toast: Show a toast by just calling toast(yourText), and dodge API 25 BadTokenException.
Typesafe RecyclerView: Typesafe ViewHolder and ItemViewHolder for easy basic usage of RecyclerView.
UI Thread: Properties related to Android UI thread, and checkUiThread() precondition checker.
View DSL: Create UIs with readable Kotlin code.
View DSL AppCompat: AppCompat extension of View DSL.
View DSL AppCompat styles: AppCompat styles for View DSL.
View DSL ConstraintLayout: ConstraintLayout extension of View DSL.
View DSL Design: Design Support Library extension of View DSL.
View DSL IDE preview: Preview View DSL UIs in the IDE.
View DSL RecyclerView: RecyclerView extension of View DSL.
Views: Extensions function and properties on Views.
Views AppCompat: AppCompat extension of Views. Includes helpers for ImageView tinting, ActionBar and tooltip.
Views CardView: CardView extension of Views. Provides a contentPadding property.
Views Design: Design Support library extension of Views.
Views RecyclerView: RecyclerView extension of Views.

Download

Gradle instructions

Make sure you have jcenter() in the repositories defined in your project's (root) build.gradle file (default for new Android Studio projects).

Add the version of the library to not repeat yourself if you use multiple artifacts, and make sure their versions are in sync by adding an ext property into your root project build.gradle file:

allProjects {
    ext {
        splitties_version = '2.0.0-alpha4'
    }
}

Here are all the artifacts of this library. Just use the ones you need. (Click to expand)

implementation "com.louiscad.splitties:splitties-activities:$splitties_version"
implementation "com.louiscad.splitties:splitties-alertdialog:$splitties_version"
implementation "com.louiscad.splitties:splitties-alertdialog-appcompat:$splitties_version"
implementation "com.louiscad.splitties:splitties-appctx:$splitties_version"
implementation "com.louiscad.splitties:splitties-arch-lifecycle:$splitties_version"
implementation "com.louiscad.splitties:splitties-arch-room:$splitties_version"
implementation "com.louiscad.splitties:splitties-bitflags:$splitties_version"
implementation "com.louiscad.splitties:splitties-bundle:$splitties_version"
implementation "com.louiscad.splitties:splitties-checkedlazy:$splitties_version"
implementation "com.louiscad.splitties:splitties-collections:$splitties_version"
implementation "com.louiscad.splitties:splitties-dimensions:$splitties_version"
implementation "com.louiscad.splitties:splitties-exceptions:$splitties_version"
implementation "com.louiscad.splitties:splitties-fragments:$splitties_version"
implementation "com.louiscad.splitties:splitties-fragmentargs:$splitties_version"
implementation "com.louiscad.splitties:splitties-initprovider:$splitties_version"
implementation "com.louiscad.splitties:splitties-intents:$splitties_version"
implementation "com.louiscad.splitties:splitties-mainhandler:$splitties_version"
implementation "com.louiscad.splitties:splitties-material-colors:$splitties_version"
implementation "com.louiscad.splitties:splitties-material-lists:$splitties_version"
implementation "com.louiscad.splitties:splitties-preferences:$splitties_version"
implementation "com.louiscad.splitties:splitties-resources:$splitties_version"
implementation "com.louiscad.splitties:splitties-selectableviews:$splitties_version"
implementation "com.louiscad.splitties:splitties-selectableviews-appcompat:$splitties_version"
implementation "com.louiscad.splitties:splitties-selectableviews-constraintlayout:$splitties_version"
implementation "com.louiscad.splitties:splitties-snackbar:$splitties_version"
debugImplementation "com.louiscad.splitties:splitties-stetho-init:$splitties_version"
implementation "com.louiscad.splitties:splitties-systemservices:$splitties_version"
implementation "com.louiscad.splitties:splitties-toast:$splitties_version"
implementation "com.louiscad.splitties:splitties-typesaferecyclerview:$splitties_version"
implementation "com.louiscad.splitties:splitties-uithread:$splitties_version"
implementation "com.louiscad.splitties:splitties-viewdsl:$splitties_version"
implementation "com.louiscad.splitties:splitties-viewdsl-appcompat:$splitties_version"
implementation "com.louiscad.splitties:splitties-viewdsl-appcompat-styles:$splitties_version"
implementation "com.louiscad.splitties:splitties-viewdsl-constraintlayout:$splitties_version"
implementation "com.louiscad.splitties:splitties-viewdsl-design:$splitties_version"
debugImplementation "com.louiscad.splitties:splitties-viewdsl-ide-preview:$splitties_version"
implementation "com.louiscad.splitties:splitties-viewdsl-recyclerview:$splitties_version"
implementation "com.louiscad.splitties:splitties-views:$splitties_version"
implementation "com.louiscad.splitties:splitties-views-appcompat:$splitties_version"
implementation "com.louiscad.splitties:splitties-views-cardview:$splitties_version"
implementation "com.louiscad.splitties:splitties-views-design:$splitties_version"
implementation "com.louiscad.splitties:splitties-views-recyclerview:$splitties_version"

Snapshots

Let's say you need a new feature or a fix that did not make it to a release yet:

You can grab it in the latest snapshot by adding the snapshots repository and changing the library version to the -SNAPSHOT version in your root project build.gradle file:

allProjects {
    repositories {
        google()
        jcenter() // Add snapshots repo below
        maven { url 'https://oss.jfrog.org/artifactory/oss-snapshot-local' }
    }
    ext {
        splitties_version = '2.0.0-SNAPSHOT' // Change this line
    }
}

If you need to, you can browse the deployed snapshots on artifactory with the native browser or the web app so you can pick a specific snapshot.

Other build systems

For maven and alternative build-systems, check the Bintray page.

New versions notifications

To get notified for new versions, be sure to click on "Watch" on the splitties Bintray page.

Improve this library

If you want this library to have a new feature or an improvement in a new or in an existing module, please, open an issue or vote/comment a similar one first, so it can be discussed.

Documentation contributions are also welcome. For typos or other small improvements, feel free to submit a PR (pull request) directly. For more significant doc contributions, please, open an issue first so it can be discussed.

If you find a bug, please open an issue with all the important details. If you know a simple fix that is not API breaking and that does not have side-effects that need to be considered, you may also directly submit a PR.

What is a split

A "split" is a module of the Splitties library that you can add as a dependency. It only includes the required transitive dependencies. This allows you to only add what you need in your app or library module, so the final apk is as small as possible and doesn't include stuff not used by your app.

Let's say you're build an Android Wear app using the View DSL. Android Wear apps don't need AppCompat. Including it would be a waste of bandwidth and storage. The View DSL core module relies on the Android SDK but not on AppCompat, so you don't bloat your wrist app with AppCompat by using View DSL. However, if you are building a phone, tablet or computer Android app, there's a View DSL AppCompat split with a few extensions for you to use.

License

This library is published under Apache License version 2.0 which you can see here.

Satish2804/Splitties