Menambahkan pembelian dalam aplikasi ke aplikasi Flutter Anda

1. Pengantar

Menambahkan pembelian dalam aplikasi ke aplikasi Flutter memerlukan konfigurasi Apple App Store dan Google Play Store, verifikasi token pembelian di backend tepercaya, dan pemberian hak seperti mata uang habis pakai, upgrade satu kali, atau keuntungan langganan berulang.

Dalam codelab ini, Anda akan berkolaborasi dengan Google Antigravity untuk membangun Dash Clicker—game clicker seluler yang menggunakan maskot Dash sebagai mata uang—dan menyandingkannya dengan layanan backend shelf Dart dan Cloud Firestore untuk memvalidasi dan melacak tiga jenis pembelian dalam aplikasi:

  1. Dapat digunakan (dash_consumable_2k): Pembelian berulang yang langsung memberi pemain 2.000 Dash dan dapat dibeli beberapa kali.
  2. Tidak dapat habis digunakan (dash_upgrade_3d): Upgrade satu kali yang permanen dan mengubah maskot Dash klasik menjadi Dash 3D modern selamanya.
  3. Langganan (dash_subscription_doubler): Langganan yang diperpanjang otomatis yang melipatgandakan klik yang dihasilkan secara pasif selama langganan tetap aktif.

Layar utama Dash Clicker yang menampilkan maskot Dash klasik dan penghitung ketukan

Layar pembelian Dash Clicker yang mencantumkan produk dalam aplikasi yang tersedia dan pembelian sebelumnya

Layar utama Dash Clicker setelah membeli upgrade 3D Dash

Yang akan Anda build

  • Aplikasi seluler Flutter (app/) yang diberi gaya dengan material_ui dan cupertino_ui yang mengkueri produk toko, memulai pembelian, dan bereaksi terhadap streaming pembelian real-time.
  • Server backend shelf Dart (dart-backend/) yang memverifikasi tanda terima pembelian dengan Google Play dan App Store, melakukan polling peristiwa penagihan store, dan mencatat status pembelian di Cloud Firestore.

Perjalanan pembelajaran Anda

Codelab ini memandu Anda membangun dan menghubungkan alur pembelian dalam aplikasi full-stack langkah demi langkah:

  1. Menyiapkan lingkungan pengembangan - Instal Flutter dan Google Antigravity, minta Antigravity untuk membuat scaffold project awal Dash Clicker (app/), dan konfigurasi ID paket iOS dan applicationId Android Anda.
  2. Menginstal plugin - Meminta Antigravity untuk menambahkan in_app_purchase dan in_app_purchase_platform_interface ke app/.
  3. Menyiapkan App Store - Daftarkan ID Aplikasi Anda, buat akun pengujian sandbox, dan konfigurasi tiga produk di App Store Connect.
  4. Menyiapkan Google Play Store - Buat aplikasi Anda di Konsol Google Play, minta Antigravity untuk mengonfigurasi penandatanganan keystore rilis di Gradle, upload app bundle awal, tambahkan penguji lisensi, dan konfigurasikan produk.
  5. Menyiapkan Firebase - Aktifkan Login dengan Google dan Cloud Firestore di Firebase console, jalankan flutterfire configure, dan konfigurasi sidik jari SHA-1 Android dan skema URL iOS.
  6. Memproses update pembelian - Minta Antigravity untuk menambahkan wrapper IAPConnection yang dapat diuji, berlangganan ke purchaseStream, dan menguji aplikasi dengan TestIAPConnection.
  7. Melakukan pembelian - Minta Antigravity untuk menggabungkan ProductDetails dalam PurchasableProduct, mengkueri produk toko, memicu buyConsumable dan buyNonConsumable, serta menyelesaikan pembelian tertunda.
  8. Menyiapkan backend - Minta Antigravity untuk membuat scaffold server dart-backend/ dengan IapRepository dan mengonfigurasi kredensial akun layanan.
  9. Verifikasi pembelian - Minta Antigravity untuk mewajibkan login Firebase di PurchasePage, memposting token pembelian ke /verifypurchase, serta menerapkan GooglePlayPurchaseHandler dan AppStorePurchaseHandler.
  10. Melacak pembelian - Minta Antigravity untuk melakukan polling pada Google Cloud Pub/Sub dan App Store Server API di backend dan menyinkronkan hak kembali ke klien Flutter menggunakan IAPRepo.

Yang akan Anda pelajari

  • Cara berkolaborasi dengan Google Antigravity untuk membangun dan menyesuaikan aplikasi pembelian dalam aplikasi Flutter full-stack dan backend Dart secara iteratif.
  • Cara mengonfigurasi App Store Connect dan Konsol Google Play dengan produk habis pakai, tidak habis pakai, dan produk langganan.
  • Cara membuat kueri produk, memulai pembelian, dan menangani streaming pembelian dengan plugin in_app_purchase.
  • Cara memverifikasi token pembelian Google Play dan App Store di backend Dart dan menyimpannya di Cloud Firestore.
  • Cara memproses peristiwa penagihan toko serta menyinkronkan langganan dan hak upgrade di seluruh perangkat.

