README zu RYLC-HTML5-PHONEGAP

Beispielcode zum Kapitel 10 Hybride Apps im Buch Mobile Web-Apps mit JavaScript.

• Voraussetzungen:

  • Java Development Kit 1.6 oder neuer.
  • Apache Maven 3.0.4 oder neuer.
  • cURL Kommandozeilenwerkzeug (muss im PATH der Kommandozeile enthalten sein).
  • Android SDK.

• Bauen der Backend-Komponente:

  • rylc-backend klonen
  • In das Verzeichnis rylc-backend wechseln
  • Das Backend mittels mvn clean install -Pproduction bauen

• Bauen und Starten des Android PhoneGap-Containers für ein Profil <profil>:

  1. rylc-android-phonegap klonen
  2. PhoneGap-Container via mvn clean install -P<profile> android:deploy android:run bauen und auf einem via USB angeschlossenem Gerät ausführen.

• Bauen des Projekts inkl. Integrationstests: mvn clean verify -Pintegration. Dazu muss Chrome über den Kommandozeilen-Befehl chrome gestartet werden können. Alternativ kann die Property browser in pom.xml angepasst und dort der gewünschte Befehl zum Starten von Chrome eingetragen werden.

• Manuelles Starten und Ausführen der Tests:

  1. Jetty starten mittels mvn jetty:run -Pdevelopment.
  2. Zum Ausführen von Unit Tests in Chrome den Unit Spec Runner aufrufen.
  3. Zum Ausführen von UI Tests in Chrome den UI Spec Runner aufrufen.

• Starten des Projekts im Desktop-Browser:

  1. Projekt bauen: mvn clean install
  2. PhoneGap-Container bauen und starten für das Profil phonegapproxy (s.o.).
  3. Webserver starten: mvn jetty:run
  4. App öffnen, Eingabe von Server http://<webserver-ip>:8585/rylc-html5/cometd, Channel default, und Connect-Button drücken.
  5. Startseite im Desktop-Browser aufrufen.

• Starten des Projekts als native App:

  1. Projekt bauen: mvn clean install
  2. PhoneGap-Container bauen und starten für das Profil rylc (s.o.).
  3. Webserver starten: mvn jetty:run
  4. App öffnen und einloggen

• Erzeugen der App via PhoneGap Build (ohne Barcode-Scanner):

  1. Erzeugen eines Accounts auf PhoneGap Build
  2. Benutzerinformationen in der pom.xml-Properties phonegap.* eintragen
  3. Projekt bauen: mvn install -Pphonegap
  4. Die erzeugten Binärpakete finden sich anschließend im Verzeichnis target/phonegap. Alternativ können sie auch im Handy von PhoneGap Build heruntergeladen werden.
  5. Webserver starten: mvn jetty:run
  6. App öffnen und einloggen

• Login an der Anwendung:

  • Server http://<webserver-ip>:8585, Benutzer fred, Passwort pass

• Beispiel Barcodes, die von der Anwendung eingescannt werden können (via Google Chart API generiert):

  • Gültiger Code.
  • Fehlerhafter Code