Referenz zur Lizenzierung

LVL-Klassen und -Schnittstellen

In Tabelle 1 sind alle Quelldateien in der Lizenzüberprüfungsbibliothek (License Verification Library, LVL) aufgeführt, die über das Android SDK verfügbar ist. Alle Dateien sind Teil des Pakets com.android.vending.licensing.

Tabelle 1 Zusammenfassung der LVL-Bibliotheksklassen und -Schnittstellen

Serverantwort

In Tabelle 2 sind alle Lizenzantwortfelder aufgelistet, die vom Lizenzierungsserver zurückgegeben werden.

Tabelle 2 Zusammenfassung der vom Google Play-Server zurückgegebenen Lizenzantwortfelder.

Serverantwortcodes

In Tabelle 3 sind alle Lizenzantwortcodes aufgeführt, die vom Lizenzierungsserver unterstützt werden. Im Allgemeinen sollte eine Anwendung alle diese Antwortcodes verarbeiten können. Standardmäßig bietet die Klasse LicenseValidator in der LVL die erforderliche Verarbeitung dieser Antwortcodes für Sie.

Tabelle 3 Zusammenfassung der vom Google Play-Server in einer Lizenzantwort zurückgegebenen Antwortcodes.

Hinweis:Wie unter Testumgebung einrichten beschrieben, kann der Antwortcode für den Anwendungsentwickler und alle registrierten Testnutzer über die Google Play Console manuell überschrieben werden.

Hinweis:Bisher konnten Sie eine Anwendung testen, indem Sie eine unveröffentlichte Entwurfsversion hochgeladen haben. Diese Funktion wird nicht mehr unterstützt. Sie müssen sie stattdessen im Alpha- oder Betavertriebskanal veröffentlichen. Weitere Informationen finden Sie unter App-Entwürfe werden nicht mehr unterstützt.

Server Response Extras

Der Lizenzierungsserver fügt in die Lizenzantworten verschiedene Informationen ein, damit Ihre Anwendung während des Erstattungszeitraums der Anwendung den Zugriff auf die Anwendung verwalten und weitere Informationen angeben kann. Der Dienst bietet insbesondere empfohlene Werte für den Gültigkeitszeitraum der Lizenz, den Kulanzzeitraum für Wiederholungen, die maximal zulässige Anzahl von Wiederholungen und andere Einstellungen. Wenn Ihre Anwendung APK-Erweiterungsdateien verwendet, enthält die Antwort auch die Dateinamen, Größen und URLs. Der Server hängt die Einstellungen als Schlüssel/Wert-Paare im Feld "extras" der Lizenzantwort an.

Jede Policy-Implementierung kann die Einstellungen für die Extras aus der Lizenzantwort extrahieren und nach Bedarf verwenden. Die LVL-Standardimplementierung Policy (ServerManagedPolicy) dient als funktionierende Implementierung und zeigt, wie die Einstellungen abgerufen, gespeichert und verwendet werden.

Tabelle 4 Zusammenfassung der Einstellungen für die Lizenzverwaltung, die vom Google Play-Server in einer Lizenzantwort bereitgestellt werden.

Gültigkeit der Lizenz

Der Google Play-Lizenzierungsserver legt eine Gültigkeitsdauer der Lizenz für alle heruntergeladenen Apps fest. Der Zeitraum gibt das Zeitintervall an, in dem der Lizenzstatus einer Anwendung von einer Policy-Lizenzierung in der Anwendung als unveränderlich angesehen und im Cache gespeichert werden kann. Der Lizenzierungsserver nimmt den Gültigkeitszeitraum in seine Antwort auf alle Lizenzprüfungen auf und hängt unter dem Schlüssel VT zusätzlich einen Zeitstempel für das Ende der Gültigkeitsdauer an die Antwort an. Ein Policy kann den VT-Schlüsselwert extrahieren und damit bis zum Ablauf des Gültigkeitszeitraums bedingt den Zugriff auf die Anwendung ohne erneute Überprüfung der Lizenz zulassen.

Die Lizenzgültigkeit signalisiert einer Lizenzierung Policy, wenn der Lizenzierungsstatus noch einmal mit dem Lizenzierungsserver geprüft werden muss. Sie sollen nicht andeuten, ob eine App tatsächlich für die Nutzung lizenziert ist. Das heißt, wenn der Lizenzgültigkeitszeitraum einer Anwendung abläuft, bedeutet dies nicht, dass die Anwendung nicht mehr zur Nutzung lizenziert ist. Es bedeutet nur, dass Policy den Lizenzstatus auf dem Server noch einmal prüfen muss. Solange der Gültigkeitszeitraum der Lizenz nicht abgelaufen ist, kann die Policy also den anfänglichen Lizenzstatus lokal im Cache speichern und den im Cache gespeicherten Lizenzstatus zurückgeben, anstatt eine neue Lizenzprüfung an den Server zu senden.