Prasyarat

  • Pemahaman dasar tentang widget Flutter, sintaksis Dart, dan pengelolaan status Provider.
  • Akun Apple Developer (untuk menguji pembelian App Store di iOS), akun Developer Google Play (untuk menguji pembelian Google Play Store di Android), atau keduanya.
  • Akun Firebase dan Firebase CLI.

2. Menyiapkan lingkungan pengembangan

Editor

Codelab ini menggunakan Google Antigravity sebagai lingkungan pengembangan berbasis AI Anda. Di setiap langkah, Anda akan meminta Antigravity untuk membuat atau mengembangkan klien Flutter (app/) dan backend Dart (dart-backend/), memeriksa kode yang dihasilkan, dan secara opsional menjelajahi variasi.

Menginstal Flutter

Instruksi terkini mengenai cara menginstal Flutter SDK selalu dapat ditemukan di docs.flutter.dev.

Untuk codelab ini, instal software berikut:

  1. Flutter SDK
  2. Google Antigravity dengan plugin Dart dan Flutter resmi diaktifkan (tersedia di Plugin Marketplace di bagian Build with Google).
  3. Software compiler untuk target seluler pilihan Anda (Android Studio untuk target Android, atau Xcode untuk target iOS).

Minta Antigravity untuk membuat project awal

  1. Luncurkan Google Antigravity dan buka direktori ruang kerja kosong tempat Anda ingin membangun aplikasi Flutter (app/) dan server Dart (dart-backend/). Pilih jalur yang tidak memerlukan hak istimewa yang ditingkatkan atau berisi spasi, seperti folder di direktori utama atau C:\src\.
  2. Di panel Percakapan agen Antigravity, kirim perintah berikut untuk membuat scaffold aplikasi awal Dash Clicker di 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')`.

Memahami kode awal yang dihasilkan

Antigravity membuat project Flutter app/ dan menyusun arsitektur game Dash Clicker menggunakan Provider dan ChangeNotifier:

  • app/lib/main.dart mendaftarkan lima ChangeNotifierProvider (FirebaseNotifier, DashCounter, DashUpgrades, IAPRepo, dan DashPurchases) di dalam MyHomePage dan beralih antara HomePage dan PurchasePage.
  • app/lib/constants.dart menentukan tiga ID produk toko yang harus cocok dengan ID yang Anda konfigurasi di App Store Connect dan Konsol Google Play:
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';

Mengonfigurasi ID paket dan ID aplikasi Anda

Untuk berkomunikasi dengan App Store dan Google Play Store, aplikasi Anda memerlukan ID domain terbalik yang unik (misalnya, dev.flutter.dashclicker). Di iOS, ID ini disebut ID paket; di Android, ID ini disebut ID aplikasi. Menggunakan ID yang sama di kedua platform akan membuat konfigurasi lebih sederhana.

Pertama, siapkan ID paket untuk iOS dengan membuka app/ios/Runner.xcworkspace di Xcode:

Membuka Runner.xcworkspace di Xcode

Di navigator project Xcode, pilih Runner di bagian atas, buka tab Signing & Capabilities, pilih Team, dan masukkan Bundle Identifier unik Anda:

Mengonfigurasi Tim dan ID Paket di Xcode Signing & Capabilities

Selanjutnya, perbarui applicationId Android di app/android/app/build.gradle.kts agar sesuai dengan ID yang Anda pilih (Anda dapat mengeditnya secara langsung atau meminta Antigravity untuk memperbarui applicationId di app/android/app/build.gradle.kts ke ID yang Anda pilih):

Menetapkan applicationId di android/app/build.gradle.kts

3. Menginstal plugin

Pada langkah ini, Anda akan meminta Antigravity untuk menambahkan plugin in_app_purchase dan paket antarmuka platformnya (digunakan untuk membuat tiruan koneksi toko dalam pengujian widget) ke app/.

Minta Antigravity untuk menginstal in_app_purchase

Di panel chat agen Antigravity, kirim perintah berikut:

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

Memahami kode yang dihasilkan

Antigravity menjalankan flutter pub add in_app_purchase dev:in_app_purchase_platform_interface di dalam app/, mengupdate 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 menyediakan API InAppPurchase lintas platform yang didukung oleh StoreKit di iOS dan Layanan Penagihan Google Play di Android.
  • in_app_purchase_platform_interface mengekspos InAppPurchasePlatformAddition, yang memungkinkan Anda menerapkan klien InAppPurchase tiruan di app/test/widget_test.dart.

4. Menyiapkan App Store

Untuk menguji pembelian dalam aplikasi di iOS, Anda harus mendaftarkan aplikasi di App Store Connect dan mengonfigurasi produk yang dapat dibeli. Anda tidak perlu memublikasikan aplikasi atau mengirimkannya untuk ditinjau, tetapi Anda memerlukan akun developer Apple. Jika Anda belum memilikinya, daftar ke Apple Developer Program.

Untuk menggunakan pembelian dalam aplikasi, Anda harus memiliki perjanjian Aplikasi Berbayar yang aktif di App Store Connect. Buka App Store Connect, lalu pilih Agreements, Tax, and Banking (atau Business).

