Hoe de officiële WooCommerce Android-app broncode is gestructureerd

Wanneer je de architectuur van een grote e-commerce Android-app wilt bestuderen, kan het lastig zijn om een geschikt voorbeeld te vinden. De meeste real-world projecten zijn verborgen in de privé-repositories van bedrijven, en openbare tutorials beperken zich tot eenvoudige to-do lijsten. De WooCommerce mobiele app is een welkome uitzondering. Het Automattic-team houdt de client-broncode volledig open.

De repository bevat een volledig functionele Kotlin-applicatie die dagelijks wordt gebruikt door duizenden online winkeleigenaren. Het is een uitstekend platform voor het leren van praktische architecturale oplossingen, testbenaderingen en layouts.

Wat zit er in het project

De app is gebouwd rond Kotlin en Android Jetpack-componenten. Voorheen leefde de data-laag in een aparte FluxC-bibliotheek. Later verplaatsten de ontwikkelaars deze logica rechtstreeks naar de hoofdrepository.

Interessant detail: Google ML Kit wordt gebruikt voor streepjescodescannen en tekstherkenning op productverpakkingen. Dit is een van de weinige proprietaire afhankelijkheden in het project. Als je van plan bent om te bouwen zonder Google-services, moet deze module worden vervangen.

De repository-documentatie bevat handleidingen over de volgende onderwerpen:

• OAuth2-autorisatie instellen voor het werken met de WooCommerce REST API.
• Ondersteuning voor rechts-naar-links (RTL) interfaces en lokalisatie.
• Schermen aanpassen voor tablets en grote schermen.
• Feature flags gebruiken voor veilige release van nieuwe functies.

Bouwen en uitvoeren

Je kunt het project binnen enkele minuten lokaal draaiende krijgen. De basisvereisten zijn gewoon Android Studio en een geïnstalleerde SDK.

Kloon eerst de repository:

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

Kopieer vervolgens het configuratiesjabloon naar de secrets-directory:

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

Open daarna de map in Android Studio. De GUI maakt local.properties met SDK-paden automatisch aan. Je kunt een debug-versie bouwen of tests uitvoeren vanaf de terminal met standaard Gradle-commando's:

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

Waarom je deze repository zou moeten bestuderen

In de WooCommerce Android-code kun je oplossingen vinden voor alledaagse taken waar midden- of senior-level ontwikkelaars mee te maken hebben:

• Geconfigureerde Detekt statische analyzer met een kant-en-klare set regels die overeenkomen met teamstandaarden.
• Automatische screenshot-generatie voor Google Play via een speciale testuitvoering.
• Georganiseerde analytics event-tracking apart voor basiswinkelbeheer en POS-terminal.
• Goede scheiding van stijlen en thema's met Material Design.

Wie heeft voordeel bij dit project

De repository is nuttig voor Android-ontwikkelaars die willen zien hoe een echte Kotlin-applicatie met een rijke geschiedenis is gestructureerd. Hier kun je evalueren hoe het engineeringteam van Automattic technische schuld afhandelt, modules structureert en nieuwe Jetpack-bibliotheken integreert.

Als je je eigen e-commerce-client of WordPress API-integratie bouwt, zal deze code je veel tijd besparen tijdens de ontwerpfase van de architectuur.