Android's Simple Views and Utils in KOTLIN.
dependencies {
implementation 'com.aptus:droidils:1.2.0'
}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" />
</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.
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.