Dasbor beranda App Store Connect yang menandai Perjanjian, Pajak, dan Perbankan

Tinjau perjanjian untuk aplikasi gratis dan berbayar. Lihat dan setujui persyaratan untuk Aplikasi Berbayar, lalu masukkan informasi pajak dan perbankan yang diperlukan.

Daftar Perjanjian App Store Connect yang menampilkan Aplikasi Gratis aktif dan Aplikasi Berbayar baru

Setelah semuanya dikonfigurasi, status untuk Aplikasi Berbayar akan berubah menjadi Aktif. Tanpa perjanjian Aplikasi Berbayar yang aktif, StoreKit tidak akan menampilkan produk dalam aplikasi Anda selama pengujian.

Daftar Perjanjian App Store Connect yang menampilkan Aplikasi Gratis dan Aplikasi Berbayar aktif

Mendaftarkan ID Aplikasi

Buat ID Aplikasi baru di Portal Developer Apple:

  1. Buka Apple Developer Identifiers, lalu klik ikon + di samping header Identifiers.Daftar ID portal developer Apple dengan tombol tambah ditandai
  2. Pilih App IDs, lalu klik Continue.Layar Register a new identifier dengan App IDs dipilih
  3. Pilih Aplikasi sebagai jenisnya, lalu klik Lanjutkan.Layar pemilihan jenis dengan Aplikasi dipilih
  4. Masukkan deskripsi dan tetapkan Bundle ID (Eksplisit) ke ID paket yang sama persis dengan yang Anda konfigurasi di Xcode. Pastikan kemampuan pembelian dalam aplikasi diaktifkan, lalu daftarkan ID.Formulir Register an App ID yang menampilkan deskripsi dan Bundle ID eksplisit

Untuk detail tambahan, lihat Bantuan Akun Developer Apple.

Membuat aplikasi dan pengguna sandbox baru

Buat aplikasi baru di App Store Connect menggunakan ID paket terdaftar Anda:

Menu Apps di App Store Connect yang menampilkan opsi New App

Dialog Aplikasi Baru di App Store Connect yang menampilkan kolom platform, nama, bahasa, ID paket, dan SKU

Untuk panduan selengkapnya tentang cara membuat aplikasi dan mengelola perjanjian, lihat Bantuan App Store Connect.

Untuk menguji pembelian dalam aplikasi tanpa tagihan sungguhan, buat Akun Apple Sandbox di App Store Connect di bagian Users and Access > Sandbox. Anda harus menggunakan alamat email yang belum dikaitkan dengan Akun Apple.

Daftar Penguji Sandbox App Store Connect

Di iPhone atau iPad pengujian, login dengan akun sandbox di bagian Settings > Developer > Sandbox Apple Account.

Layar Setelan iOS yang menampilkan bagian Akun Apple Sandbox

Layar Setelan iOS yang menampilkan Akun Apple Sandbox yang login

Mengonfigurasi pembelian dalam aplikasi

Selanjutnya, konfigurasikan tiga item yang dapat dibeli di App Store Connect:

  • dash_consumable_2k: Pembelian habis pakai yang dapat dibeli berulang kali, memberikan 2.000 Dash per pembelian.
  • dash_upgrade_3d: Pembelian upgrade tidak habis pakai yang hanya dapat dibeli sekali, yang membuka maskot Dash 3D.
  • dash_subscription_doubler: Langganan yang diperpanjang otomatis yang melipatgandakan klik pasif saat aktif.

Sidebar App Store Connect yang menandai Pembelian dalam Aplikasi dan Langganan

Di bagian Pembelian Dalam Aplikasi (dan Langganan) aplikasi Anda, buat tiga produk dengan ID Produk yang sama persis:

  1. Dapat digunakan habis (dash_consumable_2k):
    • Buat produk Consumable dengan Reference Name dash consumable 2k dan ID Produk dash_consumable_2k.Membuat modal Pembelian dalam Aplikasi yang dikonfigurasi untuk dash_consumable_2k
    • Konfigurasikan ketersediaan agar produk tersedia di negara atau wilayah pengguna sandbox Anda.Konfigurasi ketersediaan untuk pembelian dalam aplikasi
    • Tetapkan harga ke \$1.99 (atau nilai setara dalam mata uang lokal).Konfigurasi Jadwal Harga ditetapkan ke $1,99
    • Tambahkan pelokalan dengan Nama Tampilan Spring is in the air dan Deskripsi 2000 dashes fly out.Pelokalan App Store yang menampilkan Nama Tampilan dan Deskripsi
    • Upload screenshot ulasan. Konten gambar tidak penting untuk pengujian sandbox, tetapi mengupload screenshot akan mengalihkan produk ke status Ready to Submit, yang diperlukan agar aplikasi dapat mengambil produk dari StoreKit.Bagian Informasi Peninjauan dengan gambar pratinjau produk yang diupload
  2. Tidak habis pakai (dash_upgrade_3d):
    • Buat produk Non-Consumable dengan Nama Referensi dash upgrade 3d dan ID Produk dash_upgrade_3d.
    • Tetapkan Nama Tampilan ke 3D Dash, Deskripsi ke Brings your dash back to the future, dan harga ke \$0.99.
    • Konfigurasikan ketersediaan dan upload screenshot peninjauan seperti yang Anda lakukan untuk dash_consumable_2k.Konfigurasi produk tidak habis pakai untuk dash_upgrade_3d
  3. Langganan yang diperpanjang otomatis (dash_subscription_doubler):
    • Di bagian Subscriptions, buat Subscription Group bernama subscriptions (pengguna hanya dapat berlangganan satu produk dalam grup yang sama pada satu waktu, dan dapat mengupgrade atau mendowngrade dalam grup).Dialog Create Subscription Group
    • Tambahkan pelokalan App Store untuk grup langganan.Dialog App Store Localization untuk grup langganan
    • Di dalam grup, buat langganan dengan Nama Referensi dash subscription doubler dan ID Produk dash_subscription_doubler.Dialog Create Subscription untuk dash_subscription_doubler
    • Tetapkan Durasi Langganan ke 1 Week, Nama Tampilan ke Jet Engine, Deskripsi ke Doubles your clicks, dan harga ke \$0.49. Konfigurasi ketersediaan dan upload screenshot peninjauan sehingga statusnya menjadi Siap Dikirim.Setelan durasi, harga, dan pelokalan langganan

