/roundware-android

Android client for Roundware contributory audio platform

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

Roundware® for Android

Roundware® Overview

Roundware® is a flexible distributed framework which collects, stores, organizes and re-presents audio content. Basically, it lets you collect audio from anyone with a smartphone or web access, upload it to a central repository along with its metadata and then filter it and play it back collectively in continuous audio streams.

For more information about Roundware® functionality and projects that use the platform, please check out: roundware.org

Creating your own Roundware® Android App

Summary

Your App and namespace wraps the available Roundware® App functionality allowing customization of existing Java Classes and Resources such as drawables and XML.

Getting Started

Prerequisites:

  • A working Roundware® Server installation.
  • Knowledge of Android Mobile Application development with Android Studio

Setup the codebase:

# Clone the codebase
git clone https://github.com/roundware/roundware-android.git
cd roundware-android
# Copy the starter app
cp -R app-starter app
cd app
# Make your copy into a git repository
git init
# Add the origin remote repository
git remote add origin <your-app-repo>
# Add all files and store them in the repo.
git add .
git commit -m "Initial commit of original app-starter"
git push origin master

Configure the project:

  • Open the project in Android Studio
  • Edit app/AndroidManifest.xml to set your namespace.
  • Edit app/src/main/res/values/rwconfig.xml to set your server and project ID.
  • Edit app/src/main/res/values/strings.xml to set your application name.
  • Edit app/src/main/res/values/api_keys.xml to set your Google Maps API Key.

Any files you copy from the rwapp and rwservice Modules into your app project will override the original versions during project build. Add the new values if the XML file already exists.

TODO: More details...