Der Lizenzierungsserver verwaltet den Gültigkeitszeitraum, damit die App während des von Google Play für kostenpflichtige Apps angebotenen Erstattungszeitraums die Lizenzierung ordnungsgemäß durchsetzen kann. Der Gültigkeitszeitraum hängt davon ab, ob die Anwendung gekauft wurde und wenn ja, wie lange sie her ist. Der Server legt einen Gültigkeitszeitraum so fest:

• Bei einer kostenpflichtigen Anwendung legt der Server den anfänglichen Gültigkeitszeitraum der Lizenz so fest, dass die Lizenzantwort so lange gültig bleibt, wie die Anwendung erstattungsfähig ist. Eine Lizenzierung Policy in der Anwendung kann das Ergebnis der ersten Lizenzprüfung im Cache speichern und muss die Lizenz erst nach Ablauf des Gültigkeitszeitraums noch einmal prüfen.
• Wenn eine Anwendung nicht mehr erstattungsfähig ist, legt der Server einen längeren Gültigkeitszeitraum fest, der in der Regel mehrere Tage beträgt.
• Bei kostenlosen Anwendungen setzt der Server die Gültigkeitsdauer auf einen sehr hohen Wert (long.MAX_VALUE). So wird sichergestellt, dass der Lizenzstatus der Anwendung in Zukunft nicht noch einmal überprüft werden muss, sofern Policy den Gültigkeitszeitstempel lokal im Cache gespeichert hat.

Die Implementierung ServerManagedPolicy verwendet den extrahierten Zeitstempel (mValidityTimestamp) als primäre Bedingung zum Bestimmen, ob der Lizenzstatus mit dem Server noch einmal geprüft werden soll, bevor dem Nutzer Zugriff auf die Anwendung gewährt wird.

Wiederholungszeitraum und maximale Anzahl von Wiederholungen

In einigen Fällen können System- oder Netzwerkbedingungen verhindern, dass die Lizenzprüfung einer Anwendung den Lizenzierungsserver erreicht, oder verhindern, dass die Antwort des Servers die Google Play-Clientanwendung erreicht. Beispielsweise kann der Nutzer eine Anwendung starten, wenn kein Mobilfunknetz oder keine Datenverbindung verfügbar ist – z. B. in einem Flugzeug – oder wenn die Netzwerkverbindung instabil oder das Mobilfunksignal schwach ist.

Wenn Netzwerkprobleme eine Lizenzprüfung verhindern oder unterbrechen, benachrichtigt der Google Play-Client die Anwendung, indem ein RETRY-Antwortcode an die Methode processServerResponse() der Policy zurückgegeben wird. Bei Systemproblemen, z. B. wenn sich die App nicht an die ILicensingService-Implementierung von Google Play binden kann, ruft die LicenseChecker-Bibliothek selbst die Methode processServerResponse() mit einem RETRY-Antwortcode auf.

Im Allgemeinen ist der Antwortcode RETRY ein Signal für die Anwendung, dass ein Fehler aufgetreten ist, durch den eine Lizenzprüfung nicht abgeschlossen werden konnte.

Der Google Play-Server unterstützt eine App bei der Verwaltung der Lizenzierung unter Fehlerbedingungen, indem er einen Kulanzzeitraum für Wiederholungen und eine empfohlene maximale Anzahl von Wiederholungen festlegt. Der Server nimmt diese Werte in alle Antworten zur Lizenzprüfung auf und hängt sie als Extras unter den Schlüsseln GT und GR an.

Die Anwendung Policy kann die Extras GT und GR extrahieren und verwenden, um bedingten Zugriff auf die Anwendung zuzulassen:

• Bei einer Lizenzprüfung, die zu einer RETRY-Antwort führt, sollte Policy den RETRY-Antwortcode im Cache speichern und die Anzahl der RETRY-Antworten erhöhen.
• Die Policy sollte dem Nutzer den Zugriff auf die Anwendung ermöglichen, sofern entweder der Kulanzzeitraum für Wiederholungen noch aktiv ist oder die maximale Anzahl an Wiederholungen nicht erreicht wurde.

ServerManagedPolicy verwendet die vom Server bereitgestellten Werte GT und GR wie oben beschrieben. Das folgende Beispiel zeigt die bedingte Verarbeitung der Wiederholungsantworten in der Methode allow(). Die Anzahl der RETRY-Antworten wird in der processServerResponse()-Methode beibehalten (nicht gezeigt).

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