How giglancer/samplebilling works
Project type and purpose
• Type: Mobile full-stack (client-only) Android application
• Purpose: Demonstrate in-app billing integration with Google Play Billing Library using clean architecture (UI → ViewModel → Use-Cases → Repositories → Data-Sources → Play Billing Service).
File structure
• app/src/main/java/com/samplebillingapp/… breaks down into:
• ui/… (BillingViewModel, UI state, Activity)
• domain/… (models, repository interface, use-cases)
• data/… (billing/datasource wrappers and repository implementation)
• di/… (BillingModule for dependency injection)
• Configuration: build.gradle.kts, proguard, signing keys, release artifacts.
• Tests under androidTest and test.
README (minimal)
1. Android App Layer
• MainActivity
• BillingViewModel
2. Domain Layer
• Use-Cases (InitializeBilling, GetProductsUseCase, PurchaseProductUseCase, etc.)
• Models (ProductList, PurchaseUpdate, BillingConnectionState)
• Repository Interface (BillingRepository)
3. Data Layer
• Repository Impl (BillingRepositoryImpl)
• Data Sources
– BillingClientWrapper (wraps GoogleBillingClient)
– ProductDataSource
– PurchaseDataSource
4. External Service
• Google Play Billing Service
5. DI Layer
• BillingModule (provides singletons for client, datasources, repo, use-cases)
1. MainActivity → observes → BillingViewModel
2. BillingViewModel → invokes → Domain Use-Cases
3. Use-Cases → call → BillingRepository interface
4. BillingRepositoryImpl → delegates → Data Sources
5. ProductDataSource & PurchaseDataSource → invoke → BillingClientWrapper
6. BillingClientWrapper → communicates → Google Play Billing Service
7. Updates from service → propagate back ↑ through wrapper → data source → repo → use-case → ViewModel → UI
c. Architectural patterns & principles:
• Clean architecture separation: UI, Domain, Data
• Dependency inversion: UI & Domain depend on abstractions (BillingRepository)
• Single Responsibility: each use-case handles one business action
• DI (via BillingModule) for easy swapping/testing
d. Key technologies/frameworks:
• Android Jetpack (ViewModel)
• Kotlin coroutines/Flow (in domain/use-case layers)
• Google Play Billing Library (inside BillingClientWrapper)
• Koin/Hilt-like DI module (BillingModule.kt)
• Gradle Kotlin DSL (build.gradle.kts)