BillingX is a library that makes in-app billing testing easier. It allows adding test products and purchases to a local data store without requiring a connection to the Google Play API. During development, the app uses this local data store instead of the real API. This allows testing purchases and managing inventory without publishing apps or using test accounts. The library provides a seamless experience for both testing and production by swapping the data source based on build type.

1. Testing In App Billing
The easy way
@rharter
Ryan Harter

2. In App Billing

3. AIDL
• Copy Google’s IInAppBillingService.aidl
• Connect to Play Store via Service Connection
• Manually manage connection
• Communicate directly with IAB service

4. IInAppBillingService
Play Billing LibraryServiceConnection
Google Play
Library Code
Your Code
AIDL
MyApp

5. IInAppBillingService
Play Billing LibraryServiceConnection
Google Play
Library Code
Your Code
AIDL
MyApp
Third Party Libs

6. Play Billing Library
• Support library
• Wraps AIDL service binding
• Based on abstract BillingClient class
• Now official solution

7. IInAppBillingService
Play Billing LibraryServiceConnection
Google Play
Library Code
Your Code
AIDL
MyApp

8. Google Play
Library Code
Your Code
Play Billing Library
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection

9. Testing

10. Testing
Static SKUs
Test Accounts

11. Testing
Static SKUs
Test Accounts

12. Static SKUs
android.test.purchased
android.test.canceled
android.test.item_unavailable

13. Google Play
Library Code
Your Code
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection
Purchase com.sku.foo
Static SKUs

14. Google Play
Library Code
Your Code
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection
com.sku.foo
Static SKUs

15. Google Play
Library Code
Your Code
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection
com.sku.foo
android.test.purchased
Static SKUs

16. Google Play
Library Code
Your Code
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection
co
android.test.purchased
Static SKUs

17. Google Play
Library Code
Your Code
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection
co
android.test.purchased
Static SKUs

18. Google Play
Library Code
Your Code
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection
co
android.test.purchased
Success
Static SKUs

19. Google Play
Library Code
Your Code
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection
co
android.test.purchased
Success
Static SKUs

20. Google Play
Library Code
Your Code
IInAppBillingServicePlay Billing Library
MyApp
ServiceConnection
co
android.test.purchased
Success
Static SKUs

21. Google Play
Library Code
Your Code
Static SKUs
IInAppBillingServicePlay Billing LibraryServiceConnection
co
android.test.purchased
MyApp

22. Static SKUs - Problems
• No Inventory
• No Subscriptions
• No Consumption
• Not actual code (switcheroo)

23. Testing
Static SKUs
Test Accounts

24. Testing
Static SKUs
Test Accounts

25. Test Accounts
Test the actual purchase flow using real accounts.

26. Test Accounts
1. Add test user accounts in Google Play Console

27. Test Accounts
1. Add test user accounts in Google Play Console
2. Deploy your app on Google Play

28. Test Accounts
1. Add test user accounts in Google Play Console
2. Deploy your app on Google Play
3. Create products in the Google Play Console

29. Test Accounts
1. Add test user accounts in Google Play Console
2. Deploy your app on Google Play
3. Create products in the Google Play Console
4. Install Release build on a device

30. Test Accounts
1. Add test user accounts in Google Play Console
2. Deploy your app on Google Play
3. Create products in the Google Play Console
4. Install Release build on a device
5. Make a purchase with a test account

31. Test Accounts - Problems
• Must know test user accounts in advance
• Purchasable items must be published
• Must run on a device
• Must be signed with release keys
• Can’t manually manage subscription state

32. Test Accounts - Problems
• Must know test user accounts in advance
• Purchasable items must be published
• Must run on a device
• Must be signed with release keys
• Can’t manually manage subscription state
• Subscription testing is slow

33. Testing
Static SKUs
Test Accounts

34. Testing
Static SKUs Test Accounts
Early Development Release

35. Testing
Static SKUs Test Accounts
Early Development Release
???

36. ???

37. Goals
• Easy integration with minimal code changes
• No debug code in production
• Allow easy inventory/transaction management
• Seamless user experience
Easily test in app purchases and subscriptions

38. BillingX
Easily test in app purchases and subscriptions

39. BillingStoreBillingX
Google Play
Library Code
Your Code
Play Billing Library
IInAppBillingServicePlay Billing Library
MyApp

40. BillingStoreBillingX
Google Play
Library Code
Your Code
Play Billing Library
IInAppBillingServicePlay Billing Library
MyApp
Release

41. BillingStore
Google Play
Library Code
Your Code
Play Billing Library
IInAppBillingServicePlay Billing Library
MyApp
BillingX
Debug Release

42. BillingX
Play Billing Library
BillingClient

43. BillingX
Play Billing Library
BillingClient
BillingClientImpl