Produk Anda sekarang akan muncul di App Store Connect dengan status Ready to Submit:

Daftar Pembelian dalam Aplikasi yang menampilkan dash_consumable_2k dan dash_upgrade_3d sebagai Siap Dikirim

Daftar langganan yang menampilkan dash_subscription_doubler sebagai Siap Dikirim

5. Menyiapkan Google Play Store

Untuk menguji pembelian dalam aplikasi di Android, Anda memerlukan akun Developer Google Play. Jika Anda belum memilikinya, daftar untuk membuat akun Developer Google Play.

Buat aplikasi baru

Buat aplikasi baru di Konsol Google Play:

  1. Buka Konsol Google Play.
  2. Pilih Semua aplikasi > Buat aplikasi.
  3. Pilih bahasa default dan masukkan nama aplikasi (Anda dapat mengubahnya nanti).
  4. Pilih Game sebagai jenis aplikasi dan Free sebagai model harga.
  5. Lengkapi deklarasi Kebijakan Program Developer dan Hukum ekspor Amerika Serikat, lalu pilih Buat aplikasi.

Setelah membuat aplikasi, selesaikan tugas Siapkan aplikasi Anda awal di dasbor:

Dasbor Konsol Google Play yang menampilkan checklist Siapkan aplikasi Anda

Menandatangani aplikasi

Untuk menguji Layanan Penagihan Google Play, Anda harus mengupload setidaknya satu rilis appbundle yang ditandatangani ke jalur pengujian di Konsol Google Play.

Membuat keystore

Jika Anda belum memiliki keystore upload, buat keystore dari terminal.

Di macOS atau Linux:

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

Di Windows:

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

Buat app/android/key.properties

Buat app/android/key.properties yang berisi referensi ke keystore Anda:

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>

Meminta Antigravity untuk mengonfigurasi penandatanganan rilis di Gradle

Kirim perintah berikut di Antigravity untuk menghubungkan penandatanganan rilis di 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 mengupdate app/android/app/build.gradle.kts untuk memuat key.properties dan menandatangani build rilis:

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")
        }
    }
}

Mengupload build pertama Anda

Bangun app bundle rilis yang ditandatangani dari app/:

cd app
flutter build appbundle

Paket rilis ditulis ke app/build/app/outputs/bundle/release/app-release.aab.

Di Konsol Google Play, buka Pengujian dan rilis > Pengujian > Pengujian tertutup, buat rilis pengujian tertutup, upload app-release.aab, lalu klik Simpan > Tinjau rilis > Mulai peluncuran ke Pengujian tertutup.

Menyiapkan pengguna pengujian

Untuk menguji pembelian dalam aplikasi di Android, tambahkan Akun Google penguji Anda di dua tempat di Konsol Google Play:

  1. Penguji jalur pengujian: Buka Pengujian dan rilis > Pengujian > Pengujian internal (atau Pengujian tertutup), buka tab Penguji, klik Buat daftar email, tambahkan alamat email penguji, pilih daftar, lalu klik Simpan perubahan.Tab Penguji Pengujian internal Konsol Google Play
  2. Penguji lisensi: Kembali ke tampilan Semua aplikasi, pilih Setelan > Pengujian lisensi, tambahkan alamat email penguji yang sama, tetapkan Respons lisensi ke RESPOND_NORMALLY, lalu klik Simpan perubahan.Setelan pengujian Lisensi Konsol Google Play

Mengonfigurasi pembelian dalam aplikasi

Konfigurasikan tiga ID produk yang sama di Konsol Google Play:

  • dash_consumable_2k: Pembelian item habis pakai yang memberikan 2.000 Dash.
  • dash_upgrade_3d: Upgrade Dash 3D satu kali yang tidak dapat habis digunakan.
  • dash_subscription_doubler: Langganan pengganda klik yang diperpanjang otomatis.

Pertama, buat produk sekali beli (dash_consumable_2k dan dash_upgrade_3d):

  1. Pilih aplikasi Anda di Konsol Google Play, lalu buka Monetisasi dengan Google Play > Produk > Produk dalam aplikasi.
  2. Klik Buat produk.Halaman Produk dalam aplikasi di Konsol Google Play dengan tombol Buat produk
  3. Masukkan ID Produk (dash_consumable_2k), nama, deskripsi, dan harga yang sama persis, lalu klik Simpan dan Aktifkan.
  4. Ulangi proses untuk dash_upgrade_3d.

Selanjutnya, buat langganan (dash_subscription_doubler):

  1. Buka Monetisasi dengan Google Play > Produk > Langganan, lalu klik Buat langganan.Halaman Langganan Konsol Google Play dengan tombol Buat langganan
  2. Masukkan ID Produk (dash_subscription_doubler), tambahkan paket dasar dengan periode penagihan dan harga mingguan, lalu Simpan dan Aktifkan.

6. Menyiapkan Firebase

Menggunakan layanan backend dengan Cloud Firestore untuk memverifikasi dan melacak pembelian memberikan beberapa keuntungan keamanan bagi aplikasi Anda:

  • Anda memverifikasi transaksi langsung dengan server Google Play dan Apple.
  • Anda dapat bereaksi terhadap peristiwa penagihan sisi server (seperti perpanjangan atau pembatalan).
  • Anda menyimpan satu sumber tepercaya di Cloud Firestore yang terkait dengan setiap pengguna yang diautentikasi.
  • Pengguna tidak dapat membuka keuntungan premium dengan mengubah jam perangkat mereka.

Membuat project Firebase

  1. Buka Firebase console dan buat project Firebase baru (misalnya, Dash Clicker).
  2. Buka Build > Authentication, klik Get started, buka tab Metode login, lalu aktifkan penyedia login Google.Tab metode login Firebase Authentication yang menampilkan Google diaktifkan
  3. Buka Build > Firestore Database dan buat database.Banner pembuatan Cloud Firestore di Firebase console
  4. Buka tab Rules di Cloud Firestore dan publikasikan aturan keamanan berikut agar pengguna yang diautentikasi hanya dapat membaca dokumen pembelian mereka sendiri:
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
    }
  }
}

Menyiapkan Firebase untuk Flutter

Ikuti panduan penyiapan FlutterFire untuk menginstal FlutterFire CLI, lalu jalankan flutterfire configure di dalam app/:

cd app
flutterfire configure
  1. Pilih project Firebase yang Anda buat.
  2. Aktifkan android dan ios.
  3. Konfirmasi yes saat diminta untuk mengganti lib/firebase_options.dart.

Menyiapkan Firebase untuk Android: Sertifikat SHA-1 debug

Login dengan Google di Android memerlukan pendaftaran sidik jari SHA-1 keystore debug Anda di Firebase console:

  1. Di Firebase console, buka Ringkasan Project > Setelan project > Umum, scroll ke bawah ke Aplikasi Anda, lalu pilih aplikasi Android Anda:Setelan Project Firebase yang menampilkan konfigurasi aplikasi Android dan tombol Tambahkan sidik jari
  2. Buat laporan penandatanganan dari app/android/:
    cd app/android
    ./gradlew :app:signingReport
    
  3. Temukan sidik jari SHA1 di bagian Variant: debug dan Config: debug, tambahkan ke aplikasi Android Anda di Firebase console, dan jalankan ulang flutterfire configure di app/ agar google-services.json dan lib/firebase_options.dart menyertakan konfigurasi klien OAuth yang telah diupdate.

Menyiapkan Firebase untuk iOS: Mengonfigurasi skema URL

Untuk mendukung Login dengan Google di iOS, app/ios/Runner/Info.plist harus menyertakan REVERSED_CLIENT_ID dari app/ios/Runner/GoogleService-Info.plist di dalam CFBundleURLTypes (lihat dokumentasi integrasi iOS google_sign_in).

Anda dapat meminta Antigravity untuk menyalin REVERSED_CLIENT_ID dan CLIENT_ID dari app/ios/Runner/GoogleService-Info.plist ke 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.

Di app/ios/Runner/Info.plist, entri CFBundleURLTypes terlihat seperti ini:

<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. Memproses update pembelian

Pada langkah ini, Anda akan menyiapkan aplikasi Flutter untuk memproses update pembelian di Play Store segera setelah aplikasi diluncurkan, dan menjaga hierarki widget tetap dapat diuji dengan memperkenalkan wrapper IAPConnection yang dapat diganti.

Meminta Antigravity memproses update pembelian

