Добавьте в приложение Flutter покупки в приложении

1. Введение

Чтобы добавить покупки в приложение Flutter, необходимо настроить Apple App Store и Google Play, проверить токены покупок в надежном бэкенде и предоставить права, например на расходуемую валюту, однократные обновления или преимущества регулярной подписки.

В этой практической работе вы вместе с Google Antigravity создадите Dash Clicker – мобильный кликер, в котором валютой служит талисман Дэш. Вы также подключите к игре бэкенд-сервис Dart shelf и Cloud Firestore, чтобы проверять и отслеживать три типа покупок в приложении:

  1. Расходуемый контент (dash_consumable_2k). Покупка,которую можно совершать многократно. Каждый раз игрок сразу получает 2000 единиц валюты.
  2. Нерасходуемый контент (dash_upgrade_3d). Постоянное однократное улучшение, которое навсегда превращает классического талисмана Дэша в современного 3D-Дэша.
  3. Подписка (dash_subscription_doubler). Автоматически продлеваемая подписка, которая увеличивает количество пассивно генерируемых кликов, пока она активна.

Главный экран Dash Clicker с классическим талисманом Dash и счетчиком нажатий

Экран покупок в Dash Clicker со списком доступного контента и прошлых покупок

Главный экран Dash Clicker после покупки улучшения 3D Dash

Что вы создадите

  • Мобильное приложение Flutter (app/) со стилями material_ui и cupertino_ui, которое запрашивает товары в магазине, инициирует покупки и реагирует на потоки покупок в реальном времени.
  • Бэкенд-сервер Dart shelf (dart-backend/), который проверяет квитанции о покупках в Google Play и App Store, опрашивает события платежей в магазинах и записывает состояния покупок в Cloud Firestore.

Ваш путь в обучении

В этой практической работе вы узнаете, как создать и подключить полнофункциональный процесс покупки в приложении.

  1. Настройте среду разработки. Установите Flutter и Google Antigravity, попросите Antigravity создать шаблон начального проекта Dash Clicker (app/) и настройте идентификатор пакета iOS и applicationId Android.
  2. Установите плагин. Попросите Antigravity добавить in_app_purchase и in_app_purchase_platform_interface в app/.
  3. Настройте магазин приложений. Зарегистрируйте идентификатор приложения, создайте тестовый аккаунт в изолированной среде и настройте три продукта в App Store Connect.
  4. Настройка Google Play. Создайте приложение в Google Play Console, попросите Antigravity настроить подписание хранилища ключей выпуска в Gradle, загрузите начальный набор App Bundle, добавьте тестировщиков лицензий и настройте продукты.
  5. Настройте Firebase. Включите вход с аккаунтом Google и Cloud Firestore в консоли Firebase, запустите flutterfire configure и настройте цифровые отпечатки SHA-1 для Android и схемы URL для iOS.
  6. Отслеживание обновлений покупок. Попросите Antigravity добавить тестируемую оболочку IAPConnection, подписаться на purchaseStream и протестировать приложение с помощью TestIAPConnection.
  7. Совершать покупки. Antigravity может упаковывать ProductDetails в PurchasableProduct, запрашивать информацию о товарах в магазине, активировать buyConsumable и buyNonConsumable, а также завершать незавершенные покупки.
  8. Настройка бэкенда. Попросите Antigravity создать сервер dart-backend/ с помощью IapRepository и настроить учетные данные сервисного аккаунта.
  9. Проверка покупок. Попросите Antigravity требовать вход в Firebase на PurchasePage, отправлять токены покупок на /verifypurchase и реализовать GooglePlayPurchaseHandler и AppStorePurchaseHandler.
  10. Отслеживание покупок. Antigravity запрашивает данные у Google Cloud Pub/Sub и App Store Server API на сервере и синхронизирует права с клиентом Flutter, используя IAPRepo.

Что вы узнаете

  • Как работать совместно с Google Antigravity, чтобы выполнять итерации при создании и настройке полнофункционального приложения Flutter с покупками в приложении и бэкенда Dart.
  • Как настроить App Store Connect и Google Play Console для работы с расходуемыми и нерасходуемыми товарами, а также подписками.
  • Как запрашивать информацию о товарах, инициировать покупки и обрабатывать потоки покупок с помощью плагина in_app_purchase.
  • Как проверять токены покупок в Google Play и App Store на бэкенде Dart и сохранять их в Cloud Firestore.
  • Как обрабатывать события, связанные с оплатой в магазине, и синхронизировать подписки и права на обновление на разных устройствах.

Требования

  • Базовые знания о виджетах Flutter, синтаксисе Dart и управлении состоянием Provider.
  • Аккаунт разработчика Apple (для тестирования покупок в магазине приложений на iOS), аккаунт разработчика Google Play (для тестирования покупок в Google Play на Android) или оба аккаунта.
  • Аккаунт Firebase и интерфейс командной строки Firebase.

2. Как настроить среду разработки

Редактор

В этой практической работе в качестве среды разработки на основе ИИ используется Google Antigravity. На каждом этапе вы просите Antigravity сгенерировать или улучшить клиент Flutter (app/) и серверную часть Dart (dart-backend/), проверяете сгенерированный код и при необходимости изучаете варианты.

Установите Flutter

Самые актуальные инструкции по установке Flutter SDK всегда можно найти на сайте docs.flutter.dev.

Для этой практической работы установите следующее ПО:

  1. Flutter SDK
  2. Google Antigravity с включенным официальным плагином Dart и Flutter (доступен в Plugin Marketplace в разделе Build with Google).
  3. Программное обеспечение компилятора для выбранной мобильной платформы (Android Studio для Android или Xcode для iOS).

Попросите Antigravity создать базовый проект

  1. Запустите Google Antigravity и откройте пустой каталог рабочей области, в котором вы хотите создать приложение Flutter (app/) и сервер Dart (dart-backend/). Выберите путь, который не требует повышенных привилегий и не содержит пробелов, например папку в домашнем каталоге или C:\src\.
  2. На панели чата агента Antigravity отправьте следующий запрос, чтобы создать шаблон приложения Dash Clicker в app/:
Create a new empty Flutter project in `app/` named `dashclicker` targeting Android and iOS (`flutter create app --project-name dashclicker --empty --platforms android,ios`). Add the `cloud_firestore`, `cupertino_icons`, `firebase_auth`, `firebase_core`, `google_sign_in`, `http`, `intl`, `provider`, `logging`, `material_ui`, and `cupertino_ui` packages. Download `dash_old.png` and `dash.png` from `https://raw.githubusercontent.com/flutter/codelabs/main/in_app_purchases/step_00/app/assets/dash_old.png` and `https://raw.githubusercontent.com/flutter/codelabs/main/in_app_purchases/step_00/app/assets/dash.png` into `app/assets/` and register `assets/` under `flutter: assets:` in `app/pubspec.yaml`. Set `minSdk = 23` in `app/android/app/build.gradle.kts`, and add `GIDClientID` and `CFBundleURLTypes` placeholders in `app/ios/Runner/Info.plist`. Scaffold the Dash Clicker starter files using `package:material_ui/material_ui.dart` and `package:cupertino_ui/cupertino_ui.dart`:
- `lib/constants.dart` defining `cloudRegion = 'europe-west1'`, `storeKeyConsumable = 'dash_consumable_2k'`, `storeKeyUpgrade = 'dash_upgrade_3d'`, `storeKeySubscription = 'dash_subscription_doubler'`, and `serverIp = '192.168.178.46'`
- `lib/firebase_options.dart` with a placeholder `DefaultFirebaseOptions` for Android and iOS
- `lib/model/firebase_state.dart` (`enum FirebaseState { loading, available, notAvailable }`), `lib/model/store_state.dart` (`enum StoreState { loading, available, notAvailable }`), `lib/model/purchasable_product.dart` (`enum ProductStatus { purchasable, purchased, pending }` and `PurchasableProduct(this.title, this.description, this.price)`), and `lib/model/past_purchase.dart` (`PurchaseType`, `Store`, `Status`, and `PastPurchase.fromJson`)
- `lib/logic/dash_counter.dart` (`DashCounter extends ChangeNotifier` with `count`, `countString`, `increment()`, `addAutoIncrement()`, `applyPaidMultiplier()`, `removePaidMultiplier()`, `addBoughtDashes(int amount)`, and a 10Hz `Timer.periodic`)
- `lib/logic/dash_purchases.dart` (`DashPurchases extends ChangeNotifier` with `counter`, `storeState = StoreState.available`, mock `products`, `bool get beautifiedDash => false`, and a simulated `buy(PurchasableProduct product)` method)
- `lib/logic/dash_upgrades.dart` (`DashUpgrades extends ChangeNotifier` and `Upgrade` for `'Tim Sneath'`)
- `lib/logic/firebase_notifier.dart` (`FirebaseNotifier extends ChangeNotifier` initializing `Firebase.initializeApp`, `GoogleSignIn.instance`, `FirebaseAuth`, and `FirebaseFirestore`)
- `lib/repo/iap_repo.dart` (`IAPRepo extends ChangeNotifier` listening to Firebase auth changes and the `purchases` collection in Firestore)
- `lib/pages/home_page.dart` (`HomePage`, `DashClickerWidget`, `CounterStateWidget`, and `UpgradeList`), `lib/pages/login_page.dart` (`LoginPage`), and `lib/pages/purchase_page.dart` (`PurchasePage`, `_PurchasesLoading`, `_PurchasesNotAvailable`, `_PurchaseList`, `_PurchaseWidget`, and `PastPurchasesWidget`)
- `lib/main.dart` (`MyApp` and `MyHomePage` providing `FirebaseNotifier`, `DashCounter`, `DashUpgrades`, `IAPRepo`, and `DashPurchases` using `MultiProvider` with a `BottomNavigationBar` switching between `HomePage` and `PurchasePage`)
- `test/widget_test.dart` pumping `const MyApp()` and verifying `find.text('Tim Sneath')`.

Как работает сгенерированный шаблонный код

Antigravity создает проект Flutter app/ и формирует архитектуру игры Dash Clicker с помощью Provider и ChangeNotifier:

  • app/lib/main.dart регистрирует пять ChangeNotifierProvider (FirebaseNotifier, DashCounter, DashUpgrades, IAPRepo и DashPurchases) в MyHomePage и переключается между HomePage и PurchasePage.
  • app/lib/constants.dart определяет три идентификатора товаров в магазине, которые должны совпадать с идентификаторами, настроенными в App Store Connect и Google Play Console:
const cloudRegion = 'europe-west1';
const storeKeyConsumable = 'dash_consumable_2k';
const storeKeyUpgrade = 'dash_upgrade_3d';
const storeKeySubscription = 'dash_subscription_doubler';

// TODO: Replace by your own server IP
const serverIp = '192.168.178.46';

Как настроить идентификатор пакета и идентификатор приложения

Чтобы взаимодействовать с магазином приложений и Google Play, вашему приложению нужен уникальный идентификатор обратного домена (например, dev.flutter.dashclicker). В iOS он называется идентификатором пакета, а в Android – идентификатором приложения. Использование одного и того же идентификатора на обеих платформах упрощает настройку.

Сначала настройте идентификатор пакета для iOS, открыв app/ios/Runner.xcworkspace в Xcode:

Открытие Runner.xcworkspace в Xcode

В навигаторе проектов Xcode выберите Runner вверху, откройте вкладку Signing & Capabilities (Подписи и возможности), выберите Team (Команда) и введите уникальный Bundle Identifier (Идентификатор пакета):

Настройка идентификаторов команды и пакета в разделе Signing & Capabilities (Подпись и возможности) в Xcode

Затем обновите applicationId Android в app/android/app/build.gradle.kts, чтобы он соответствовал выбранному идентификатору. Вы можете изменить его самостоятельно или попросить Antigravity обновить applicationId в app/android/app/build.gradle.kts.

Настройка applicationId в android/app/build.gradle.kts

3. Установите плагин

На этом шаге вы попросите Antigravity добавить плагин in_app_purchase и пакет интерфейса платформы (используется для имитации подключений к магазину в тестах виджетов) в app/.

Попросите Antigravity установить приложение "in_app_purchase"

На панели чата с агентом Antigravity отправьте следующий запрос:

In `app/`, add `in_app_purchase` to `dependencies` and `in_app_purchase_platform_interface` to `dev_dependencies` in `pubspec.yaml`.

Как работает сгенерированный код

Antigravity запускает flutter pub add in_app_purchase dev:in_app_purchase_platform_interface в app/, обновляя app/pubspec.yaml:

dependencies:
  flutter:
    sdk: flutter
  cloud_firestore: ^7.1.0
  cupertino_icons: ^2.0.0
  cupertino_ui: ^1.1.6
  firebase_auth: ^7.0.1
  firebase_core: ^5.1.0
  google_sign_in: ^7.2.0
  http: ^1.6.0
  in_app_purchase: ^3.3.1
  intl: ^0.20.3
  logging: ^1.3.0
  material_ui: ^1.11.0
  provider: ^6.1.5+1

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^6.0.0
  in_app_purchase_platform_interface: ^1.4.1
  • in_app_purchase предоставляет кросс-платформенный API InAppPurchase, поддерживаемый StoreKit на iOS и Google Play Платежами на Android.
  • in_app_purchase_platform_interface предоставляет InAppPurchasePlatformAddition, что позволяет реализовать макет клиента InAppPurchase в app/test/widget_test.dart.

4. Как настроить магазин приложений

Чтобы протестировать покупки в приложении на iOS, зарегистрируйте приложение в App Store Connect и настройте товары, доступные для покупки. Публиковать приложение или отправлять его на проверку не нужно, но вам потребуется аккаунт разработчика Apple. Если у вас его нет, зарегистрируйтесь в программе Apple Developer Program.

Чтобы использовать покупки в приложении, у вас должно быть действующее соглашение Paid Apps в App Store Connect. Перейдите в App Store Connect и выберите Agreements, Tax, and Banking (Соглашения, налоги и банковские операции) или Business (Бизнес).

Главная страница App Store Connect с выделенным разделом Agreements, Tax, and Banking (Соглашения, налоги и банковские операции)

Ознакомьтесь с соглашениями для бесплатных и платных приложений. Прочитайте и примите условия для платных приложений, а затем укажите налоговую и банковскую информацию.

Список соглашений в App Store Connect, в котором показаны активные бесплатные приложения и новые платные приложения

Когда все будет настроено, статус Платные приложения изменится на Активно. Если у вас нет действующего соглашения о платных приложениях, StoreKit не будет возвращать контент, продаваемый через приложение, во время тестирования.

Список соглашений в App Store Connect, в котором активны соглашения Free Apps и Paid Apps

Зарегистрируйте идентификатор приложения

Создайте новый идентификатор приложения на портале для разработчиков Apple:

  1. Перейдите на страницу Apple Developer Identifiers (Идентификаторы разработчика Apple) и нажмите на значок + рядом с заголовком Identifiers (Идентификаторы).Список идентификаторов на портале Apple Developer Portal с выделенной кнопкой добавления
  2. Выберите App IDs (Идентификаторы приложений) и нажмите Continue (Продолжить).Экран регистрации нового идентификатора с выбранными идентификаторами приложений
  3. Выберите тип Приложение и нажмите Продолжить.Экран выбора типа с выбранным вариантом "Приложение"
  4. Введите описание и укажите в поле Bundle ID (Идентификатор пакета) (Explicit) точный идентификатор пакета, который вы настроили в Xcode. Убедитесь, что функция In-App Purchase (Покупки в приложении) включена, и зарегистрируйте идентификатор.Форма регистрации идентификатора приложения с описанием и идентификатором пакета

