Project Indoor Navigation System Onderwerp: Indoor Navigation System Document: Handleiding Ontwikkeltools Groep: EII6RTa Auteurs: 1. Jordi Betting 109277 2. Jerome Bos 113180 3. Theo Miltenburg 112883 4. Sebastian Nadorp 109369 5. Ingmar te Raa 112375 6. Simon Wels 107479 Klanten: Saxion (CII, kenniscentrum) Alten PTS (Dhr. G. Blom) Begeleiders: 1. Dhr. R.J.W.T. Tangelder 2. Dhr. R. Tobias Versie: 1.1 Datum: 16-juni-2010 Status: Final
Geschiedenis Versie Datum Auteur Opmerking 0.1 2-juni-2010 Jerome Bos Initiële versie 0.2 15-juni-2010 Jerome Bos Applicaties bouwen toegevoegd, Synchronisatie toegevoegd 1.0 15-juni-2010 Jordi Betting Review 1.1 16-juni-2010 Groep EII6RTa Review Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 2/17
Inhoudsopgave Geschiedenis... 2 1 Inleiding... 4 1.1 Scope... 4 1.2 Terminologie en afkortingen... 4 2 Android SDK... 5 3 Eclipse... 6 4 Android Development Tools for Eclipse... 7 5 Subclipse... 8 6 HTC Tattoo en HTC Legend... 9 7 Motorola Milestone... 10 8 Enterprise Architect... 11 9 Apache Subversion... 12 10 Redmine... 13 11 Applicaties compileren en starten... 14 12 Synchronisatie code en ontwerp... 17 Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 3/17
1 Inleiding 1.1 Scope Dit document beschrijft de ontwikkeltools en applicaties die gebruikt zijn door de projectleden en hoe deze applicaties geïnstalleerd kunnen worden. Bij iedere applicatie staat ook het versienummer vermeld en het platform. De installatie van deze applicaties wordt meestal ook op de bijhorende sites uitgelegd. Dit document is bestemd voor: project begeleiders project leden project beheerders Minimale kennis die benodigd is om dit document te lezen en te begrijpen: Basiskennis over hardware and software ontwikkeling. 1.2 Terminologie en afkortingen term / afkorting betekenis Android Android is een open source platform voor mobiele telefoons gebaseerd op Linux en Java. IDE Integrated Development Environment SDK Software Development Kit SVN Subversion repository Lokatie waar bestanden worden opgeslagen Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 4/17
2 Android SDK De Android SDK is noodzakelijk om voor Android telefoons te ontwikkelen. Versie: Android SDK revision 4 Platform: Win32, Linux (i386) Site: http://developer.android.com/sdk/index.html Installatie: 1. Bemachtig een versie van de Android SDK 2. Start de SDK Setup 3. Er kan een foutmelding optreden. De Android-repository is niet altijd beschikbaar middels HTTPS. 4. Kies in het linkermenu de optie Settings. 5. Vink de optie Force https://...sources to be fetched using http://... aan. 6. Klik op de knop Save & Apply. 7. Kies in het linkermenu de optie Available Packages. 8. Klik op de knop Refresh. 9. Volg de instructies om de Android SDK Tools te downloaden en te installeren. Dit kan lang duren. 10. Kies in het linkermenu de optie Installed Packages om de geïnstalleerde packages te zien en het pad van de SDK-directory. Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 5/17
3 Eclipse Eclipse is een IDE die gebruikt kan worden om Android-applicaties mee te ontwikkelen. IDE for Java EE Developers Versie: 1.2.2.20100216-1730 of 1.2.2.20100217-2310 Build-id: 20100218-1602 Platform: Win32, Linux(i386) Eclipse Platform Versie: 3.5.2 Build-id: M20100211-1343 Platform: Win32, Linux (i386) Site: http://www.eclipse.org/ Installatie: 7. Bemachtig een versie van Eclipse 8. Installeer Eclipse Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 6/17
4 Android Development Tools for Eclipse ADT (Android Development Tools) is een plugin voor Eclipse die voor integratie zorgt met de android SDK. Via deze tools kan het bouwen en debuggen van applicaties eenvoudiger. Versie: 0.9.5.v200911191123-20404 Platform: n.v.t. Site: http://developer.android.com/sdk/eclipse-adt.html Installatie: 1. Start Eclipse en ga naar het menu Help -> Install New Software. 2. Klik op de knop Add. Er verschijnt een nieuw venster. 3. Vul in dit venster bij Location het adres https://dlssl.google.com/android/eclipse/. 4. Eclipse zal de Developer Tools laden 5. Selecteer Developer Tools en klik op de knop Next >. 6. Volg de overige instructies en accepteer de licentie-overeenkomst. 7. Herstart Eclipse Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 7/17
5 Subclipse Met de Subclipse plug-in is het mogelijk om in de Eclipse IDE projecten te synchroniseren met een SVN server. Via een GUI is het mogelijk om bestanden binnen een project te synchroniseren en te vergelijken. Hierdoor kunnen er meerdere mensen aan een project werken. Versie: Subclipse 1.6.10 Platform: n.v.t. Site: http://subclipse.tigris.org/ Installatie vanuit Eclipse: 1. Start Eclipse en ga naar Help -> Install New Software. 2. Er verschijnt een venster met Available Software. Klik op Add... 3. Voeg een naam aan de nieuwe software toe (Bijvoorbeeld "Subclipse"), en voeg http://subclipse.tigris.org/update_1.6.x in bij de url. 4. Selecteer de volledige tree bij het selectie vakje met de naam "Subclipse Plugin" en klik op Next. 5. Vervolgens zal Eclipse details tonen voor de te installeren componenten. Click op Next om de license agreement te lezen. Als je de licentie accepteert, kun je op Finish klikken. 6. Herstart Eclipse Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 8/17
6 HTC Tattoo en HTC Legend Het installeren van de HTC mobiele telefoons gaf nog enige problemen onder Windows 7. De drivers zijn in de zelfde bestandsmap te vinden als dit document. Installatie onder Windows 7: 1. plug de USB-kabel in de telefoon en de computer. 2. Windows zal automatisch de drivers gaan installeren. Dit gaat niet goed, de ADB driver wordt niet goed geïnstalleerd. 3. Installeer de ADB driver handmatig of probeer de automatische installatie opnieuw totdat de ADB driver wel goed is geïnstalleerd. Wellicht zal HTC Sync geïnstalleerd moeten worden. Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 9/17
7 Motorola Milestone Installatie onder Windows 7: 1. plug de USB-kabel in de telefoon en de computer 2. Windows zal automatische de drivers proberen te installeren. Dit gaat niet goed, de ADB driver wordt niet goed geïnstalleerd. 3. Installeer de ADB driver handmatig. Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 10/17
8 Enterprise Architect Enterprise Architect is een programma om applicaties te ontwerpen op basis van XML. Bovendien bied het programma de mogelijkheid om code te genereren en zelfs om de implementatie en het ontwerp te synchroniseren. Versie: 7.5.844 (Build: 844) Registratie: Licenced User, registration key required Platform: Win32 Installatie: 1. Pak het EnterpriseArchitect-bestand uit naar een geschikte locatie 2. Start de setup 3. Volg de instructies Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 11/17
9 Apache Subversion Apache Subversion, of kortweg SVN, is een open-source versiebeheersysteem. Het systeem slaat niet alleen de data van een bestand op, maar ook de verschillen tussen de versies van een bestand. Hierdoor is het mogelijk om terug te keren naar een oude versie van een bestand. Als er bijvoorbeeld een bug is ontstaan tijdens het bewerken van een bestand, kun je door middel van een vergelijking van de twee bestanden de oorzaak van de bug vinden. Door met SVN te werken, wordt het ook makkelijk om in teamverband aan één codebase werken. Door steeds te synchroniseren met de SVN server zal de meest recente versie op één plek worden behouden. Als iemand een verouderd bestand probeert in te checken, zal er een waarschuwing gegeven worden met de mededeling dat een nieuwere versie op de server beschikbaar is. Zo kan iedereen aan de meest recente codebase werken. Versie: 1.6.5, revisie: 18866 Site: http://subversion.apache.org/ Installatie: 1. Volg de instructies op de site Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 12/17
10 Redmine Redmine is een open-source projectmanagement en bug-tracking tool. Het systeem kan de status van een project bijhouden doordat gebruikers gegevens over taken kunnen invoegen. Doordat Redmine ook gekoppeld kan worden aan een SVN repository, kunnen taken ook aan projecten binnen een SVN repository worden gekoppeld. Doordat Scrum taken centraal zet binnen een project, bied deze tool goede ondersteuning om digitaal bij te houden wat de status van een project is. Versie: 0.8.6 Platform: Linux (i386) Vereist: Ruby 1.8.6, Ruby on Rails 2.1.2, MySQL 4.1 Site: http://www.redmine.org/ Installatie: 1. Bemachtig een versie van Redmine. 2. Volg de installatie-instructies: http://www.redmine.org/wiki/redmine/redmineinstall 3. Gebruik het startup-script om Redmine te starten Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 13/17
11 Applicaties compileren en starten Het compileren en starten van Android-applicaties gaat vanuit Eclipse: 1. Vanuit de Android SDK kan een emulator gestart worden. 2. Daarna kan men op Debug of Run drukken. 3. Men moet kiezen op welk apparaat de applicatie dient te draaien. Dit kan een emulator zijn of een werkelijk apparaat. 4. De applicatie zal daarna automatisch op het apparaat geladen worden. 5. Vanuit de Dalvik Debug Monitor Service kan men de applicatie debuggen. Figuur 1: Android-opties binnen Eclipse Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 14/17
Figuur 2: Android SDK Figuur 3: Emulator Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 15/17
Figuur 4: Device kiezen Figuur 5: Dalvik Debug Monitor Service Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 16/17
12 Synchronisatie code en ontwerp Het is mogelijk om de code en het ontwerp te synchroniseren. Wijzigingen in het ontwerp kunnen direct doorgevoerd worden in de code en vice versa. Figuur 6: Synchronisatie binnen Enterprise Architect Indoor Navigation System, Handleiding Ontwikkeltools, 1.1 17/17