kotlin sample app

app/build.gradle

@@ -1,4 +1,5 @@
 apply plugin: 'com.android.application'
+apply plugin: 'kotlin-android'
 
 android {
     compileSdkVersion defCompileSdkVersion
@@ -24,4 +25,8 @@ dependencies {
     implementation "androidx.appcompat:appcompat:$defAndroidXVersion"
     implementation "com.google.android.material:material:$defMaterialVersion"
     implementation 'com.facebook.stetho:stetho:1.5.0'
+    compile "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+}
+repositories {
+    mavenCentral()
 }

app/src/main/java/com/getkeepsafe/taptargetviewsample/MainActivity.kt

@@ -0,0 +1,120 @@
+package com.getkeepsafe.taptargetviewsample
+
+import android.content.DialogInterface
+import android.graphics.Rect
+import android.graphics.Typeface
+import android.graphics.drawable.Drawable
+import android.os.Bundle
+import androidx.core.content.ContextCompat
+import androidx.appcompat.app.AlertDialog
+import androidx.appcompat.app.AppCompatActivity
+import androidx.appcompat.widget.Toolbar
+import android.text.SpannableString
+import android.text.style.StyleSpan
+import android.text.style.UnderlineSpan
+import android.util.Log
+import android.view.Display
+import android.view.View
+import android.widget.TextView
+import android.widget.Toast
+
+import com.getkeepsafe.taptargetview.TapTarget
+import com.getkeepsafe.taptargetview.TapTargetSequence
+import com.getkeepsafe.taptargetview.TapTargetView
+
+class MainActivity : AppCompatActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+
+        val toolbar = findViewById<Toolbar>(R.id.toolbar)
+        toolbar.inflateMenu(R.menu.menu_main)
+        toolbar.navigationIcon = ContextCompat.getDrawable(this, R.drawable.ic_arrow_back_white_24dp)
+
+        // We load a drawable and create a location to show a tap target here
+        // We need the display to get the width and height at this point in time
+        val display = windowManager.defaultDisplay
+        // Load our little droid guy
+        val droid = ContextCompat.getDrawable(this, R.drawable.ic_android_black_24dp)
+        // Tell our droid buddy where we want him to appear
+        val droidTarget = Rect(0, 0, droid!!.intrinsicWidth * 2, droid.intrinsicHeight * 2)
+        // Using deprecated methods makes you look way cool
+        droidTarget.offset(display.width / 2, display.height / 2)
+
+        val sassyDesc = SpannableString("It allows you to go back, sometimes")
+        sassyDesc.setSpan(StyleSpan(Typeface.ITALIC), sassyDesc.length - "sometimes".length, sassyDesc.length, 0)
+
+        // We have a sequence of targets, so lets build it!
+        val sequence = TapTargetSequence(this)
+                .targets(
+                        // This tap target will target the back button, we just need to pass its containing toolbar
+                        TapTarget.forToolbarNavigationIcon(toolbar, "This is the back button", sassyDesc).id(1),
+                        // Likewise, this tap target will target the search button
+                        TapTarget.forToolbarMenuItem(toolbar, R.id.search, "This is a search icon", "As you can see, it has gotten pretty dark around here...")
+                                .dimColor(android.R.color.black)
+                                .outerCircleColor(R.color.colorAccent)
+                                .targetCircleColor(android.R.color.black)
+                                .transparentTarget(true)
+                                .textColor(android.R.color.black)
+                                .id(2),
+                        // You can also target the overflow button in your toolbar
+                        TapTarget.forToolbarOverflow(toolbar, "This will show more options", "But they're not useful :(").id(3),
+                        // This tap target will target our droid buddy at the given target rect
+                        TapTarget.forBounds(droidTarget, "Oh look!", "You can point to any part of the screen. You also can't cancel this one!")
+                                .cancelable(false)
+                                .icon(droid)
+                                .id(4)
+                )
+                .listener(object : TapTargetSequence.Listener {
+                    // This listener will tell us when interesting(tm) events happen in regards
+                    // to the sequence
+                    override fun onSequenceFinish() {
+                        (findViewById<View>(R.id.educated) as TextView).text = "Congratulations! You're educated now!"
+                    }
+
+                    override fun onSequenceStep(lastTarget: TapTarget, targetClicked: Boolean) {
+                        Log.d("TapTargetView", "Clicked on " + lastTarget.id())
+                    }
+
+                    override fun onSequenceCanceled(lastTarget: TapTarget) {
+                        val dialog = AlertDialog.Builder(this@MainActivity)
+                                .setTitle("Uh oh")
+                                .setMessage("You canceled the sequence")
+                                .setPositiveButton("Oops", null).show()
+                        TapTargetView.showFor(dialog,
+                                TapTarget.forView(dialog.getButton(DialogInterface.BUTTON_POSITIVE), "Uh oh!", "You canceled the sequence at step " + lastTarget.id())
+                                        .cancelable(false)
+                                        .tintTarget(false), object : TapTargetView.Listener() {
+                            override fun onTargetClick(view: TapTargetView) {
+                                super.onTargetClick(view)
+                                dialog.dismiss()
+                            }
+                        })
+                    }
+                })
+
+        // You don't always need a sequence, and for that there's a single time tap target
+        val spannedDesc = SpannableString("This is the sample app for TapTargetView")
+        spannedDesc.setSpan(UnderlineSpan(), spannedDesc.length - "TapTargetView".length, spannedDesc.length, 0)
+        TapTargetView.showFor(this, TapTarget.forView(findViewById<View>(R.id.fab), "Hello, world!", spannedDesc)
+                .cancelable(false)
+                .drawShadow(true)
+                .titleTextDimen(R.dimen.title_text_size)
+                .tintTarget(false), object : TapTargetView.Listener() {
+            override fun onTargetClick(view: TapTargetView) {
+                super.onTargetClick(view)
+                // .. which evidently starts the sequence we defined earlier
+                sequence.start()
+            }
+
+            override fun onOuterCircleClick(view: TapTargetView) {
+                super.onOuterCircleClick(view)
+                Toast.makeText(view.context, "You clicked the outer circle!", Toast.LENGTH_SHORT).show()
+            }
+
+            override fun onTargetDismissed(view: TapTargetView, userInitiated: Boolean) {
+                Log.d("TapTargetViewSample", "You dismissed me :(")
+            }
+        })
+    }
+}

build.gradle

@@ -1,4 +1,5 @@
 buildscript {
+    ext.kotlin_version = '1.2.71'
     repositories {
         jcenter()
         google()
@@ -7,6 +8,7 @@ buildscript {
         classpath 'com.android.tools.build:gradle:3.2.0'
         classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1'
         classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.8.4'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }