Skip to content

Commit d15fd8d

Browse files
author
Christoph Stanik
committed
closes issue #7
1 parent 0c1924c commit d15fd8d

File tree

4 files changed

+46
-1
lines changed

4 files changed

+46
-1
lines changed

Figures/emulator_part_1.png

70.3 KB
Loading

Figures/run_config.png

42.9 KB
Loading

MUSESDevGuide.pdf

1.33 MB
Binary file not shown.

MUSESDevGuide.tex

Lines changed: 46 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@
3232
\usepackage{graphicx}
3333
\usepackage[UKenglish]{babel}
3434
\usepackage[UKenglish]{isodate}
35+
\usepackage{enumitem}
3536

3637
\newcommand*{\plogo}{\fbox{$\mathcal{PL}$}} % Generic publisher logo
3738

@@ -112,6 +113,18 @@ \chapter{Building MUSES Client}
112113

113114
The first prototype of MUSES has been developed for Android. This chapter describes the needed tools, as well as building instructions, for developing inside the MUSES client. For instructions about how to install the whole system, please refer to Chapter \ref{ch:installmuses}.
114115

116+
\begin{enumerate}
117+
\item Prepare eclipse (or any other IDE) for Android
118+
\item Building the Common project
119+
\item Deploy the app on a device or emulator (Building Client project)
120+
\begin{enumerate}[label*=\arabic*.]
121+
\item Create an emulator
122+
\item Prepare your device for usb debugging
123+
\item Deploy
124+
\end{enumerate}
125+
\end{enumerate}
126+
127+
115128
\section{Installing Android SDK}
116129
\label{sec:ADT}
117130

@@ -152,10 +165,42 @@ \section{Building Common project}
152165
\end{center}
153166
\end{figure}
154167

155-
\section{Building Client application}
168+
\section{Building Client project}
156169
\label{sec:buildclient}
170+
This section is split into three parts \textit{1. Create an emulator}, \textit{2. Prepare your device for usb debugging}, and \textit{3. Deploy}, each of them describing the necessary steps.
171+
172+
\subsection{Create an emulator}
173+
\label{sec:createanemulator}
174+
This step is optional and should just be performed if you don't own an Android device to test with, because the emulator of Android has a bad performance and does not support the full functionality of a device, which can influence your debugging experience.
175+
\\
176+
\linebreak
177+
In order to create an emulator, you have to open the Android Virtual Device Manager (ADV). In Figure \ref{fig:emu_part_1} you can see that you can open the AVD by following step 1, which shows the corresponding icon in the toolbar of eclipse. Alternatively, you can open this dialog in eclipse by following: \textit{Windows -> Android Virtual Device Manager}. Open the emulator creator (step 2 in Figure \ref{fig:emu_part_1}) and fill in the fields with your preferences. Remember, we use the target SDK level 19 in the MUSES project.
178+
179+
\begin{figure}
180+
\begin{center}
181+
\includegraphics[width=0.8\textwidth]{./Figures/emulator_part_1}
182+
\label{fig:emu_part_1}
183+
\caption{Open the emulator window}
184+
\end{center}
185+
\end{figure}
186+
157187

158188

189+
\subsection{Prepare your device for usb debugging}
190+
\label{sec:prepareyourdeviceforusbdebugging}
191+
Android devices do not support debugging by default, you have to activate the debugging menu on the device manually. Go to the settings of your device and search for the \emph{Build Number}, the location on this setting depends on your device; then you need to click on the \emph{Build Number} seven times. After this, the developer menu is visible in the settings; open this menu and activate \emph{usb debugging}. If your operating system is Windows, you need to download the \emph{usb driver} from the Android SDK Manager (manual: \url{http://developer.android.com/sdk/win-usb.html}), if you are using a mac with OS X, you do not need to perform any further step. If you are using Linux you need to add a \emph{udev} rule (more information about i on \url{http://developer.android.com/tools/device.html#setting-up} step 3).
192+
193+
\subsection{Deployment}
194+
\label{sec:deploytheclient}
195+
The deployment process is straight forward, you just need to right click you project and select \emph{Run As -> Android Project}. Alternatively, you can also configure the deployment of the app and choose whether, you want to deploy the app on the emulator or the device by default, or if you would like to choose it individually for each deployment. Figure \ref{fig:run_config} shows the dialog of the configuration, you can open this dialog by right clicking on the project \emph{Run As -> Run configurations..}.
196+
197+
\begin{figure}
198+
\begin{center}
199+
\includegraphics[width=0.8\textwidth]{./Figures/run_config}
200+
\label{fig:run_config}
201+
\caption{Optional run configuration}
202+
\end{center}
203+
\end{figure}
159204

160205
\chapter{Building MUSES Server}
161206
\label{ch:server}

0 commit comments

Comments
 (0)