feat(android): horizon support (#583)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Horizon OS support for Meta Quest with Play/Horizon build flavors and
runtime selection.

* **Documentation**
* Added Horizon OS guides, updated Android setup, changelog entry, and
example README with build/run steps.

* **Chores**
* Gradle flavor and dependency updates, example manifest/placeholders
for Horizon App ID, IDE launch configs, version bumps, removed obsolete
podspec.

* **Tests**
  * Updated tests to supply mandatory iOS introductory price mode.

* **Bug Fixes**
  * Default to Android path when no billing platform detected.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: hyochan

.gitignore

@@ -10,6 +10,7 @@ build/
 .claude/
 
 .idea/
+!.idea/runConfigurations/
 flutter_inapp.iml
 flutter_inapp_android.iml
 flutter_export_environment*

.vscode/launch.json

@@ -1,13 +1,10 @@
 {
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
   "version": "0.2.0",
   "configurations": [
     {
+      "name": "start documentation",
       "type": "node",
       "request": "launch",
-      "name": "Start Docusaurus",
       "cwd": "${workspaceFolder}/docs",
       "runtimeExecutable": "npm",
       "runtimeArgs": ["run", "start"],
@@ -18,92 +15,46 @@
       }
     },
     {
-      "type": "node",
-      "request": "launch",
-      "name": "Build Docusaurus",
-      "cwd": "${workspaceFolder}/docs",
-      "runtimeExecutable": "npm",
-      "runtimeArgs": ["run", "build"],
-      "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen"
-    },
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Serve Docusaurus Build",
-      "cwd": "${workspaceFolder}/docs",
-      "runtimeExecutable": "npm",
-      "runtimeArgs": ["run", "serve"],
-      "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen"
-    },
-    {
-      "name": "Open Xcode",
-      "type": "node",
-      "request": "launch",
-      "runtimeExecutable": "/usr/bin/open",
-      "runtimeArgs": ["-a", "Xcode"],
-      "console": "internalConsole",
-      "internalConsoleOptions": "openOnSessionStart"
-    },
-    {
-      "name": "Open Android Studio",
+      "name": "open android studio",
       "type": "node",
       "request": "launch",
       "runtimeExecutable": "/usr/bin/open",
-      "runtimeArgs": ["-a", "Android Studio"],
+      "runtimeArgs": ["-a", "Android Studio", "${workspaceFolder}/example/android"],
       "console": "internalConsole",
       "internalConsoleOptions": "openOnSessionStart"
     },
     {
-      "name": "Flutter: Attach to Device",
-      "type": "dart",
-      "request": "attach"
-    },
-    {
-      "name": "Flutter: Run Example App",
-      "type": "dart",
-      "request": "launch",
-      "program": "lib/main.dart",
-      "cwd": "${workspaceFolder}/example",
-      "args": []
-    },
-    {
-      "name": "Flutter: Run Example App (Profile Mode)",
+      "name": "run ios",
       "type": "dart",
       "request": "launch",
       "program": "lib/main.dart",
       "cwd": "${workspaceFolder}/example",
-      "flutterMode": "profile",
-      "args": []
+      "args": ["-d", "ios"]
     },
     {
-      "name": "Flutter: Run Example App (Release Mode)",
+      "name": "run ios (device)",
       "type": "dart",
       "request": "launch",
       "program": "lib/main.dart",
       "cwd": "${workspaceFolder}/example",
       "flutterMode": "release",
-      "args": []
+      "args": ["-d", "ios"]
     },
     {
-      "name": "Example (Flutter Pixel 2)",
+      "name": "run android",
       "type": "dart",
       "request": "launch",
       "program": "lib/main.dart",
       "cwd": "${workspaceFolder}/example",
-      "deviceId": "HT79F1A00473",
-      "args": []
+      "args": ["--flavor", "play"]
     },
     {
-      "name": "Example (iOS iPhone)",
+      "name": "run horizon",
       "type": "dart",
       "request": "launch",
       "program": "lib/main.dart",
       "cwd": "${workspaceFolder}/example",
-      "deviceId": "00008101-0006455036D8001E",
-      "args": []
+      "args": ["--flavor", "horizon"]
     }
-  ],
-  "compounds": []
+  ]
 }

