Lisanslama Referansı

LVL Sınıfları ve Arayüzleri

Tablo 1'de, Lisans Doğrulama'daki tüm kaynak dosyalar listelenmektedir Kitaplık (LVL), Android SDK aracılığıyla kullanılabilir. Tüm dosyalar com.android.vending.licensing paketi.

Tablo 1. LVL kitaplığının özeti farklı türler yer alıyor.

Sunucu Yanıtı

Tablo 2'de, lisans yöneticisinin döndürdüğü tüm lisans yanıt alanları lisanslama sunucusuna geç.

Tablo 2. Lisans yanıt alanlarının özeti Google Play sunucusu tarafından döndürülür.

Sunucu Yanıt Kodları

Tablo 3'te, lisans lisansı tarafından desteklenen tüm lisans yanıt kodları lisanslama sunucusuna geç. Genel olarak, bir uygulama tüm bu yanıtları işlemelidir ekleyebilirsiniz. Varsayılan olarak LVL'deki LicenseValidator sınıfı gerekli işlemleri yapmanızı öneririz.

Tablo 3. Yanıt kodlarının özeti Google Play sunucusu tarafından bir lisans yanıtında döndürülür.

Not: bölümünde belirtildiği gibi Test Ortamı kurulurken yanıt kodu manuel olarak uygulama geliştirici ve kayıtlı test kullanıcıları için geçersiz kılmayı Google Play Console

Not: Önceden uygulamaları aşağıdaki ölçütlere göre test edebiliyordunuz: yayınlanmamış bir "taslak" yükleme sürümünü değil. Bu işlev artık devre dışı destekleniyor; bunun yerine alfa veya beta dağıtımına yayınlamanız gerekir. yardımcı olur. Daha fazla bilgi için Taslak Uygulamalar artık Desteklenmiyor.

Sunucu Yanıtı Ekstraları

Uygulamanızın geri ödemesi kapsamında uygulamaya erişimi yönetmesine yardımcı olmak için ve diğer bilgileri sağlamanız gerekir. Lisanslama sunucusu, lisans süreçlerinin ekleyebilirsiniz. Hizmet özellikle uygulamanın lisans geçerlilik süresi, yeniden deneme ek süresi, izin verilen maksimum yeniden deneme sayısı ve diğer Ayarlar'da devre dışı bırakabilirsiniz. Uygulamanız APK kullanıyorsa genişletme dosyalarını içeriyorsa yanıt; dosya adlarını, boyutlarını ve URL'leri de içerir. Sunucu, "extras" lisans yanıtındaki anahtar/değer çiftleri olarak ayarlar girin.

Herhangi bir Policy uygulaması, lisanstan ekstra ayarları çıkarabilir bunları gerektiği gibi kullanın. LVL varsayılan Policy uygulaması (ServerManagedPolicy), ve verilerin nasıl edinileceğini, saklanacağını ve kullanılacağını Ayarlar'da devre dışı bırakabilirsiniz.

Tablo 4. Özet bir lisansta Google Play sunucusu tarafından sağlanan lisans yönetimi ayarları tıklayın.

Lisans geçerlilik süresi

Google Play lisanslama sunucusu, lisanslarınızın her biri için indirilmiş uygulamalar. Dönem, bir kampanyanın belirli bir süre içinde uygulamanın lisans durumu, değiştirilemez ve Uygulamada bir lisanslama Policy. Lisanslama sunucusu şunları içerir: tüm lisans kontrollerine yanıt olarak geçerlilik süresi, yanıta VT anahtarının altında ekstra bir geçerlilik sonu zaman damgası CEVAP Policy, VT anahtar değerini ayıklayabilir ve bunu, şuna koşullu olarak erişim izni vermek için kullanabilir: geçerlilik süresine kadar, lisans tekrar kontrol edilmeden yapılan başvuru sona erecektir.

Lisans geçerliliği, tekrar kontrol edilmesi gerektiğinde Policy lisansı için sinyal gönderir. lisans durumu. ima etmemektedir. uygulamanın kullanım için gerçekten lisanslanıp lisanslanmadığı. Başka bir deyişle, lisans geçerlilik süresinin sona ermesi, bu dokümanın kullanım lisansının kaldırılmış olduğunu ve bu durumun Policy, lisanslama durumunu sunucuyla yeniden kontrol etmelidir. Şöyle diyor: lisans geçerlilik süresi sona ermediği sürece Lisans İlk lisans durumunu yerel olarak önbelleğe almak ve önbelleğe alınan lisansı döndürmek için Policy lisansının durumunu kontrol edebilirsiniz.

Lisans veren sunucu, geçerlilik süresini Google'ın sunduğu geri ödeme süresi boyunca lisanslamayı uygun şekilde zorunlu kılma Ücretli uygulamalar için Google Play. Geçerlilik süresini, uygulamanın satın alınıp alınmadığı ve satın alındıysa ne kadar süre önce satın alındığı. Özellikle, sunucu, geçerlilik süresini şu şekilde ayarlar:

• Ücretli bir uygulama için ilk lisans geçerlilik süresini sunucu belirler Bu şekilde lisans yanıtının, başvuru yapıldığı sürece geçerli kalması için geri ödeme yapılabilir. Uygulamadaki lisanslama Policy, lisansın yeniden kontrol edilmesi gerekmez ve lisansın, Geçerlilik süresi sona erene kadar.
• Bir uygulama için artık geri ödeme yapılmazsa sunucu daha uzun bir geçerlilik süresi (genellikle birkaç gün) belirler.
• Sunucu, ücretsiz bir uygulama için geçerlilik süresini çok yüksek bir değer (long.MAX_VALUE). Bu, Policy öğesinin geçerlilik zaman damgasını yerel olarak önbelleğe aldıysa, lisans durumunu kontrol edebilir.

ServerManagedPolicy uygulaması, çıkarılan zaman damgasını kullanır (mValidityTimestamp) ekleyebilirsiniz. kullanıcıya lisans durumunu tekrar kontrol ederek takip edebilirsiniz.

Yeniden deneme süresi ve maksimum yeniden deneme sayısı

Bazı durumlarda, sistem veya ağ koşulları bir uygulamanın lisans kontrolünün lisanslama sunucusuna ulaşmasını veya sunucunun Google Play istemci uygulamasına ulaşarak yanıt almamasını sağlayabilirsiniz. Örneğin, Kullanıcı, hücresel ağ veya veri bağlantısı olmadığında bir uygulamayı başlatabilir bağlantı varsa (ör. uçaktayken) veya ağ bağlantısı kararsız veya hücre sinyali zayıf.

Ağ sorunları bir lisans kontrolünü engellediğinde veya kesintiye uğrattığında Google Play istemcisi, şuna bir RETRY yanıt kodu döndürerek uygulamayı bilgilendirir: Policy processServerResponse() yöntemi. durumunda, Google Play'in ILicensingService uygulandığında LicenseChecker kitaplığının kendisi RETRY yanıt koduna sahip processServerResponse() politikası yöntemi.

Genel olarak RETRY yanıt kodu, uygulamanın lisans kontrolünün tamamlanmasını engelleyen bir hata oluştu.

Google Play sunucusu, bir uygulamanın yeniden deneme "ek yayınlanma süresi" ayarlayarak hata koşullarını karşılama ve önerilen maksimum yeniden deneme sayısı. Sunucu, bu değerleri tüm lisans kontrolü yanıtlarına ekler. bunları GT ve GR anahtarlarının altına fazladan olarak ekleyin.

Policy uygulaması GT ve GR ekstralarını ayıklayabilir ve bunları şu amaçlarla kullanabilir: aşağıdaki koşullara uygun şekilde uygulamaya erişim izni verebilirsiniz:

• RETRY yanıtıyla sonuçlanan bir lisans kontrolü için Policy RETRY yanıt kodunu önbelleğe alır ve RETRY yanıt sayısını artırır.
• Policy, aşağıdaki şartlarda kullanıcının uygulamaya erişmesine izin vermelidir: ek deneme süresi hâlâ etkin durumda veya maksimum yeniden deneme sayısı ulaşılmadı.

ServerManagedPolicy, sunucu tarafından sağlanan GT ve GR değerlerini 'ne başvurun. Aşağıdaki örnekte, yeniden deneme işleminin koşullu olarak nasıl işlendiği gösterilmektedir allow() yöntemindeki yanıtları. RETRY yanıt sayısı processServerResponse() yönteminde saklanmaktadır, gösterilmez.

fun allowAccess(): Boolean {
    val ts = System.currentTimeMillis()
    return when(lastResponse) {
        LICENSED -> {
            // Check if the LICENSED response occurred within the validity timeout.
            ts <= validityTimestamp  // Cached LICENSED response is still valid.
        }
        RETRY -> {
            ts < lastResponseTime + MILLIS_PER_MINUTE &&
                    // Only allow access if we are within the retry period
                    // or we haven't used up our max retries.
                    (ts <= retryUntil || retryCount <= maxRetries)
        }
        else -> false
    }
}

public boolean allowAccess() {
    long ts = System.currentTimeMillis();
    if (lastResponse == LicenseResponse.LICENSED) {
        // Check if the LICENSED response occurred within the validity timeout.
        if (ts <= validityTimestamp) {
            // Cached LICENSED response is still valid.
            return true;
        }
    } else if (lastResponse == LicenseResponse.RETRY &&
                ts < lastResponseTime + MILLIS_PER_MINUTE) {
        // Only allow access if we are within the retry period
        // or we haven't used up our max retries.
        return (ts <= retryUntil || retryCount <= maxRetries);
    }
    return false;
}