Skip to main content
Tek bir React Native kod tabanı kullanarak Whop için yerel iOS, Android ve web deneyimleri oluşturun. Uygulamalarınız doğrudan Whop mobil uygulamasının içinde çalışır ve yerel platform özelliklerine erişebilir.

Nasıl çalışır

Whop, React Native uygulamalarını birden fazla platformda çalışan deneyimler olarak yerleştirir:
  • Mobil (iOS/Android): Uygulamalar, tam platform entegrasyonuyla Whop mobil uygulamasının içinde yerel olarak çalışır
  • Web: Uygulamalar, platforma özgü özellikler için otomatik yedeklerle tarayıcıda çalışır
  • Evrensel kod: Bir kez yazın, platforma özgü optimizasyonlarla her yerde dağıtın
Uygulamanız kimliği doğrulanmış kullanıcı bağlamını alır ve Whop SDK’sı aracılığıyla API çağrıları yapabilir. Derleme sistemi, mobil için Metro ve web için esbuild kullanarak platforma özgü paketlemeyi otomatik olarak yönetir.

Başlarken

Sistem gereksinimleri

Başlamadan önce sisteminizin aşağıdaki gereksinimleri karşıladığından emin olun: Kontrol etmek için node -v ve pnpm -v komutlarını çalıştırın.

Uygulamanızı oluşturun

CLI’ı kullanarak yeni bir Whop React Native uygulaması oluşturun:
Bu, aşağıdaki yapıya sahip yeni bir proje kurar:

Ortam değişkenlerini yapılandırın

Kök dizinde bir .env.local dosyası oluşturun:
Bu kimlik bilgilerini Whop Geliştirici Panosundan alın:
  1. Whop Geliştirici Panosuna gidin
  2. Yeni bir uygulama oluşturun veya mevcut bir uygulamayı seçin
  3. Ortam değişkenlerini uygulama ayarlarından kopyalayın

Görünümler

Proje yapısı
Whop uygulamaları, nerede görüntülendiklerine bağlı olarak farklı “görünümler” kullanır. Her görünüm, kimliği doğrulanmış bağlamı props olarak alır.

Deneyim görünümü

Deneyim uygulamaları için ana görünüm. Kullanıcılar uygulama içeriğinizle burada etkileşime girer.
Props:
  • experienceId - Deneyim kimliği
  • companyId - Bu deneyimin sahibi olan hesap
  • currentUserId - Kimliği doğrulanmış kullanıcı (oturum açılmamışsa null)
  • path - Dizi olarak gezinme yolu (ör. ["courses", "123"])
  • params - Nesne olarak sorgu parametreleri

Pano görünümü

Satıcıların işletmelerini yönettiği hesap panosu entegrasyonları için.
Props:
  • companyId - Hesap kimliği
  • currentUserId - Kimliği doğrulanmış kullanıcı
  • path - Dizi olarak gezinme yolu
  • params - Sorgu parametreleri

Keşfet görünümü (isteğe bağlı)

Kullanıcıların içeriğe göz attığı pazar yeri/keşif deneyimleri için.

Veri getirme

Whop SDK’sını kullanma

Bu örnek, kullanımdan kaldırılmış bir SDK arayüzü kullanır. Yerini alacak React Native SDK’sı yayınlandığında güncellenecektir.
Whop SDK’sı, istemci tarafında veri getirme için kutudan çıktığı gibi kullanılabilir:
TanStack Query, önbelleğe almayı, yükleme durumlarını ve yeniden getirmeyi otomatik olarak yönettiği için veri getirme açısından iyi bir seçimdir.
Bazı SDK işlemleri “yalnızca sunucu” işlemleridir ve API’nizden çağrılmalıdır. Hangi yöntemlerin sunucu tarafında yürütme gerektirdiğini öğrenmek için Hızlı başlangıç sayfasına bakın.

Kimliği doğrulanmış API istekleri yapma

Sunucu tarafı işlemler için API rotaları oluşturun ve bunları React Native uygulamanızdan çağırın:
1

API temel URL'nizi ayarlayın

API kaynağınızı geliştirici panosunda Base URL altında yapılandırın.
Temel URL
2

Bir API uç noktası oluşturun

