encore_flutter 2.0.1

Flutter plugin wrapping the native Encore iOS and Android SDKs for monetization, offers, and entitlements. All offer UI is rendered natively via StoreKit (iOS) and Play Billing (Android).

example/lib/main.dart

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart' show PlatformException;
import 'package:encore_flutter/encore_flutter.dart';
import 'package:purchases_flutter/purchases_flutter.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const ExampleApp());
}

class ExampleApp extends StatelessWidget {
  const ExampleApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Encore Flutter Example',
      theme: ThemeData(
        colorSchemeSeed: Colors.deepPurple,
        useMaterial3: true,
      ),
      home: const HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  final List<String> _eventLog = [];
  String? _activeLanguage;
  StreamSubscription<EncorePlacementOutcome>? _outcomes;

  @override
  void initState() {
    super.initState();
    _initEncore();
  }

  @override
  void dispose() {
    _outcomes?.cancel();
    super.dispose();
  }

  void _log(String message) {
    final now = DateTime.now();
    final timestamp = '${now.hour.toString().padLeft(2, '0')}:${now.minute.toString().padLeft(2, '0')}:${now.second.toString().padLeft(2, '0')}';
    setState(() => _eventLog.insert(0, '[$timestamp] $message'));
  }

  Future<void> _initEncore() async {
    await Purchases.configure(
      PurchasesConfiguration('YOUR_REVENUECAT_API_KEY'),
    );

    // The purchase controller is registered here and nowhere else — the
    // native SDKs bind it once, inside configure, and it survives reset().
    await Encore.shared.configure(
      apiKey: 'pk_test_dyzxq1bl6jdt9dly78qdjnad',
      purchaseController: RevenueCatPurchaseController(_log),
      logLevel: EncoreLogLevel.debug,
    );

    // Passive observation of every outcome, including strict-unlock
    // verifications that land after (or on a later launch than) the flow.
    _outcomes = Encore.shared.outcomes.listen((outcome) {
      switch (outcome) {
        case EncorePlacementPresentation(:final placementId, :final result):
          _log('outcome: $placementId → $result');
        case EncoreStrictUnlockVerified(:final transactionId):
          _log('outcome: strict unlock verified ($transactionId)');
      }
    });

    await Encore.shared.identify(
      userId: 'demo_user_flutter_001',
      attributes: const EncoreUserAttributes(
        email: '[e-mail]',
        subscriptionTier: 'premium',
      ),
    );

    _log('identify: demo_user_flutter_001');
  }

  Future<void> _showOffer() async {
    _log('placement: presenting...');
    final result = await Encore.placement('example_placement').show();

    // The record carries facts, not a verdict: branch on the raw axes.
    final message = switch (result) {
      EncoreNotPresented(:final reason) =>
        'placement: nothing shown (${reason.name})',
      EncorePresented(:final outcome) => 'placement: '
          'advertiser=${outcome.advertiser} '
          'publisher=${outcome.publisher.name} '
          'dismissal=${outcome.dismissal.name}',
    };
    _log(message);

    final converted = result.claim != null ||
        result.publisher == EncorePublisherOutcome.purchased;
    _log(converted ? 'placement: converted' : 'placement: not converted');
  }

  Future<void> _resetSdk() async {
    await Encore.shared.reset();
    setState(() => _activeLanguage = null);
    _log('reset: SUCCESS (language cleared, falls back to device locale)');
  }

