Eine lokale Testinstallation #

Diese Seite richtet sich an App-Entwickler, die eine eigene Exponential-Installation möchten, gegen die sie entwickeln und testen. Mit SQLite braucht sie keinen Datenbankserver und ist in wenigen Minuten installiert.

Inhalt #

1. Installieren
2. Die APIs prüfen
3. Für die App vorbereiten
4. Von einem Gerät aus erreichen
5. Zwischen Testläufen zurücksetzen

Installieren #

Aus einem Checkout von Exponential, dessen Voraussetzungen erfüllt sind (Voraussetzungen):

./console exp:install --apply

Das installiert das Multisite-Paket auf SQLite in eng-US mit den Siteaccesses site und admin und gibt die Adressen und die Anmeldedaten aus (Exponential mit einem Befehl installieren). Eine umfassendere Entwicklungsumgebung mit Webserver und Entwicklungseinstellungen beschreibt Eine Entwicklungsumgebung einrichten.

Die APIs prüfen #

Führen Sie die drei Prüfungen aus Gegen eine Demo testen gegen Ihre lokale Adresse aus. Antwortet REST mit 404, aktivieren Sie ezprestapi so, wie es der Leitfaden beschreibt (Migration von ezprestapiprovider):

# settings/override/site.ini.append.php
[ExtensionSettings]
ActiveExtensions[]=ezprestapi

php bin/php/ezcache.php --clear-tag=ini --allow-root-user
php bin/php/ezpgenerateautoloads.php -e

Laden Sie danach PHP-FPM neu oder starten Sie Velocity neu, wenn Velocity die Website ausliefert. Fehlen die Remote-Dienste, gilt dasselbe Vorgehen mit ActiveExtensions[]=expservices (Remote-Dienste und Apps, Abschnitt 1).

Für die App vorbereiten #

1. Inhalte: ein Ordner für die App mit einigen Einträgen jeder Klasse, die die App anzeigt; geben Sie dem Ordner eine Remote-ID, die die Konfiguration der App verwendet (Knoten-IDs, Remote-IDs und Deep Links).
2. Eine Rolle und ein Benutzer, genau wie der Integrationsbenutzer der Produktion (Berechtigungen für App-Benutzer).
3. Ein persönlicher API-Schlüssel dieses Benutzers für Tests (vorher apikey/create in einer Rolle) (Persönliche API-Schlüssel für Werkzeuge).
4. Ein OAuth-Client unter Setup > oAuth-Verwaltung mit der Weiterleitungsadresse Ihres Entwicklungs-Backends und oauth/authorize für die Testbenutzer (OAuth2-Autorisierungscode-Ablauf).
5. Ein expservices-Token des Testbenutzers, wenn die App die Remote-Dienste verwendet (expservices-Tokens in Apps).

Von einem Gerät aus erreichen #

• Der Android-Emulator erreicht den Host-Rechner unter 10.0.2.2; der iOS-Simulator teilt das Netzwerk des Hosts, dort funktioniert also localhost.
• Ein echtes Smartphone braucht die Adresse des Rechners im lokalen Netz und einen Server, der darauf lauscht.
• Verwenden Sie wie in der Produktion HTTPS, wo die Plattform es für App-Verkehr verlangt; ein lokales Zertifikat oder ein Tunnel sind die üblichen Wege. Halten Sie Ausnahmen für unverschlüsseltes HTTP aus Release-Builds heraus.

Zwischen Testläufen zurücksetzen #

• Bewahren Sie nach der Vorbereitung eine Kopie der SQLite-Datenbankdatei auf und kopieren Sie sie vor einem Testlauf zurück, damit jeder Lauf mit denselben Inhalten und IDs beginnt.
• Oder schreiben Sie die Vorbereitung als Skript mit den Remote-Diensten (expnode::create mit festen remote_ids) und führen Sie es nach einer frischen Installation aus.

Verwandte Seiten #

• Apps gegen Exponential testen
• Anwendungen testen
• Erste Schritte
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.