Adapty'yi Flutter uygulamanıza yapay zeka yardımıyla entegre edin

Bu sayfa, Adapty’yi Flutter uygulamanıza entegre etmenin iki yolunu ele almaktadır. Otomatik uçtan uca akış için aşağıdaki SDK entegrasyon becerisini kullanın ya da daha aşağıdaki adım adım kılavuzu takip edin.

SDK entegrasyon becerisini kullanın (beta)

adapty-sdk-integration skill, entegrasyon sürecini baştan sona otomatikleştirir: kontrol paneli kurulumu, SDK yükleme, paywall ve her aşama için doğrulama. Araçınız Claude Skills formatını desteklemiyorsa, aşağıdaki manuel adım adım rehberi yedek olarak kullanabilirsiniz.

Desteklenen araçlar: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.

Kurulum

Aracınıza uygun formu seçin. Tam liste skill README sayfasındadır.

  • Claude Code: Kabuğunuzdan claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill ardından claude plugin install adapty-sdk-integration@adapty komutunu çalıştırın.
  • GitHub Copilot CLI: gh skill install adaptyteam/adapty-sdk-integration-skill komutunu çalıştırın.
  • Gemini CLI: gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill komutunu çalıştırın.
  • OpenAI Codex veya başka bir araç: Repoyu klonlayın ve plugins/adapty-sdk-integration/skills/adapty-sdk-integration/ dizinini aracınızın skills klasörüne kopyalayın.

Çalıştırma

Projenizde /adapty-sdk-integration komutunu çalıştırın. Skill, platformunuzu otomatik olarak algılar ve birkaç kurulum sorusu sorar. Ardından kontrol paneli kurulumu, SDK yüklemesi, paywall ve doğrulama aşamalarını tek tek ele alır; her aşamada ilgili Adapty dokümanlarını getirir.

Skill beta aşamasındadır. Takılı kalır ya da beklenmedik şekilde davranırsa, aşağıdaki manuel rehber her aşamayı adım adım kapsamaktadır.

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce bazı kontrol paneli ayarlarının yapılmasını gerektirir. Bunu etkileşimli bir LLM aracıyla ya da Kontrol Paneli üzerinden manuel olarak yapabilirsiniz.

Adapty CLI skill’i, LLM’inizin uygulamanızı, ürünlerinizi, access level’larınızı, paywall’larınızı ve placement’larınızı doğrudan kurmasını sağlar — her adım için kontrol panelini açmanıza gerek kalmaz. Yalnızca kontrol panelinde mağazalarınızı bağlamanız gerekir.

npx skills add adaptyteam/adapty-cli --skill adapty-cli

Skill eklendikten sonra, agent’ınızda /adapty-cli komutunu çalıştırın. Mağazalarınızı bağlamak için kontrol panelini ne zaman açmanız gerektiği dahil her adımda sizi yönlendirecektir.

Kontrol paneli yaklaşımı

Her şeyi manuel olarak yapılandırmayı tercih ediyorsanız, herhangi bir kod yazmadan önce ihtiyacınız olanlar burada. LLM’niz kontrol paneli değerlerini sizin için arayamaz — bunları kendiniz sağlamanız gerekecek.

  1. Uygulama mağazalarınızı bağlayın: Adapty Kontrol Paneli’nde App settings → General bölümüne gidin. Flutter uygulamanız her iki platformu da hedefliyorsa hem App Store’u hem de Google Play’i bağlayın. Bu, satın alma işlemlerinin çalışması için zorunludur. Uygulama mağazalarını bağlayın

  2. Genel SDK anahtarınızı kopyalayın: Adapty Kontrol Paneli’nde App settings → General bölümüne gidin ve API keys kısmını bulun. Kodda bu, Adapty yapılandırmasına geçirdiğiniz metindir.

  3. En az bir ürün oluşturun: Adapty Kontrol Paneli’nde Products sayfasına gidin. Ürünlere kodda doğrudan başvurmazsınız — Adapty onları paywall’lar aracılığıyla iletir. Ürün ekle

  4. Bir paywall ve placement oluşturun: Adapty Kontrol Paneli’nde Paywalls sayfasında bir paywall oluşturun, ardından Placements sayfasında bir placement’a atayın. Kodda, placement ID’si Adapty().getPaywall() fonksiyonuna geçirdiğiniz string’dir. Paywall oluşturun

  5. Access level’ları ayarlayın: Adapty Kontrol Paneli’nde, Products sayfasında her ürün için yapılandırın. Kodda, profile.accessLevels['premium']?.isActive içinde kontrol edilen string’e bakın. Varsayılan premium access level çoğu uygulama için yeterlidir. Ödeme yapan kullanıcılar ürüne göre farklı özelliklere erişiyorsa (örneğin basic plan ile pro plan), kodlamaya başlamadan önce ek access level’lar oluşturun.

