Thank you for your interest in ribot’s development work. Unfortunately there are no current plans to make any changes to this project in the near future, and it is not being maintained or updated. We hope you still find this a useful resource.
The ribot app is an internal project based off of our Android Boilerplate. It was created to make us aware of our fellow ribots locations. Currently, the app allows you to:
We've open sourced this to both showcase our efforts and allow you to recreate the experience in your own workplace - why not fork this project and give it a go?
The libraries and tools used include:
In order to run this project, you'll need to setup several things beforehand:
Our application uses the ribot API to handle data requests, you'll need to clone this and configure it to your requirements. This application will not work without an API and the implementation in this repository requires the use of an @ribot.co.uk email address, so your own API is required if you wish to clone this project.
You'll need to set the values found in the gradle.properties file.
This involves the web application client id (
ribotAppGoogleApiServerClientId) and debug/release keystore locations, aliases and passwords. Ideally the
UNDEFINED values found in this file should be defined in the Global
gradle.properties that lives in
This project follows our Android architecture guidelines. Read more about them here.
This project integrates a combination of unit tests, functional test and code analysis tools.
To run unit tests on your machine:
To run functional tests on connected devices:
Note: For Android Studio to use syntax highlighting for Automated tests and Unit tests you must switch the Build Variant to the desired mode.
The following code analysis tools are set up on this project:
To ensure that your code is valid and stable use check:
This will run all the code analysis tools and unit tests in the following order:
Copyright 2015 Ribot Ltd. 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.