Referenz zur Lizenzierung

LVL-Klassen und -Schnittstellen

In Tabelle 1 sind alle Quelldateien der Lizenzüberprüfung aufgeführt. Bibliothek (LVL), die über das Android SDK verfügbar ist. Alle Dateien gehören zu com.android.vending.licensing-Paket.

Tabelle 1 Zusammenfassung der LVL-Bibliothek Klassen und Benutzeroberflächen.

Serverantwort

In Tabelle 2 sind alle Lizenzantwortfelder aufgeführt, die vom Lizenzierungsserver.

Tabelle 2: Zusammenfassung der Felder für die Lizenzantwort die vom Google Play-Server zurückgegeben werden.

Serverantwortcodes

In Tabelle 3 sind alle Lizenzantwortcodes aufgeführt, die vom Lizenzierungsserver. Im Allgemeinen sollte eine Anwendung alle diese Antworten verarbeiten, Codes. Standardmäßig stellt die LicenseValidator-Klasse in der LVL alle wie Sie diese Antwortcodes handhaben müssen.

Tabelle 3 Zusammenfassung der Antwortcodes zurückgegeben, die vom Google Play-Server in einer Lizenzantwort zurückgegeben werden.

Hinweis: Wie dokumentiert in Testumgebung einrichten können Sie den Antwortcode manuell für den Anwendungsentwickler und alle registrierten Testnutzer über die Google Play Console

Hinweis:Bisher konnten Sie Apps testen, indem Sie Hochladen eines unveröffentlichten "Entwurfs" Version. Diese Funktion ist nicht mehr unterstützt; müssen Sie sie als Alpha- oder Betaversion veröffentlichen, Kanal. Weitere Informationen finden Sie unter App-Entwürfe werden nicht mehr unterstützt.

Extras der Serverantwort

Um Ihre Anwendung bei der Verwaltung des Zugriffs auf die Anwendung für die Erstattung der Anwendung zu unterstützen und andere Informationen zur Verfügung stellen, enthält der Lizenzierungsserver verschiedene in den Lizenzantworten. Insbesondere bietet der Dienst empfohlene Werte für die Gültigkeitszeitraum der Lizenz der Anwendung, Kulanzzeitraum für Wiederholungsversuche, maximal zulässige Anzahl von Wiederholungen und andere Einstellungen. Wenn Ihre App APK verwendet Erweiterungsdateien enthält, enthält die Antwort auch die Dateinamen, Größen und URLs. Der Server hängt die Einstellungen als Schlüssel/Wert-Paare in der Lizenzantwort „extras“ ein.

Jede Policy-Implementierung kann die Extras-Einstellungen aus der Lizenz extrahieren. und verwenden Sie sie bei Bedarf. Die LVL-Standardimplementierung Policy, ServerManagedPolicy, dient als funktionierende Implementierung und eine Abbildung, wie das Abrufen, Speichern und Verwenden Einstellungen.

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

Gültigkeitsdauer der Lizenz

Der Google Play-Lizenzierungsserver legt eine Gültigkeitsdauer für alle heruntergeladenen Anwendungen. Die Periode drückt das Zeitintervall aus, über das ein sollte der Lizenzstatus der Anwendung nicht geändert werden und eine Policy-Lizenzierung in der Anwendung. Der Lizenzierungsserver umfasst die Gültigkeit in der Antwort auf alle Lizenzprüfungen, Gültigkeitsende-Zeitstempel als Extraelement unter dem Schlüssel VT an die Antwort. A Policy kann den Wert des VT-Schlüssels extrahieren und damit bedingt Zugriff auf Folgendes gewähren: den Antrag ohne erneute Überprüfung der Lizenz bis zum Gültigkeitszeitraum bearbeiten. verfällt.

Die Gültigkeit der Lizenz signalisiert einer Lizenzierung Policy, wenn diese die Lizenzierungsstatus mit dem Lizenzierungsserver. Dies soll nicht implizieren, ob eine Anwendung tatsächlich für die Nutzung lizenziert ist. Das heißt, wenn ein die Gültigkeit der Lizenz abläuft, bedeutet dies nicht, Anwendung nicht mehr zur Nutzung lizenziert ist, sondern sie weist nur darauf hin, Der Policy muss den Lizenzierungsstatus noch einmal mit dem Server prüfen. Daraus folgt, Solange die Gültigkeitsdauer der Lizenz noch nicht abgelaufen ist, ist die Lizenz Policy, um den anfänglichen Lizenzstatus lokal im Cache zu speichern und die im Cache gespeicherte Lizenz zurückzugeben statt eine neue Lizenzprüfung an den Server zu senden.

