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...