Kirim perintah berikut di 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`.

Memahami kode yang dihasilkan

Inisialisasi penyedia eager dan IAPConnection di app/lib/main.dart

Secara default, Provider membuat nilainya secara lambat saat widget pertama kali membacanya. Karena transaksi Play Store yang tertunda dapat langsung masuk ke purchaseStream saat memulai, ChangeNotifierProvider akan menetapkan lazy: false. Selain itu, IAPConnection menyediakan seam statis sehingga pengujian widget dapat memasukkan implementasi InAppPurchase palsu:

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,
),

Berlangganan purchaseStream di app/lib/logic/dash_purchases.dart

Di DashPurchases, konstruktor berlangganan ke iapConnection.purchaseStream dan dispose() membatalkan _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();
  }

Menjalankan dan menguji aplikasi

Jalankan suite pengujian widget di app/ untuk memverifikasi bahwa TestIAPConnection meniru koneksi Play Store dengan baik:

cd app
flutter test

8. Melakukan pembelian

Pada langkah ini, Anda akan mengganti produk tiruan hardcode dengan produk toko live yang diambil menggunakan queryProductDetails, memulai pembelian saat pengguna mengetuk produk, dan menyelesaikan transaksi saat update tiba di purchaseStream.

Minta Antigravity untuk memuat dan melakukan pembelian

Kirim perintah berikut di 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.

Memahami kode yang dihasilkan

Menggabungkan ProductDetails dalam app/lib/model/purchasable_product.dart

PurchasableProduct menggabungkan ProductDetails yang ditampilkan oleh penyimpanan saat melacak ProductStatus UI lokal (purchasable, purchased, atau 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;
}

Membuat kueri produk di app/lib/logic/dash_purchases.dart

loadPurchases() pertama-tama memverifikasi bahwa toko yang mendasarinya dapat dijangkau dengan iapConnection.isAvailable(), lalu mengkueri tiga ID produk yang ditentukan di 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();
  }

Memulai dan menyelesaikan pembelian

Saat pengguna mengetuk produk di PurchasePage, buy() akan membuat PurchaseParam dan mengirimkan item habis pakai ke buyConsumable dan upgrade atau langganan sekali beli ke 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',
        );
    }
  }

Saat Play Store memunculkan objek PurchaseDetails yang diperbarui di purchaseStream, _handlePurchase akan memberikan reward yang sesuai dan mengonfirmasi penyelesaian dengan memanggil 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);
    }
  }

Menjalankan dan menguji aplikasi

Jalankan flutter test di app/ dan luncurkan aplikasi di perangkat pengujian yang telah dikonfigurasi. Saat produk toko Anda aktif, tab Pembelian akan menampilkannya dan siap dibeli:

Tab Pembelian Dash Clicker menampilkan tiga produk toko yang dimuat dari toko

9. Siapkan backend

Sebelum memverifikasi dan melacak pembelian di server, Anda akan membuat scaffold layanan backend Dart di dart-backend/ bersama app/ dan mengonfigurasi kredensial untuk Firebase, Google Play, dan App Store.

Meminta Antigravity untuk membuat scaffold backend Dart

Di panel Percakapan agen Antigravity, kirim perintah berikut untuk membuat project 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)`.

Memahami kode yang dihasilkan

  • dart-backend/bin/server.dart melakukan inisialisasi shelf_router Router dan menyajikan permintaan HTTP di port 8080 menggunakan serveHandler di dart-backend/lib/helpers.dart.
  • dart-backend/lib/products.dart memetakan setiap ID produk (dash_consumable_2k, dash_upgrade_3d, dan dash_subscription_doubler) ke ProductType-nya (nonSubscription atau subscription).
  • dart-backend/lib/iap_repository.dart mengenkapsulasi pembacaan dan penulisan dokumen NonSubscriptionPurchase dan SubscriptionPurchase dalam koleksi purchases Cloud Firestore menggunakan FirestoreApi.

Anda dapat menguji apakah server dimulai secara lokal dengan menjalankan:

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

Menyiapkan akses Firebase

Untuk mengizinkan dart-backend/ menulis pembelian terverifikasi ke Cloud Firestore, buat kunci akun layanan:

  1. Di Firebase console, buka Setelan project > Akun layanan, lalu klik Buat kunci pribadi baru.Tab Akun layanan di setelan project Firebase yang menampilkan Buat kunci pribadi baru
  2. Simpan file JSON yang didownload sebagai dart-backend/assets/service-account-firebase.json.

Menyiapkan akses Google Play

Agar dart-backend/ dapat memverifikasi pembelian Android dengan Google Play Android Developer API:

  1. Buka halaman Google Play Android Developer API di Konsol Google Cloud dan aktifkan API.Halaman Konsol Google Cloud untuk Google Play Android Developer API
  2. Buka halaman Akun layanan Google Cloud dan klik + Create service account.Halaman Service accounts di Konsol Google Cloud yang menampilkan Create service account
  3. Masukkan nama akun layanan, lalu klik Create and continue.Langkah detail akun layanan
  4. Berikan peran Pub/Sub Subscriber, lalu klik Done.Langkah Grant this service account access to project yang menampilkan peran Pub/Sub Subscriber
  5. Buka menu tindakan akun layanan yang baru dibuat, lalu pilih Manage keys.Menu tindakan akun layanan yang menandai Kelola kunci
  6. Pilih Add key > Create new key, pilih JSON, lalu download kuncinya:Menu Tambahkan kunci yang menampilkan Buat kunci baruDialog Buat kunci pribadi dengan JSON dipilih
  7. Simpan file yang didownload sebagai dart-backend/assets/service-account-google-play.json.
  8. Buka Pengguna dan izin di Konsol Google Play, klik Undang pengguna baru, lalu masukkan alamat email akun layanan:Halaman Pengguna dan izin Konsol Google PlayTabel akun layanan Google Cloud yang menampilkan alamat email akun layanan
  9. Berikan izin Melihat data keuangan serta Mengelola pesanan dan langganan untuk aplikasi Anda, lalu klik Undang pengguna.Tab izin aplikasi yang menampilkan Melihat data keuangan serta Mengelola pesanan dan langganan dicentang

