/rylc-html5-phonegap

Primary LanguageJavaScript

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):