Europeana.eu for Android

This is a demo application for the Europeana.eu API version 2.

Contributing to this project

As this is an Open Source project, all contributions/suggestions are welcome. You can contribute in several ways.

Report bugs/suggestions

Use the Issues functionality on our GitHub page to add bug reports or issues. Try to be as specific as possible, mention brand and type of hardware, android version, screen size etc etc.

Translating

Help us translating this app via our online translations tool so we can offer the app in more languages!

Contribute code

Get a fork: The easiest way is to create a fork of our project, make your changes and submit a pull request. Some of the core developers will look at your request and hopefully merge it into the master branch.
Join the team: It's also possible to be added to the development team and submit directly into the repository. But it would be nice if we know you a bit, so use the fork method first a few times. :-)

Contribute translations

If you want to contribute or correct translations of the application there are two ways to do so. We try to find a better way of doing this but till then...

Pull requests: same as the code contribution method, fork the project and add the language folder and the translated strings.xml or update an existing one. Commit and send us a pull request to merge the translations into our master branch.
Submit as issue: download this file: strings.xml and translate it. Create an issue starting with the language and it's code and post the complete translation into the issue between three of markdown code quotes. A preview should look like this:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="app_name">Europeana.eu</string>
</resources>

Setup project

This project is using the gradle building system coming with Android Studio. Setting up the project is relatively easy.

Development Environment

This project requires the following setup:

Android Studio 1.3.0 or higher
JDK 1.7 or higher
Gradle 2.4 or higher

Check build.gradle which SDK and build tools are required via the SDK manager.

Creating a project

Check out europeana4android on GIT.
In the europeana4android project, copy the src/main/AndroidManifest.xml.template to AndroidManifest.xml in the same folder. The copied file is configured to be ignored by GIT.
Import the project folder into AndroidStudio using the import project function. If you want to use gradle wrapper or a local gradle installation is up to you.
Before testing you are required to have a Google Maps API key and combination of Europeana API public and private key.

Project planning

We have our to do list on a trello scrum board (although we don't do sprints (yet))

https://trello.com/b/AykTks3F/europeana-4-android

More project information

For more detailed project documentation, visit the WIKI pages on:

https://github.com/eLedge/europeana4android/wiki

TouchBoarder / europeana4android