Bu beşine sahip olduğunuzda kod yazmaya hazırsınız. LLM’inize şunu söyleyin: “Public SDK anahtarım X, placement ID’im Y” — böylece doğru başlatma ve paywall getirme kodunu üretebilir.

Hazır olduğunuzda kurulum

Kodlamaya başlamak için bunlar zorunlu değil, ancak entegrasyonunuz olgunlaştıkça ihtiyaç duyacaksınız:

  • A/B testleri: Placements sayfasında yapılandırın. Kod değişikliği gerekmez. A/B testleri
  • Ek paywall’lar ve placement’lar: Farklı placement ID’leriyle daha fazla getPaywall çağrısı ekleyin.
  • Analitik entegrasyonları: Integrations sayfasında yapılandırın. Kurulum entegrasyona göre değişir. Bkz. analitik entegrasyonları ve attribution entegrasyonları.

LLM’nize Adapty Dokümanlarını Besleyin

Context7, LLM’inize güncel Adapty belgelerine doğrudan erişim sağlayan bir MCP sunucusudur. LLM, ne sorduğunuza göre doğru belgeleri otomatik olarak getirir — URL yapıştırmaya gerek yok.

Context7; Cursor, Claude Code, Windsurf ve diğer MCP uyumlu araçlarla çalışır. Kurulum için şunu çalıştırın:

npx ctx7 setup

Bu komut editörünüzü algılar ve Context7 sunucusunu yapılandırır. Manuel kurulum için Context7 GitHub deposuna bakın. Yapılandırıldıktan sonra, Adapty kütüphanesine promptlarınızda başvurun:

Use the adaptyteam/adapty-docs library to look up how to install the Flutter SDK

Context7, doküman bağlantılarını manuel olarak yapıştırma ihtiyacını ortadan kaldırsa da uygulama sırası önemlidir. Her şeyin düzgün çalıştığından emin olmak için aşağıdaki uygulama adımlarını sırayla takip edin.

Düz metin doküman kullanımı

Adapty dokümanlarının herhangi birine düz metin Markdown olarak erişebilirsiniz. URL’nin sonuna .md ekleyin ya da makale başlığının altındaki Copy for LLM butonuna tıklayın. Örnek: adapty-cursor-flutter.md.

Aşağıdaki uygulama adım adım kılavuzundaki her aşama, yapıştırabileceğiniz .md bağlantılarıyla birlikte “Send this to your LLM” bloğu içerir.

Daha fazla dokümanı aynı anda görmek için aşağıdaki dizin dosyalarına ve platforma özgü alt kümelere bakın.

Uygulama adım adım rehberi

Bu rehberin geri kalanı, Adapty entegrasyonunu uygulama sırasına göre ele alır. Her aşamada LLM’inize gönderebileceğiniz belgeler, tamamlandığında görmeniz gerekenler ve sık karşılaşılan sorunlar yer alır.

Entegrasyonunuzu Planlayın

Koda geçmeden önce, LLM’inizden projenizi analiz etmesini ve bir uygulama planı oluşturmasını isteyin. AI aracınız bir planlama modunu destekliyorsa (Cursor veya Claude Code’un plan modu gibi), LLM’in herhangi bir kod yazmadan önce hem proje yapınızı hem de Adapty dokümanlarını okuyabilmesi için bu modu kullanın.

LLM’inize satın almalar için hangi yaklaşımı kullandığınızı söyleyin — bu, takip etmesi gereken kılavuzları etkiler:

  • Adapty Paywall Builder: Adapty’nin kodsuz oluşturucusunda paywall’lar oluşturursunuz; SDK bunları otomatik olarak render eder.
  • Manuel olarak oluşturulan paywall’lar: Kendi paywall arayüzünüzü kodla oluşturursunuz, ancak ürünleri getirmek ve satın alma işlemlerini yönetmek için yine Adapty’yi kullanırsınız.
  • Observer modu: Mevcut satın alma altyapınızı korur ve Adapty’yi yalnızca analitik ve entegrasyonlar için kullanırsınız.