Дополнительную информацию можно найти в Справке по аккаунту разработчика Apple.

Создайте новое приложение и пользователя тестовой среды

Создайте новое приложение в App Store Connect, используя зарегистрированный идентификатор пакета:

Меню Apps в App Store Connect с выделенным пунктом New App

Диалоговое окно "Новое приложение" в App Store Connect с полями "Платформа", "Название", "Язык", "Идентификатор пакета" и "SKU"

Дополнительную информацию о создании приложения и управлении соглашениями можно найти в справочном центре App Store Connect.

Чтобы протестировать покупки в приложении без реальных платежей, создайте аккаунт Apple для тестовой среды в App Store Connect в разделе Users and Access (Пользователи и доступ) > Sandbox (Тестовая среда). Укажите адрес электронной почты, который ещё не связан с аккаунтом Apple.

Список тестировщиков в песочнице App Store Connect

На тестовом устройстве iPhone или iPad войдите в аккаунт тестовой среды. Для этого выберите Настройки > Разработчик > Аккаунт Apple в тестовой среде.

Экран настроек iOS с разделом "Аккаунт Apple для тестовой среды"

Экран настроек iOS, на котором показан вход в аккаунт Apple в тестовой среде

Настройте покупки в приложении

Затем настройте три товара в App Store Connect:

  • dash_consumable_2k – расходуемый контент, который можно покупать многократно. Каждая покупка дает 2000 рывков.
  • dash_upgrade_3d – одноразовая покупка, которая открывает 3D-талисман Dash.
  • dash_subscription_doubler – подписка с автоматическим продлением, которая увеличивает количество пассивных кликов, пока она активна.

Боковая панель App Store Connect с выделенными разделами "Покупки в приложении" и "Подписки"

В разделах In-App Purchases (Покупки в приложении) и Subscriptions (Подписки) создайте три товара со следующими идентификаторами товаров:

  1. Расходуемый контент (dash_consumable_2k)
    • Создайте расходуемый товар с названием dash consumable 2k и идентификатором dash_consumable_2k.Создайте модальное окно покупки в приложении, настроенное для dash_consumable_2k.
    • Настройте доступность так, чтобы продукт был доступен в стране или регионе пользователя тестовой среды.Настройки доступности для покупки в приложении
    • Установите цену \$1.99 (или эквивалент в местной валюте).В расписании цен задано значение 1,99 доллара США.
    • Добавьте локализацию с отображаемым названием Spring is in the air и описанием 2000 dashes fly out.Локализация в магазине приложений с отображаемым названием и описанием
    • Загрузите скриншот отзыва. Содержимое изображения не имеет значения для тестирования в песочнице, но загрузка скриншота переводит продукт в состояние Готово к отправке, которое требуется для того, чтобы приложение могло получить продукт из StoreKit.Раздел "Проверка информации" с предварительным просмотром загруженного изображения товара
  2. Контент, не являющийся расходуемым (dash_upgrade_3d).
    • Создайте неиспользуемый контент с названием dash upgrade 3d и идентификатором dash_upgrade_3d.
    • Укажите отображаемое название 3D Dash, описание Brings your dash back to the future и цену \$0.99.
    • Настройте доступность и загрузите скриншот для проверки, как вы делали для dash_consumable_2k.Конфигурация контента без автопродления для dash_upgrade_3d
  3. Автоматически продлеваемая подписка (dash_subscription_doubler).
    • В разделе Подписки создайте группу подписок с названием subscriptions. Пользователи могут оформить только одну подписку в группе и переходить на другие уровни в ее рамках.Диалоговое окно "Создать группу подписок"
    • Добавьте локализацию для группы подписок в магазине приложений.Диалоговое окно локализации в магазине приложений для группы подписок
    • Внутри группы создайте подписку с названием dash subscription doubler и идентификатором товара dash_subscription_doubler.Диалоговое окно "Создать подписку" для dash_subscription_doubler
    • Установите срок действия подписки 1 неделя, отображаемое название – Jet Engine, описание – Doubles your clicks, а цену – \$0.49. Настройте доступность и загрузите скриншот для проверки, чтобы статус изменился на Готово к отправке.Длительность, цена и настройки локализации подписки

Теперь ваши товары должны появиться в App Store Connect со статусом Ready to Submit (Готово к отправке).

Список покупок в приложении, в котором dash_consumable_2k и dash_upgrade_3d отмечены как готовые к отправке

Список подписок, в котором dash_subscription_doubler имеет статус "Готово к отправке"

5. Как настроить Google Play

Чтобы тестировать покупки в приложении на Android, вам нужен аккаунт разработчика Google Play. Если у вас его нет, зарегистрируйте аккаунт разработчика Google Play.

Создать приложение

Создайте приложение в Google Play Console.

  1. Откройте Google Play Console.
  2. Нажмите Все приложения > Создать приложение.
  3. Выберите язык по умолчанию и введите название приложения (его можно будет изменить позже).
  4. Выберите тип приложения Игра и модель ценообразования Бесплатно.
  5. Подтвердите, что ваше приложение соответствует Правилам программы для разработчиков и экспортному законодательству США, а затем нажмите Создать приложение.

После создания приложения выполните на панели управления начальные задачи из раздела Настройка приложения:

Панель управления Google Play Console с контрольным списком для настройки приложения

Подпишите заявку.

Чтобы протестировать Google Play Платежи, загрузите хотя бы один подписанный выпуск appbundle в тестовую версию в Google Play Console.

Как создать хранилище ключей

Если у вас нет хранилища ключей загрузки, создайте его в терминале.

В macOS или Linux:

keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key

В Windows

keytool -genkey -v -keystore c:\Users\USER_NAME\key.jks -storetype JKS -keyalg RSA -keysize 2048 -validity 10000 -alias key

Создать app/android/key.properties

Создайте файл app/android/key.properties со ссылкой на хранилище ключей:

storePassword=<password from previous step>
keyPassword=<password from previous step>
keyAlias=key
storeFile=<location of the key store file, such as /Users/<user name>/key.jks>

Попросите Antigravity настроить подпись выпуска в Gradle

Отправьте в Antigravity следующий запрос, чтобы настроить подпись выпуска в app/android/app/build.gradle.kts:

Update `app/android/app/build.gradle.kts` to load `key.properties` into a `Properties` object if the file exists, configure a `release` signing config inside `signingConfigs` using `keyAlias`, `keyPassword`, `storeFile`, and `storePassword`, and assign `signingConfigs.getByName("release")` to the `release` build type when `key.properties` is present.

Antigravity обновляет app/android/app/build.gradle.kts, чтобы загружать key.properties и подписывать конечные сборки:

val keystoreProperties = Properties()
val keystorePropertiesFile = rootProject.file("key.properties")
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(FileInputStream(keystorePropertiesFile))
}

android {
    // ...
    signingConfigs {
        create("release") {
            keyAlias = keystoreProperties["keyAlias"] as String?
            keyPassword = keystoreProperties["keyPassword"] as String?
            storeFile = keystoreProperties["storeFile"]?.let { file(it) }
            storePassword = keystoreProperties["storePassword"] as String?
        }
    }

    buildTypes {
        release {
            signingConfig = signingConfigs.getByName("release")
        }
    }
}

Загрузите первую сборку

Создайте подписанный набор App Bundle для выпуска из app/:

cd app
flutter build appbundle

