Droidils

Android’s Simple Views and Utils in KOTLIN.

Download

dependencies {
      implementation 'com.aptus:droidils:1.2.0'
}

Views

Lets see the example,

In Xml,

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:layout_behavior="@string/appbar_scrolling_view_behavior"
    tools:context=".MainActivity"
    tools:showIn="@layout/activity_main">
    <com.aptus.droidils.views.HtmlTextView
        android:id="@+id/htmlTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" ></com.aptus.droidils.views.HtmlTextView>
</android.support.constraint.ConstraintLayout>

In Activity,

class MainActivity : AppCompatActivity() {
          override fun onCreate(savedInstanceState: Bundle?) {
              super.onCreate(savedInstanceState)
              setContentView(R.layout.activity_main)
              setSupportActionBar(toolbar)
              val htmlTextView: HtmlTextView = findViewById(R.id.htmlTextView)
              htmlTextView.setHtmlText("<b>What</b> <i>the</i> <u>Html</u>")
          }
      }

• VectorDrawableButton - which supports vector drawable in left,right,top and bottom position.
• CheckableButton - checkable interface added.
• EndlessRecyclerScrollListener - which is used for simple pagination or load more.

Droidils utils classes fully based on Kotlin Extension function. So, we can write code concise and avoid boilerplate.

Example,

Url actionview

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        //Here using kotlin Extension to avoid findViewById
        fab.setOnClickListener {
            urlActionView("http://www.example.com") // Open in browser.
        }
    }
}

Parse String to Date

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        val dateTime = "19-03-2018 09:40" // date in String
        val date = dateTime.toParseDateTime("dd-MM-yyyy hh:mm") // Convert into Date.
    }
}

Format Date

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        val dateTime = "19-03-2018 09:40" // date in String
        val date = dateTime.toParseDateTime("dd-MM-yyyy hh:mm") // Convert into Date.
        val formatDate = date.toFormatDateTime("dd MMM yyyy") // Date into String by given format
    }
}

Check whether the date after or before from given date.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        val dateTime = "19-03-2018 09:40" // date in String
        val date = dateTime.toParseDateTime("dd-MM-yyyy hh:mm") // Convert into Date.
        val dateAfter = date.isAfter(Date()) // false
        val dateBefore = date.isBefore(date()) // true
    }
}

Hide and Show Status Bar in simple way

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        fullScreen() // hide StatusBar
        fab.setOnClickListener {
           exitFullScreen()// Show StatusBar
        }
    }
}

Change Status Bar Color

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        fab.setOnClickListener {
           changeStatusBarColor(R.color.blue)
        }
    }
}

Json String to Object

Droidils uses Google’s GSON library

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        val jsonString = "{ name: droidils, age: 25 }" // JSON String
        val jsonObjectSerialized = jsonString.toMappedObject<User>() // Serialized as Object
    }
}

Json Object to String

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        val jsonObject = User("Droidils","25") // Object
        val jsonString = jsonObject.toJson() // Object to Json
    }
}

View Visible,Invisible and Gone

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        fab.gone()// Hides view
        fab.invisible()// Invisible view
        fab.visible();// Show view
    }
}

Create notification channel with simple notification

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)
        fab.setOnClickListener {
            val channelId = "com.aptus.test"
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                createNotificationChannel(channelId, "Test") // only for oreo version
            }
            getNotificationManager().notify(102,
                    simpleNotification(channelId, "Droidils",
                            "Simple Utils library"))
        }
    }
}

Create Shortcut in simple way

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        fab.setOnClickListener {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
                val appShortCuts = SparseArray<AppShortCut>()
                val intents = arrayOf(Intent(Intent.ACTION_MAIN, Uri.EMPTY, this,
                        MainActivity::class.java)
                        .setFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK),
                        Intent("com.aptus.droidils.OPEN_SECOND"))
                // It's recommended more than 4 shortcut is not allowed and throw exception
                appShortCuts.append(0, AppShortCut("0",
                        "Droidils 1", R.drawable.ic_notifications, intents))
                appShortCuts.append(1, AppShortCut("1",
                        "Droidils 2", R.drawable.ic_notifications, intents))
                // Short label not more than 10 character and long label not more than 25 character
                // If it's exceeds exception will thrown.
                appShortCuts.append(2, AppShortCut("2",
                        "Droidils 3", R.drawable.ic_notifications, intents,
                        "Simple utils library", true))
                setShortCuts(buildShortCuts(appShortCuts))
            }
        }
    }
}

EditText IME Action Listener

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // we must to set inputType
        imeActionEdit.setImeActionListener { _, _ ->
            Toast.makeText(this, "Droidils Utils library", Toast.LENGTH_SHORT).show()
            true
        }
    }
}

Start an activity with Action and Flags

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // Start second activity
        goTo { buildIntent<SecondActivity>() }
        // Start second activity with action
        goTo { buildIntent<SecondActivity>("com.aptus.testAction") }
        // Start second activity with Flags
        goTo { buildIntent<SecondActivity>().addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) }
    }
}

Do log simply…;)

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // Logging method
        logDebug<MainActivity>("Droidils makes code concise...!!!")
        logError<MainActivity>("Droidils, The Utils Library!!!...")
    }
}

EditText TextWatcherListener

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // TextWatcher listener all three methods
        imeActionEdit.onTextWatcher({ s, start, count, after -> },
                { s, start, before, count -> }, { s -> })
        // TextWatcher listener before text change
        imeActionEdit.onBeforeTextChange { s, start, count, after -> }
        // TextWatcher listener on text change
        imeActionEdit.onTextChange { s, start, before, count -> }
        // TextWatcher listener after text change
        imeActionEdit.onAfterTextChange { s -> }
    }
}

Added few simple views and utils classes more will be add soon. Explore and give suggestion to improve Droidils.

Licence

  Copyright 2018 Shanmugasanthosh
      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.