Add maestro E2E test for purchase through paywall by ajpallares · Pull Request #1698 · RevenueCat/purchases-flutter

ajpallares · 2026-03-25T11:33:11Z

Summary

Adds Maestro YAML test files for the "purchase through paywall" E2E flow
Adds config.yaml for Maestro test execution
Test flow: clear state → launch app → navigate to purchase screen → verify no entitlements → present V2 paywall → select "Yearly" → tap "Continue" → confirm purchase → verify "pro" entitlement
Adds utils/confirm_purchase.yaml utility that handles test store purchase confirmation on both iOS and Android

Depends on #1654

Note

Low Risk
Adds new Maestro E2E test YAMLs and a shared purchase-confirmation flow; no production code paths are changed. Risk is limited to test flakiness due to UI text/timeouts and store confirmation dialogs.

Overview
Adds a Maestro E2E flow that drives the app through purchase via the V2 paywall (select yearly, continue, confirm purchase) and asserts entitlements change from none to pro.

Introduces a shared utils/confirm_purchase.yaml step for handling the test-store purchase confirmation dialog, plus a config.yaml to run all flows under e2e_tests/* with fail-fast execution.

^{Reviewed by Cursor Bugbot for commit 48b6b03. Bugbot is set up for automated code reviews on this repo. Configure here.}

Made-with: Cursor

The default Flutter widget test references MyApp which doesn't exist in this project (the app class is MaestroTestApp). Made-with: Cursor

- Lower Gradle JVM from 8G/4G to 4G/2G (sufficient for a minimal test app) - Simplify README setup: flutter pub get is all that's needed Made-with: Cursor

- Add `mounted` guard before every setState after an async gap - Remove unused Widget Key identifiers (Maestro uses text selectors) - Add flutter_lints to dev_dependencies (analysis_options.yaml referenced it) - Remove leftover flutter create TODO comments from build.gradle.kts - Remove CocoaPods from README prerequisites (flutter build handles it) Made-with: Cursor

Made-with: Cursor

These steps were only used for debugging CI failures and add unnecessary clutter to the CI report. Made-with: Cursor

Both iOS and Android Test Store dialogs use the same text, so the regex patterns are unnecessary. Use exact strings like the native iOS SDK's maestro tests do. Made-with: Cursor

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 2cae89b. Configure here.}

cursor · 2026-04-15T09:06:27Z

+name: Confirm purchase - Test Store Purchase Alert
+
+---
+- assertVisible: "Test Store Purchase"


Missing extended wait before purchase dialog assertion

Medium Severity

confirm_purchase.yaml uses assertVisible: "Test Store Purchase" which has a default 7-second timeout. The main test flow consistently uses extendedWaitUntil with 15000ms timeouts for all async transitions (app launch, entitlements loading, post-purchase entitlement update), but the purchase confirmation dialog — which appears after an async purchase initiation — only gets the default 7-second wait. In CI environments or slower devices, the system purchase dialog may take longer than 7 seconds to appear after tapping "Continue," causing flaky failures.

^{Reviewed by Cursor Bugbot for commit 2cae89b. Configure here.}

tonidero

Nice!

- Remove Podfile and Podfile.lock (project already uses SPM via FlutterGeneratedPluginSwiftPackage; zero CocoaPods refs in pbxproj) - Remove Pods #include? from Debug/Release xcconfig - Add enable-swift-package-manager: true to pubspec.yaml - Extract test case definitions to test_cases.dart for extensibility (single source of truth for title, flowKey, and screen widget) - Refactor TestCasesScreen to build from the shared list Made-with: Cursor

Made-with: Cursor

Avoids eagerly constructing all screen widgets upfront — the widget is only created when the user navigates to it. Made-with: Cursor

## Summary Adds a Maestro E2E test app under `e2e-tests/MaestroTestApp/` — a minimal Flutter app with two screens used by automated Maestro flows to verify the RevenueCat purchase integration. - Two screens: "Test Cases" list and "Purchase through paywall" (presents a RevenueCat V2 paywall and displays entitlement status) - Bundle ID `com.revenuecat.automatedsdktests` - API key placeholder (`MAESTRO_TESTS_REVENUECAT_API_KEY`) replaced at CI time via `sed` - Local SDK resolution via `path:` references + `dependency_overrides` (same mechanism as `revenuecat_examples/purchase_tester`) - iOS plugins resolved via Swift Package Manager (`FlutterGeneratedPluginSwiftPackage`); CocoaPods only carries the Flutter engine - Errors from `getCustomerInfo` and `presentPaywall` are surfaced in the UI for debugging failed Maestro flows Counterpart PRs: [react-native-purchases#1635](RevenueCat/react-native-purchases#1635), [purchases-capacitor#699](RevenueCat/purchases-capacitor#699), [cordova-plugin-purchases#857](RevenueCat/cordova-plugin-purchases#857), [purchases-unity#836](RevenueCat/purchases-unity#836), [purchases-kmp#708](RevenueCat/purchases-kmp#708) ### Follow-up PRs (stacked) - [#1698](#1698) — Maestro test flows (YAML) - [#1699](#1699) — CircleCI jobs to run the tests - [#1714](#1714) — Launch argument routing to skip test list  --- > [!NOTE] > **Low Risk** > Adds a new, isolated test-only Flutter project with standard iOS/Android scaffolding and a simple paywall purchase flow; it does not modify the SDK runtime code paths. > > **Overview** > Introduces a new Flutter app in `e2e-tests/MaestroTestApp` intended for Maestro E2E automation, including a test-case list screen and a purchase flow that calls `RevenueCatUI.presentPaywall()` and displays active `pro` entitlement state. > > Adds full iOS/Android project scaffolding (manifests, Gradle/Xcode configs, app IDs) plus local `path:` dependencies on `purchases_flutter`/`purchases_ui_flutter`, and documents CI-time API key injection via the `MAESTRO_TESTS_REVENUECAT_API_KEY` placeholder. > > Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit cb1f2f4. Bugbot is set up for automated code reviews on this repo. Configure [here](https://www.cursor.com/dashboard/bugbot).

## Summary - Adds two separate CircleCI workflows triggered by the `maestro_e2e_tests` schedule: - `maestro-e2e-tests-ios`: runs on macOS executor, builds the test app for iOS simulator via `flutter build ios --debug --simulator`, runs Maestro tests - `maestro-e2e-tests-android`: runs on `android:2024.11.1` machine image, creates an Android emulator, builds a debug APK via `flutter build apk --debug`, runs Maestro tests - Adds Fastlane lanes with upfront API key validation (`UI.user_error!` if env var is missing): - `run_maestro_e2e_tests_ios`: replaces API key placeholder, builds with Flutter, installs on simulator, runs Maestro - `build_maestro_app_android` / `run_maestro_e2e_tests_android`: replaces API key placeholder, builds APK, installs via adb, runs Maestro - Both lanes use `$RC_E2E_TEST_API_KEY_PRODUCTION_TEST_STORE` from the `e2e-tests` CircleCI context - Test results stored as JUnit artifacts Depends on #1698  --- > [!NOTE] > **Medium Risk** > CI pipeline changes add new scheduled iOS/Android emulator runs and Fastlane scripting that mutates the E2E test app at build time; main risk is increased CI flakiness or misconfigured secrets causing failures rather than product impact. > > **Overview** > Adds Maestro end-to-end testing to CircleCI by introducing new `run-maestro-e2e-tests-ios` and `run-maestro-e2e-tests-android` jobs that build and run a dedicated Flutter test app on an iOS simulator and an Android emulator, then upload JUnit results as artifacts. > > Wires these jobs into the main `test` workflow (using the `e2e-tests` context) and also adds dedicated scheduled workflows (`maestro_e2e_tests`) to run iOS/Android E2E suites independently. > > Extends the `Fastfile` with lanes to build/install the Maestro test app and execute `maestro test`, including validation of `RC_E2E_TEST_API_KEY_PRODUCTION_TEST_STORE` and replacing an API-key placeholder before running the suite. > > Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit b01d19b. Bugbot is set up for automated code reviews on this repo. Configure [here](https://www.cursor.com/dashboard/bugbot).

@brunovsiqueira

**This is an automatic release.** ## RevenueCat SDK ### 🐞 Bugfixes * [EXTERNAL] Fix Wasm incompatibility in web error processing (#1684) contributed by @brunovsiqueira (#1722) via Toni Rico (@tonidero) ### 📦 Dependency Updates * [AUTOMATIC BUMP] Updates purchases-hybrid-common to 18.1.0 (#1726) via RevenueCat Git Bot (@RCGitBot) * [Android 10.2.0](https://github.com/RevenueCat/purchases-android/releases/tag/10.2.0) * [iOS 5.68.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.68.0) ### 🔄 Other Changes * Add retry mechanism to Maestro e2e tests (#1723) via Antonio Pallares (@ajpallares) * Bump fastlane-plugin-revenuecat_internal from `20911d1` to `a1eed48` (#1725) via dependabot[bot] (@dependabot[bot]) * Skip test cases list in maestro tests using launch arguments (#1714) via Antonio Pallares (@ajpallares) * Add CircleCI job for maestro E2E tests (#1699) via Antonio Pallares (@ajpallares) * Add maestro E2E test for purchase through paywall (#1698) via Antonio Pallares (@ajpallares) * Add maestro E2E test app (#1654) via Antonio Pallares (@ajpallares)  --- > [!NOTE] > **Low Risk** > Low risk release bookkeeping: primarily version bumps and changelog/version-matrix updates, with no functional logic changes in the plugin code beyond reporting the new version string. > > **Overview** > Updates the SDKs to **v`10.0.1`** by bumping version identifiers across `pubspec.yaml`, Android Gradle configs, and iOS/macOS podspecs (including the runtime-reported plugin version strings). > > Refreshes release documentation (`CHANGELOG.md`, `CHANGELOG-LATEST.md`, `VERSIONS.md`) to include the `10.0.1` notes (Wasm web error-processing fix) and the dependency bump to `purchases-hybrid-common` `18.1.0` (Android `10.2.0`, iOS `5.68.0`). > > Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit ff0bb5e. Bugbot is set up for automated code reviews on this repo. Configure [here](https://www.cursor.com/dashboard/bugbot).

ajpallares added the pr:other label Mar 25, 2026

ajpallares mentioned this pull request Mar 25, 2026

Add CircleCI job for maestro E2E tests #1699

Merged

ajpallares force-pushed the add-maestro-e2e-test branch 7 times, most recently from b266f9e to 82563b8 Compare March 30, 2026 15:03

ajpallares mentioned this pull request Mar 30, 2026

Add maestro E2E test app #1654

Merged

ajpallares force-pushed the add-maestro-e2e-test branch 4 times, most recently from c01f963 to 691052f Compare March 30, 2026 17:21

Add maestro E2E test app

6e0b11d

Made-with: Cursor

ajpallares force-pushed the e2e-tests-app branch from 109b156 to 6e0b11d Compare April 6, 2026 16:32

ajpallares force-pushed the add-maestro-e2e-test branch from 691052f to 48841a6 Compare April 6, 2026 16:32

Remove stale widget_test.dart template

a30caf7

The default Flutter widget test references MyApp which doesn't exist in this project (the app class is MaestroTestApp). Made-with: Cursor

ajpallares force-pushed the add-maestro-e2e-test branch from 48841a6 to 32f4b13 Compare April 6, 2026 17:10

ajpallares changed the title ~~feat: add maestro E2E test for purchase through paywall~~ Add maestro E2E test for purchase through paywall Apr 7, 2026

Reduce Gradle JVM heap and simplify README setup

cdedffe

- Lower Gradle JVM from 8G/4G to 4G/2G (sufficient for a minimal test app) - Simplify README setup: flutter pub get is all that's needed Made-with: Cursor

ajpallares force-pushed the add-maestro-e2e-test branch from deeccff to f947270 Compare April 7, 2026 12:00

ajpallares added 4 commits April 8, 2026 14:42

Add maestro E2E test for purchase through paywall

50bb072

Made-with: Cursor

Remove takeScreenshot steps from maestro tests

5b5480b

These steps were only used for debugging CI failures and add unnecessary clutter to the CI report. Made-with: Cursor

Simplify confirm_purchase to use exact text matching

596dc19

Both iOS and Android Test Store dialogs use the same text, so the regex patterns are unnecessary. Use exact strings like the native iOS SDK's maestro tests do. Made-with: Cursor

ajpallares force-pushed the add-maestro-e2e-test branch from f947270 to 596dc19 Compare April 8, 2026 12:42

ajpallares added 2 commits April 15, 2026 10:59

Merge branch 'main' into e2e-tests-app

bc36459

Merge branch 'e2e-tests-app' into add-maestro-e2e-test

2cae89b

ajpallares marked this pull request as ready for review April 15, 2026 09:02

ajpallares requested a review from a team as a code owner April 15, 2026 09:02

ajpallares requested a review from a team April 15, 2026 09:02

cursor Bot reviewed Apr 15, 2026

View reviewed changes

tonidero approved these changes Apr 15, 2026

View reviewed changes

ajpallares added 6 commits April 15, 2026 12:24

Merge branch 'e2e-tests-app' into add-maestro-e2e-test

ccb339a

Remove flowKey from test_cases — belongs in PR4

608da08

Made-with: Cursor

Merge branch 'e2e-tests-app' into add-maestro-e2e-test

eb30131

Use builder instead of pre-built widget in test cases

cb1f2f4

Avoids eagerly constructing all screen widgets upfront — the widget is only created when the user navigates to it. Made-with: Cursor

Merge branch 'e2e-tests-app' into add-maestro-e2e-test

48b6b03

Base automatically changed from e2e-tests-app to main April 15, 2026 11:03

ajpallares merged commit 9fd724a into main Apr 15, 2026
15 checks passed

ajpallares deleted the add-maestro-e2e-test branch April 15, 2026 11:03

This was referenced Apr 15, 2026

[AUTOMATIC] Release/10.0.1 #1724

Closed

[AUTOMATIC] Release/10.0.1 #1727

Closed

[AUTOMATIC] Release/10.0.1 #1728

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add maestro E2E test for purchase through paywall#1698

Add maestro E2E test for purchase through paywall#1698
ajpallares merged 15 commits into
mainfrom
add-maestro-e2e-test

ajpallares commented Mar 25, 2026 •

edited by cursor Bot

Loading

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot Apr 15, 2026

Uh oh!

tonidero left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

ajpallares commented Mar 25, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Apr 15, 2026

Choose a reason for hiding this comment

Missing extended wait before purchase dialog assertion

Uh oh!

tonidero left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ajpallares commented Mar 25, 2026 •

edited by cursor Bot

Loading