Wie der offizielle Quellcode der WooCommerce-Android-App aufgebaut ist

Wenn Sie die Architektur einer großen E-Commerce-Android-App untersuchen möchten, kann es schwierig sein, ein geeignetes Beispiel zu finden. Die meisten realen Projekte sind in privaten Repositories von Unternehmen versteckt, und öffentliche Tutorials beschränken sich auf einfache To-do-Listen. Die WooCommerce-Mobile-App ist eine willkommene Ausnahme. Das Automattic-Team hält den Client-Quellcode vollständig offen.

Das Repository enthält eine voll funktionsfähige Kotlin-Anwendung, die täglich von Tausenden von Online-Shop-Betreibern genutzt wird. Es ist eine ausgezeichnete Plattform, um praktische architektonische Lösungen, Testansätze und Layouts zu erlernen.

Was steckt im Projekt

Die App basiert auf Kotlin und Android Jetpack-Komponenten. Zunächst befand sich die Datenschicht in einer separaten FluxC-Bibliothek. Später haben die Entwickler diese Logik direkt in das Hauptrepository verschoben.

Interessantes Detail: Google ML Kit wird für Barcode-Scanning und Texterkennung auf Produktverpackungen verwendet. Dies ist eine der wenigen proprietären Abhängigkeiten im Projekt. Wenn Sie vorhaben, ohne Google-Dienste zu bauen, muss dieses Modul ersetzt werden.

Die Repository-Dokumentation enthält Anleitungen zu folgenden Themen:

• Einrichtung der OAuth2-Autorisierung für die Arbeit mit der WooCommerce REST API.
• Unterstützung von Rechts-nach-links-Schnittstellen (RTL) und Lokalisierung.
• Anpassung von Bildschirmen für Tablets und große Bildschirme.
• Verwendung von Feature-Flags für sichere Releases neuer Funktionen.

Erstellen und Ausführen

Sie können das Projekt in wenigen Minuten lokal zum Laufen bringen. Die grundlegenden Anforderungen sind lediglich Android Studio und ein installiertes SDK.

Klonen Sie zunächst das Repository:

git clone https://github.com/woocommerce/woocommerce-android.git
cd woocommerce-android

Kopieren Sie anschließend die Konfigurationsvorlage in das Secrets-Verzeichnis:

cp defaults.properties ~/.configure/woocommerce-android/secrets/secrets.properties

Öffnen Sie danach den Ordner in Android Studio. Die GUI erstellt local.properties mit SDK-Pfaden automatisch. Sie können eine Debug-Version erstellen oder Tests über das Terminal mit Standard Gradle-Befehlen ausführen:

./gradlew assembleVanillaDebug                         
./gradlew installVanillaDebug                          
./gradlew :WooCommerce:testVanillaDebugUnitTest        
./gradlew :WooCommerce:connectedVanillaDebugAndroidTest

Warum Sie dieses Repository studieren sollten

Im WooCommerce-Android-Code finden Sie Lösungen für alltägliche Aufgaben, mit denen Mid- oder Senior-Entwickler konfrontiert werden:

• Konfigurierter Detekt-Static-Analyzer mit einem fertigen Regelset, das den Teamstandards entspricht.
• Automatische Screenshot-Generierung für Google Play durch einen speziellen Testlauf.
• Organisiertes Analytics-Event-Tracking, separat für grundlegendes Store-Management und POS-Terminal.
• Korrekte Trennung von Styles und Themes mit Material Design.

Wem dieses Projekt nützt

Das Repository ist nützlich für Android-Entwickler, die sehen möchten, wie eine echte Kotlin-Anwendung mit langer Geschichte aufgebaut ist. Hier können Sie bewerten, wie das Engineering-Team von Automattic mit Tech Debt umgeht, Module strukturiert und neue Jetpack-Bibliotheken integriert.

Wenn Sie Ihren eigenen E-Commerce-Client oder eine WordPress-API-Integration erstellen, wird Ihnen dieser Code viel Zeit in der Architektur-Design-Phase sparen.