This is a demo application for the Europeana.eu API version 2.
As this is an Open Source project, all contributions/suggestions are welcome. You can contribute in several ways.
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.
Help us translating this app via our online translations tool so we can offer the app in more languages!
-
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. :-)
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>
This project is using the gradle building system coming with Android Studio. Setting up the project is relatively easy.
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.
- 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.
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
For more detailed project documentation, visit the WIKI pages on: