https://github.com/antoniolg/Bandhook-Kotlin

A showcase music app for Android entirely written using Kotlin language
https://github.com/antoniolg/Bandhook-Kotlin

Last synced: 3 months ago
JSON representation

A showcase music app for Android entirely written using Kotlin language

• Host: GitHub
• URL: https://github.com/antoniolg/Bandhook-Kotlin
• Owner: antoniolg
• License: apache-2.0
• Created: 2015-03-21T19:41:38.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2018-04-10T17:01:11.000Z (almost 7 years ago)
• Last Synced: 2024-08-01T01:31:01.694Z (6 months ago)
• Language: Kotlin
• Size: 5.23 MB
• Stars: 1,863
• Watchers: 76
• Forks: 399
• Open Issues: 13
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-kotlin-libraries-for-android - Bandhook Kotlin - A showcase music app for Android entirely written using Kotlin language. (<a name="projects"></a>Projects ^{[Back ⇈](#contents)} / <a name="franeworks"></a>Frameworks ^{[Back ⇈](#contents)})
• awesome-kotlin - Bandhook-Kotlin
• awesome-kotlin-android - Bandhook-Kotlin - 音乐信息展示APP🔥🔥🔥🔥 (完整 app / 测试)

README

        
# Bandhook Kotlin

This project is a small replica of the app I developed some time ago. [Bandhook can still be found on Play Store](https://play.google.com/store/apps/details?id=com.limecreativelabs.bandhook)

At the moment it will only connect to LastFm and retrieve some music bands. It will let navigate to the artist detail. This is what you´ll get:



  



The purpose of the project is to show a complex (at least in architecture) project entirely written using Kotlin. This example also supports the articles

written in [antonioleiva.com](http://antonioleiva.com) related to Kotlin for Android:

* [Kotlin for Android (I): Introduction](http://antonioleiva.com/kotlin-for-android-introduction/)

* [Kotlin for Android (II): Create a new project](http://antonioleiva.com/kotlin-android-create-project/)

* [Kotlin for Android (III): Extension functions and default values](http://antonioleiva.com/kotlin-android-extension-functions/)

* [Kotlin for Android (IV): Custom Views and Android Extensions](http://antonioleiva.com/kotlin-android-custom-views/)

This sample project is still in development, and could easily break or have some messy code. However, any idea or suggestion to improve it will be welcomed. Feel free to [open an issue](https://github.com/antoniolg/Bandhook-Kotlin/issues/new) if you think something could be improved.

## How to use this project

You can use Android Studio or Intellij to work with this repository.

First thing you will need to compile this project is to get an [API Key from Last.fm](http://www.lastfm.es/api). It will we used to connect to the service that will provide artists info. Then create a resource file `app/src/main/res/values/api_key.xml` (this path is ignored by git) with the following content:

```xml

YOUR_KEY

```

The `Kotlin` plugin for Android Studio is also required.

Many ideas on how this project is organized were taken from [Clean Contacts](https://github.com/PaNaVTEC/Clean-Contacts/blob/master/Readme.md) project, by [PaNaVTEC](https://github.com/PaNaVTEC). There are some slight differences, but reading [How to start section](https://github.com/PaNaVTEC/Clean-Contacts/blob/master/Readme.md#how-to-start-with-this-repository) will be helpful.

# License

    Copyright 2015 Antonio Leiva

    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.