Jak zorganizowany jest oficjalny kod źródłowy aplikacji WooCommerce na Androida

Gdy potrzebujesz przeanalizować architekturę dużej aplikacji Android do e-commerce, znalezienie odpowiedniego przykładu może być trudne. Większość prawdziwych projektów jest ukryta w prywatnych repozytoriach firm, a publiczne tutoriale ograniczają się do prostych list zadań. Aplikacja mobilna WooCommerce jest miłym wyjątkiem. Zespół Automattic udostępnia pełny kod źródłowy klienta.

Repozytorium zawiera w pełni funkcjonalną aplikację Kotlin używaną codziennie przez tysiące właścicieli sklepów internetowych. To doskonała platforma do nauki praktycznych rozwiązań architektonicznych, podejść do testowania i układów.

Co zawiera projekt

Aplikacja jest zbudowana wokół Kotlina i komponentów Android Jetpack. Wcześniej warstwa danych znajdowała się w oddzielnej bibliotece FluxC. Później deweloperzy przenieśli tę logikę bezpośrednio do głównego repozytorium.

Interesujący szczegół: Google ML Kit jest używany do skanowania kodów kreskowych i rozpoznawania tekstu na opakowaniach produktów. To jedna z niewielu zastrzeżonych zależności w projekcie. Jeśli planujesz budować bez usług Google, ten moduł będzie musiał zostać zastąpiony.

Dokumentacja repozytorium zawiera przewodniki dotyczące następujących tematów:

• Konfiguracja autoryzacji OAuth2 do pracy z WooCommerce REST API.
• Obsługa interfejsów od prawej do lewej (RTL) i lokalizacji.
• Dostosowywanie ekranów do tabletów i dużych ekranów.
• Używanie flag funkcji do bezpiecznego wydawania nowych funkcji.

Budowanie i uruchamianie

Możesz uruchomić projekt lokalnie w ciągu kilku minut. Podstawowe wymagania to tylko Android Studio i zainstalowany SDK.

Najpierw sklonuj repozytorium:

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

Następnie skopiuj szablon konfiguracji do katalogu secrets:

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

Po tym otwórz folder w Android Studio. GUI automatycznie utworzy local.properties ze ścieżkami SDK. Możesz zbudować wersję debug lub uruchomić testy z terminala za pomocą standardowych poleceń Gradle:

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

Dlaczego warto analizować to repozytorium

W kodzie WooCommerce na Androida można znaleźć rozwiązania codziennych zadań, z którymi mierzą się deweloperzy na poziomie mid lub senior:

• Skonfigurowany statyczny analizator Detekt z gotowym zestawem reguł dopasowanych do standardów zespołu.
• Automatyczne generowanie zrzutów ekranu dla Google Play poprzez specjalny test.
• Zorganizowane śledzenie zdarzeń analitycznych osobno dla podstawowego zarządzania sklepem i terminala POS.
• Właściwe rozdzielenie stylów i motywów przy użyciu Material Design.

Kto skorzysta z tego projektu

Repozytorium będzie przydatne dla deweloperów Androida, którzy chcą zobaczyć, jak zorganizowana jest prawdziwa aplikacja Kotlin z bogatą historią. Tutaj możesz ocenić, jak zespół inżynieryjny Automattic radzi sobie z długiem technicznym, strukturyzuje moduły i integruje nowe biblioteki Jetpack.

Jeśli budujesz własnego klienta e-commerce lub integrację z WordPress API, ten kod zaoszczędzi Ci dużo czasu podczas fazy projektowania architektury.