Пакет выпуска записывается в app/build/app/outputs/bundle/release/app-release.aab.

В Google Play Console перейдите в раздел Тестирование и выпуск > Тестирование > Закрытое тестирование, создайте выпуск для закрытого тестирования, загрузите app-release.aab и нажмите Сохранить > Проверить выпуск > Начать внедрение в рамках закрытого тестирования.

Как настроить тестовых пользователей

Чтобы протестировать покупки в приложении на Android, добавьте аккаунты Google тестировщиков в двух местах в Google Play Console:

  1. Тестировщики, участвующие в тестировании. Перейдите в раздел Тестирование и выпуск > Тестирование > Внутреннее тестирование (или Закрытое тестирование), откройте вкладку Тестировщики, нажмите Создать список рассылки, добавьте адреса электронной почты тестировщиков, выберите список и нажмите Сохранить изменения.Вкладка &quot;Тестировщики&quot; на странице &quot;Внутреннее тестирование&quot; в Google Play Console
  2. Тестировщики лицензий. Вернитесь в раздел Все приложения, выберите Настройки > Тестирование лицензий, добавьте те же адреса электронной почты тестировщиков, установите для параметра Ответ лицензии значение RESPOND_NORMALLY и нажмите Сохранить изменения.Настройки тестирования лицензий в Google Play Console

Настройте покупки в приложении

Настройте те же три идентификатора товаров в Google Play Console:

  • dash_consumable_2k: расходуемый контент,дающий 2000 рывков.
  • dash_upgrade_3d: одноразовое улучшение 3D Dash.
  • dash_subscription_doubler – подписка с автоматическим продлением, которая увеличивает количество кликов.

Сначала создайте контент для однократных покупок (dash_consumable_2k и dash_upgrade_3d):

  1. Выберите приложение в Google Play Console и перейдите в раздел Монетизация с Google Play > Товары > Контент для продажи.
  2. Нажмите Создать товар.Страница &quot;Контент для продажи через приложение&quot; в Google Play Console с кнопкой &quot;Создать товар&quot;
  3. Введите точный идентификатор товара (dash_consumable_2k), название, описание и цену, а затем нажмите Сохранить и Активировать.
  4. Повторите эти действия для dash_upgrade_3d.

Затем создайте подписку (dash_subscription_doubler):

  1. Перейдите в раздел Монетизация с Google Play > Товары > Подписки и нажмите Создать подписку.Страница &quot;Подписки&quot; в Google Play Console с кнопкой &quot;Создать подписку&quot;
  2. Укажите идентификатор товара (dash_subscription_doubler), добавьте основной план с еженедельным расчетным периодом и ценой, а затем нажмите Сохранить и Активировать.

6. Настройка Firebase

Использование бэкенд-службы с Cloud Firestore для проверки и отслеживания покупок дает вашему приложению несколько преимуществ в плане безопасности:

  • Вы проверяете транзакции напрямую на серверах Google Play и Apple.
  • Вы можете реагировать на события, связанные с оплатой, на стороне сервера (например, на продление или отмену подписки).
  • Вы храните единый источник достоверных данных в Cloud Firestore, связанный с каждым аутентифицированным пользователем.
  • Пользователи не могут разблокировать платные бонусы, изменяя время на устройстве.

Создать проект Firebase

  1. Откройте консоль Firebase и создайте проект Firebase (например, Dash Clicker).
  2. Перейдите в раздел Build (Сборка) > Authentication (Аутентификация), нажмите Get started (Начать), откройте вкладку Sign-in method (Способ входа) и включите поставщика входа Google.Вкладка &quot;Способ входа&quot; в Firebase Authentication, на которой показано, что Google включен
  3. Перейдите в раздел Build (Создание) > Firestore Database (База данных Firestore) и создайте базу данных.Баннер создания Cloud Firestore в консоли Firebase
  4. Откройте вкладку Rules (Правила) в Cloud Firestore и опубликуйте следующие правила безопасности, чтобы пользователи, прошедшие аутентификацию, могли читать только свои документы о покупках:
rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /purchases/{purchaseId} {
      allow read: if request.auth != null && request.auth.uid == resource.data.userId
    }
  }
}

Как настроить Firebase для Flutter

Следуйте руководству по настройке FlutterFire, чтобы установить интерфейс командной строки FlutterFire, а затем запустите flutterfire configure в app/:

cd app
flutterfire configure
  1. Выберите созданный проект Firebase.
  2. Включите android и ios.
  3. Подтвердите, что вы хотите перезаписать lib/firebase_options.dart, нажав Да.

Настройка Firebase для Android: отладка сертификата SHA-1

Чтобы использовать функцию "Войти с аккаунтом Google" на Android, необходимо зарегистрировать цифровой отпечаток SHA-1 хранилища ключей отладки в консоли Firebase. Для этого выполните следующие действия:

  1. В консоли Firebase откройте Обзор проекта > Настройки проекта > Общие, прокрутите вниз до раздела Ваши приложения и выберите приложение для Android.Настройки проекта Firebase, в которых показана конфигурация приложения для Android и кнопка &quot;Добавить отпечаток&quot;
  2. Создайте отчет о подписи из app/android/:
    cd app/android
    ./gradlew :app:signingReport
    
  3. Найдите цифровой отпечаток SHA1 в Variant: debug и Config: debug, добавьте его в приложение для Android в консоли Firebase и повторно запустите flutterfire configure в app/, чтобы google-services.json и lib/firebase_options.dart включали обновленную конфигурацию клиента OAuth.

Как настроить Firebase для iOS: настройка схем URL

Чтобы поддерживать вход с аккаунтом Google на iOS, app/ios/Runner/Info.plist должен включать REVERSED_CLIENT_ID из app/ios/Runner/GoogleService-Info.plist в CFBundleURLTypes (см. документацию по интеграции google_sign_in с iOS).

Вы можете попросить Antigravity скопировать REVERSED_CLIENT_ID и CLIENT_ID из app/ios/Runner/GoogleService-Info.plist в app/ios/Runner/Info.plist:

Read `CLIENT_ID` and `REVERSED_CLIENT_ID` from `app/ios/Runner/GoogleService-Info.plist` and update `GIDClientID` and `CFBundleURLTypes` (`CFBundleURLSchemes`) in `app/ios/Runner/Info.plist` with those values.

В app/ios/Runner/Info.plist запись CFBundleURLTypes выглядит следующим образом:

<key>CFBundleURLTypes</key>
<array>
	<dict>
		<key>CFBundleTypeRole</key>
		<string>Editor</string>
		<key>CFBundleURLSchemes</key>
		<array>
			<string>com.googleusercontent.apps.YOUR_REVERSED_CLIENT_ID</string>
		</array>
	</dict>
</array>

7. Прослушивание обновлений о покупках

На этом шаге вы подготовите приложение Flutter к прослушиванию обновлений покупок в магазине сразу после запуска приложения и сохраните возможность тестирования дерева виджетов, добавив переопределяемую оболочку IAPConnection.

Предложите Antigravity прослушать обновления о покупках

Отправьте в Antigravity следующий запрос:

Update `app/lib/main.dart` to define an `IAPConnection` class with a static `InAppPurchase? _instance` and a static getter and setter for `instance` (defaulting to `InAppPurchase.instance`), and set `lazy: false` on `ChangeNotifierProvider<DashPurchases>`. Update `DashPurchases` in `app/lib/logic/dash_purchases.dart` to set `storeState = StoreState.notAvailable`, hold `final iapConnection = IAPConnection.instance` and `late StreamSubscription<List<PurchaseDetails>> _subscription`, subscribe to `iapConnection.purchaseStream.listen(_onPurchaseUpdate, onDone: _updateStreamOnDone, onError: _updateStreamOnError)` in the constructor, cancel `_subscription` in `dispose()`, and add `_onPurchaseUpdate`, `_updateStreamOnDone`, and `_updateStreamOnError` methods. Finally, update `app/test/widget_test.dart` to define `TestIAPConnection implements InAppPurchase` and set `IAPConnection.instance = TestIAPConnection()` before pumping `MyApp`.

