1. 소개
Flutter 앱에 인앱 구매를 추가하려면 Apple App Store와 Google Play 스토어를 구성하고, 신뢰할 수 있는 백엔드에서 구매 토큰을 확인하고, 소모성 화폐, 일회성 업그레이드 또는 정기 결제 혜택과 같은 사용 권한을 부여해야 합니다.
이 Codelab에서는 Google Antigravity와 협력하여 Dash 마스코트를 화폐로 사용하는 모바일 클리커 게임인 Dash Clicker를 빌드하고 Dart shelf 백엔드 서비스 및 Cloud Firestore와 페어링하여 세 가지 유형의 인앱 구매를 검증하고 추적합니다.
- 소비성(
dash_consumable_2k): 플레이어에게 즉시 2,000개의 대시를 부여하며 여러 번 구매할 수 있는 반복 구매 항목입니다. - 비소모성(
dash_upgrade_3d): 기존 Dash 마스코트를 현대적인 3D Dash로 영구적으로 변환하는 일회성 업그레이드입니다. - 구독(
dash_subscription_doubler): 구독이 활성 상태로 유지되는 동안 수동적으로 생성된 클릭수를 늘리는 자동 갱신 구독입니다.
|
|
|
빌드할 항목
material_ui및cupertino_ui로 스타일이 지정된 Flutter 모바일 앱(app/)으로, 스토어 제품을 쿼리하고 구매를 시작하며 실시간 구매 스트림에 반응합니다.- Google Play 및 앱 스토어에서 구매 영수증을 확인하고, 스토어 결제 이벤트를 폴링하고, Cloud Firestore에 구매 상태를 기록하는 Dart
shelf백엔드 서버(dart-backend/)
학습 여정
이 Codelab에서는 풀 스택 인앱 구매 흐름을 빌드하고 연결하는 과정을 단계별로 안내합니다.
- 개발 환경 설정 - Flutter 및 Google Antigravity를 설치하고, Antigravity에 Dash Clicker 시작 프로젝트(
app/)를 스캐폴드하도록 프롬프트를 표시하고, iOS 번들 식별자와 AndroidapplicationId를 구성합니다. - 플러그인 설치 - Antigravity에
in_app_purchase및in_app_purchase_platform_interface를app/에 추가하라는 프롬프트를 표시합니다. - App Store 설정 - 앱 ID를 등록하고, 샌드박스 테스트 계정을 만들고, App Store Connect에서 세 가지 제품을 구성합니다.
- Play 스토어 설정 - Google Play Console에서 앱을 만들고, Antigravity에 Gradle에서 출시 키 저장소 서명을 구성하라는 메시지를 표시하고, 초기 App Bundle을 업로드하고, 라이선스 테스터를 추가하고, 제품을 구성합니다.
- Firebase 설정 - Firebase Console에서 Google 로그인 및 Cloud Firestore를 사용 설정하고,
flutterfire configure를 실행하고, Android SHA-1 디지털 지문과 iOS URL 스키마를 구성합니다. - 구매 업데이트 수신 대기 - Antigravity에 테스트 가능한
IAPConnection래퍼를 추가하고,purchaseStream를 구독하고,TestIAPConnection로 앱을 테스트하라는 프롬프트를 표시합니다. - 구매 - Antigravity에
ProductDetails를PurchasableProduct로 래핑하고, 스토어 제품을 쿼리하고,buyConsumable및buyNonConsumable를 트리거하고, 대기 중인 구매를 완료하라는 메시지를 표시합니다. - 백엔드 설정 - Antigravity에
IapRepository를 사용하여dart-backend/서버를 스캐폴딩하고 서비스 계정 사용자 인증 정보를 구성하라는 프롬프트를 표시합니다. - 구매 확인 - Antigravity에
PurchasePage에서 Firebase 로그인을 요구하고, 구매 토큰을/verifypurchase에 게시하고,GooglePlayPurchaseHandler및AppStorePurchaseHandler를 구현하도록 요청합니다. - 구매 추적 - Antigravity가 백엔드에서 Google Cloud Pub/Sub 및 App Store Server API를 폴링하고
IAPRepo를 사용하여 사용 권한을 Flutter 클라이언트에 다시 동기화하도록 요청합니다.
학습할 내용
- Google Antigravity와 협업하여 풀 스택 Flutter 인앱 구매 앱과 Dart 백엔드를 반복적으로 빌드하고 맞춤설정하는 방법
- 소비성 제품, 비소비성 제품, 정기 결제 제품으로 App Store Connect 및 Google Play Console을 구성하는 방법
in_app_purchase플러그인을 사용하여 제품을 쿼리하고, 구매를 시작하고, 구매 스트림을 처리하는 방법- Dart 백엔드에서 Google Play 및 앱 스토어 구매 토큰을 확인하고 Cloud Firestore에 저장하는 방법
- 스토어 결제 이벤트를 처리하고 여러 기기에서 정기 결제 및 업그레이드 사용 권한을 동기화하는 방법
기본 요건
- Flutter 위젯, Dart 문법,
Provider상태 관리에 관한 기본 지식 - Apple 개발자 계정(iOS에서 App Store 구매를 테스트하는 경우), Google Play 개발자 계정(Android에서 Play 스토어 구매를 테스트하는 경우) 또는 둘 다
- Firebase 계정 및 Firebase CLI
2. 개발 환경 설정
편집자
이 Codelab에서는 Google Antigravity를 AI 우선 개발 환경으로 사용합니다. 각 단계에서 Antigravity에 Flutter 클라이언트(app/)와 Dart 백엔드(dart-backend/)를 생성하거나 발전시키도록 프롬프트를 입력하고, 생성된 코드를 검사하고, 원하는 경우 변형을 살펴봅니다.
Flutter 설치
Flutter SDK 설치에 관한 가장 최신 안내는 docs.flutter.dev에서 항상 확인할 수 있습니다.
이 Codelab에서는 다음 소프트웨어를 설치합니다.
- Flutter SDK
- 공식 Dart 및 Flutter 플러그인이 사용 설정된 Google Antigravity(플러그인 마켓플레이스의 Build with Google 섹션에서 사용 가능)
- 선택한 모바일 타겟의 컴파일러 소프트웨어(Android를 타겟팅하는 Android 스튜디오 또는 iOS를 타겟팅하는 Xcode)
Antigravity에 스타터 프로젝트를 만들도록 프롬프트 입력
- Google Antigravity를 실행하고 Flutter 앱(
app/)과 Dart 서버(dart-backend/)를 모두 빌드할 빈 작업공간 디렉터리를 엽니다. 홈 디렉터리의 폴더 또는C:\src\와 같이 승격된 권한이 필요하지 않거나 공백이 포함되지 않은 경로를 선택합니다. - Antigravity 에이전트 채팅 패널에서 다음 프롬프트를 전송하여
app/에서 Dash Clicker 시작 앱을 스캐폴딩합니다.
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는 app/ Flutter 프로젝트를 만들고 Provider 및 ChangeNotifier를 사용하여 Dash Clicker 게임 아키텍처를 스캐폴딩합니다.
app/lib/main.dart는MyHomePage내에 5개의ChangeNotifierProvider(FirebaseNotifier,DashCounter,DashUpgrades,IAPRepo,DashPurchases)를 등록하고HomePage와PurchasePage간에 전환합니다.app/lib/constants.dart는 App Store Connect 및 Google Play Console에서 구성하는 ID와 일치해야 하는 세 가지 스토어 제품 ID를 정의합니다.
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';
앱의 번들 식별자 및 애플리케이션 ID 구성
App Store 및 Play 스토어와 통신하려면 앱에 고유한 역방향 도메인 식별자(예: dev.flutter.dashclicker)가 필요합니다. iOS에서는 이를 번들 식별자라고 하고 Android에서는 애플리케이션 ID라고 합니다. 두 플랫폼에서 동일한 식별자를 사용하면 구성을 더 간단하게 유지할 수 있습니다.
먼저 Xcode에서 app/ios/Runner.xcworkspace를 열어 iOS의 번들 식별자를 설정합니다.

