Developing Android applications in Windows Below you will find information about the components needed for developing Android applications and other (optional) software needed to connect to the institution s resources. A small description on how to connect and install the HaptiMap Toolkit is also attached. Step 1 Install the JDK6 If you don t have the JDK, you will need to install it. 1. Go to http://www.oracle.com/technetwork/java/javase/downloads 2. Accept the License Agreement and choose your platform to Continue (Please make sure you are downloading JDK and not JRE and check if your OS is x86 or x64) 3. Follow the instructions for a default installation Registration optional! Note: If you choose a 64 bit version, you might need to add the Java directory to the path. First create a windows environment variable called JAVA_PATH pointing to C:\Program Files\Java\jdk1.6.0_xx (xx being your version number). Then prefix your Path variable with %JAVA_PATH%\bin Step 2 Eclipse IDE Classic 3.6.2 or greater Install or update Eclipse if needed. 1. Go to http://www.eclipse.org/downloads/ We recommend you to download Eclipse Classic (current version is 4.2.1) 2. Extract files and put in folder c:\eclipse (NOT c:\eclipse\eclipse!) No installation is needed. Note: It seems to be a problem with Android and Eclipse after a fresh installation. The issue is because of the Java JDK compliance. If you find the following error message:
Android requires compiler compliance level 5.0 or 6.0. Found '1.4' instead. Please use Android Tools > Fix Project Properties. Step 3 Then, from Eclipse 1. Go to Window -> Preferences. 2. On the left panel select Java -> Compiler and change to level 1.6 If the level is 1.6, select another level, apply and change back to 1.6. Download and Install Android SDK Install or update SKD if needed. 1. Go to http://developer.android.com/sdk and download the current package We recommend to download the zip file and extract to your local drive 2. Follow up by downloading and extracting the current Android SDK files to your local drive (c:\android-sdk-windows) If you choose the installer package, remember the location where it is installed.if the installer fails, please use the zip version that is available on the same link. 3. If you used the zip package, go to c:\android-sdk-windows and start the SDK Manager If you used the installer, Go the start menu and start the SDK Manager. 4. Make sure that the desired Android version is selected. You need at least ONE platform. We recommend that you choose version 2.3.3. The versions installed in the devices from the department can vary. If your intention is to use your private device, please make sure you install a supported version for your device. i. Select the latest SDK Platform-tools ii. Select the USB Driver for Windows which will be needed to connect the mobile phone to the developer s computer iii. (Optional) There are some samples available for the different versions. Select a suitable one that you can use to learn about Android and for further reference
iv. (Optional) If you would like to use Google Maps, then you will need to install the Google API. 5. Install to continue Note: The Android 4.0 is a major platform release and is highlighted every time the SDK is launched. There are some dependencies that need to be solved and
additional packages need to be downloaded. We have little experience with this release as of yet. Step 4 Download and Install ADT Plugin for Eclipse If you have a fresh copy of Eclipse or if you are running an older version of the ADT Plugin and recently updated the SDK, then you will need to install or update the ADT Plugin. 1. Start Eclipse and go to http://developer.android.com/sdk/installing/installing-adt.html and follow the instructions 2. You will need at least the Android Development Tools although we recommend selecting all available tools in the repository 3. Restart Eclipse and go to Window -> preferences and select Android
4. Browse to the SDK location and click OK 5. There is also a video on how to achieve this at http://www.xtensivearts.com/2009/07/03/episode-1-getting-started The video is old but it gives the basics for the installation. Note: It might take some time to install the Plugin Step 5 The Hello World App and Create an AVD When the dev environment is completed, follow the steps in the Hello World tutorial which also guides you to set up the Android emulator. 1. Go to http://developer.android.com/training/basics/firstapp/creatingproject.html and follow the instructions.
2. Run the application and make sure it runs (at least) on the Android 2.3.3 http://developer.android.com/training/basics/firstapp/running-app.html#emulator The AVD Manager is located in the same directory as your SDK Manager. Step 6 There are other tools that might be of interest in the android-sdk-windows\tools such as the DDMS. Run in and find out more. Connect your mobile The Hello World runs fine on an emulator and with this step you ll be ready to use a regular device to upload and run applications on it. 1. Go to http://developer.android.com/tools/device.html and follow instructions 2. Upload your Hello World application and see if you can find out anything else about the Activity you are running Step 7 Subversive (SVN) plugin for Eclipse A simple way to share code between other project members is by using a collaboration tool which supports revision control. Eclipse comes with a default cvs client, which is not supported in our department. More about Subversion (SVN): http://subversion.tigris.org/ http://en.wikipedia.org/wiki/apache_subversion Subversive consists of two parts: Subversive Plug-in and Subversive SVN Connector. You must install both. 1. Go to Help -> Install New Software 2. Choose --All Available Sites-- and type svn or subversive 3. Choose Subversive SVN Team Provider and follow the installation instructions. 4. Restart eclipse.
After restart, you will need to install the Connector 5. A pop-up should appear when Eclipse restarts. Select the SVNKit 1.3.8 Implementation and Finish
6. Then the following screen appears, both the Connectors and the SVNKit should be selected. Select Next and follow the instructions. A license needs to be approved and Eclipse needs to be restarted.
Step 8 Share Project In order to let the other project members to update and commit changes to a project, we need to share it. 1. Highlight your Hello World Project and right click. Select Team -> Share Project 2. Select SVN and Next 3. At the URL for repository location information, type in http://certec-svn.design.lth.se/svn/demo and type in User: demo Password: aid2011
Note: Next time you want to share a project, the credentials for the demo login will be stored automatically. For the real project, you need to use the login and password that will be attributed to your group. To force subversive to forget the stored credentials first close Eclipse. You can then erase the secure_storage file that has just been stored under your home folder : HOME\.eclipse\org.eclipse.equinox.security\ Finally, open Eclipse again. 4. Click on Browse to continue and select trunk and OK 5. Click on Next and answer YES to the question about normalizing the URL 6. On the next dialog, change from Simple Mode to Advanced Mode and
leave the default values and go Next 7. Add some comments to your project sharing and select Finish.
8. Here you can add extra comments to your code and how you were thinking when you committed your code. These comments might be of useful in the future when many persons are working on the same project. 9. Click on OK and your code will be submitted to the svn server. Note: If HelloWorld already exists, change the project name before sharing Step 9 Check out a (SVN) project Now we should be able to check out a project and begin experimenting. For the demo, you can use the same username and password given above. The username and passwords for your particular groups which will be given first after you put together your project teams. ote: The login and password might be remembered automatically and thus be set to demo or another group login on a shared computer, remember to use the procedure described in the previous step to force subversive to forget the credentials. 1. In Eclipse, go to File -> New -> Other Select Project from SVN and Next.
2. The URL for the project is http://certec-svn.design.lth.se/svn/demo Enter your username and password 3. Click on Browse and select the Hello World demo in the trunk resource directory that you committed before. Note: Since the project you are trying to check out is the same located in your local computer, delete or move the one in your local workspace before you continue. Be aware that ONLY the last committed changes will be available on the svn server. 4. Click on Next OK and Finish the import.
5. The Check Out As dialog gives different ways on how to check out the project. Just leave the default values and click Finish Be aware that the projects there are for demo purposes and files might disappear or be changed without warnings. In order to commit your changes to the repository, right click on the project, select Team -> Commit Note: You will find additional tools that might be helpful for your project and also ways to revert previous code.
Developing Android applications in Windows with the Haptimap Toolkit The HaptiMap toolkit adds more functionality to your projects and the library is added by following the following steps Step 1 Download the HaptiMap Toolkit The HaptiMap toolkit is available online and you can find more resources at http://haptimap.org 1. Log in or fulfil the registration procedure at http://haptimap.org/ 2. Download the toolkit from http://haptimap.org/toolkitdownload/download-page2.html 3. Extract the content to c:\haptimaptoolkit and read the README.txt
There you will find information about the directory structure and where thing could be situated. 4. Since we are developing for the Android platform you can go directly to C:\HaptimapToolkit\toolkit\build\android and there you will find the INSTALL.txt Note: There are other platforms supported such as for iphone and Windows. There is also a possibility to use other parts of the toolkit (core and mantle) that require cygwin, Apache Ant and Android NDK, but this is not covered in this tutorial. You can read more about this on https://haptimap.ee.qub.ac.uk/dev/wiki/usingtoolkitonandroid 5. Iwe will be using the crust modules from the toolkit. You can access them right away from the toolkit just by importing the HaptiMap toolkit as a library into your project. The HaptiMapToolkit must be imported as a project into Eclipse. i. Start Eclipse ii. Go to File -> Import and select Existing Projects into workspace Click on Next iii. Choose Select root directory and Browse Select HaptimapToolkit\toolkit\crust\android\HaptiMapToolkit
iv. The library import procedure is explained at point 5 of: https://haptimap.ee.qub.ac.uk/dev/wiki/usingtoolkitonandr oid 6. To check that the toolkit works properly, follow the HapticGuide tutorial linked on the course page.
After these steps you should now be ready to start experimenting. If you feel you need to, use the tutorials to help you on the way, making gradual changes in the applications, trying to play sounds and starting the vibrator, for example. If you get stuck, these are the steps to follow: a. Search for solutions online (there might be someone else who already has run into your problem). b. Look in the wiki or ask in the forums referenced at http://haptimap.org/toolkit-help.html You can also find links to tutorials (menu to the left). c. Ask Delphine for help: delphine.szymczak@certec.lth.se, room 520 Jour times : wednesday 15.00 to 17.00 and friday 13.00 to 15.00 REMEMBER: Google is your friend ;o) / Kirre 091028 revised by Miguel 101022 revised by Delphine 121029