SDK yapılandırması için Hızlı başlangıç sayfasına bakın.
3

React Native'den çağırın

Kimliği doğrulanmış istekler yapmak için apiOrigin kullanın:
Kimliği doğrulanmış istekler için apiOrigin kullanmak önemlidir. Bu, isteklerin uygun kimlik doğrulama başlıklarıyla Whop’un proxy’sinden geçmesini sağlar.

Örnek: Bir deneyime erişimi kontrol etme

Bu sunucu tarafı örnek, kullanımdan kaldırılmış bir SDK arayüzü kullanır. @whop/sdk ile güncel sunucu tarafı token doğrulaması için Kimlik doğrulama sayfasına bakın.

Stil

Renk temaları

React Native, cihazın renk şemasını algılamak için bir useColorScheme hook’u sağlar. Bu, Whop uygulamalarında otomatik olarak çalışır:

Radix UI renklerini kullanma

Otomatik karanlık mod içeren kapsamlı bir renk sistemi için useColors hook desenini Radix UI renkleriyle kullanın:
Kullanım:

Ekranlar arasında gezinmek ve modal pencereler göstermek için dahili gezinme API’lerini kullanın:
Whop, path ve params değerlerini görünüm bileşeninize props olarak iletir.

Geri dönün

Bir sayfa veya modal gösterin

Mevcut rotayı alın


Platforma özgü özellikler

Gezinme çubuğunun başlığını ve açıklamasını yapılandırın:

Ekran yönü

Ekran yönünü kontrol edin:

Dokunsal geri bildirim

Mobil cihazlarda dokunsal geri bildirim sağlayın:
Kullanılabilir dokunsal türler:
  • "selection" - Hafif seçim geri bildirimi
  • "impactLight" | "impactMedium" | "impactHeavy" - Darbe geri bildirimi
  • "notificationSuccess" | "notificationWarning" | "notificationError" - Bildirim geri bildirimi

Yerel önbellekleme

Verileri cihazda yerel olarak saklayın:

Ana uygulama ayrıntıları

Whop uygulaması hakkında bilgi alın:

Uygulama içi satın alımlar

Ödemeleri doğrudan uygulamanızın içinde kabul edin:
Ödeme kabul etmeye ilişkin eksiksiz bir kılavuz için Ödeme kabul etme dokümantasyonuna bakın.

Üçüncü taraf kitaplıkları kullanma

Çoğu React Native kitaplığı kutudan çıktığı gibi çalışır. Yaygın kitaplıklar için önerilen sürümler şunlardır:
Yeni kitaplıklar eklerken React Native ile uyumlu olduklarından emin olun. Bazı npm paketleri yalnızca web içindir ve mobil platformlarda çalışmaz.

Dağıtım

Derleme ve dağıtım

ship komutu uygulamanızı tüm platformlar için derler ve bir geliştirme derlemesi olarak yükler:
Belirli platformlar için derleyin:
ship komutu bir geliştirme derlemesi olarak dağıtır; bu, mevcut üretim uygulamalarında çalıştırmak için güvenlidir. Canlı kullanıcılarınızı etkilemez.

Geliştirme ve üretim derlemeleri

Geliştirme derlemeleri:
  • pnpm ship ile dağıtılır
  • Yalnızca Dev mode etkinleştirildiğinde görünür (telefonu sallayın)
  • Üretim kullanıcılarını etkilemeden test etmek güvenlidir
  • İstediğiniz zaman dağıtabilirsiniz
Üretim derlemeleri:
  • Pano üzerinden geliştirme derlemelerinden yükseltilir
  • Tüm kullanıcılara görünür
  • Onay/inceleme gerektirir
  • Yükseltmeden önce test edin

Uygulamanızı önizleyin

Bir geliştirme derlemesini dağıttıktan sonra cihazınızda önizleyin:
Bu, uygulamanızı yükleyen bir QR kodu oluşturur.
Geliştirme derlemelerini önizlemek için Whop uygulamasında Dev mode’u etkinleştirmek üzere telefonunuzu sallamanız gerekir. Bu, üretim dışı derlemeleri görmenizi sağlar.

Derleme komutları

Derlemeleri yönetmek için ek komutlar:

Üretime yükseltme

  1. Bir geliştirme derlemesi dağıtın: pnpm ship
  2. Dev mode içinde test edin (etkinleştirmek için sallayın)
  3. Uygulama panonuza gidin
  4. Builds sekmesine gidin
  5. Geliştirme derlemenizi seçin
  6. Promote to Production seçeneğini seçin
Üretime yükseltme
Whop uygulamanızı inceler ve onaydan sonra tüm kullanıcılara dağıtır.

Geri alma

Derlemeler ekranından ayrıca önceki bir üretim derlemesine anında geri dönebilir ve onu Whop genelindeki tüm kullanıcılar için canlıya alabilirsiniz.
Geri alma

Komut satırı arayüzü referansı

@whop/react-native CLI’ı, uygulamanızı derlemek ve dağıtmak için komutlar sağlar:

Komutlar

Derleme süreci

pnpm ship komutunu çalıştırdığınızda CLI:
  1. Giriş noktaları oluşturur - Görünümlerinizi kaydeden platforma özgü giriş dosyaları oluşturur
  2. Kodu paketler:
    • Mobil (iOS/Android): Metro paketleyici + Hermes bayt kodu derleyicisini kullanır
    • Web: React Native Web takma adlarıyla esbuild kullanır
  3. Varlıkları paketler - Görselleri ve diğer varlıkları toplar ve optimize eder
  4. Whop’a yükler - Uygulama panonuzda bir geliştirme derlemesi oluşturur
  5. Yükleme bağlantısı oluşturur - Test için QR kodu sağlar

Derleme çıktısı


Sorun giderme

Geliştirme derlemesi görünmüyor

Sorun: Bir geliştirme derlemesi dağıttınız ancak uygulamada göremiyorsunuz. Çözüm: Dev mode’u etkinleştirmek için telefonunuzu sallayın. Geliştirme derlemeleri yalnızca Dev mode etkin olduğunda görünür.

Derleme hataları

Sorun: Derleme Metro veya esbuild hatalarıyla başarısız oluyor. Çözümler:
  • Derleme önbelleğini temizlemek için pnpm clean çalıştırın
  • Tüm bağımlılıkları yüklediğinizi kontrol edin: pnpm install
  • Node.js sürümünü doğrulayın: node -v (22+ olmalı)
  • Görünümlerinizde söz dizimi hatalarını kontrol edin

Uygulama programlama arayüzü istekleri çalışmıyor

Sorun: API istekleri 401 veya kimlik doğrulama hataları döndürüyor. Çözümler:
  • __internal_execSync("getAppApiOrigin", {}) içinden gelen apiOrigin değerini kullandığınızı doğrulayın
  • .env.local dosyasının WHOP_API_KEY değerini ayarladığını kontrol edin
  • API uç noktanızın whopSdk.verifyUserToken(request.headers) çağırdığını doğrulayın
  • Panonun temel URL’yi doğru ayarladığını doğrulayın

Görünümler bulunamadı

Sorun: Derleme başarılı oluyor ancak görünümler oluşturulmuyor. Çözümler:
  • Görünüm dosyalarının src/views/ içinde bulunduğunu kontrol edin
  • Dışa aktarımların eşleştiğini doğrulayın: export function ExperienceView(props: ExperienceViewProps)
  • Görünüm dosyalarının .tsx veya .jsx ile bittiğinden emin olun

Kitaplıklar çalışmıyor

Sorun: Üçüncü taraf kitaplık mobilde çökmelere neden oluyor. Çözümler:
  • Kitaplığın React Native’i desteklediğini (yalnızca web’i değil) doğrulayın
  • Kitaplıkları kullanma bölümündeki önerilen sürümleri kullanın
  • Kitaplığın yerel modüller gerektirip gerektirmediğini kontrol edin (gerektiriyorsa ve önerilenler arasında değilse desteklenmez)

Platforma özgü sorunlar

Sorun: Uygulama bir platformda çalışıyor ancak diğerinde çalışmıyor. Çözümler:
  • Platformu algılamak ve yedekler sağlamak için Platform.OS kullanın
  • Üretime yükseltmeden önce tüm platformlarda test edin
  • Platforma özgü API’leri yanlış kullanıp kullanmadığınızı kontrol edin

Sonraki adımlar