Xcode의 프로젝트 탐색기에서 상단의 Runner를 선택하고 Signing & Capabilities(서명 및 기능) 탭을 열고 Team(팀)을 선택한 후 고유한 Bundle Identifier(번들 식별자)를 입력합니다.

그런 다음 app/android/app/build.gradle.kts의 Android applicationId를 선택한 식별자와 일치하도록 업데이트합니다. 직접 수정하거나 Antigravity에 app/android/app/build.gradle.kts의 applicationId를 선택한 ID로 업데이트하도록 요청할 수 있습니다.

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는 app/ 내에서 flutter pub add in_app_purchase dev:in_app_purchase_platform_interface을 실행하여 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는 iOS의 StoreKit과 Android의 Google Play 결제를 기반으로 하는 크로스 플랫폼InAppPurchaseAPI를 제공합니다.in_app_purchase_platform_interface는InAppPurchasePlatformAddition를 노출하므로app/test/widget_test.dart에서 모의InAppPurchase클라이언트를 구현할 수 있습니다.
4. 앱 스토어 설정하기
iOS에서 인앱 구매를 테스트하려면 App Store Connect에 앱을 등록하고 구매 가능한 제품을 구성해야 합니다. 앱을 게시하거나 검토를 위해 제출할 필요는 없지만 Apple 개발자 계정이 필요합니다. 계정이 없는 경우 Apple Developer Program에 등록합니다.
유료 앱 계약
인앱 구매를 사용하려면 App Store Connect에 활성 상태의 유료 앱 계약이 있어야 합니다. App Store Connect로 이동하여 계약, 세금 및 금융 거래(또는 비즈니스)를 선택합니다.