Menyiapkan akses Apple App Store

Untuk memverifikasi tanda terima App Store di backend, buat Rahasia Bersama Khusus Aplikasi:

  1. Buka App Store Connect, pilih Apps, lalu pilih aplikasi Anda.
  2. Di sidebar, buka General > App Information.
  3. Di bagian App-Specific Shared Secret, klik Manage, buat rahasia bersama baru, dan salin:Bagian App-Specific Shared Secret di App Store ConnectModal Rahasia Bersama Khusus Aplikasi yang menampilkan rahasia yang dihasilkan

Perbarui dart-backend/lib/constants.dart

Pastikan konstanta berikut ditetapkan di dart-backend/lib/constants.dart:

  • androidPackageId: applicationId Android Anda (seperti com.example.dashclicker).
  • appStoreSharedSecret: Rahasia bersama App Store Connect Anda.
  • bundleId: ID paket iOS Anda (seperti com.example.dashclicker).

10. Memverifikasi pembelian

Saat pengguna menyelesaikan pembelian di iOS atau Android, toko akan menerbitkan token verifikasi (PurchaseDetails.verificationData.serverVerificationData). Daripada memercayai perangkat klien secara langsung, aplikasi Flutter mengirimkan token ini ke dart-backend/, yang memverifikasi token dengan Google Play atau App Store dan mencatat pembelian di Cloud Firestore.

Hierarki class PurchaseHandler yang diimplementasikan oleh GooglePlayPurchaseHandler dan AppStorePurchaseHandler

Meminta Antigravity untuk memverifikasi pembelian di klien dan backend

Kirim perintah berikut di Antigravity untuk menghubungkan aplikasi Flutter dan alur verifikasi backend 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.

Memahami kode yang dihasilkan

Membatasi pembelian dengan autentikasi dan memanggil /verifypurchase

Di app/lib/pages/purchase_page.dart, PurchasePage memeriksa FirebaseNotifier dan menampilkan LoginPage hingga pengguna login:

    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();
    }

Di app/lib/logic/dash_purchases.dart, _verifyPurchase memposting sumber app store (google_play atau app_store), productID, serverVerificationData, dan userId yang login ke backend Dart sebelum _handlePurchase memberikan reward dalam aplikasi:

  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;
    }
  }

Pemilihan rute dan pencocokan pola Dart 3 di dart-backend/bin/server.dart

Di server, POST /verifypurchase mendekode isi permintaan JSON dengan getPurchaseData menggunakan pola peta Dart 3 dan jenis nilai yang ditampilkan data, lalu mendelegasikan verifikasi ke pengendali penyimpanan yang cocok:

  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');
  }
}

Memverifikasi tanda terima Google Play dan App Store

  • Di dart-backend/lib/google_play_purchase_handler.dart, GooglePlayPurchaseHandler mengkueri androidPublisher.purchases.products.get untuk produk sekali beli dan androidPublisher.purchases.subscriptions.get untuk langganan, menghapus akhiran perpanjangan ..# dari ID pesanan langganan menggunakan extractOrderId, dan menulis NonSubscriptionPurchase atau SubscriptionPurchase yang dihasilkan ke Cloud Firestore menggunakan iapRepository.
  • Di dart-backend/lib/app_store_purchase_handler.dart, AppStorePurchaseHandler memanggil _iTunesAPI.verifyReceipt menggunakan paket app_store_server_sdk dan mempertahankan setiap tanda terima yang diverifikasi di response.latestReceiptInfo ke Cloud Firestore.

Menjalankan dan menguji backend

Mulai server backend dari dart-backend/:

cd dart-backend
dart run bin/server.dart

11. Memantau pembelian

Langganan dapat diperpanjang, berakhir, atau dibatalkan di luar aplikasi Anda. Pada langkah ini, Anda akan mengonfigurasi backend untuk melakukan polling update penagihan app store dari Google Cloud Pub/Sub dan App Store Server API, serta mengupdate klien Flutter untuk menyinkronkan hak aktif pengguna secara reaktif dari Cloud Firestore menggunakan IAPRepo.

Mengonfigurasi kunci API Cloud Pub/Sub dan App Store Server