44. BillingX
Play Billing Library
BillingClient
BillingClientImpl
BillingX
DebugBillingClient

45. Play Billing Library
BillingClient
BillingX
BillingClientImpl
BillingX
DebugBillingClient
My App
MyActivity

46. BillingX
class MyActivity : AppCompatActivity() {
private lateinit var billingClient: BillingClient
private val myPurchaseUpdatedListener: PurchasesUpdatedListener // = ...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
billingClient = BillingClient
.newBuilder(this)
.setListener(myPurchaseUpdatedListener)
.build()
billingClient.startConnection(object : BillingClientStateListener {
// ...
})
}
}

47. BillingX
class MyActivity : AppCompatActivity() {
private lateinit var billingClient: BillingClient
private val myPurchaseUpdatedListener: PurchasesUpdatedListener // = ...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
billingClient = BillingClient
.newBuilder(this)
.setListener(myPurchaseUpdatedListener)
.build()
billingClient.startConnection(object : BillingClientStateListener {
// ...
})
}
}

48. class MyActivity : AppCompatActivity() {
private lateinit var billingClient: BillingClient
private val myPurchaseUpdatedListener: PurchasesUpdatedListener // = ...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
billingClient = BillingClientFactory
.createBillingClient(this, myPurchaseUpdatedListener)
billingClient.startConnection(object : BillingClientStateListener {
// ...
})
}
}
BillingX

49. class MyActivity : AppCompatActivity() {
private lateinit var billingClient: BillingClient
private val myPurchaseUpdatedListener: PurchasesUpdatedListener // = ...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
billingClient = BillingClientFactory
.createBillingClient(this, myPurchaseUpdatedListener)
billingClient.startConnection(object : BillingClientStateListener {
// ...
})
}
}
BillingX

50. BillingX
src/release/java/BillingClientFactory.kt
object BillingClientFactory {
fun createBillingClient(activity: Activity,
updateListener: PurchasesUpdatedListener): BillingClient {
return BillingClient
.newBuilder(activity)
.setListener(updateListener)
.build()
}
}

51. src/debug/java/BillingClientFactory.kt
object BillingClientFactory {
fun createBillingClient(activity: Activity,
updateListener: PurchasesUpdatedListener): BillingClient {
return DebugBillingClient(activity, updateListener)
}
}
BillingX

52. build.gradle
BillingX
dependencies {
implementation 'com.android.billingclient:billing:1.0'
debugImplementation 'com.pixiteapps.billingx:billingx:0.8.0'
}

53. build.gradle
BillingX
dependencies {
releaseImplementation 'com.android.billingclient:billing:1.0'
debugImplementation 'com.pixiteapps.billingx:billingx:0.8.0'
}

54. Goals
• Easy integration with minimal code changes
• No debug code in production
• Allow easy inventory/transaction management
• Seamless user experience
Easily test in app purchases and subscriptions

55. Goals
✓Easy integration with minimal code changes
• No debug code in production
• Allow easy inventory/transaction management
• Seamless user experience
Easily test in app purchases and subscriptions

56. Goals
✓Easy integration with minimal code changes
✓No debug code in production
• Allow easy inventory/transaction management
• Seamless user experience
Easily test in app purchases and subscriptions

57. BillingStore
Google Play
Library Code
Your Code
BillingStore
IInAppBillingServicePlay Billing Library
MyApp
BillingX
Debug Release

58. BillingStore Google Play
Library Code
Your Code
BillingStore
IInAppBillingServicePlay Billing Library
MyApp
BillingX
Debug Release

59. BillingStore
interface BillingStore {
fun getSkuDetails(params: SkuDetailsParams): List<SkuDetails>
fun getPurchases(skuType: String): Purchase.PurchasesResult
fun addProduct(skuDetails: SkuDetails): BillingStore
fun removeProduct(sku: String): BillingStore
fun clearProducts(): BillingStore
fun addPurchase(purchase: Purchase): BillingStore
fun removePurchase(sku: String): BillingStore
fun clearPurchases(): BillingStore
}

60. BillingStore
interface BillingStore {
fun getSkuDetails(params: SkuDetailsParams): List<SkuDetails>
fun getPurchases(skuType: String): Purchase.PurchasesResult
fun addProduct(skuDetails: SkuDetails): BillingStore
fun removeProduct(sku: String): BillingStore
fun clearProducts(): BillingStore
fun addPurchase(purchase: Purchase): BillingStore
fun removePurchase(sku: String): BillingStore
fun clearPurchases(): BillingStore
}

61. BillingStore
interface BillingStore {
fun getSkuDetails(params: SkuDetailsParams): List<SkuDetails>
fun getPurchases(skuType: String): Purchase.PurchasesResult
fun addProduct(skuDetails: SkuDetails): BillingStore
fun removeProduct(sku: String): BillingStore
fun clearProducts(): BillingStore
fun addPurchase(purchase: Purchase): BillingStore
fun removePurchase(sku: String): BillingStore
fun clearPurchases(): BillingStore
}

