Skip to content
This repository has been archived by the owner on Jun 7, 2022. It is now read-only.
/ Kotlin-Example Public archive

An example for who are all going to start learning Kotlin programming language to develop Android application.

License

Notifications You must be signed in to change notification settings

myinnos/Kotlin-Example

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

26 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Here is an example for who are all going to start learning Kotlin programming language to develop Android application.

First check this example APK to understand basic steps easily. I enjoyed a lot while doing this tutorial, If your Java developer you can play with this. Happy Coding!

Get it on Google Play

Kotlin is very lightweight, its run-time library is under 400K minus the ProGuard minification. Also, installation is very simple. All you have to do is browse the plugin repository and get the official Kotlin plugin. You also had to install Kotlin Android Extensions as well, required for Android of course, but not until recently it has been merged with the Kotlin plugin and is now obsolete.

Settings > Plugins > Browse Repositories > Search Kotlin and install

To configure Kotlin in your project, convert any source file to Kotlin first.

Select a Java file > Hit Ctrl+Shift+A > โ€œconvert to kotlinโ€ Hit enter

Take a look here for screenshots and brief explanation.

Android UI With Anko

Anko is a library made in Kotlin that is a great utility for Android development. It consists of DSL wrappers and other nice extensions that make development easier. The prime value of Anko is that it allows you to embed UI layouts inside your source code, which makes it type-safe and allows programmatic transformation.

Just a brief example. Here is a "hello world" written with Anko:

verticalLayout {
    val name = editText()
    button("Say Hello") {
        onClick { toast("Hello, ${name.text}!") }
    }
}

Started by letting Gradle know some dependencies, one set for the Support Library, another for the Kotlin run-time, and one more set for Anko obviously.

Reference those dependencies
final SUPPORT_VERSION = '23.3.0'
final ANKO_VERSION = '0.8.3'

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
    compile "com.android.support:appcompat-v7:${SUPPORT_VERSION}"
    compile "com.android.support:recyclerview-v7:${SUPPORT_VERSION}"
    compile "org.jetbrains.anko:anko-sdk15:${ANKO_VERSION}"
    compile "org.jetbrains.anko:anko-appcompat-v7:${ANKO_VERSION}"
    compile "org.jetbrains.anko:anko-recyclerview-v7:${ANKO_VERSION}"
    compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
}

One thing to be noted here, the Anko base library, i.e., the anko-sdk* lib, you should add on the basis of your minimum SDK version and the rest of the other dependencies, you add on the basis of the Support Library that you wish to extend with Anko. For instance, add anko-design for design, which is from the Support Library.

Example

Kotlin Example - Splashscreen Kotlin Example - MainScreen Kotlin Example - Menu Kotlin Example - WebView

SplashScreenActivity.kt

Splash screen is one of the friend for android developers will see most of the times this screen while developing interesting concepts. Here you can see how Splashscreen code looks interms of Kotlin.

Note: Here i followed this tutorial to create express splashscreen.

class : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Start main activity
        startActivity(Intent(this, MainActivity::class.java))

        // close this activity
        overridePendingTransition(R.anim.abc_fade_in, R.anim.abc_fade_out)
        finish()
    }

}
Some Awesome methods/functions
Variable declaration. int/string/boolean
var EMAIL_ID = "[email protected]"
To open Web URL
browse(GIT_HUB_URL)
setText function
tvHeader.text = HEADER_TEXT
Hint to Edit Text
etName.hint = EDIT_TEXT_NAME_HINT
Toast
toast("Activity restarted!")
Email Intent
email(EMAIL_ID, "subject")
Share Intent
share("text")
Function declaration, function to get text length of edit text
fun checkTextLength(editText: EditText): Boolean {
        var length = editText.length()
        if (length > 0)
            return true
        else
            return false
}
onClick funtion
btDone.onClick {
            hideKeyboard()
            if (!checkTextLength(etName) || !checkTextLength(etMobile))
                toast("Fields cannot be empty!")
            else
                onButtonClicks()
}
Dialog Aleart Box
fun openAlertDialog(name: String, phoneNumber: String) {

        val countries = listOf("Russia", "India", "USA", "Japan", "China")

        selector("Where are you from?", countries) { i ->
            alert("One more thing! You have entered this number " + phoneNumber, name + "! So you're living in ${countries[i]}, right?")            {
                customView {
                    verticalLayout {
                        positiveButton("AWESOME!") {
                            longToast("Thank you!")
                        }
                    }
                }

            }.show()
}
Initializing menu options
 override fun onCreateOptionsMenu(menu: Menu?): Boolean {
        getMenuInflater().inflate(R.menu.menu_main, menu)
        return true
    }

 override fun onOptionsItemSelected(item: MenuItem?): Boolean {
        val id = item!!.getItemId()
        //noinspection SimplifiableIfStatement
        if (id == R.id.action_rate) {
            // opining browser intent
            browse(PLAY_STORE_URL)
            return true
        }
        return super.onOptionsItemSelected(item)
    }

MainActivity.kt

Main screen, The wall where Android developer paint and repair. Here you can observe the code how plain and simple. Basically i started loving Kotlin while writing this class.

Note: I used Google Custom Tabs library to understand how third party java libraries will work with Kotlin.

class MainActivity : AppCompatActivity() {

    var HEADER_TEXT = "You can try awesome example!"
    var EDIT_TEXT_NAME_HINT = "enter name"
    var EDIT_TEXT_NUMBER_HINT = "enter number"
    var EMAIL_ID = "[email protected]"
    var GIT_HUB_URL = "https://github.com/myinnos/Kotlin-Example"
    var GIT_HUB_WEB_URL = "https://myinnos.github.io/Kotlin-Example/";
    var PLAY_STORE_URL = "market://details?id=" + BuildConfig.APPLICATION_ID

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // setting header text
        tvHeader.text = HEADER_TEXT
        // setting hint for edit text
        etName.hint = EDIT_TEXT_NAME_HINT
        etMobile.hint = EDIT_TEXT_NUMBER_HINT

        // setting drawable image to image view
        imageView.resources.getDrawable(R.mipmap.ic_launcher)

        // onclick event for image view to restart activity (Intent function)
        imageView.onClick {
            startActivity<SplashScreenActivity>()
            finish()
            toast("Activity restarted!")
        }

        // onclick event for button
        btDone.onClick {
            hideKeyboard()
            if (!checkTextLength(etName) || !checkTextLength(etMobile))
                toast("Fields cannot be empty!")
            else
                onButtonClicks()
        }

        btGitHubLink.onClick {
            // opining browser intent
            browse(GIT_HUB_URL)
        }

        btTutorial.onClick {
            // google custom tabs
            val builder = CustomTabsIntent.Builder()
            builder.setToolbarColor(ContextCompat.getColor(this, R.color.colorPrimary))
            val customTabsIntent = builder.build()
            customTabsIntent.launchUrl(this, Uri.parse(GIT_HUB_WEB_URL))
        }
    }

    // function to get text from edit text
    fun EditText.textValue(): String {
        return text.toString()
    }

    // function to get text length of edit text
    fun checkTextLength(editText: EditText): Boolean {

        var length = editText.length()

        if (length > 0)
            return true
        else
            return false
    }

    // function to hide keyboard
    fun hideKeyboard() {
        try {
            val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            imm.hideSoftInputFromWindow(currentFocus!!.windowToken, 0)
        } catch (e: Exception) {
            // TODO: handle exception
        }

    }

    fun onButtonClicks() {
        //using function
        val phoneNumber = etMobile.textValue()
        // direct access
        val name = etName.text.toString()
        // calling alert dialog
        openAlertDialog(name, phoneNumber)
    }

    fun openAlertDialog(name: String, phoneNumber: String) {

        val countries = listOf("Russia", "India", "USA", "Japan", "China")

        selector("Where are you from?", countries) { i ->
            //toast("So you're living in ${countries[i]}, right?")
            alert("One more thing! You have entered this number " + phoneNumber, name + "! So you're living in ${countries[i]}, right?") {
                customView {
                    verticalLayout {
                        positiveButton("AWESOME!") {
                            longToast("Thank you!")
                        }
                    }
                }

            }.show()

        }
    }

    // Initializing menu options
    override fun onCreateOptionsMenu(menu: Menu?): Boolean {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.menu_main, menu)
        return true
    }

    override fun onOptionsItemSelected(item: MenuItem?): Boolean {
        // Handle action bar item clicks here. The action bar will
        // automatically handle clicks on the Home/Up button, so long
        // as you specify a parent activity in AndroidManifest.xml.
        val id = item!!.getItemId()

        //noinspection SimplifiableIfStatement
        if (id == R.id.action_share) {
            // sharing intent
            share(getString(R.string.share_text) + BuildConfig.APPLICATION_ID,
                    getString(R.string.app_name))
            return true
        } else if (id == R.id.action_feedback) {
            // email intent
            email(EMAIL_ID, getString(R.string.app_name))
            return true
        } else if (id == R.id.action_rate) {
            // opining browser intent
            browse(PLAY_STORE_URL)
            return true
        }

        return super.onOptionsItemSelected(item)
    }
}

Conclusion

Kotlin is overall a great language. It is much less verbose than Java, and has an excellent standard library that removes the need to use a lot of the libraries that make Java life bearable. Converting an app from Java to Kotlin is made much easier thanks to automated syntax conversion, and the result is almost always an improvement. If youโ€™re an Android developer, you owe it to yourself to give it a try.

Any Queries? or Feedback, please let me know by opening a new issue!

Contact

Prabhakar Thota

License

Copyright 2017 MyInnos

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.