Как работает сгенерированный код

Ранняя инициализация поставщика и IAPConnection в app/lib/main.dart

По умолчанию Provider создает свое значение лениво, когда виджет впервые считывает его. Поскольку ожидающие транзакции могут поступить в purchaseStream сразу после запуска, ChangeNotifierProvider устанавливает lazy: false. Кроме того, IAPConnection предоставляет статическую точку интеграции, чтобы тесты виджетов могли внедрять поддельную реализацию InAppPurchase:

class IAPConnection {
  static InAppPurchase? _instance;
  static set instance(InAppPurchase value) {
    _instance = value;
  }

  static InAppPurchase get instance {
    _instance ??= InAppPurchase.instance;
    return _instance!;
  }
}
ChangeNotifierProvider<DashPurchases>(
  create: (context) => DashPurchases(context.read<DashCounter>()),
  lazy: false,
),

Оформление подписки на издание "purchaseStream" в приложении "app/lib/logic/dash_purchases.dart"

В DashPurchases конструктор подписывается на iapConnection.purchaseStream, а dispose() отменяет _subscription:

  final iapConnection = IAPConnection.instance;

  DashPurchases(this.counter) {
    final purchaseUpdated = iapConnection.purchaseStream;
    _subscription = purchaseUpdated.listen(
      _onPurchaseUpdate,
      onDone: _updateStreamOnDone,
      onError: _updateStreamOnError,
    );
  }

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

Запустите и протестируйте приложение

Запустите набор тестов виджета в app/, чтобы убедиться, что TestIAPConnection правильно имитирует подключение к хранилищу:

cd app
flutter test

8. совершать покупки;

На этом этапе вы замените заданные в коде макеты товаров на товары из магазина, полученные с помощью queryProductDetails, инициируете покупки, когда пользователь нажимает на товар, и завершите транзакции, когда обновления поступят в purchaseStream.

Загрузите Antigravity и совершайте покупки.

Отправьте в Antigravity следующий запрос:

Update `PurchasableProduct` in `app/lib/model/purchasable_product.dart` to wrap a `ProductDetails productDetails` from `package:in_app_purchase/in_app_purchase.dart`, exposing `id`, `title`, `description`, and `price` getters from `productDetails` and initializing `status = ProductStatus.purchasable`. Then update `DashPurchases` in `app/lib/logic/dash_purchases.dart` to initialize `storeState = StoreState.loading`, `products = []`, and `bool _beautifiedDashUpgrade = false` (backing `beautifiedDash`), call `loadPurchases()` in the constructor to check `iapConnection.isAvailable()` and query `{storeKeyConsumable, storeKeySubscription, storeKeyUpgrade}` with `iapConnection.queryProductDetails(ids)`, implement `buy(PurchasableProduct product)` using `PurchaseParam` to call `iapConnection.buyConsumable` for `storeKeyConsumable` and `iapConnection.buyNonConsumable` for `storeKeySubscription` and `storeKeyUpgrade`, and implement `_onPurchaseUpdate` and `_handlePurchase(PurchaseDetails purchaseDetails)` to apply `PurchaseStatus.purchased` rewards (`counter.applyPaidMultiplier()`, `counter.addBoughtDashes(2000)`, `_beautifiedDashUpgrade = true`) and call `iapConnection.completePurchase(purchaseDetails)` when `purchaseDetails.pendingCompletePurchase` is true.

Как работает сгенерированный код

Упаковка ProductDetails в app/lib/model/purchasable_product.dart

PurchasableProduct оборачивает ProductDetails, возвращенный хранилищем, отслеживая локальный интерфейс ProductStatus (purchasable, purchased или pending):

class PurchasableProduct {
  String get id => productDetails.id;
  String get title => productDetails.title;
  String get description => productDetails.description;
  String get price => productDetails.price;
  ProductStatus status;
  ProductDetails productDetails;

  PurchasableProduct(this.productDetails) : status = ProductStatus.purchasable;
}

Запрос товаров в категории "app/lib/logic/dash_purchases.dart"

loadPurchases() сначала проверяет, доступен ли магазин, с помощью iapConnection.isAvailable(), а затем запрашивает три идентификатора товаров, определенных в app/lib/constants.dart:

  Future<void> loadPurchases() async {
    final available = await iapConnection.isAvailable();
    if (!available) {
      storeState = StoreState.notAvailable;
      notifyListeners();
      return;
    }
    const ids = <String>{
      storeKeyConsumable,
      storeKeySubscription,
      storeKeyUpgrade,
    };
    final response = await iapConnection.queryProductDetails(ids);
    products = response.productDetails
        .map((e) => PurchasableProduct(e))
        .toList();
    storeState = StoreState.available;
    notifyListeners();
  }

начало и завершение покупки;

Когда пользователь нажимает на товар в PurchasePage, buy() создает PurchaseParam и отправляет расходные материалы в buyConsumable, а одноразовые обновления или подписки – в buyNonConsumable:

  Future<void> buy(PurchasableProduct product) async {
    final purchaseParam = PurchaseParam(productDetails: product.productDetails);
    switch (product.id) {
      case storeKeyConsumable:
        await iapConnection.buyConsumable(purchaseParam: purchaseParam);
      case storeKeySubscription:
      case storeKeyUpgrade:
        await iapConnection.buyNonConsumable(purchaseParam: purchaseParam);
      default:
        throw ArgumentError.value(
          product.productDetails,
          '${product.id} is not a known product',
        );
    }
  }

Когда хранилище передает обновленные объекты PurchaseDetails в purchaseStream, _handlePurchase предоставляет соответствующее вознаграждение и подтверждает завершение, вызывая completePurchase:

  Future<void> _handlePurchase(PurchaseDetails purchaseDetails) async {
    if (purchaseDetails.status == PurchaseStatus.purchased) {
      switch (purchaseDetails.productID) {
        case storeKeySubscription:
          counter.applyPaidMultiplier();
        case storeKeyConsumable:
          counter.addBoughtDashes(2000);
        case storeKeyUpgrade:
          _beautifiedDashUpgrade = true;
      }
    }

    if (purchaseDetails.pendingCompletePurchase) {
      await iapConnection.completePurchase(purchaseDetails);
    }
  }

Запустите и протестируйте приложение

Запустите flutter test в app/ и откройте приложение на настроенном тестовом устройстве. Когда товары в магазине активны, они отображаются на вкладке Покупка и готовы к продаже:

Вкладка &quot;Покупки&quot; в Dash Clicker, на которой показаны три товара, загруженные из магазина

9. Настройте серверную часть

Прежде чем проверять и отслеживать покупки на сервере, вы создадите каркас бэкенд-сервиса Dart в dart-backend/ вместе с app/ и настроите учетные данные для Firebase, Google Play и магазина приложений.

Попросите Antigravity создать каркас бэкенда Dart

На панели чата агента Antigravity отправьте следующий запрос, чтобы создать проект dart-backend/:

Create a Dart shelf server project in `dart-backend/` with package name `firebase_backend_dart` (`dart create -t server-shelf`). Add `googleapis: ^16.0.0`, `googleapis_auth`, `http`, and `app_store_server_sdk` to `dependencies`, and `test` to `dev_dependencies` (configuring `deprecated_member_use: ignore` in `dart-backend/analysis_options.yaml`). Create:
- `dart-backend/lib/constants.dart` defining `androidPackageId`, `appStoreIssuerId`, `appStoreKeyId`, `appStoreSharedSecret`, `bundleId`, `googleCloudProjectId`, and `googlePlayPubsubBillingTopic = 'play_billing'`
- `dart-backend/lib/helpers.dart` with `serveHandler(Handler handler)`, `listenPort()`, and `terminateRequestFuture()` listening to `SIGINT` and `SIGTERM`
- `dart-backend/lib/products.dart` defining `ProductData(this.productId, this.type)`, `enum ProductType { subscription, nonSubscription }`, and `productDataMap` for `'dash_consumable_2k'`, `'dash_upgrade_3d'`, and `'dash_subscription_doubler'`
- `dart-backend/lib/iap_repository.dart` defining `enum IAPSource { googleplay, appstore }`, `abstract class Purchase`, `NonSubscriptionPurchase`, `SubscriptionPurchase`, and `IapRepository(this.api, this.projectId)` using `package:googleapis/firestore/v1.dart` (`createOrUpdatePurchase`, `updatePurchase`, and `getPurchases`)
- `dart-backend/bin/server.dart` starting an empty `Router()` with `await serveHandler(router.call)`.

Как работает сгенерированный код

  • dart-backend/bin/server.dart инициализирует Router shelf_router и обслуживает HTTP-запросы на порту 8080, используя serveHandler в dart-backend/lib/helpers.dart.
  • dart-backend/lib/products.dart сопоставляет каждый идентификатор товара (dash_consumable_2k, dash_upgrade_3d и dash_subscription_doubler) с его ProductType (nonSubscription или subscription).
  • dart-backend/lib/iap_repository.dart инкапсулирует чтение и запись документов NonSubscriptionPurchase и SubscriptionPurchase в коллекции purchases Cloud Firestore с помощью FirestoreApi.

Чтобы проверить, запускается ли сервер локально, выполните следующую команду:

cd dart-backend
dart run ./bin/server.dart

Как настроить доступ к Firebase

Чтобы разрешить dart-backend/ записывать подтвержденные покупки в Cloud Firestore, создайте ключ сервисного аккаунта:

  1. В консоли Firebase откройте Project settings (Настройки проекта) > Service accounts (Сервисные аккаунты) и нажмите Generate new private key (Создать закрытый ключ).Вкладка &quot;Сервисные аккаунты&quot; в настройках проекта Firebase, на которой показана кнопка &quot;Создать закрытый ключ&quot;
  2. Сохраните скачанный JSON-файл под названием dart-backend/assets/service-account-firebase.json.

Как настроить доступ к Google Play

Чтобы разрешить dart-backend/ проверять покупки в Android с помощью Google Play Android Developer API:

  1. Откройте страницу Google Play Android Developer API в консоли Google Cloud и включите API.Страница Google Play Android Developer API в консоли Google Cloud
  2. Перейдите на страницу сервисных аккаунтов Google Cloud и нажмите + Create service account (+ Создать сервисный аккаунт).Страница &quot;Сервисные аккаунты&quot; в консоли Google Cloud с кнопкой &quot;Создать сервисный аккаунт&quot;
  3. Введите название сервисного аккаунта и нажмите Создать и продолжить.Шаг &quot;Сведения о сервисном аккаунте&quot;
  4. Предоставьте роль Подписчик Pub/Sub и нажмите Готово.Шаг &quot;Предоставить этому сервисному аккаунту доступ к проекту&quot; с ролью &quot;Подписчик Pub/Sub&quot;
  5. Откройте меню действий только что созданного сервисного аккаунта и выберите Управление ключами.Меню действий с сервисным аккаунтом, в котором выделен пункт &quot;Управление ключами&quot;
  6. Выберите Add key (Добавить ключ) > Create new key (Создать ключ), выберите JSON и скачайте ключ.Меню &quot;Добавить ключ&quot; с пунктом &quot;Создать ключ&quot;Диалоговое окно &quot;Создать закрытый ключ&quot; с выбранным вариантом JSON
  7. Сохраните скачанный файл под названием dart-backend/assets/service-account-google-play.json.
  8. В Google Play Console откройте раздел Пользователи и разрешения, нажмите Пригласить новых пользователей и введите адрес электронной почты сервисного аккаунта:Страница &quot;Пользователи и разрешения&quot; в Google Play ConsoleТаблица сервисных аккаунтов Google Cloud с адресами электронной почты
  9. Предоставьте разрешения Просмотр финансовых данных и Управление заказами и подписками для своего приложения, а затем нажмите Пригласить пользователя.Вкладка &quot;Разрешения для приложений&quot;, на которой установлены флажки &quot;Просмотр финансовых данных&quot; и &quot;Управление заказами и подписками&quot;

Как настроить доступ к Apple App Store

Чтобы проверять чеки магазина приложений на бэкенде, создайте общий секретный ключ для приложения:

  1. Откройте App Store Connect, нажмите Apps (Приложения) и выберите нужное приложение.
  2. На боковой панели выберите General (Общие) > App Information (Информация о приложении).
  3. В разделе App-Specific Shared Secret (Общий секретный ключ для приложения) нажмите Manage (Управление), создайте новый общий секретный ключ и скопируйте его.Раздел App-Specific Shared Secret (Общий секретный ключ для приложения) в App Store ConnectМодальное окно &quot;Общий секретный ключ для приложения&quot; со сгенерированным ключом

Обновление ПО: dart-backend/lib/constants.dart

Убедитесь, что в dart-backend/lib/constants.dart заданы следующие константы:

  • androidPackageId – версия Android applicationId (например, com.example.dashclicker).
  • appStoreSharedSecret – общий секретный ключ App Store Connect.
  • bundleId – идентификатор пакета iOS (например, com.example.dashclicker).

10. Подтверждение покупок

Когда пользователь совершает покупку на устройстве iOS или Android, магазин приложений выдает токен подтверждения (PurchaseDetails.verificationData.serverVerificationData). Вместо того чтобы доверять клиентскому устройству напрямую, приложение Flutter отправляет этот токен в dart-backend/, который проверяет токен в Google Play или App Store и записывает покупку в Cloud Firestore.

Иерархия классов PurchaseHandler, реализованная в GooglePlayPurchaseHandler и AppStorePurchaseHandler

Запросите у Antigravity подтверждение покупок на стороне клиента и сервера

Отправьте в Antigravity следующий запрос, чтобы подключить процесс проверки приложения Flutter и серверной части Dart:

1. In `app/`:
- Update `PurchasePage` in `app/lib/pages/purchase_page.dart` to watch `FirebaseNotifier` and return `_PurchasesLoading()` when `state == FirebaseState.loading`, `_PurchasesNotAvailable()` when `state == FirebaseState.notAvailable`, and `const LoginPage()` when `!firebaseNotifier.loggedIn`.
- Add `User? get user => FirebaseAuth.instance.currentUser;` to `FirebaseNotifier` in `app/lib/logic/firebase_notifier.dart`.
- Update `DashPurchases` in `app/lib/logic/dash_purchases.dart` (and its provider in `app/lib/main.dart`) to accept `this.firebaseNotifier`, implement `_verifyPurchase(PurchaseDetails purchaseDetails)` that sends an HTTP `POST` request to `Uri.http('$serverIp:8080', '/verifypurchase')` with JSON body `{'source': purchaseDetails.verificationData.source, 'productId': purchaseDetails.productID, 'verificationData': purchaseDetails.verificationData.serverVerificationData, 'userId': firebaseNotifier.user?.uid}`, and update `_handlePurchase` so purchase rewards are only applied when `await _verifyPurchase(purchaseDetails)` returns `true`.

