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.
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.gitadresinden uygulamanıza Lottie ekleyin. .jsonformatında bir Lottie animasyonu hazırlayın ya da örnekstreak_ring.jsondosyası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:
- 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.
- 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.