무료 및 유료 앱에 관한 계약을 검토합니다. 유료 앱 약관을 확인하고 동의한 후 필요한 세금 및 은행 정보를 입력합니다.

모든 항목이 구성되면 유료 앱의 상태가 활성으로 변경됩니다. 활성 상태의 유료 앱 계약이 없으면 테스트 중에 StoreKit에서 인앱 상품을 반환하지 않습니다.

앱 ID 등록
Apple 개발자 포털에서 새 앱 ID를 만듭니다.
- Apple Developer Identifiers(Apple 개발자 식별자)를 방문하여 Identifiers(식별자) 헤더 옆에 있는 + 아이콘을 클릭합니다.

- App IDs를 선택하고 계속을 클릭합니다.

- 유형으로 앱을 선택하고 계속을 클릭합니다.

- 설명을 입력하고 번들 ID(명시적)를 Xcode에서 구성한 정확한 번들 식별자로 설정합니다. 인앱 구매 기능이 사용 설정되어 있는지 확인한 후 식별자를 등록합니다.

자세한 내용은 Apple 개발자 계정 도움말을 참고하세요.
새 앱 및 샌드박스 사용자 만들기
등록된 번들 식별자를 사용하여 App Store Connect에서 새 앱을 만듭니다.
|
|
앱을 만들고 계약을 관리하는 방법에 관한 자세한 내용은 App Store Connect 도움말을 참고하세요.
실제 요금 청구 없이 인앱 구매를 테스트하려면 App Store Connect의 사용자 및 액세스 > 샌드박스에서 샌드박스 Apple 계정을 만듭니다. Apple 계정과 연결되지 않은 이메일 주소를 사용해야 합니다.

테스트 iPhone 또는 iPad에서 설정 > 개발자 > 샌드박스 Apple 계정에서 샌드박스 계정으로 로그인합니다.
|
|
인앱 구매 구성
그런 다음 App Store Connect에서 구매 가능한 항목 3개를 구성합니다.
dash_consumable_2k: 반복적으로 구매할 수 있는 소모성 구매로, 구매당 2,000개의 대시를 제공합니다.dash_upgrade_3d: 한 번만 구매할 수 있는 비소모성 업그레이드 구매로, 3D Dash 마스코트를 잠금 해제합니다.dash_subscription_doubler: 활성 상태에서 수동 클릭을 배가하는 자동 갱신 정기 결제입니다.

앱의 인앱 구매(및 정기 결제) 섹션에서 다음 제품 ID를 사용하여 세 가지 제품을 만듭니다.
- 소비형(
dash_consumable_2k):- 참조 이름이
dash consumable 2k이고 제품 ID가dash_consumable_2k인 소비성 제품을 만듭니다.
- 샌드박스 사용자의 국가 또는 지역에서 제품을 사용할 수 있도록 사용 가능 여부를 구성합니다.

- 가격을
\$1.99(또는 현지 통화로 환산한 금액)로 설정합니다.
- 표시 이름
Spring is in the air및 설명2000 dashes fly out을 사용하여 현지화를 추가합니다.
- 리뷰 스크린샷을 업로드합니다. 이미지 콘텐츠는 샌드박스 테스트에 중요하지 않지만 스크린샷을 업로드하면 제품이 제출 준비 완료 상태로 전환되며, 이는 앱이 StoreKit에서 제품을 가져오는 데 필요합니다.