CHANGELOG.md

@@ -1,5 +1,21 @@
 # CHANGELOG
 
+## 7.1.13
+
+- **feat**: Add Horizon OS support for Meta Quest devices
+  - Added product flavor support for Meta Horizon billing (play/horizon flavors)
+  - Integrated `openiap-google-horizon` dependency for Meta Quest Platform SDK
+  - Added Horizon App ID configuration via gradle.properties and AndroidManifest.xml
+  - Example app now supports both Google Play and Meta Horizon builds
+  - Added comprehensive documentation for Horizon OS setup
+  - [Blog post: Horizon OS Support](https://hyochan.github.io/flutter_inapp_purchase/blog/horizon-os-support)
+  - [Setup guide: Horizon OS](https://hyochan.github.io/flutter_inapp_purchase/docs/getting-started/setup-horizon)
+- **BREAKING**: `introductoryPricePaymentModeIOS` is now required (non-nullable) in `ProductSubscriptionIOS`
+  - Changed from `PaymentModeIOS?` to `PaymentModeIOS` (required field)
+  - Default value is `PaymentModeIOS.Empty` when not provided
+  - Update: Modified `_parsePaymentMode` helper to return `PaymentModeIOS.Empty` instead of `null`
+  - **Migration**: Add `introductoryPricePaymentModeIOS: PaymentModeIOS.Empty` when creating `ProductSubscriptionIOS` instances manually
+
 ## 7.1.12
 
 - Update openiap-versions.

android/build.gradle

@@ -56,9 +56,16 @@ android {
     }
     compileSdkVersion 34
 
+    // Read horizonEnabled from gradle.properties, default to false (play)
+    def horizonEnabled = project.findProperty('horizonEnabled')?.toBoolean() ?: false
+
     defaultConfig {
         minSdkVersion 21
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+
+        // Use horizonEnabled to determine platform flavor
+        def flavor = horizonEnabled ? 'horizon' : 'play'
+        missingDimensionStrategy "platform", flavor
     }
     sourceSets {
         main.java.srcDirs += 'src/main/kotlin'
@@ -74,16 +81,41 @@ android {
     kotlinOptions {
         jvmTarget = '17'
     }
+
+    flavorDimensions "platform"
+    productFlavors {
+        // Play flavor - Google Play Billing (default)
+        play {
+            dimension "platform"
+            isDefault = true
+        }
+        // Horizon flavor - Meta Horizon Billing
+        horizon {
+            dimension "platform"
+        }
+    }
 }
 
 dependencies {
-    // OpenIAP Google billing wrapper includes Google Play Billing
-    implementation "io.github.hyochan.openiap:openiap-google:${openiapGoogleVersion}"
+    // Determine which OpenIAP dependency to use based on horizonEnabled flag
+    def horizonEnabled = project.findProperty('horizonEnabled')?.toBoolean() ?: false
+    if (horizonEnabled) {
+        // Use openiap-google-horizon for Meta Quest when horizonEnabled is true
+        implementation "io.github.hyochan.openiap:openiap-google-horizon:${openiapGoogleVersion}"
+    } else {
+        // Use standard Google Play Billing
+        implementation "io.github.hyochan.openiap:openiap-google:${openiapGoogleVersion}"
+    }
 
     // For local debugging with a checked-out module, you can switch to:
-    //   debugImplementation project(":openiap")
-    // and include the module in android/settings.gradle (see CONTRIBUTING.md)
+    //   implementation project(":openiap")
+    // and uncomment the include in android/settings.gradle
 
+    // Amazon IAP only for play flavor (legacy support)
     implementation files('jars/in-app-purchasing-2.0.76.jar')
     implementation 'androidx.annotation:annotation:1.6.0'
+
+    // Google Play Billing for direct API usage (only in play flavor)
+    // Note: This is already included in openiap, but kept for backward compatibility
+    add("playCompileOnly", "com.android.billingclient:billing-ktx:8.0.0")
 }

android/settings.gradle

@@ -4,8 +4,8 @@ rootProject.name = 'flutter_inapp_purchase'
 // 1) git clone https://github.com/hyodotdev/openiap-google
 // 2) Update path below to your local checkout
 // 3) In android/build.gradle, switch dependency to:
-//      debugImplementation project(":openiap")
-//    (and keep release on the Maven artifact)
+//      implementation project(":openiap")
+//    (and comment out the Maven Central dependency)
 //
 // include ':openiap'
-// project(':openiap').projectDir = new File('/Users/you/path/to/openiap-google/openiap')
+// project(':openiap').projectDir = new File('/path/to/openiap/packages/google/openiap')

android/src/main/kotlin/io/github/hyochan/flutter_inapp_purchase/AndroidInappPurchasePlugin.kt

@@ -671,7 +671,7 @@ class AndroidInappPurchasePlugin internal constructor() : MethodCallHandler, Act
                             safe.error(OpenIapError.NotPrepared.CODE, OpenIapError.NotPrepared.MESSAGE, "IAP module not initialized.")
                             return@launch
                         }
-                        val purchases = iap.getAvailableItems(reqType)
+                        val purchases = iap.getAvailablePurchases(null)
                         val arr = purchasesToJsonArray(purchases)
                         safe.success(arr.toString())
                     } catch (e: Exception) {
@@ -710,7 +710,11 @@ class AndroidInappPurchasePlugin internal constructor() : MethodCallHandler, Act
                             safe.error(OpenIapError.NotPrepared.CODE, OpenIapError.NotPrepared.MESSAGE, "IAP module not initialized.")
                             return@launch
                         }
-                        val purchases = iap.getAvailableItems(reqType)
+                        // Note: As of v6.4.6+, getAvailablePurchases returns only active purchases on Android.
+                        // Purchase history (including expired/consumed items) is not supported on Android
+                        // by the OpenIAP library. The reqType parameter is preserved for backward compatibility
+                        // but is not used. Apps should migrate to getAvailableItems() for active purchases.
+                        val purchases = iap.getAvailablePurchases(null)
                         val arr = purchasesToJsonArray(purchases)
                         safe.success(arr.toString())
                     } catch (e: Exception) {

android/src/main/kotlin/io/github/hyochan/flutter_inapp_purchase/BillingError.kt

@@ -31,14 +31,24 @@ class FlutterInappPurchasePlugin : FlutterPlugin, ActivityAware {
                 isAmazon = false
             }
         }
+
+        // If neither Play Store nor Amazon is detected, default to Android (for Horizon and other stores)
+        // This allows openiap to handle different billing implementations via flavors
+        if (!isAndroid && !isAmazon) {
+            android.util.Log.i("FlutterInappPurchase", "No Play Store or Amazon detected - defaulting to Android plugin (supports Horizon and other stores)")
+            isAndroid = true
+        }
+
         channel = MethodChannel(messenger, "flutter_inapp")
         if (isAndroid) {
+            android.util.Log.i("FlutterInappPurchase", "Initializing Android IAP plugin")
             val plugin = AndroidInappPurchasePlugin()
             plugin.setContext(context)
             plugin.setChannel(channel)
             androidInappPurchasePlugin = plugin
             channel!!.setMethodCallHandler(plugin)
         } else if (isAmazon) {
+            android.util.Log.i("FlutterInappPurchase", "Initializing Amazon IAP plugin")
             amazonInappPurchasePlugin = AmazonInappPurchasePlugin()
             amazonInappPurchasePlugin!!.setContext(context)
             amazonInappPurchasePlugin!!.setChannel(channel)