Kullanıcı ilerlemesini Lottie animasyonuyla göster

Kullanıcının ilerlemesini Lottie animasyonu olarak görüntülemek için bu tarifi izle — örneğin, günlük serilerini belirtmek için dolup taşan bir halka. Uygulamanız animasyonu, bir özel element içinde yerel bir Lottie görünümü olarak render eder.

Tip

Bu tarif yalnızca iOS uygulamalarını kapsar. Diğer framework’lerle oluşturulan uygulamalar, özel öğelerin yalnızca yedek içeriğini görüntüler. Android ve çapraz platform framework desteği yakında geliyor.

Başlamadan önce

  • Uygulamanızı Adapty iOS SDK 4.4 veya sonraki bir sürüme güncelleyin. Daha eski SDK sürümleri, her özel öğe için yedek içeriği gösterir.
  • Uygulamanızı flow’ları çekecek ve gösterecek şekilde ayarlayın.
  • Swift Package Manager aracılığıyla https://github.com/airbnb/lottie-spm.git adresinden uygulamanıza Lottie ekleyin.
  • .json formatında bir Lottie animasyonu hazırlayın ya da örnek streak_ring.json dosyasını indirin. Uygulama, animasyonu baştan oynatır ve ilerlemeyle orantılı olarak durdurur; örneğin %50 için animasyonun yarısında durur. Tam ilerlemeyi göstermek için animasyonun şu özelliklere sahip olması gerekir:
    • İlk karede hiç ilerleme olmamalı, son karede ise tam ilerleme gösterilmeli.
    • Hız sabit olmalı, easing (yumuşatma) bulunmamalı. Animasyon yavaş başlayıp hızlanıyorsa, yarı yolda gerçek ilerlemenin yarısından daha azını gösterir.

1. Özel öğeyi ekrana ekleyin

Flow & Paywall Builder’da bir flow ekranına özel öğe ekleyin ve animasyon için ayarlayın:

  • Type: lottie_animation.
  • ID: streak_ring. Bu tarifde ID, aynı zamanda animasyon dosyasının adıdır.
  • Height: Varsayılan Fixed yüksekliği koruyun. Animasyon, özel öğeye sığacak şekilde ölçeklenir.

Özel elementin içine, yüzüğün durağan bir görüntüsüyle bir Image ekleyin. Uygulamanızın eski sürümlerini kullanan kullanıcılar, animasyonu oynatamadığında bunu yedek olarak görür.

2. Animasyon dosyasını uygulamanıza ekleyin

Xcode’da, animasyon dosyasını uygulama hedefinize ekleyin. .json uzantısı olmadan dosya adı, özel öğenin ID’siyle eşleşmelidir; örneğin streak_ring için streak_ring.json.

3. Animasyon görünümünü oluşturun

Streak için bir model ve animasyonu oynatacak bir SwiftUI görünümü oluşturun. Uygulamanız streak değiştiğinde modeli günceller. Görünüm modeli okur, bu sayede ekran açıldığında halka mevcut streak’i gösterir:

.playing(.fromProgress(0, toProgress: progress, loopMode: .playOnce)) halkayı bir kez, boştan progress değerine kadar doldurur. Uygulamanız streak’i zaten bir ObservableObject içinde tutuyorsa, StreakStore yerine o nesneyi kullanabilirsiniz.

4. Animasyonu özel öğeyle eşleştirin

Uygulama genelindeki resolver’ınıza streak modeli için bir property ekleyin. Ardından lottie_animation Türü ve streak_ring ID’si için StreakRingView döndüren bir case ekleyin. Vurgulanan satırlar eklemeniz gerekenleri gösteriyor. Uygulamanızda henüz uygulama genelinde bir resolver yoksa kodun tamamını kopyalayabilirsiniz:

streak_ring case’ini diğer tüm lottie_animation case’lerinden önce yerleştirin; çünkü Swift yalnızca eşleşen ilk case’i çalıştırır. Uygulama bundle’ında ilgili ID için bir dosya yoksa, resolver nil döndürür ve kullanıcılar yedek içeriği görür.

Resolver’ı streak modeliyle oluşturun ve uygulama genelinde geçerli resolver olarak ayarlayın. AdaptyUI.setCustomElementsResolver(_:) fonksiyonunu, örneğin uygulama başlangıcında, yalnızca bir kez çağırın:

5. Cihazda Test Edin

Flow & Paywall Builder, uygulama kodunuzu çalıştıramadığı için tuval yalnızca yedek görseli gösterir. Animasyonu önizlemek için:

  1. Flow’u yayınlayın. Önbelleğe alınmış sürüm yerine en son yayınlanan sürümü görmek için cihazı bir test cihazı olarak kaydedin.
  2. Resolver’ı içeren uygulamanızın bir derlemesini çalıştırın. Streak’i 0, 4 ve 7 gün gibi birkaç farklı değere ayarlayın. Her değer için ekranı açın ve halkanın o değere kadar dolduğunu doğrulayın.

Yedek görseli test etmek için animasyon dosyasını derlemeden kaldırın ve ekranı yeniden açın.

Yedek içeriğin animasyon yerine neden göründüğünü anlamak için iOS kılavuzunun Cihazda test etme bölümündeki talimatları izleyin.