Der Lizenzierungsserver verwaltet die Gültigkeitsdauer, um dem Anwendung die Lizenzierung über den von Google Play für kostenpflichtige Apps Der Gültigkeitszeitraum richtet sich nach ob die Anwendung gekauft wurde und, falls ja, wann. Genauer gesagt: legt der Server den Gültigkeitszeitraum wie folgt fest:

• Bei einer kostenpflichtigen Anwendung legt der Server die anfängliche Gültigkeitsdauer der Lizenz fest. damit die Lizenzantwort so lange gültig bleibt, wie der Antrag erstattungsfähig. Eine Lizenzierung Policy in der Anwendung kann das Element Ergebnis der ersten Lizenzprüfung und muss die Lizenz nicht noch einmal prüfen bis der Gültigkeitszeitraum abgelaufen ist.
• Wenn eine Anwendung nicht mehr erstattungsfähig ist, legt einen längeren Gültigkeitszeitraum fest, der in der Regel mehrere Tage umfasst.
• Bei einer kostenlosen Anwendung legt der Server den Gültigkeitszeitraum sehr hoch fest. Wert (long.MAX_VALUE) Dadurch wird sichergestellt, dass, sofern Policy den Gültigkeitszeitstempel lokal im Cache gespeichert hat, Lizenzstatus des Antrags in der Zukunft liegt.

Die ServerManagedPolicy-Implementierung verwendet den extrahierten Zeitstempel (mValidityTimestamp) als primäre Bedingung für die Entscheidung, den Lizenzstatus noch einmal mit dem Server zu prüfen, bevor Sie dem Nutzer Zugriff auf der Anwendung.

Wiederholungszeitraum und maximale Anzahl von Wiederholungen

In einigen Fällen können System- oder Netzwerkbedingungen den Lizenzierungsserver nicht erreicht, oder verhindert, die Google Play-Clientanwendung erreicht. Beispiel: Der Parameter Nutzende starten eine App, wenn kein Mobilfunknetz oder keine Daten vorhanden sind. verfügbar ist, zum Beispiel im Flugzeug, Netzwerkverbindung ist instabil oder das Mobilfunksignal ist schwach.

Wenn eine Lizenzüberprüfung durch Netzwerkprobleme verhindert oder unterbrochen wird, Der Play-Client benachrichtigt die App durch Rückgabe eines RETRY-Antwortcodes an Die Methode processServerResponse() der Policy. Bei einem System z. B. wenn die App nicht mit dem ILicensingService-Implementierung ruft die LicenseChecker-Bibliothek selbst den Methode processServerResponse() der Richtlinie mit einem RETRY-Antwortcode.

Im Allgemeinen signalisiert der Antwortcode RETRY der Anwendung, dass ein ist ein Fehler aufgetreten, durch den die Lizenzüberprüfung nicht abgeschlossen werden konnte.

Der Google Play-Server unterstützt eine App bei der Verwaltung der Lizenzierung unter Fehlerbedingungen durch Festlegen eines Kulanzzeitraums für den Wiederholungsversuch und ein empfohlenes Maximum Anzahl der Wiederholungsversuche. Der Server nimmt diese Werte in alle Antworten zur Lizenzprüfung auf, und hängen Sie sie als Extras unter den Schlüsseln GT und GR an.

Die Anwendung Policy kann die Extras GT und GR extrahieren und für Folgendes verwenden: unter bestimmten Bedingungen den Zugriff auf die Anwendung zulassen:

• Für eine Lizenzprüfung, die zu einer RETRY-Antwort führt, sollte Policy speichern Sie den RETRY-Antwortcode im Cache und erhöhen Sie die Anzahl der RETRY-Antworten.
• Der Policy sollte es dem Nutzer ermöglichen, auf die Anwendung zuzugreifen, vorausgesetzt, Entweder ist der Kulanzzeitraum für Wiederholungsversuche noch aktiv oder die maximale Anzahl der Wiederholungen wurde nicht erreicht.

ServerManagedPolicy verwendet die vom Server bereitgestellten Werte GT und GR als beschrieben. Das folgende Beispiel zeigt die bedingte Verarbeitung der Wiederholungsversuche. Antworten in der Methode allow(). Die Anzahl der RETRY Antworten beträgt werden in der processServerResponse()-Methode beibehalten (nicht dargestellt).

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