Hangisini seçeceğinizden emin değil misiniz? Hızlı başlangıçtaki karşılaştırma tablosunu inceleyin.

SDK’yı Yükleyin ve Yapılandırın

flutter pub add komutunu kullanarak Adapty SDK bağımlılığını ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu temel adımdır — diğer hiçbir şey bunu yapmadan çalışmaz.

Rehber: Adapty SDK’yı Yükleyin ve Yapılandırın

Bunu LLM’inize gönderin:

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/sdk-installation-flutter.md

Checkpoint

  • Beklenen: Uygulama hem iOS hem Android’de derleniyor ve çalışıyor. Debug konsolunda Adapty aktivasyon logu görünüyor.
  • Dikkat: “Public API key is missing” → App settings kısmından aldığın gerçek anahtarı placeholder’ın yerine koyduğundan emin ol.

Paywall’ları göster ve satın almaları yönet

Bir paywall’ı placement ID ile çek, göster ve satın alma olaylarını yönet. İhtiyaç duyacağın kılavuzlar, satın almaları nasıl ele aldığına göre değişir.

Her satın almayı süreç içinde sandbox’ta test et — sonuna bırakma. Kurulum talimatları için Sandbox’ta satın alma testi sayfasına bak.

Abonelik durumunu kontrol etme

Bir satın alma işleminin ardından, premium içeriğe erişimi kısıtlamak için kullanıcı profilindeki aktif access level’ı kontrol edin.

Rehber: Abonelik durumunu kontrol etme

Bunu LLM’inize gönderin:

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/flutter-check-subscription-status.md

Kontrol noktası

  • Beklenen: Bir sandbox satın alma işleminin ardından profile.accessLevels['premium']?.isActive değeri true döner.
  • Dikkat: Satın alma sonrası accessLevels boş geliyor → kontrol panelinde ürüne bir access level atanıp atanmadığını kontrol edin.

Kullanıcıları tanımlayın

Uygulama kullanıcı hesaplarınızı Adapty profilleriyle ilişkilendirerek satın almaların cihazlar arasında kalıcı olmasını sağlayın.

Uygulamanızda kimlik doğrulama yoksa bu adımı atlayın.

Kılavuz: Kullanıcıları tanımlayın

Bunu LLM’inize gönderin:

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/flutter-quickstart-identify.md

Checkpoint

  • Beklenen: Adapty().identify() çağrısının ardından, kontrol panelindeki Profiles bölümünde özel kullanıcı ID’niz görünür.
  • Dikkat: Anonim profil attribution sorununu önlemek için identify fonksiyonunu aktivasyondan sonra, paywall’ları çekmeden önce çağırın.

Yayına hazırlanma

Entegrasyonunuz sandbox ortamında düzgün çalışıyorsa, her şeyin üretime hazır olduğundan emin olmak için yayın kontrol listesini gözden geçirin.

Kılavuz: Yayın kontrol listesi

Bunu LLM’inize gönderin:

Read these Adapty docs before releasing:
- https://adapty.io/docs/tr/release-checklist.md

Kontrol Noktası

  • Beklenen: Tüm kontrol listesi maddeleri onaylandı: mağaza bağlantıları, sunucu bildirimleri, satın alma akışı, access level kontrolleri ve gizlilik gereksinimleri.
  • Dikkat: Sunucu bildirimleri eksikse → App Store Server Notifications’ı App settings → iOS SDK bölümünde, Google Play Real-Time Developer Notifications’ı ise App settings → Android SDK bölümünde yapılandırın.

Düz metin belge dizin dosyaları

LLM’nize bireysel sayfaların ötesinde daha geniş bir bağlam sağlamanız gerekiyorsa, tüm Adapty belgelerini listeleyen veya birleştiren dizin dosyaları sunuyoruz:

  • llms.txt: .md bağlantılarıyla tüm sayfaları listeler. LLM’lerin web sitelerine erişimini kolaylaştırmak için gelişmekte olan bir standart. Bazı yapay zeka ajanlarında (ör. ChatGPT) llms.txt dosyasını indirip sohbete yüklemeniz gerekebilir.
  • llms-full.txt: Tüm Adapty dokümantasyon sitesini tek bir dosyada birleştirir. Oldukça büyük — yalnızca tam resme ihtiyaç duyduğunuzda kullanın.
  • Flutter’a özel flutter-llms.txt ve flutter-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.