Skip to content

DresdenStory is an app to get to know or rediscover Dresden with a storytelling approach and interactive challenges. Written as a well commented example Android app in Java.

License

Notifications You must be signed in to change notification settings

justvalerian/dresdenstory

Repository files navigation

DresdenStory

About

DresdenStory launcher icon

DresdenStory is an app to get to know or rediscover the most exciting places in Dresden in a different and more interactive way compared to regular city guides. To reach this aim we utilized storytelling (the different points are chapters in a connected narrative), images and challenges (questions that need to be answered after each chapter) to let users enjoy the experience of getting to know or rediscovering Dresden.

This project was created by Ana Pinilla and Valerian Lange as part of the Cartography M.Sc. programme.

The app was written in Java only (no Kotlin), as this was a course requirement and helps to make the code approachable for beginners. The app was written for Android 12 (API level 31).

How to work with this project

1. Build the app in Android Studio and run it on a virtual device

  1. Clone the repository or download the zipped project and unzip it.
  2. Then open the folder in Android Studio.
  3. For the app to work properly you will need to add your own Google Maps API key. Find instructions and then paste your key here.
  4. To run the app you will then need to set up a virtual device or connect a phone using Android API level 31.

2. Look at the code

In app/src/main, you can find the main parts of the code of the app. If you are unfamiliar with Android projects, try reading an introduction to the Android project folder structure first.

Functions

The user interface of the app is structured into three main activities:

Map activity

See the location where each chapter takes place. Get directions to reach each point.

annotated map activity

Story activity

Find historical references told through storytelling, images and challenges.

annotated story activity screenshot

annotated story activity interaction screenshot

Info activity

Find additional information about the app.

annotated info activity screenshot

About

DresdenStory is an app to get to know or rediscover Dresden with a storytelling approach and interactive challenges. Written as a well commented example Android app in Java.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages