OS güncellemeleri için Android Yükseltme Partisi

Yükseltme Partisi, Android kullanıcıları önemli bir işletim sistemi yükseltmesi yaptığında yeni özellikleri öne çıkaran bir keşif akışıdır.

Android işletim sisteminde yapılan büyük bir yükseltme, kullanıcılarınız için hayal kırıklığına uğratıcı bir deneyim olabilir. Yükseltme Partisi akışı, kullanıcı etkileşimini artırır ve kullanıcıların yeni yenilenen işletim sistemlerinde nasıl gezineceklerini anlamalarına yardımcı olur.

Kullanıcılar, en son işletim sistemi sürümüne geçtikten sonra, yeni işletim sistemine hoşlandıklarını ve yeni özelliklerin bulunduğu bir kart akışını gösteren bir push bildirimi alırlar.

Android OS'inizde Yükseltme Partisi'ni etkinleştirmek için Android Yükseltme Partisi'ni etkinleştirme isteği formunu kullanarak kaydolun.

Yükseltme Partisi deneyimini özelleştirme

Yükseltme Partisi deneyimini aşağıdaki yöntemlerle özelleştirebilirsiniz:

  • Alakasız özellikleri kaldırın.
  • Metin bloklarındaki dili güncelleyin.
  • Animasyonları, renkleri ve yazı tiplerini markanıza uyacak şekilde değiştirin.

Akışınızı özelleştirmek için Yükseltme Partisi Stil Kılavuzu'ndaki yönergeleri inceleyin ve özelleştirme bilgilerinizi Android Yükseltme Partisi'ni etkinleştirme isteği formuna ekleyin.

Yükseltme Davet Stil Kılavuzu

Yükseltme daveti görünümünü kendi markanıza (ekranlar, renkler, yazı tipleri) uyacak şekilde değiştirmek için bu stil kılavuzunu kullanın. Boyutları ve yapıyı orijinal tasarıma yakın tutmanızı önemle tavsiye ederiz.

Yeni Sürüme Geçiş Daveti akışı aşağıdaki üç bileşeni içerir:

  • Giriş ekranı
  • Özellik ekranı
  • Kapanış ekranı
Şekil 1. Yükseltme daveti akışında üç ekran türü

Ekrandaki animasyonlar her özelliğin açıklanmasına yardımcı olur.

Giriş ekranı

Tanıtım ekranında, kullanıcıyı karşılayan ve tanıtım ekranında gösterilen akışı başlatmaya teşvik eden kısa bir animasyon bulunur.

Düzen
Şekil 2. Yükseltme daveti giriş ekranı için taslak düzen

Cihaz animasyonu her zaman şunları içerir:

  • Beyaz arka plan ve renkli şekiller
  • Cihaz çerçevesi
  • Kullanıcı arayüzü içeriği
Stil

Material You stilini kullanmayı seçerseniz örnekte gösterilen varsayılan renkleri ve şekilleri kullanabilirsiniz.

Şekil 3. Daveti Yükseltme akışı için varsayılan renk şeması.

Kendi marka renginizi kullanıyorsanız bu rengin kullanıcı arayüzü arka planıyla uyumlu olduğundan emin olun.

Hareket

1. Seçenek: Ana ekranda saat var

  1. Ekrana sayılar girilir.
  2. Sayılar, boyutları küçülürken merkeze doğru hareket eder. Cep telefonu çerçevesi görünür.
  3. Telefonun boyutu küçülür. Şekiller ekrana girmeye başlar.
  4. Animasyon tamamlandı. Şekiller yavaşça hareket etmeye devam eder.
Şekil 4. Saatli Yükseltme Daveti giriş ekranı animasyonu için tel çerçeve düzeni.
Şekil 5. Saat içeren giriş ekranı animasyonu örneği.

2. Seçenek: Ana ekranda saat yok

  1. Cep telefonu ekrana girer.
  2. Telefon, boyutu büyüdükçe ortaya doğru hareket eder. Şekiller ekrana girmeye başlar.
  3. Telefon maksimum boyuta ulaşır ve şekiller hareket etmeye devam eder.
Şekil 6. Yükseltme daveti giriş ekranı animasyonu için saat içermeyen şematik düzen.
Şekil 7. Saat içermeyen giriş ekranı animasyonu örneği.

Özellik ekranı

Her özellik ekranında, yeni işletim sistemindeki bir özellik vurgulanır.

Düzen
Şekil 8. Yükseltme Daveti özellik ekranları için şema düzeni.

Cihaz animasyonu her zaman şunları içerir:

  • Renkli arka plan
  • Cihaz çerçevesi
  • Kullanıcı arayüzü içeriği
Stil
  • Kullanıcı arayüzü içeriği ve genel görünümle uyumlu bir arka plan rengi seçin.
  • Ekranlarda, kolayca okunabilen yazı tipi boyutları ayarlayın. Gerekirse daha büyük yazı tipi boyutları ayarlayın.
Hareket

Dokunma etkileşimleri de dahil olmak üzere her özelliğin akışının animasyonunu kaydedebilir. Kayıtları Lottie dosyaları olarak dışa aktarın.

Kapanış ekranı

Kapanış ekranı akışı tamamlar. Kullanıcılara tüm ekranları tamamladıklarını gösterir.

Düzen
Şekil 9. "Daveti yükselt" kapanış ekranı için tel çerçeve düzeni.

Cihaz animasyonu her zaman şunlardan oluşur:

  • Arka planda yarım daire (ve animasyonlu şekiller)
  • Cihaz çerçevesi
  • Kullanıcı arayüzü içeriği
