7.1.13 - Horizon OS Support for Meta Quest Devices

Flutter In-App Purchase now supports Meta Quest devices with Horizon OS billing, enabling seamless in-app purchases in VR applications using Meta's Platform SDK.

View the release on GitHub →

Feature Highlights

With Horizon OS support, you can now:

• Build VR apps for Meta Quest devices (Quest 2, Quest 3, Quest Pro) with in-app purchases
• Use the same Flutter In-App Purchase API for both Google Play and Meta Horizon stores
• Switch between billing platforms with a simple configuration flag
• Distribute apps on both Google Play Store and Meta Horizon Store from a single codebase

What is Horizon OS?

Horizon OS is Meta's operating system for Quest VR devices. With this update, flutter_inapp_purchase now supports Meta's Platform SDK for billing, allowing developers to monetize their VR applications on the Meta Horizon Store.

How It Works

The implementation uses OpenIAP's openiap-google-horizon wrapper, which provides a unified interface for both Google Play Billing and Meta's Platform SDK. Your existing code remains unchanged - the platform selection happens at build time through product flavors.

Configuration

Enable Horizon Mode

Add to your android/gradle.properties:

# Enable Horizon OS billing
horizonEnabled=true

Configure Horizon App ID

Add your Meta Horizon App ID in android/local.properties:

HORIZON_APP_ID=your_horizon_app_id_here

Update AndroidManifest.xml

Add the metadata in your android/app/src/main/AndroidManifest.xml:

<application>
    <!-- Meta Horizon App ID - injected by Gradle -->
    <meta-data
        android:name="com.meta.horizon.platform.ovr.HORIZON_APP_ID"
        android:value="${HORIZON_APP_ID}" />
</application>

Getting Started

Installation

flutter pub add flutter_inapp_purchase

Or add to your pubspec.yaml:

dependencies:
  flutter_inapp_purchase: ^7.1.13

Build Commands

# Build for Google Play Store
flutter build apk --flavor play

# Build for Meta Horizon Store
flutter build apk --flavor horizon

# Run on Quest device
flutter run --flavor horizon -d Quest

Code Usage

No code changes required! The API remains identical across platforms.

The implementation automatically detects the horizonEnabled flag and uses:

• Google Play Billing when horizonEnabled=false (default)
• Meta Platform SDK when horizonEnabled=true

Under the Hood

Dependency Management

The plugin uses conditional dependencies in android/build.gradle:

dependencies {
    // Play flavor - Google Play Billing
    add("playImplementation", "io.github.hyochan.openiap:openiap-google:version")

    // Horizon flavor - Meta Platform SDK
    add("horizonImplementation", "io.github.hyochan.openiap:openiap-google-horizon:version")
}

Build System

Product flavors are configured in both the plugin and your app:

Plugin (flutter_inapp_purchase/android/build.gradle):

android {
    flavorDimensions "platform"
    productFlavors {
        play { dimension "platform"; isDefault = true }
        horizon { dimension "platform" }
    }
}

Your App (android/app/build.gradle):

android {
    flavorDimensions "platform"
    productFlavors {
        play { /* configuration */ }
        horizon { /* configuration */ }
    }
}

Backward Compatibility

This update is 100% backward compatible:

• Existing apps using Google Play Billing continue to work without changes
• The default behavior remains Google Play Billing (horizonEnabled=false by default)
• Horizon support is opt-in through simple configuration flag
• No API changes or breaking changes
• No product flavors required in your app

Testing on Meta Quest

Prerequisites

1. Meta Quest Developer Account
2. Quest device with Developer Mode enabled
3. Test products configured in Meta Quest Developer Dashboard

Steps

1. Enable Developer Mode on your Quest device
2. Connect via ADB: adb devices
3. Configure test products in Meta Quest Developer Dashboard
4. Enable Horizon mode in android/gradle.properties: horizonEnabled=true
5. Run on Quest: flutter run -d Quest

Example App

Check out the updated example app which demonstrates:

• Simple configuration with horizonEnabled flag
• No product flavors required
• Identical API usage across platforms
• Easy platform switching

# Clone the repository
git clone https://github.com/hyochan/flutter_inapp_purchase.git
cd flutter_inapp_purchase/example

# For Google Play (default)
flutter run

# For Meta Quest
echo "horizonEnabled=true" >> android/gradle.properties
echo "HORIZON_APP_ID=your_app_id" >> android/local.properties
flutter run -d Quest

Platform Support Comparison

Feature	Google Play	Meta Horizon
One-time purchases	✅	✅
Consumables	✅	✅
Subscriptions	✅	✅
Purchase verification	✅	✅
Purchase restoration	✅	✅
Subscription offers	✅	✅
Promo codes	✅	✅
Alternative billing	✅	N/A
Deferred payments	✅	❌

Documentation

Complete documentation for Horizon OS setup:

• Horizon OS Setup Guide - Complete setup instructions
• Quick Start - Getting started guide
• Purchases Guide - Purchase implementation

OpenIAP Ecosystem

This feature is powered by the OpenIAP ecosystem:

• openiap-google-horizon - Horizon billing wrapper
• OpenIAP Specification - Unified IAP specification
• Cross-platform support: Flutter, React Native, Expo

The Horizon implementation follows the same OpenIAP specification used across all platforms, ensuring consistent behavior and developer experience.

What's Next?

We continue to expand platform support and improve developer experience:

• Enhanced testing tools for VR development
• Better error messages for Horizon-specific issues
• Additional documentation and examples
• Performance optimizations

Feedback

Try out Horizon OS support and let us know your feedback! If you encounter any issues or have suggestions:

• GitHub Issues - Report bugs
• OpenIAP Discussions - Spec discussions

Build amazing VR experiences with seamless in-app purchases on Meta Quest!

dependencies:
  flutter_inapp_purchase: ^7.1.13