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 see: roundware.org
Starting with a copy of the starter-app
directory, your App wraps the
available Roundware App functionality allowing customization of existing Java
Classes and Resources such as drawables and XML.
Prerequisites:
Setup the codebase:
# Clone the codebase
git clone https://github.com/roundware/roundware-android.git
cd roundware-android
# Copy "starter app" to "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
Note that creating a copy of the app-starter is ESSENTIAL. Without it Android Studio will not find a runnable Android app in the project.
Configure the project:
Open the project in Android Studio (use Import Project and choose the top level roundware-android folder)
Edit app/src/main/AndroidManifest.xml
to set your namespace. Change:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="org.roundware.app_starter">
To:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.rw">
Edit app/build.gradle
to set your namespace. Change:
defaultConfig {
applicationId "org.roundware.app_starter"
To:
defaultConfig {
applicationId "com.example.rw"
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.
Run 'app' to try your new Roundware app with the provided configuration.
rwapp
and rwservice
modules into your app
project will override the original versions during project build.app
directory. If not, please file an issue
on the issue queue.