Kotlin Example


Source link: https://github.com/myinnos/Kotlin-Example

Kotlin Example

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!

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

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. 

Resources

Convert OkHttp requests into curl logs.

IntelliJ/AndroidStudio plugin which provides a button to connect your Android device over WiFi to install, run and debug your applications without a USB connected.

Smash is Volley-inspired networking library that's using OkHttp in its core.

Pinterest like awesome menu control for Android.

Lightweight image loader based on Retrofit and RxJava.

An Android Mandrill API Connector.

Topics


2D Engines   3D Engines   9-Patch   Action Bars   Activities   ADB   Advertisements   Analytics   Animations   ANR   AOP   API   APK   APT   Architecture   Audio   Autocomplete   Background Processing   Backward Compatibility   Badges   Bar Codes   Benchmarking   Bitmaps   Bluetooth   Blur Effects   Bread Crumbs   BRMS   Browser Extensions   Build Systems   Bundles   Buttons   Caching   Camera   Canvas   Cards   Carousels   Changelog   Checkboxes   Cloud Storages   Color Analysis   Color Pickers   Colors   Comet/Push   Compass Sensors   Conferences   Content Providers   Continuous Integration   Crash Reports   Credit Cards   Credits   CSV   Curl/Flip   Data Binding   Data Generators   Data Structures   Database   Database Browsers   Date &   Debugging   Decompilers   Deep Links   Dependency Injections   Design   Design Patterns   Dex   Dialogs   Distributed Computing   Distribution Platforms   Download Managers   Drawables   Emoji   Emulators   EPUB   Equalizers &   Event Buses   Exception Handling   Face Recognition   Feedback &   File System   File/Directory   Fingerprint   Floating Action   Fonts   Forms   Fragments   FRP   FSM   Functional Programming   Gamepads   Games   Geocaching   Gestures   GIF   Glow Pad   Gradle Plugins   Graphics   Grid Views   Highlighting   HTML   HTTP Mocking   Icons   IDE   IDE Plugins   Image Croppers   Image Loaders   Image Pickers   Image Processing   Image Views   Instrumentation   Intents   Job Schedulers   JSON   Keyboard   Kotlin   Layouts   Library Demos   List View   List Views   Localization   Location   Lock Patterns   Logcat   Logging   Mails   Maps   Markdown   Mathematics   Maven Plugins   MBaaS   Media   Menus   Messaging   MIME   Mobile Web   Native Image   Navigation   NDK   Networking   NFC   NoSQL   Number Pickers   OAuth   Object Mocking   OCR Engines   OpenGL   ORM   Other Pickers   Parallax List   Parcelables   Particle Systems   Password Inputs   PDF   Permissions   Physics Engines   Platforms   Plugin Frameworks   Preferences   Progress Indicators   ProGuard   Properties   Protocol Buffer   Pull To   Purchases   Push/Pull   QR Codes   Quick Return   Radio Buttons   Range Bars   Ratings   Recycler Views   Resources   REST   Ripple Effects   RSS   Screenshots   Scripting   Scroll Views   SDK   Search Inputs   Security   Sensors   Services   Showcase Views   Signatures   Sliding Panels   Snackbars   SOAP   Social Networks   Spannable   Spinners   Splash Screens   SSH   Static Analysis   Status Bars   Styling   SVG   System   Tags   Task Managers   TDD &   Template Engines   Testing   Testing Tools   Text Formatting   Text Views   Text Watchers   Text-to   Toasts   Toolkits For   Tools   Tooltips   Trainings   TV   Twitter   Updaters   USB   User Stories   Utils   Validation   Video   View Adapters   View Pagers   Views   Watch Face   Wearable Data   Wearables   Weather   Web Tools   Web Views   WebRTC   WebSockets   Wheel Widgets   Wi-Fi   Widgets   Windows   Wizards   XML   XMPP   YAML   ZIP Codes