62. BillingStore
interface BillingStore {
fun getSkuDetails(params: SkuDetailsParams): List<SkuDetails>
fun getPurchases(skuType: String): Purchase.PurchasesResult
fun addProduct(skuDetails: SkuDetails): BillingStore
fun removeProduct(sku: String): BillingStore
fun clearProducts(): BillingStore
fun addPurchase(purchase: Purchase): BillingStore
fun removePurchase(sku: String): BillingStore
fun clearPurchases(): BillingStore
}

63. BillingStore
class BillingClientFactory {
fun createBillingClient(activity: Activity,
updateListener: PurchasesUpdatedListener): BillingClient {
return DebugBillingClient(activity, updateListener)
}
}

64. BillingStore
class BillingClientFactory {
fun createBillingClient(activity: Activity,
updateListener: PurchasesUpdatedListener): BillingClient {
initializeData(activity)
return DebugBillingClient(activity, updateListener)
}
}

65. BillingStore
class BillingClientFactory {
fun createBillingClient(activity: Activity,
updateListener: PurchasesUpdatedListener): BillingClient {
initializeData(activity)
return DebugBillingClient(activity, updateListener)
}
private fun initializeData(context: Context) {
}
}

66. BillingStore
class BillingClientFactory {
fun createBillingClient(activity: Activity,
updateListener: PurchasesUpdatedListener): BillingClient {
initializeData(activity)
return DebugBillingClient(activity, updateListener)
}
private fun initializeData(context: Context) {
runOnce(context, "init_inventory") {
}
}
}

67. BillingStore
class BillingClientFactory {
fun createBillingClient(activity: Activity,
updateListener: PurchasesUpdatedListener): BillingClient {
initializeData(activity)
return DebugBillingClient(activity, updateListener)
}
private fun initializeData(context: Context) {
runOnce(context, "init_inventory") {
val store = BillingStore.defaultStore(context)
val inventory: List<SkuDetails> = loadInventory(context)
inventory.forEach { store.addProduct(it) }
}
}
}

68. BillingStore
class BillingClientFactory {
fun createBillingClient(activity: Activity,
updateListener: PurchasesUpdatedListener): BillingClient {
initializeData(activity)
return DebugBillingClient(activity, updateListener)
}
private fun initializeData(context: Context) {
runOnce(context, "init_inventory") {
val store = BillingStore.defaultStore(context)
val inventory: List<SkuDetails> = loadInventory(context)
inventory.forEach { store.addProduct(it) }
}
}
}

69. Google Play
Library Code
Your Code
BillingStore
IInAppBillingServicePlay Billing Library
MyApp
Debug Release
BillingStoreBillingStoreBillingStore
BillingX

70. BillingStoreBillingStoreBillingStore Google Play
Library Code
Your Code
BillingStore
IInAppBillingServicePlay Billing Library
MyApp
Debug Release
BillingX

71. BillingStore
BillingStoreBillingStoreBillingStore
BillingX

72. BillingStore
BillingStore BillingStore BillingStore
BillingX

73. BillingStoreSharedPrefsBillingStore BillingStore BillingStore
BillingStore
BillingX

74. BillingStoreSharedPrefsBillingStore BillingStoreRetrofitBillingStore BillingStore
BillingStore
BillingX

75. BillingStoreSharedPrefsBillingStore BillingStoreRetrofitBillingStore BillingStoreAmazonBillingStore
BillingStore
BillingX

76. AmazonBillingStoreRetrofitBillingStoreSharedPrefsBillingStoreBillingStoreBillingStoreBillingStore Google Play
Library Code
Your Code
BillingStore
IInAppBillingServicePlay Billing Library
MyApp
Debug Release
BillingX

77. Goals
✓Easy integration with minimal code changes
✓No debug code in production
• Allow easy inventory/transaction management
• Seamless user experience
Easily test in app purchases and subscriptions

78. Goals
✓Easy integration with minimal code changes
✓No debug code in production
✓Allow easy inventory/transaction management
• Seamless user experience
Easily test in app purchases and subscriptions

79. User Experience

80. User Experience

81. User Experience

82. Goals
✓Easy integration with minimal code changes
✓No debug code in production
✓Allow easy inventory/transaction management
• Seamless user experience
Easily test in app purchases and subscriptions

83. Goals
✓Easy integration with minimal code changes
✓No debug code in production
✓Allow easy inventory/transaction management
✓Seamless user experience
Easily test in app purchases and subscriptions

84. Testing In App Billing
The easy way
@rharter
Ryan Harter
https://github.com/pixiteapps/billingx