/KonamiCode

Installs the Konami code easter-egg into your Android app ;)

Primary LanguageJavaApache License 2.0Apache-2.0

KonamiCode


Easy install of our favorite easter-egg!

konami-code-tutorial

JitPack Badge Android Arsenal

Preview

Get it on Google Play

a screenshot

Inculde in your project

Gradle

Add the JitPack repository to your build file:

repositories {
    maven {
	    url "https://jitpack.io"
	}
}

Add the dependency in the form:

dependencies {
    compile 'com.github.thiagokimo:KonamiCode:1.1.6'
}

Maven

If you use Maven, add this into your build file:

<repository>
    <id>jitpack.io</id>
	<url>https://jitpack.io</url>
</repository>

And them this into your dependencies

<dependency>
    <groupId>com.github.thiagokimo</groupId>
    <artifactId>KonamiCode</artifactId>
	<version>1.1.6</version>
</dependency>

How to use

Add the following code in your Activity:

new KonamiCode.Installer(context)
        .on(activity-or-fragment-or-view)
        .install();

The library injects a KonamiCodeLayout as the first child of your Activity's view. It listens your swipe events without harming the touch events of the original view.

For the first part of the Konami code, swipe into the correct directions. If you do it correctly, an AlertDialog with the buttons A, B and START will appear. Pressing them correctly will trigger the final callback.

By default a callback with a Toast message will appear. You can customize the final callback by yourself:

new KonamiCode.Installer(context)
        .on(activity-or-fragment-or-view)
        .callback(new KonamiCodeLayout.Callback() {
            @Override
            public void onFinish() {
                //whatever
            }
        })
        .install();

Attention

Make sure you add this AFTER your view is set, otherwise it won't listen to your swipes. KonamiCode adds a swipe listener into the root view of your Activity.

Contribuiting

  1. Fork it
  2. Create your feature/bug-fix branch(git checkout -b my-new-feature-or-fix)
  3. Commit your changes (git commit -am 'Add some feature/fix')
  4. Do your pull-request

Developed by

License

Copyright 2011, 2012 Thiago Rocha

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.