- 참조 이름이
- 비소비성(
dash_upgrade_3d):- 참조 이름이
dash upgrade 3d이고 제품 ID가dash_upgrade_3d인 비소비성 제품을 만듭니다. - 표시 이름을
3D Dash, 설명을Brings your dash back to the future, 가격을\$0.99로 설정합니다. dash_consumable_2k에서와 마찬가지로 사용 가능 여부를 구성하고 검토 스크린샷을 업로드합니다.
- 참조 이름이
- 자동 갱신 정기 결제(
dash_subscription_doubler):- 정기 결제에서
subscriptions라는 이름의 정기 결제 그룹을 만듭니다(사용자는 한 번에 동일한 그룹 내에서 하나의 제품만 정기 결제할 수 있으며 그룹 내에서 업그레이드 또는 다운그레이드할 수 있음).
- 정기 결제 그룹의 앱 스토어 현지화를 추가합니다.

- 그룹 내에서 참조 이름이
dash subscription doubler이고 제품 ID가dash_subscription_doubler인 정기 결제를 만듭니다.
- 정기 결제 기간을 1주일로, 표시 이름을
Jet Engine로, 설명을Doubles your clicks으로, 가격을\$0.49로 설정합니다. 사용 가능 여부를 구성하고 검토 스크린샷을 업로드하여 상태가 제출 준비 완료가 되도록 합니다.
- 정기 결제에서
이제 제품이 App Store Connect에 제출 준비 완료 상태로 표시됩니다.


5. Play 스토어 설정하기
Android에서 인앱 구매를 테스트하려면 Google Play 개발자 계정이 필요합니다. 아직 개발자 계정이 없다면 Google Play 개발자 계정을 등록하세요.
새 앱 만들기
Google Play Console에서 새 앱을 만듭니다.
- 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>
Gradle에서 출시 서명을 구성하도록 Antigravity에 프롬프트 작성
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/에서 서명된 출시 App Bundle을 빌드합니다.
cd app
flutter build appbundle
출시 번들이 app/build/app/outputs/bundle/release/app-release.aab에 기록됩니다.
Google Play Console에서 테스트 및 출시 > 테스트 > 비공개 테스트로 이동하여 비공개 테스트 버전을 만들고 app-release.aab를 업로드한 후 저장 > 버전 검토 > 비공개 테스트 출시 시작을 클릭합니다.
테스트 사용자 설정
Android에서 인앱 구매를 테스트하려면 Google Play Console의 두 위치에 테스터의 Google 계정을 추가하세요.
- 테스트 트랙 테스터: 테스트 및 출시 > 테스트 > 내부 테스트(또는 비공개 테스트)로 이동하여 테스터 탭을 열고 이메일 목록 만들기를 클릭한 다음 테스터의 이메일 주소를 추가하고 목록을 선택한 후 변경사항 저장을 클릭합니다.

- 라이선스 테스터: 모든 앱 보기로 돌아가서 설정 > 라이선스 테스트를 선택하고 동일한 테스터 이메일 주소를 추가한 후 라이선스 응답을
RESPOND_NORMALLY로 설정하고 변경사항 저장을 클릭합니다.
인앱 구매 구성
Google Play Console에서 동일한 제품 ID 3개를 구성합니다.
dash_consumable_2k: 대시 2,000개를 부여하는 소모성 구매입니다.dash_upgrade_3d: 비소비성 일회성 3D Dash 업그레이드dash_subscription_doubler: 자동 갱신되는 클릭 배율 정기 결제입니다.
먼저 일회성 제품(dash_consumable_2k 및 dash_upgrade_3d)을 만듭니다.
- Google Play Console에서 앱을 선택하고 Play를 통한 수익 창출 > 제품 > 인앱 상품으로 이동합니다.
- 제품 만들기를 클릭합니다.

- 정확한 제품 ID(
dash_consumable_2k), 이름, 설명, 가격을 입력한 다음 저장 및 활성화를 클릭합니다. dash_upgrade_3d에 대해 이 프로세스를 반복합니다.
그런 다음 구독(dash_subscription_doubler)을 만듭니다.
- Google Play를 통한 수익 창출 > 제품 > 정기 결제로 이동하여 정기 결제 만들기를 클릭합니다.

- 제품 ID(
dash_subscription_doubler)를 입력하고 주간 결제 기간과 가격이 있는 기본 요금제를 추가한 다음 저장하고 활성화합니다.
6. Firebase 설정하기
Cloud Firestore와 함께 백엔드 서비스를 사용하여 구매를 확인하고 추적하면 앱에 다음과 같은 보안 이점이 있습니다.
- Google Play 및 Apple 서버에서 직접 거래를 확인합니다.
- 갱신 또는 취소와 같은 서버 측 결제 이벤트에 대응할 수 있습니다.
- 인증된 각 사용자와 연결된 단일 정보 소스를 Cloud Firestore에 저장합니다.
- 사용자는 기기 시계를 조작하여 프리미엄 혜택을 잠금 해제할 수 없습니다.
Firebase 프로젝트 만들기
- Firebase Console을 열고 새 Firebase 프로젝트(예: Dash Clicker)를 만듭니다.
- 빌드 > 인증으로 이동하여 시작하기를 클릭하고 로그인 방법 탭을 열고 Google 로그인 제공업체를 사용 설정합니다.

- 빌드 > Firestore 데이터베이스로 이동하여 데이터베이스를 만듭니다.

- 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
}
}
}
Flutter용 Firebase 설정
FlutterFire 설정 가이드에 따라 FlutterFire CLI를 설치한 후 app/ 내에서 flutterfire configure를 실행합니다.
cd app
flutterfire configure
- 만든 Firebase 프로젝트를 선택합니다.
- android 및 ios를 사용 설정합니다.
lib/firebase_options.dart를 재정의하라는 메시지가 표시되면 yes를 확인합니다.
Android용 Firebase 설정: 디버그 SHA-1 인증서
Android에서 Google 로그인을 사용하려면 Firebase Console에 디버그 키 저장소의 SHA-1 디지털 지문을 등록해야 합니다.
- Firebase Console에서 프로젝트 개요 > 프로젝트 설정 > 일반을 열고 내 앱까지 아래로 스크롤한 후 Android 앱을 선택합니다.

