İşletim sistemi güncellemeleri için Android Yükseltme Partisi

Yükseltme Partisi, Android kullanıcıları için büyük bir işletim sistemi yükseltmesi aldıklarında yeni özelliklerin vurgulandığı bir keşif akışıdır.

Büyük bir Android işletim sistemi yükseltmesi, kullanıcılarınız için pek de tatmin edici olmayan bir deneyim olabilir. Yükseltme Partisi akışı, kullanıcı katılımını 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 yükseltme yaptıktan sonra, kendilerini yeni işletim sistemine davet eden ve yeni özelliklerin yer aldığı kart akışını gösteren bir anında bildirim alır.

Android işletim sisteminiz için Yükseltme Partisini etkinleştirmek için Android Yükseltme Partisini etkinleştirme isteği formunu kullanarak kaydolun.

Yükseltme Partisi deneyimini özelleştirin

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

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

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

Yükseltme Partisini SDK ile tetikleyin

Varsayılan olarak Android işletim sistemi, kullanıcılara yükseltme yaptıkları anda en son özellikleri içeren bir kart akışını gösteren bir anında bildirim gönderir. Akışı kendi anlık bildiriminizden veya bir uygulamadan tetiklemeyi tercih ederseniz Android SDK'yı kullanın.

Önkoşullar

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

• minSdkVersion 14 veya üzeri
• compileSdkVersion 28 veya üzeri

Uygulamanızı yapılandırın

1. Kitaplığı sağlanan Zip dosyasından çıkarın ve deponuza yerleştirin.

2. Google Growth SDK bağımlılıklarını modülünüzün uygulama düzeyindeki Gradle dosyasına (normalde 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ılık 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 kullanın

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);
   

Ortaya çıkan UpgradePartyClient API işlevselliğini ortaya çıkarır.

Yükseltme Partisi İçin Uygundur

Task<Boolean> isEligibleForUpgradeParty();

Kullanıcının Yükseltme Partisine uygun olup olmadığını eşzamansız olarak doğrulayan bir Task nesnesi döndürür. Ortaya çıkan boole değeri kullanıcının uygun olup olmadığını gösterir.

çağrıUpgradeParty

Task<Void> invokeUpgradeParty();

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

Hatalar

com.google.android.gms.common.api.ApiException türü istisnası dışında her iki API yöntemi de başarısız olabilir. Bu gibi durumlarda arayanın daha sonra tekrar denemesi beklenir.

Beklenen ortak durum kodları şunları içerir:

• INTERNAL_ERROR : Temel mantığın akışındaki herhangi bir hatayı temsil eder.
• TIMEOUT : İsteğin zamanında yerine getirilemediği durumlarda gösterilir.
• API_NOT_CONNECTED : API'nin kullanılamadığı anlamına gelir (örneğin, UpgradeParty modülü henüz hazır değil).
• DEVELOPER_ERROR : Çağıran paketin UpgradeParty sınıfına erişmesine izin verilmediğinde gösterilir.

SDK örneği

SDK'yı çağıran bir uygulamanın aşağıdaki örneğine bakın:

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 edin

Kullanıcılarınızın Android işletim sistemini yükselttiklerinde gördükleri Yükseltme Partisi akışını test etmek için şu adımları izleyin:

1. Test Android cihazında Ayarlar > Google > Yükseltme Partisi hata ayıklaması'na gidin.
2. Rapor Yükseltme'yi ve ardından Yükseltme Partisini Aç'ı seçin. Bu, cihazın işletim sistemi sürümüne bağlı olarak 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.