|
32 | 32 | \usepackage{graphicx}
|
33 | 33 | \usepackage[UKenglish]{babel}
|
34 | 34 | \usepackage[UKenglish]{isodate}
|
| 35 | +\usepackage{enumitem} |
35 | 36 |
|
36 | 37 | \newcommand*{\plogo}{\fbox{$\mathcal{PL}$}} % Generic publisher logo
|
37 | 38 |
|
@@ -112,6 +113,18 @@ \chapter{Building MUSES Client}
|
112 | 113 |
|
113 | 114 | 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}.
|
114 | 115 |
|
| 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 | + |
115 | 128 | \section{Installing Android SDK}
|
116 | 129 | \label{sec:ADT}
|
117 | 130 |
|
@@ -152,10 +165,42 @@ \section{Building Common project}
|
152 | 165 | \end{center}
|
153 | 166 | \end{figure}
|
154 | 167 |
|
155 |
| -\section{Building Client application} |
| 168 | +\section{Building Client project} |
156 | 169 | \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 | + |
157 | 187 |
|
158 | 188 |
|
| 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} |
159 | 204 |
|
160 | 205 | \chapter{Building MUSES Server}
|
161 | 206 | \label{ch:server}
|
|
0 commit comments