Penyiapan Google Play Cloud Pub/Sub

  1. Tetapkan googleCloudProjectId di dart-backend/lib/constants.dart ke ID project Google Cloud dan Firebase Anda.
  2. Buka halaman Topik Cloud Pub/Sub di Konsol Google Cloud, pastikan project Anda dipilih, lalu klik + Create Topic.Halaman Topik Google Cloud Pub/Sub yang menampilkan tombol Create Topic
  3. Tetapkan Topic ID ke play_billing (cocok dengan googlePlayPubsubBillingTopic di dart-backend/lib/constants.dart, yang otomatis membuat langganan default play_billing-sub), lalu klik Create.Dialog Create a topic dengan Topic ID play_billing
  4. Buka menu tiga titik di topik play_billing Anda, lalu pilih Izin lihat.Menu topik Pub/Sub yang menandai izin lihat
  5. Klik Add principal, masukkan google-play-developer-notifications@system.gserviceaccount.com, tetapkan peran Pub/Sub Publisher, lalu klik Save.Panel Add principals yang memberikan Pub/Sub Publisher ke google-play-developer-notifications
  6. Salin nama topik lengkap, buka aplikasi Anda di Konsol Google Play, buka Monetisasi dengan Google Play > Penyiapan monetisasi, tempel nama topik, lalu klik Simpan perubahan.Penyiapan Monetisasi Konsol Google Play yang menampilkan nama topik Notifikasi developer real-time

Penyiapan kunci App Store Server API

  1. Login ke App Store Connect, lalu pilih Users and Access.
  2. Buka Integrations > Keys > Pembelian dalam Aplikasi, lalu klik tombol + untuk membuat kunci baru (misalnya, Codelab key).
  3. Download file kunci .p8 dan simpan sebagai dart-backend/assets/SubscriptionKey.p8.
  4. Salin Key ID dan Issuer ID ke appStoreKeyId dan appStoreIssuerId di dart-backend/lib/constants.dart.

Daftar kunci Pembelian Dalam Aplikasi App Store Connect yang menampilkan ID Penerbit dan ID Kunci

Meminta Antigravity untuk melakukan polling peristiwa penyimpanan dan menyinkronkan status klien

Kirim perintah berikut di 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.

Memahami kode yang dihasilkan

Melakukan polling Google Play Pub/Sub dan App Store Server API di backend

Di dart-backend/lib/google_play_purchase_handler.dart, _pullMessageFromPubSub melakukan polling pada langganan projects/$googleCloudProjectId/subscriptions/$googlePlayPubsubBillingTopic-sub setiap 10 detik, mendekode setiap payload notifikasi base64, menjalankan ulang handleSubscription atau handleNonSubscription untuk memperbarui Firestore, dan mengonfirmasi pesan menggunakan _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);
      }
    }
  }

Demikian pula, di dart-backend/lib/app_store_purchase_handler.dart, _pullStatus mengkueri appStoreServerAPI.getAllSubscriptionStatuses(purchase.orderId) setiap 10 detik dan memperbarui expiryDate dan SubscriptionStatus (active atau expired) setiap langganan di Cloud Firestore.

Menyinkronkan pembelian Firestore di perangkat

Di app/lib/repo/iap_repo.dart, IAPRepo memproses dokumen purchases pengguna yang diautentikasi di Cloud Firestore secara real time dan menghitung hasActiveSubscription dan 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();
    });

Setiap kali IAPRepo memberi tahu pemrosesnya, DashPurchases.purchasesUpdate() di app/lib/logic/dash_purchases.dart akan mengaktifkan atau menonaktifkan pengali klik 10x, mengalihkan _beautifiedDashUpgrade, dan memperbarui status produk yang ditampilkan di 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();
    }
  }

Menjalankan dan menguji aplikasi serta backend

Jalankan pengujian unit dan widget di kedua project untuk memastikan semuanya dianalisis dan lulus dengan baik:

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

12. Selamat

Selamat! Anda telah berkolaborasi dengan Google Antigravity untuk membangun integrasi pembelian dalam aplikasi full-stack di Flutter dengan backend verifikasi Dart.

Yang telah Anda bangun

  • Mengonfigurasi produk habis pakai (dash_consumable_2k), tidak habis pakai (dash_upgrade_3d), dan langganan yang diperpanjang otomatis (dash_subscription_doubler) di App Store Connect dan Konsol Google Play.
  • Menghubungkan aplikasi Dash Clicker Flutter (app/) ke plugin in_app_purchase, mengkueri detail produk, dan memproses purchaseStream.
  • Membangun backend shelf Dart (dart-backend/) yang memverifikasi token pembelian dengan Google Play Android Developer API dan App Store, melakukan polling update penagihan menggunakan Cloud Pub/Sub dan App Store Server API, serta mempertahankan status pembelian di Cloud Firestore.
  • Menyinkronkan hak pembelian terverifikasi kembali ke klien Flutter secara real time menggunakan IAPRepo.

Langkah berikutnya

  • Tambahkan middleware verifikasi token ID Firebase Auth ke POST /verifypurchase di dart-backend/bin/server.dart.
  • Men-deploy dart-backend/ ke Cloud Run dan mengonfigurasi webhook push untuk Google Cloud Pub/Sub dan App Store Server Notifications.

Pelajari lebih lanjut