Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

kotlin sample app #322

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions app/build.gradle
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'

android {
compileSdkVersion defCompileSdkVersion
Expand All @@ -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()
}

This file was deleted.

120 changes: 120 additions & 0 deletions app/src/main/java/com/getkeepsafe/taptargetviewsample/MainActivity.kt
Original file line number Diff line number Diff line change
@@ -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!"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
(findViewById<View>(R.id.educated) as TextView).text = "Congratulations! You're educated now!"
findViewById<TextView>(R.id.educated).text = "Congratulations! You're educated now!"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

R

}

override fun onSequenceStep(lastTarget: TapTarget, targetClicked: Boolean) {
Log.d("TapTargetView", "Clicked on " + lastTarget.id())
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Log.d("TapTargetView", "Clicked on " + lastTarget.id())
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())
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
TapTarget.forView(dialog.getButton(DialogInterface.BUTTON_POSITIVE), "Uh oh!", "You canceled the sequence at step " + lastTarget.id())
TapTarget.forView(dialog.getButton(DialogInterface.BUTTON_POSITIVE), "Uh oh!", "You canceled the sequence at step ${lastTarget.id()}")

.cancelable(false)
.tintTarget(false), object : TapTargetView.Listener() {
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Formatting, move object onto its own line

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 :(")
}
})
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Formatting:

        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 :(")
                 }
              }
        )

}
}
2 changes: 2 additions & 0 deletions build.gradle
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
buildscript {
ext.kotlin_version = '1.2.71'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move this version definition to the ext block below.

repositories {
jcenter()
google()
Expand All @@ -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"
}
}

Expand Down