## page was renamed from rocon_app_manager/Tutorials/hydro/Creating an App Pair
## For instruction on writing tutorials
## http://www.ros.org/wiki/WritingTutorials
####################################
##FILL ME IN
####################################
## for a custom note with links:
## note =
## for the canned note of "This tutorial assumes that you have completed the previous tutorials:" just add the links 
## note.0= [[rocon_app_manager/Tutorials/hydro/Pairing with Androids|Create a Robot App]]
## descriptive title for the tutorial
## title = Create an Android App
## multi-line description to be displayed in search 
## description = How to create an android app for robot-android pairing.
## the next tutorial description (optional)
## next =
## links to next tutorial (optional)
## next.0.link=
## next.1.link=
## what level user is this tutorial for 
## level= AdvancedCategory
## keywords = pairing, android, app
####################################

<<IncludeCSTemplate(TutorialCSHeaderTemplate)>>

<<TableOfContents(4)>>

== Overview ==

This tutorial goes through the steps needed to build an android app for robot-android pairing. If you're not using an existing robot app to pair with, make sure you've read through the previous tutorial - [[rocon_app_manager/Tutorials/hydro/Pairing with Androids|Create a Robot App]].

== Installation ==

There are two ways to get and install the sources depending on whether you want to work in a fused ros-studio environment with all the sources, or you just want to create a new app on its own.

=== Ros Environment ===

This lets you download all the source stacks together and manage the compile easily with catkin. 

 * Follow the [[http://wiki.ros.org/android/Tutorials/hydro/Installation - Ros Development Environment|android installation instructions]].
  * Make sure you use the android_apps rosinstaller.
 * Compile with `catkin_make`
 * Add your own gradle stack and subproject parallel to the others in `~/android/src`.
  * Use the convenient [[rosjava_build_tools/Tutorials/hydro/Creating Android Packages|catkin_create scripts]].

Note that you can still import the stacks individually into Android Studio once you've done this initial build.

=== Android Studio Environment ===

With this method, you'll just create a new project in android studio and promptly start coding. All dependencies come from our maven repository and no ros environment is needed.

 * Follow this [[android/Tutorials/hydro/Installation - Android Studio Development Environment|tutorial]].

== Code Structure ==

The android app must be a derivative of the !RosAppActivity. For a very simple example to get you started, refer to the sources for [[https://github.com/rosjava/android_apps/tree/hydro/listener|Listener]]. This pairs with the rocon app [[https://github.com/robotics-in-concert/rocon_app_platform/tree/hydro-devel/rocon_apps/apps/talker|Talker]].


## AUTOGENERATED DO NOT DELETE 
## TutorialCategory
## FILL IN THE STACK TUTORIAL CATEGORY HERE