Remote Config ile minimum uygulama sürümünü zorunlu kılma

Uygulamanız geliştikçe yeni sürümler, arka uç API'lerinde önemli değişiklikler yapabilir, kritik güvenlik açıklarını giderebilir veya desteği sonlandırılan hizmetlerin ve yapay zeka modellerinin yerini alabilir. Bu durumlarda, önceki uygulama sürümleri güvenilir veya güvenli bir şekilde çalışmayı durdurabilir.

Remote Config kullanarak uygulama sürümü şartlarını buluttan dinamik olarak kontrol edebilirsiniz. Remote Config içinde sürüm parametrelerini tanımlayarak özel sunucu altyapısı dağıtmadan veya acil durum güncellemesi yayınlamadan kullanıcıları uygulamalarını güncellemeye yönlendirebilir ya da güncellemelerini zorunlu kılabilirsiniz.

Güncelleme stratejisi seçme

Remote Config, istemcide değerlendirilecek sürüm parametrelerini sağlar. Bu sayede, değişikliğin önemine bağlı olarak uygulamanızın güncelleme kullanıcı arayüzünü iki stratejiden biri için yapılandırabilirsiniz:

  • Zorunlu (engelleyici) güncelleme: Uygulamanın eski bir sürümü arka uçunuzla uyumlu değilse veya güvenlik riski oluşturuyorsa kullanıcı güncelleyene kadar uygulamaya erişimi engelleyebilirsiniz. Yüklü sürüm, gerekli minimum sürümden daha eski olduğunda uygulamanızı, kullanıcıyı en son sürümü yüklemek için platform uygulama mağazasına yönlendiren kapatılamayan bir iletişim kutusu gösterecek şekilde yapılandırabilirsiniz.
  • Esnek (isteğe bağlı) güncelleme: Bir güncelleme yeni özellikler, performans iyileştirmeleri veya küçük hata düzeltmeleri içeriyorsa uygulamanızı, kullanıcıların uygulamayı kullanmaya devam etmesine izin verirken uygun oldukları zaman güncelleme yapmalarını teşvik eden, kapatılabilir bir banner veya istem gösterecek şekilde yapılandırabilirsiniz.

1. adım: Firebase konsolunda parametreleri yapılandırın

Uygulama sürümlerini yönetmek için Remote Config şablonunuzda parametreler tanımlayın:

  1. Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Parameters (Parametreler) sayfasına gidin.
  2. Parametre ekle'yi (veya bu ilk parametrenizse Yapılandırma oluştur'u) tıklayın.
  3. Aşağıdaki parametreleri tanımlayın:
    • minimum_version: Uygulamanızın desteklenen en eski sürümünü temsil eden bir dize (örneğin, "2.4.0"). Bu değerden daha eski bir sürümde çalışan uygulamalar, güncellenene kadar engellenir.
    • latest_version (isteğe bağlı): Uygulamanızın mevcut en son sürümünü temsil eden bir dize (örneğin, "2.5.1"). minimum_version ile latest_version arasında bir sürüm çalıştıran uygulamalar isteğe bağlı bir güncelleme önerisi gösterebilir.
    • update_url (isteğe bağlı): Kullanıcıların güncellemeyi indirebileceği mağaza URL'si (ör. Google Play Store veya Apple App Store girişiniz).
  4. İsteğe bağlı: Platforma özel koşullar ekleyin:
    • Android ve Apple uygulamaları genellikle farklı yayın sürümleri ve mağaza URL'leri kullandığından aynı parametre altında her platform için koşullu değerler ekleyebilirsiniz.
    • Koşul için değer ekle > Koşul oluştur'u tıklayın. Koşulu adlandırın (ör. Android App veya iOS App), hedefleme kuralı olarak Uygulama'yı seçin ve uygulamanızı belirleyin.
    • Her platform koşulu için uygun sürüm dizesini ayarlayın ve varsayılan değeri yedek olarak tutun.
  5. Şablonu uygulamak için Kaydet'i ve ardından Değişiklikleri yayınla'yı tıklayın.

2. adım: İstemci tarafı sürüm kontrollerini uygulayın

İstemcide, başlangıç sırasında Remote Config parametrelerine göre yüklü uygulama sürümünü kontrol edin:

  1. Uygulama içi varsayılan değerleri ayarlama: Uygulama paketinize her zaman güvenli uygulama içi varsayılan değerler sağlayın (örneğin, minimum_version değerini ilk uygulama sürümünüze, örneğin "1.0.0" olarak ayarlayın). Bu yedek yapılandırma, cihaz çevrimdışıysa veya ilk getirme isteği başarısız olursa uygulamanızın normal şekilde çalışmaya devam etmesini sağlar. Platforma özel yönergeler için Remote Config şablon varsayılanlarını indirme başlıklı makaleyi inceleyin.
  2. Remote Config değerlerini getirin ve etkinleştirin: Uygulamanız başladığında en son şablon değerlerini getirin ve etkinleştirin.
  3. Sürümleri karşılaştırma: Etkin minimum_version ve latest_version dizelerini alıp şu anda yüklü olan uygulama sürümüyle karşılaştırın.

  4. Sürüm karşılaştırmasına göre harekete geçin:

    • Gerekli güncellemeyi zorunlu kılma: current_version, minimum_version tarihinden önceyse tam ekran ve kapatılamayan bir modal uyarı gösterin. Uygulamanın geri kalanına gitmeyi devre dışı bırakın ve platform uygulama mağazasında update_url açan bir düğme sağlayın.
    • İsteğe bağlı güncellemeyi isteme: current_version, latest_version tarihinden önceyse kullanıcıların güncelleme olduğunu bilmesini sağlayan, kapatılabilir bir iletişim kutusu veya bildirim gösterin. Bu iletişim kutusunda ya da bildirimde Şimdi güncelle veya Daha sonra seçenekleri yer almalıdır.
    • Erişime izin ver: Aksi takdirde, kullanıcının uygulamaya devam etmesine izin verin.

En iyi uygulamalar

  • Anlık dinleyici ekleme: Güvenlik sorunları veya ciddi kullanıcı deneyimi bozulması nedeniyle sürüm güncellemeleri gerektiğinde uygulamanıza anlık Remote Config dinleyici eklemek, sürüm gereksinimi değişikliklerinin bir sonraki planlanmış getirme veya uygulama yeniden başlatma işlemi beklenmeden etkin cihazlarda hemen geçerli olmasını sağlayabilir.
  • Sınırlı bir test grubuyla test etme: minimum_version üretimdeki tüm kullanıcılar için yükseltmeden önce koşulu sınırlı bir test grubuyla test edin veya özel kullanıcı özelliklerini kullanarak şirket içi test kullanıcılarını hedefleyin. Bu test, engelleme kalıcı öğesinin doğru şekilde gösterildiğini ve mağaza bağlantılarının düzgün şekilde çözümlendiğini doğrular.
  • Platform içi uygulama güncelleme API'lerini kullanın: Android'de, kullanıcıların uygulamanızdan ayrılmadan güncellemeleri indirip yüklemesine olanak tanımak için Remote Config kontrollerinizin yanı sıra Google Play içi uygulama güncellemelerini entegre etmeyi düşünebilirsiniz.
  • Üretime hazırlık kontrol listelerini okuyun: Uygulamanızı ve yapay zeka özelliklerinizi üretime hazırlama konusunda daha fazla bilgi edinmek için Firebase lansman kontrol listesini ve AI Logic üretime hazırlık kontrol listesini okuyun.