2. In `dart-backend/`:
- Create `dart-backend/lib/purchase_handler.dart` with `abstract class PurchaseHandler` defining `handleNonSubscription`, `handleSubscription`, and `verifyPurchase` switching on `productData.type`.
- Create `dart-backend/lib/google_play_purchase_handler.dart` with `GooglePlayPurchaseHandler extends PurchaseHandler` that verifies one-time purchases using `androidPublisher.purchases.products.get` and subscriptions using `androidPublisher.purchases.subscriptions.get`, parses order IDs with `extractOrderId(String orderId)` (stripping `..` renewal suffixes), maps statuses with `_nonSubscriptionStatusFrom` and `_subscriptionStatusFrom`, and saves purchases to `iapRepository`.
- Create `dart-backend/lib/app_store_purchase_handler.dart` with `AppStorePurchaseHandler extends PurchaseHandler` that validates receipts with `ITunesApi(ITunesHttpClient(ITunesEnvironment.sandbox(), loggingEnabled: true)).verifyReceipt` and saves `NonSubscriptionPurchase` and `SubscriptionPurchase` records to `iapRepository`.
- Update `dart-backend/bin/server.dart` to initialize `AndroidPublisherApi` and `FirestoreApi` from the service account JSON files in `_createPurchaseHandlers()`, register a `POST /verifypurchase` route, and extract request fields in `getPurchaseData(dynamic payload)` using Dart 3 map pattern matching.

Как работает сгенерированный код

Ограничение покупок с помощью аутентификации и вызова /verifypurchase

В app/lib/pages/purchase_page.dart PurchasePage проверяет FirebaseNotifier и показывает LoginPage, пока пользователь не войдет в аккаунт:

    var firebaseNotifier = context.watch<FirebaseNotifier>();
    if (firebaseNotifier.state == FirebaseState.loading) {
      return _PurchasesLoading();
    } else if (firebaseNotifier.state == FirebaseState.notAvailable) {
      return _PurchasesNotAvailable();
    }

    if (!firebaseNotifier.loggedIn) {
      return const LoginPage();
    }

В app/lib/logic/dash_purchases.dart _verifyPurchase публикует источник магазина (google_play или app_store), productID, serverVerificationData и userId, с которым выполнен вход, в серверной части Dart, прежде чем _handlePurchase предоставит вознаграждение в приложении:

  Future<bool> _verifyPurchase(PurchaseDetails purchaseDetails) async {
    final url = Uri.http('$serverIp:8080', '/verifypurchase');
    const headers = {
      'Content-type': 'application/json',
      'Accept': 'application/json',
    };
    final response = await http.post(
      url,
      body: jsonEncode({
        'source': purchaseDetails.verificationData.source,
        'productId': purchaseDetails.productID,
        'verificationData':
            purchaseDetails.verificationData.serverVerificationData,
        'userId': firebaseNotifier.user?.uid,
      }),
      headers: headers,
    );
    if (response.statusCode == 200) {
      return true;
    } else {
      return false;
    }
  }

Маршрутизация и сопоставление с шаблоном Dart 3 в dart-backend/bin/server.dart

На сервере POST /verifypurchase декодирует тело запроса JSON с помощью getPurchaseData, используя шаблон карты Dart 3 и тип возвращаемого значения записи, а затем делегирует проверку соответствующему обработчику магазина:

  router.post('/verifypurchase', (Request request) async {
    final dynamic payload = json.decode(await request.readAsString());
    final (:userId, :source, :productData, :token) = getPurchaseData(payload);

    final result = await purchaseHandlers[source]!.verifyPurchase(
      userId: userId,
      productData: productData,
      token: token,
    );

    if (result) {
      return Response.ok('all good!');
    } else {
      return Response.internalServerError();
    }
  });
({String userId, String source, ProductData productData, String token})
getPurchaseData(dynamic payload) {
  if (payload case {
    'userId': String userId,
    'source': String source,
    'productId': String productId,
    'verificationData': String token,
  }) {
    return (
      userId: userId,
      source: source,
      productData: productDataMap[productId]!,
      token: token,
    );
  } else {
    throw const FormatException('Unexpected JSON');
  }
}

Проверка чеков Google Play и App Store

  • В dart-backend/lib/google_play_purchase_handler.dart GooglePlayPurchaseHandler запрашивает androidPublisher.purchases.products.get для контента для однократных покупок и androidPublisher.purchases.subscriptions.get для подписок, удаляет суффиксы продления ..# из идентификаторов заказов подписок с помощью extractOrderId и записывает полученные NonSubscriptionPurchase или SubscriptionPurchase в Cloud Firestore с помощью iapRepository.
  • В dart-backend/lib/app_store_purchase_handler.dart AppStorePurchaseHandler вызывает _iTunesAPI.verifyReceipt с помощью пакета app_store_server_sdk и сохраняет каждый подтвержденный чек в response.latestReceiptInfo в Cloud Firestore.

Запуск и тестирование бэкенда

Запустите бэкенд-сервер из каталога dart-backend/:

cd dart-backend
dart run bin/server.dart

11. Отслеживайте покупки

Подписки могут продлеваться, истекать или отменяться за пределами вашего приложения. На этом шаге вы настроите серверную часть для опроса обновлений платежей в магазине приложений из Google Cloud Pub/Sub и App Store Server API, а также обновите клиент Flutter, чтобы реактивно синхронизировать активные разрешения пользователя из Cloud Firestore с помощью IAPRepo.

Настройте ключи Cloud Pub/Sub и App Store Server API

Настройка Google Play Cloud Pub/Sub

  1. Задайте для googleCloudProjectId в dart-backend/lib/constants.dart идентификатор проекта Google Cloud и проекта Firebase.
  2. Откройте страницу Cloud Pub/Sub Topics (Темы Cloud Pub/Sub) в консоли Google Cloud, убедитесь, что выбран нужный проект, и нажмите + Create Topic (+ Создать тему).Страница &quot;Темы&quot; в Google Cloud Pub/Sub с кнопкой &quot;Создать тему&quot;
  3. Укажите идентификатор темы play_billing (соответствует googlePlayPubsubBillingTopic в dart-backend/lib/constants.dart, что автоматически создает подписку по умолчанию play_billing-sub) и нажмите Создать.Диалоговое окно создания темы с идентификатором play_billing
  4. Нажмите на значок меню в виде трех точек рядом с темой "play_billing" и выберите Посмотреть разрешения.Меню темы издателя-подписчика с выделенным пунктом &quot;Разрешения на просмотр&quot;
  5. Нажмите Добавить субъекта, введите google-play-developer-notifications@system.gserviceaccount.com, назначьте роль Издатель Pub/Sub и нажмите Сохранить.Панель &quot;Добавить субъекты&quot;, предоставляющая издателю-подписчику Pub/Sub доступ к google-play-developer-notifications
  6. Скопируйте полное название темы, откройте приложение в Google Play Console, перейдите в раздел Монетизация с Google Play > Настройка монетизации, вставьте название темы и нажмите Сохранить изменения.Настройка монетизации в Google Play Console с названием темы уведомлений для разработчиков в режиме реального времени

Настройка ключа App Store Server API

  1. Войдите в App Store Connect и выберите Users and Access (Пользователи и доступ).
  2. Перейдите в раздел Integrations (Интеграции) > Keys (Ключи) > In-App Purchase (Покупки в приложении) и нажмите кнопку +, чтобы создать ключ (например, Codelab key).
  3. Скачайте файл ключа .p8 и сохраните его как dart-backend/assets/SubscriptionKey.p8.
  4. Скопируйте идентификатор ключа и идентификатор издателя в appStoreKeyId и appStoreIssuerId в dart-backend/lib/constants.dart.

Список ключей для покупок в приложении в App Store Connect, в котором показаны идентификаторы издателя и ключа

