An open API service indexing awesome lists of open source software.

https://github.com/thiagokimo/konamicode

Installs the Konami code easter-egg into your Android app ;)
https://github.com/thiagokimo/konamicode

android easter-egg konami konamicode listen swipe

Last synced: 10 months ago
JSON representation

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

Awesome Lists containing this project

README

          

# KonamiCode
---
Easy install of our favorite easter-egg!

![konami-code-tutorial](https://static.wikia.nocookie.net/logopedia/images/d/dc/Konami_1986.svg/revision/latest/scale-to-width-down/200?cb=20200722095647)

![JitPack Badge](https://img.shields.io/github/release/thiagokimo/KonamiCode.svg?label=JitPack)
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-KonamiCode-green.svg?style=flat)](https://android-arsenal.com/details/1/2202)

## Preview
[![Get it on Google Play](https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png)](https://play.google.com/store/apps/details?id=io.kimo.konami)

[![a screenshot](https://raw.githubusercontent.com/thiagokimo/KonamiCode/master/assets/konami-code-screenshot.png)](https://youtu.be/vIRdoI-V-Pk)

## Inculde in your project
### Gradle

Add the JitPack repository to your build file:

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

Add the dependency in the form:

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

### Maven

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

``` xml

jitpack.io
https://jitpack.io

```

And them this into your dependencies
``` xml

com.github.thiagokimo
KonamiCode
1.1.6

```
## How to use

Add the following code in your Activity:

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

The library injects a [KonamiCodeLayout](https://github.com/thiagokimo/KonamiCode/blob/master/library/src/main/java/io/kimo/konamicode/KonamiCodeLayout.java) 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:

``` java
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

* Thiago Rocha - http://kimo.io -

## 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.