Stil
  • Kullanıcı arayüzü içeriğiyle ve genel görünümüyle uyumlu bir arka plan rengi seçin.
  • Yarım daire şekli kullanın.
Hareket

Standart kapanış ekranı animasyon akışını uygulayın:

  1. Cep telefonu biraz yukarı hareket eder.
  2. Arka planda bir daire görünür.
  3. Şekiller cep telefonunun arkasından çıkıyor.
  4. Şekiller arka plandan konfeti gibi uçuyor.
Şekil 10. Yükseltme daveti son ekran animasyonu için taslak düzen.
Şekil 11. Örnek kapanış ekranı animasyonu.

SDK ile Yükseltme Partisi'ni tetikleme

Android OS, varsayılan olarak kullanıcılara güncellemeyi yaptıktan hemen sonra en son özellikleri içeren bir kart akışı gösteren bir push bildirimi gönderir. Akışları kendi push bildiriminizden veya bir uygulamadan tetiklemeyi tercih ediyorsanız Android SDK'sını kullanın.

Ön koşullar

Uygulamanızın derleme dosyasının aşağıdaki değerleri kullandığından emin olun:

  • 14 veya daha yeni bir sürümün minSdkVersion
  • compileSdkVersion/28 veya üzeri

Uygulamanızı yapılandırma

  1. Kitaplığı, sağlanan Zip dosyasından çıkarın ve deponuza yerleştirin.
  2. Google Growth SDK'sına ait bağımlılıkları, modülünüzün uygulama düzeyindeki Gradle dosyasına (genellikle app/build.gradle) ekleyin:

     dependencies {
         implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar')
     }
    
  3. Aşağıdaki kitaplıkları bağımlı olarak ekleyin:

    com.google.android.gms:play-services-base:18.0.1
    com.google.android.gms:play-services-basement:18.0.0
    com.google.android.gms:play-services-tasks:18.0.1
    

API'yi kullanma

  1. Bir istemciyi başlatmak için UpgradeParty sınıfını kullanın ve activity parametresini ayarlayın.

     import com.google.android.gms.growth.UpgradeParty;
     UpgradeParty.getClient(activity);
    

Elde edilen UpgradePartyClient, API işlevini gösterir.

Yükseltme Tarafı İçin Uygun

Task<Boolean> isEligibleForUpgradeParty();

Kullanıcının bir Yükseltme Tarafı için uygun olup olmadığını eşzamansız olarak doğrulayan bir Task nesnesi döndürür. Elde edilen boole değeri, kullanıcının uygun olup olmadığını belirtir.

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

Yükseltme Partisi Activity çağrılır. Ortaya çıkan Task nesnesi, etkinlik başlatılırken bir hata oluşup oluşmadığını gösterir.

Hatalar

Her iki API yöntemi de com.google.android.gms.common.api.ApiException türündeki bir istisnayla başarısız olabilir. Bu tür durumlarda arayan kişinin daha sonra yeniden denemesi beklenir.

Yaygın olarak karşılaşılan durum kodları şunlardır:

  • INTERNAL_ERROR: Temel mantık akışındaki hataları temsil eder.
  • TIMEOUT: İstek zamanında ele alınamadığında gösterilir.
  • API_NOT_CONNECTED: API'nin kullanılamadığını gösterir (örneğin, UpgradeParty modülü henüz hazır değildir).
  • DEVELOPER_ERROR: Arayan paketin UpgradeParty sınıfına erişmesine izin verilmediğinde gösterilir.

SDK örneği

SDK'yı çağıran bir uygulama örneğini aşağıda bulabilirsiniz:

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import com.google.android.gms.growth.UpgradeParty;
import com.google.android.gms.growth.UpgradePartyClient;

public class SampleActivity extends Activity {

 @Override
 protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   final UpgradePartyClient client = UpgradeParty.getClient(this);

   // Hide the invocation button initially
   View startUpgradePartyButton = findViewById(R.id.__some_button__);
   startUpgradePartyButton.setVisibility(View.GONE);

   // Register an onClick handler to invoke the Upgrade Party Activity
   startUpgradePartyButton
       .setOnClickListener(
           view -> {
             client
                 .invokeUpgradeParty()
                 .addOnCompleteListener(
                     task -> {
                       if (!task.isSuccessful()) {
                         // Do something with error, see task.getException()
                       }
                     });
           });
   }

   // Check if eligible for an Upgrade Party
   client
       .isEligibleForUpgradeParty()
       .addOnCompleteListener(
           task -> {
             if (!task.isSuccessful()) {
               // Do something with error, see task.getException()
             } else {
                  // Show/Hide invocation button, based on the result
                  int visibility =
                        task.getResult() ? View.VISIBLE : View.GONE;
                  startUpgradePartyButton..setVisibility(visibility);
             }
           });
   }

Yükseltme Partisi akışını test etme

Kullanıcılarınızın Android OS'i yükselttiğinde gördüğü Yükseltme Partisi akışını test etmek için aşağıdaki adımları uygulayın:

  1. Test amaçlı Android cihazda Ayarlar > Google > Yükseltme Partisi hata ayıklama'ya gidin.
  2. Yükseltme Bildir'i ve ardından Yükseltme Partisini Aç'ı seçin. Bu işlem, cihazın işletim sistemi sürümüne göre ilgili akışı başlatır. Örneğin, Android 12 Yükseltme Partisi, Android 12 işletim sistemini çalıştıran bir cihazda oynatılır.