Запросить у Antigravity опрос событий магазина и синхронизировать состояние клиента

Отправьте в Antigravity следующий запрос:

1. In `dart-backend/`:
- Update `GooglePlayPurchaseHandler` in `dart-backend/lib/google_play_purchase_handler.dart` to accept `pubsub.PubsubApi pubsubApi` from `package:googleapis/pubsub/v1.dart`, start a 10-second `Timer.periodic` calling `_pullMessageFromPubSub()`, decode base64 Pub/Sub messages in `_processMessage(String data64, String? ackId)` (handling `testNotification`, `subscriptionNotification`, and `oneTimeProductNotification`), and acknowledge processed messages in `_ackMessage(String id)`.
- Update `AppStorePurchaseHandler` in `dart-backend/lib/app_store_purchase_handler.dart` to accept `AppStoreServerAPI appStoreServerAPI`, start a 10-second `Timer.periodic` calling `_pullStatus()`, query `appStoreServerAPI.getAllSubscriptionStatuses(purchase.orderId)` for active App Store subscriptions in `iapRepository`, and update their expiration date and `SubscriptionStatus` in Firestore.
- Update `dart-backend/bin/server.dart` to add `pubsub.PubsubApi.cloudPlatformScope` to the Google Play client scopes, construct `PubsubApi` and `AppStoreServerAPI` (reading `assets/SubscriptionKey.p8` and caching JWT tokens in `assets/appstore.token`), and pass them to `GooglePlayPurchaseHandler` and `AppStorePurchaseHandler`.
- Create unit tests in `dart-backend/test/firebase_backend_dart_test.dart` verifying `extractOrderId` (with and without a `..0` suffix) and `getPurchaseData` (valid and invalid payloads).

2. In `app/`:
- Update `DashPurchases` in `app/lib/logic/dash_purchases.dart` (and its provider in `app/lib/main.dart`) to accept `this.iapRepo` (`IAPRepo`), register `iapRepo.addListener(purchasesUpdate)` in the constructor and `iapRepo.removeListener(purchasesUpdate)` in `dispose()`, and implement `purchasesUpdate()` and `_updateStatus(PurchasableProduct product, ProductStatus status)` (setting `product.status = status` when `product.status != status`) so `iapRepo.hasActiveSubscription` applies or removes the paid counter multiplier and `iapRepo.hasUpgrade` updates `_beautifiedDashUpgrade` and product statuses.

Как работает сгенерированный код

Опрос Google Play Pub/Sub и App Store Server API на сервере

В dart-backend/lib/google_play_purchase_handler.dart _pullMessageFromPubSub опрашивает подписку projects/$googleCloudProjectId/subscriptions/$googlePlayPubsubBillingTopic-sub каждые 10 секунд, декодирует каждую полезную нагрузку уведомления base64, повторно запускает handleSubscription или handleNonSubscription для обновления Firestore и подтверждает сообщение с помощью _ackMessage:

  Future<void> _pullMessageFromPubSub() async {
    print('Polling Google Play messages');
    final request = pubsub.PullRequest(maxMessages: 1000);
    final topicName =
        'projects/$googleCloudProjectId/subscriptions/$googlePlayPubsubBillingTopic-sub';
    final pullResponse = await pubsubApi.projects.subscriptions.pull(
      request,
      topicName,
    );
    final messages = pullResponse.receivedMessages ?? [];
    for (final message in messages) {
      final data64 = message.message?.data;
      if (data64 != null) {
        await _processMessage(data64, message.ackId);
      }
    }
  }

Аналогично в dart-backend/lib/app_store_purchase_handler.dart _pullStatus запрашивает appStoreServerAPI.getAllSubscriptionStatuses(purchase.orderId) каждые 10 секунд и обновляет expiryDate и SubscriptionStatus (active или expired) каждой подписки в Cloud Firestore.

Синхронизация покупок Firestore на устройстве

В app/lib/repo/iap_repo.dart IAPRepo прослушивает документы purchases аутентифицированного пользователя в Cloud Firestore в реальном времени и вычисляет hasActiveSubscription и hasUpgrade:

    var purchaseStream = _firestore
        .collection('purchases')
        .where('userId', isEqualTo: user.uid)
        .snapshots();
    _purchaseSubscription = purchaseStream.listen((snapshot) {
      purchases = snapshot.docs.map((document) {
        var data = document.data();
        return PastPurchase.fromJson(data);
      }).toList();

      hasActiveSubscription = purchases.any(
        (element) =>
            element.productId == storeKeySubscription &&
            element.status != Status.expired,
      );

      hasUpgrade = purchases.any(
        (element) => element.productId == storeKeyUpgrade,
      );

      notifyListeners();
    });

Когда IAPRepo уведомляет слушателей, DashPurchases.purchasesUpdate() в app/lib/logic/dash_purchases.dart включает или отключает множитель кликов 10x, переключает _beautifiedDashUpgrade и обновляет статусы товаров, отображаемые в PurchasePage:

  void purchasesUpdate() {
    var subscriptions = <PurchasableProduct>[];
    var upgrades = <PurchasableProduct>[];
    if (products.isNotEmpty) {
      subscriptions = products
          .where((element) => element.productDetails.id == storeKeySubscription)
          .toList();
      upgrades = products
          .where((element) => element.productDetails.id == storeKeyUpgrade)
          .toList();
    }

    if (iapRepo.hasActiveSubscription) {
      counter.applyPaidMultiplier();
      for (var element in subscriptions) {
        _updateStatus(element, ProductStatus.purchased);
      }
    } else {
      counter.removePaidMultiplier();
      for (var element in subscriptions) {
        _updateStatus(element, ProductStatus.purchasable);
      }
    }

    if (iapRepo.hasUpgrade != _beautifiedDashUpgrade) {
      _beautifiedDashUpgrade = iapRepo.hasUpgrade;
      for (var element in upgrades) {
        _updateStatus(
          element,
          _beautifiedDashUpgrade
              ? ProductStatus.purchased
              : ProductStatus.purchasable,
        );
      }
      notifyListeners();
    }
  }

  void _updateStatus(PurchasableProduct product, ProductStatus status) {
    if (product.status != status) {
      product.status = status;
      notifyListeners();
    }
  }

Запустите и протестируйте приложение и серверную часть

Запустите модульные тесты и тесты виджетов в обоих проектах, чтобы убедиться, что все анализируется и проходит без ошибок:

cd dart-backend
dart test
cd ../app
flutter test

12. Поздравляю!

Поздравляем! Вы сотрудничали с Google Antigravity, чтобы создать полнофункциональную интеграцию покупок в приложении на Flutter с бэкендом проверки Dart.

Что вы создали

  • Настройте расходуемые (dash_consumable_2k) и нерасходуемые (dash_upgrade_3d) товары, а также автоматически продлеваемые подписки (dash_subscription_doubler) в App Store Connect и Google Play Console.
  • Подключили приложение Dash Clicker Flutter (app/) к плагину in_app_purchase, запросили информацию о товарах и настроили прослушивание purchaseStream.
  • Создан бэкенд shelf на Dart (dart-backend/), который проверяет токены покупок с помощью Google Play Android Developer API и магазина приложений, опрашивает обновления платежей с помощью Cloud Pub/Sub и App Store Server API и сохраняет состояние покупки в Cloud Firestore.
  • Синхронизируйте подтвержденные права на покупку с клиентом Flutter в реальном времени с помощью IAPRepo.

Дальнейшие действия

  • Добавьте промежуточное ПО для проверки токена Firebase Auth ID в POST /verifypurchase в dart-backend/bin/server.dart.
  • Разверните dart-backend/ в Cloud Run и настройте веб-хуки push-уведомлений для Google Cloud Pub/Sub и App Store Server Notifications.

Подробнее…