Opsætning af Android debugging
Guiden vil gennemgå opsætning af debugging af OS2 Indberetnings Android app mod OS2 Indberetning dmz api der køres på en lokal udviklermaskine, og som derfor kan debugges samtidig med appen.
Det forudsættes at:
- Api'et er hentet kan køre på maskinen gennem Visual Studio/IIS Express.
- Node.js er installeret
- En Android telefon er tilgængelig til debugging. Alternativt kan en virtual device bruges, men det er ikke medtaget i denne guide.
- Hent og installer Android Studio, https://developer.android.com/studio/index.html
- For at kunne ramme IIS Express på den lokale maskine fra en anden device på netværket, er det nødvendigt at hente et proxy tool: https://github.com/icflorescu/iisexpress-proxy.
- Kør kommandoen
npm install -g iisexpress-proxy
i en kommandopromt - Kør kommandoen
iisexpress-proxy <from port> to <to port>
for at sætte redirect op, fx:iisexpress-proxy 1982 to 1983
- Kør Api'et og tjek browseren hvilken port det bliver startet op på for at få <from port>
- Kør kommandoen
- Inden Api'et køres fra Visual Studio markeres Api projektet og tryk på f4. Her skal "Anonymous authetication" sættes til enabled.
- I Android Studio skal ændres følgende:
- Åben filen ServerHandler.java, og PROVIDER_URL ændres til den adresse Api'et kører på lokalt, fx http://172.20.1.152:60991/api/Appinfo. Dette vil få appen til at hente listen over kommuner fra den lokale maskine i stedet for Favrskovs server.
- I Visual Studio findes filen appinfo.json i Api projektet. Her skal den lokale maskine tilføjes som Api server/"kommune" til json filen. Især "apiurl" i appinfo.json er vigtig at få sat til samme url som i ServerHandler.java, altså urlen til det lokale API.
- Før dette setup kan bruges, er det selvfølgelig nødvendigt at have oprettet en app login til sin bruger i webdelen af Indberetning.
- Plug Android telefonen i computeren med et kabel og kør (shift+f10) eller debug (shift+f9) appen fra Android Studio her skulle android telefonen gerne komme frem i en dialog (hvis ikke skal debugging tillades på telefonen gennem dens indstillinger).
- Får man fejl med at Gradle versionen er for lav til at understøtte "instant run", kan dette slås fra gennem file-->settings–>build, execution, deployment i Android Studio.
Nu skulle Android appen og Api'et kunne debugges på samme tid fra henholdsvis Android Studio og Visual Studio.