Android client for the Freesound Project.
API is defined as per the Freesound Project API documentation.
If you've stumbled across this repository - welcome!
This project is intended as a way for Futurice developers to hone their Android skills, learn from colleagues and experiment. We're only just getting started, so expect plenty of rough edges; we're not yet making any bold claims about using best practices that you should follow. Feel free to have a look at the code and be inspired or be appalled.
Thanks for your interest!
To build the app, you will need a Freesound API client id and secret stored in the file: <repo>/app/freesound-api.properties
, as per:
freesound.api.clientId=yourapiclientidvaluegoeshere
freesound.api.clientSecret=yourapiclientsecretvaluegoeshere
If you don't have a key and you're not in the Futurice organization, then you will have to generate your own from the Freesound website.
Alternatively, you can join us at Futurice!
If you're a Futuricean and feel like getting involved, then look at the list of issues to find a task to work on. If you have an idea of your own, please add create a new issue and get the conversation started.
Create a branch from the master
branch with this format:
git checkout -b <type>/<title>
Where type
is one of the following:
feature
- a new feature, or part thereof.fix
- a fix for a bug.chore
- a technical or documentation task.
Example branch:
chore/add-branching-model-to-readme
Use labels to show the status of your pull request:
in progress
- assigned by contributor: your PR is in progress. Do this as soon as you can.awaiting review
- assigned by contributor: your PR is now ready for review. Ping some reviewers!in review
- assigned by reviewer: your PR is being reviewed.requires rework
- assigned by reviewer: you need to address the reviewer's feedback.conditionally approved
- assigned by reviewer: you may merge your pull request, subject to addressing the reviewer's feedback.approved
- assigned by reviewer: you may immediately merge your pull request. Hooray!
To ensure you that your source files match the project style, import the settings in the ide
directory. These include:
- Code style formatting settings
- Copyright header
In order to more clearly understand the nature of the Observables
and Flowables
created, we employ the following naming convention:
Observable<...> getValueStream()
- when subscribed, may or may not emit any value, but it will never complete. Still, it might emit an errorObservable<...> getValueOnceAndStream()
- when subscribed, this will emit a value as soon as possible, then may or may not emit any value. Also can emit an error
This naming convention only applies to Observables
and Flowables
, for Single
/Completable
/Maybe
, apply normal naming convention without the suffixes.
Brought to you by the power of the Chilicorn and the Futurice Open Source Program.
Copyright 2016 Futurice GmbH
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.