app/android/에서 서명 보고서를 생성합니다.cd app/android ./gradlew :app:signingReportVariant: debug및Config: debug에서SHA1지문을 찾아 Firebase Console의 Android 앱에 추가하고app/에서flutterfire configure를 다시 실행하여google-services.json및lib/firebase_options.dart에 업데이트된 OAuth 클라이언트 구성이 포함되도록 합니다.
iOS용 Firebase 설정: URL 스키마 구성
iOS에서 Google 로그인을 지원하려면 app/ios/Runner/Info.plist에 CFBundleURLTypes 내의 app/ios/Runner/GoogleService-Info.plist에서 가져온 REVERSED_CLIENT_ID가 포함되어야 합니다(google_sign_in iOS 통합 문서 참고).
Antigravity에 프롬프트를 입력하여 app/ios/Runner/GoogleService-Info.plist의 REVERSED_CLIENT_ID 및 CLIENT_ID를 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`.
생성된 코드 이해
app/lib/main.dart의 즉시 제공자 초기화 및 IAPConnection
기본적으로 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,
),
app/lib/logic/dash_purchases.dart에서 purchaseStream 구독 중
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.
생성된 코드 이해
app/lib/model/purchasable_product.dart에서 ProductDetails 래핑
PurchasableProduct는 로컬 UI ProductStatus(purchasable, purchased 또는 pending)를 추적하면서 스토어에서 반환한 ProductDetails를 래핑합니다.
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에 정의된 세 가지 제품 ID를 쿼리합니다.
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',
);
}
}
스토어가 purchaseStream에서 업데이트된 PurchaseDetails 객체를 내보내면 _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);
}
}
앱 실행 및 테스트
app/에서 flutter test를 실행하고 구성된 테스트 기기에서 앱을 실행합니다. 스토어 제품이 활성 상태이면 구매 탭에 구매 가능한 제품이 표시됩니다.

9. 백엔드 설정
서버에서 구매를 확인하고 추적하기 전에 dart-backend/에서 app/와 함께 Dart 백엔드 서비스를 스캐폴딩하고 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는shelf_routerRouter를 초기화하고dart-backend/lib/helpers.dart의serveHandler를 사용하여 포트8080에서 HTTP 요청을 처리합니다.dart-backend/lib/products.dart는 각 제품 ID(dash_consumable_2k,dash_upgrade_3d,dash_subscription_doubler)를ProductType(nonSubscription또는subscription)에 매핑합니다.dart-backend/lib/iap_repository.dart는FirestoreApi를 사용하여 Cloud Firestore의purchases컬렉션에서NonSubscriptionPurchase및SubscriptionPurchase문서를 읽고 쓰는 작업을 캡슐화합니다.
다음을 실행하여 서버가 로컬에서 시작되는지 테스트할 수 있습니다.
cd dart-backend
dart run ./bin/server.dart
Firebase 액세스 설정
dart-backend/에서 확인된 구매를 Cloud Firestore에 쓸 수 있도록 하려면 서비스 계정 키를 생성합니다.
- Firebase Console에서 프로젝트 설정 > 서비스 계정을 열고 새 비공개 키 생성을 클릭합니다.

- 다운로드한 JSON 파일을
dart-backend/assets/service-account-firebase.json로 저장합니다.
Google Play 액세스 설정하기
dart-backend/에서 Google Play Android Developer API를 사용하여 Android 구매를 확인하도록 허용하려면 다음 단계를 따르세요.
- Google Cloud 콘솔에서 Google Play Android Developer API 페이지를 열고 API를 사용 설정합니다.

- Google Cloud 서비스 계정 페이지로 이동하여 + 서비스 계정 만들기를 클릭합니다.

- 서비스 계정 이름을 입력하고 만들고 계속하기를 클릭합니다.

- Pub/Sub 구독자 역할을 부여하고 완료를 클릭합니다.

- 새로 만든 서비스 계정의 작업 메뉴를 열고 키 관리를 선택합니다.

- 키 추가 > 새 키 만들기를 선택하고 JSON을 선택한 후 키를 다운로드합니다.


- 다운로드한 파일을
dart-backend/assets/service-account-google-play.json로 저장합니다. - Google Play Console에서 사용자 및 권한을 열고 신규 사용자 초대를 클릭한 후 서비스 계정의 이메일 주소를 입력합니다.


- 앱에 재무 데이터 보기 및 주문 및 정기 결제 관리 권한을 부여한 다음 사용자 초대를 클릭합니다.

Apple App Store 액세스 설정
백엔드에서 앱 스토어 영수증을 확인하려면 앱별 공유 보안 비밀번호를 생성합니다.
- App Store Connect를 열고 앱을 선택한 다음 앱을 선택합니다.
- 사이드바에서 General(일반) > App Information(앱 정보)으로 이동합니다.
- App-Specific Shared Secret에서 Manage를 클릭하고 새 공유 보안 비밀을 생성한 후 복사합니다.


dart-backend/lib/constants.dart 업데이트
dart-backend/lib/constants.dart에 다음 상수가 설정되어 있는지 확인합니다.
androidPackageId: AndroidapplicationId(예: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에 구매를 기록합니다.

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는 _handlePurchase가 인앱 리워드를 부여하기 전에 스토어 소스(google_play 또는 app_store), productID, serverVerificationData, 로그인한 userId를 Dart 백엔드에 게시합니다.
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-backend/bin/server.dart의 라우팅 및 Dart 3 패턴 일치
서버에서 POST /verifypurchase는 Dart 3 맵 패턴과 레코드 반환 유형을 사용하여 getPurchaseData로 JSON 요청 본문을 디코딩한 다음 일치하는 스토어 핸들러에 확인을 위임합니다.
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 및 앱 스토어 영수증 확인
dart-backend/lib/google_play_purchase_handler.dart에서GooglePlayPurchaseHandler는 일회성 제품의 경우androidPublisher.purchases.products.get, 정기 결제의 경우androidPublisher.purchases.subscriptions.get를 쿼리하고,extractOrderId를 사용하여 정기 결제 주문 ID에서..#갱신 서픽스를 제거하고,iapRepository를 사용하여 결과NonSubscriptionPurchase또는SubscriptionPurchase를 Cloud Firestore에 씁니다.dart-backend/lib/app_store_purchase_handler.dart에서AppStorePurchaseHandler는app_store_server_sdk패키지를 사용하여_iTunesAPI.verifyReceipt를 호출하고response.latestReceiptInfo의 각 확인된 영수증을 Cloud Firestore에 유지합니다.
백엔드 실행 및 테스트
dart-backend/에서 백엔드 서버를 시작합니다.
cd dart-backend
dart run bin/server.dart
11. 구매 내역 추적하기
정기 결제는 앱 외부에서 갱신, 만료 또는 취소될 수 있습니다. 이 단계에서는 Google Cloud Pub/Sub 및 App Store Server API에서 스토어 결제 업데이트를 폴링하도록 백엔드를 구성하고, IAPRepo를 사용하여 Cloud Firestore에서 사용자의 활성 사용 권한을 반응적으로 동기화하도록 Flutter 클라이언트를 업데이트합니다.
Cloud Pub/Sub 및 앱 스토어 서버 API 키 구성
Google Play Cloud Pub/Sub 설정
dart-backend/lib/constants.dart의googleCloudProjectId를 Google Cloud 및 Firebase 프로젝트 ID로 설정합니다.- Google Cloud 콘솔에서 Cloud Pub/Sub 주제 페이지를 열고 프로젝트가 선택되어 있는지 확인한 후 + 주제 만들기를 클릭합니다.

- 주제 ID를
play_billing(dart-backend/lib/constants.dart의googlePlayPubsubBillingTopic와 일치하며 기본 구독play_billing-sub를 자동으로 생성함)로 설정하고 만들기를 클릭합니다.
play_billing주제에서 점 3개 메뉴를 열고 권한 보기를 선택합니다.
- 주 구성원 추가를 클릭하고
google-play-developer-notifications@system.gserviceaccount.com를 입력한 후 Pub/Sub 게시자 역할을 할당하고 저장을 클릭합니다.
- 전체 주제 이름을 복사하고 Google Play Console에서 앱을 열고 Play를 통한 수익 창출 > 수익 창출 설정으로 이동하여 주제 이름을 붙여넣고 변경사항 저장을 클릭합니다.

App Store Server API 키 설정
- App Store Connect에 로그인하고 Users and Access(사용자 및 액세스)를 선택합니다.
- 통합 > 키 > 인앱 구매로 이동하고 + 버튼을 클릭하여 새 키(예:
Codelab key)를 생성합니다. .p8키 파일을 다운로드하고dart-backend/assets/SubscriptionKey.p8로 저장합니다.- 키 ID 및 발급자 ID를
dart-backend/lib/constants.dart의appStoreKeyId및appStoreIssuerId에 복사합니다.

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는 10초마다 projects/$googleCloudProjectId/subscriptions/$googlePlayPubsubBillingTopic-sub 구독을 폴링하고, 각 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는 10초마다 appStoreServerAPI.getAllSubscriptionStatuses(purchase.orderId)를 쿼리하고 Cloud Firestore에서 각 구독의 expiryDate 및 SubscriptionStatus(active 또는 expired)를 업데이트합니다.
기기에서 Firestore 구매 동기화
app/lib/repo/iap_repo.dart에서 IAPRepo는 Cloud Firestore에서 인증된 사용자의 purchases 문서를 실시간으로 수신 대기하고 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가 리스너에 알릴 때마다 app/lib/logic/dash_purchases.dart의 DashPurchases.purchasesUpdate()는 10배 클릭 승수를 사용 설정 또는 사용 중지하고 _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와 협력하여 Dart 인증 백엔드를 사용하는 Flutter의 풀 스택 인앱 구매 통합을 빌드했습니다.
빌드한 항목
- App Store Connect 및 Google Play Console에서 소모품(
dash_consumable_2k), 비소모품(dash_upgrade_3d), 자동 갱신 정기 결제(dash_subscription_doubler) 제품을 구성했습니다. - Dash Clicker Flutter 앱(
app/)을in_app_purchase플러그인에 연결하고 제품 세부정보를 쿼리하고purchaseStream를 수신 대기했습니다. - Google Play Android Developer API 및 App Store를 사용하여 구매 토큰을 확인하고, Cloud Pub/Sub 및 App Store Server API를 사용하여 결제 업데이트를 폴링하고, Cloud Firestore에 구매 상태를 유지하는 Dart
shelf백엔드(dart-backend/)를 빌드했습니다. IAPRepo를 사용하여 확인된 구매 사용 권한을 Flutter 클라이언트에 실시간으로 다시 동기화했습니다.
다음 단계
dart-backend/bin/server.dart의POST /verifypurchase에 Firebase 인증 ID 토큰 확인 미들웨어를 추가합니다.dart-backend/를 Cloud Run에 배포하고 Google Cloud Pub/Sub 및 App Store 서버 알림에 대한 푸시 웹훅을 구성합니다.