  /// Override the locale that the SDK reports to the backend on the next
  /// `/config` and `/offers/search` calls. Beats the device's
  /// `Accept-Language` header in the resolver, so this is how to test
  /// localization without changing iOS Settings → Language.
  ///
  /// Pass `null` to clear and revert to device locale.
  Future<void> _setLanguage(String? code) async {
    await Encore.shared.setUserAttributes(
      EncoreUserAttributes(language: code),
    );
    setState(() => _activeLanguage = code);
    _log(code == null
        ? 'setUserAttributes: language cleared (device locale)'
        : 'setUserAttributes: language=$code → next placement should render in this locale');
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Encore Flutter Example')),
      body: Column(
        children: [
          Padding(
            padding: const EdgeInsets.all(16),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.stretch,
              children: [
                Row(
                  children: [
                    Expanded(
                      child: FilledButton(
                        onPressed: _showOffer,
                        child: const Text('Show Offer'),
                      ),
                    ),
                    const SizedBox(width: 12),
                    Expanded(
                      child: OutlinedButton(
                        onPressed: _resetSdk,
                        child: const Text('Reset SDK'),
                      ),
                    ),
                  ],
                ),
                const SizedBox(height: 12),
                _LanguagePicker(
                  active: _activeLanguage,
                  onPick: _setLanguage,
                ),
              ],
            ),
          ),
          const Divider(height: 1),
          Expanded(
            child: _eventLog.isEmpty
                ? const Center(child: Text('No events yet'))
                : ListView.builder(
                    padding: const EdgeInsets.all(12),
                    itemCount: _eventLog.length,
                    itemBuilder: (context, index) => Padding(
                      padding: const EdgeInsets.symmetric(vertical: 2),
                      child: Text(
                        _eventLog[index],
                        style: Theme.of(context).textTheme.bodySmall?.copyWith(
                              fontFamily: 'monospace',
                            ),
                      ),
                    ),
                  ),
          ),
        ],
      ),
    );
  }
}

/// Quick locale-override picker for end-to-end testing of /config + /offers
/// localization. Tap a language → SDK sends `?language=<code>` on the next
/// fetch and the placement renders in that locale (assuming the publisher
/// has approved translations on the backend).
///
/// Codes match the six Knowunity is rolling out plus English source.
class _LanguagePicker extends StatelessWidget {
  const _LanguagePicker({required this.active, required this.onPick});

  final String? active;
  final Future<void> Function(String?) onPick;

  static const _options = <(String code, String label)>[
    ('en', '🇺🇸 EN'),
    ('de', '🇩🇪 DE'),
    ('fr', '🇫🇷 FR'),
    ('es', '🇪🇸 ES'),
    ('it', '🇮🇹 IT'),
    ('pl', '🇵🇱 PL'),
    ('pt', '🇧🇷 PT'),
  ];

  @override
  Widget build(BuildContext context) {
    return Wrap(
      spacing: 6,
      runSpacing: 6,
      crossAxisAlignment: WrapCrossAlignment.center,
      children: [
        const Text('Language:', style: TextStyle(fontWeight: FontWeight.w500)),
        for (final (code, label) in _options)
          ChoiceChip(
            label: Text(label),
            selected: active == code,
            onSelected: (_) => onPick(code),
          ),
        TextButton(
          onPressed: active == null ? null : () => onPick(null),
          child: const Text('Auto'),
        ),
      ],
    );
  }
}

/// Routes Encore's purchase requests through RevenueCat.
///
/// The three-valued return is the point: RevenueCat surfaces a deferred
/// purchase (Ask to Buy, SCA) as `paymentPendingError`, which is neither a
/// completed purchase nor an abandonment. Reporting it as either one would
/// misstate the funnel, so it maps to its own value.
class RevenueCatPurchaseController implements EncorePurchaseController {
  RevenueCatPurchaseController(this._log);

  final void Function(String) _log;

  @override
  Future<EncorePurchaseResult> purchase(EncorePurchaseRequest request) async {
    _log('purchase: productId=${request.productId}, '
        'placementId=${request.placementId}');

    final products = await Purchases.getProducts([request.productId]);
    if (products.isEmpty) {
      // A real failure, not a cancellation \u2014 throw so Encore records it.
      throw StateError('No RevenueCat product for ${request.productId}');
    }

    try {
      await Purchases.purchaseStoreProduct(products.first);
      _log('purchase: purchased');
      return EncorePurchaseResult.purchased;
    } on PlatformException catch (e) {
      switch (PurchasesErrorHelper.getErrorCode(e)) {
        case PurchasesErrorCode.purchaseCancelledError:
          _log('purchase: cancelled');
          return EncorePurchaseResult.cancelled;
        case PurchasesErrorCode.paymentPendingError:
          _log('purchase: pending');
          return EncorePurchaseResult.pending;
        default:
          _log('purchase: failed (${e.message})');
          rethrow;
      }
    }
  }
}