|
| 1 | +rosjava is the first pure Java implementation of ROS. |
| 2 | + |
| 3 | +From [ROS.org](http://www.ros.org/wiki/): ROS is an open-source, meta-operating |
| 4 | +system for your robot. It provides the services you would expect from an |
| 5 | +operating system, including hardware abstraction, low-level device control, |
| 6 | +implementation of commonly-used functionality, message-passing between |
| 7 | +processes, and package management. |
| 8 | + |
| 9 | +Developed at Google in cooperation with Willow Garage, rosjava enables |
| 10 | +integration of Android and ROS compatible robots. This project is under active |
| 11 | +development and currently alpha quality software. Please report bugs and feature |
| 12 | +requests on the [issues |
| 13 | +list](https://github.com/rosjava/rosjava/issues?state=open). |
| 14 | + |
| 15 | +To get started, visit the |
| 16 | +[rosjava_core](http://rosjava.github.com/rosjava_core/latest) and |
| 17 | +[android_core](http://rosjava.github.com/android_core/latest) pages for |
| 18 | +documentation concerning the core libraries and examples. Also visit the roswiki |
| 19 | +[rosjava](http://wiki.ros.org/rosjava) and |
| 20 | +[android](http://wiki.ros.org/android) pages for more general rosjava-android |
| 21 | +information. |
| 22 | + |
| 23 | +Still have questions? Check out the ros-users [discussion |
| 24 | +list](https://discourse.ros.org/c/rosjava), post questions to [ROS |
| 25 | +Answers](http://answers.ros.org/questions/) with the tag "rosjava," or join #ROS |
| 26 | +on irc.oftc.net. |
| 27 | + |
| 28 | +rosjava was announced publicly during the [Cloud Robotics tech talk at Google |
| 29 | +I/O 2011](http://www.youtube.com/watch?feature=player_embedded&v=FxXBUp-4800). |
| 30 | + |
| 31 | +Looking for a robot platform to experiment with ROS, Android, and cloud |
| 32 | +robotics? The [OSRF](http://www.osrfoundation.org/) |
| 33 | +[TurtleBot](http://wiki.ros.org/Robots/TurtleBot) is a great mobile perception |
| 34 | +platform for [getting started with robotics |
| 35 | +development](http://www.youtube.com/watch?feature=player_embedded&v=MOEjL8JDvd0). |
| 36 | + |
| 37 | +### Branches ### |
| 38 | + |
| 39 | +The master branch reflects the latest version of rosjava. All development |
| 40 | +happens on the master branch in the form of pull requests from developers. |
| 41 | +Unless you are developing rosjava itself, you should _not_ use the master |
| 42 | +branch. |
| 43 | + |
| 44 | +Named branches are created whenever a new version of ROS is released. These |
| 45 | +branches are considered stable. No new features will be added to these branches, |
| 46 | +however, bug fixes may be cherry picked from master. |
| 47 | + |
| 48 | +### Pull Requests ### |
| 49 | + |
| 50 | +You must sign a Contributor License Agreement (CLA) before we can accept any |
| 51 | +code. The CLA protects you and us. |
| 52 | + |
| 53 | +* If you are an individual writing original source code and you're sure you own |
| 54 | + the intellectual property, then you'll need to sign an [individual |
| 55 | + CLA](https://developers.google.com/open-source/cla/individual). |
| 56 | +* If you work for a company that wants to allow you to contribute your work to |
| 57 | + SL4A, then you'll need to sign a [corporate |
| 58 | + CLA](https://developers.google.com/open-source/cla/corporate). |
| 59 | + |
| 60 | +Follow either of the two links above to access the appropriate CLA and |
| 61 | +instructions for how to sign and return it. Damon will respond on either github |
| 62 | +or email to confirm. |
0 commit comments