From 80ef3293412b86b295fe4b9a66fae04e95efdc18 Mon Sep 17 00:00:00 2001 From: Bill Gruber Date: Tue, 15 Nov 2011 17:20:50 -0800 Subject: Licensing docs: clarifies server response for draft apps Bug 2900690 Change-Id: Ibd1f14739e553bdc237fdb67322e43bef30dfd17 --- docs/html/guide/publishing/licensing.jd | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) (limited to 'docs') diff --git a/docs/html/guide/publishing/licensing.jd b/docs/html/guide/publishing/licensing.jd index fc0de9d..609241b 100644 --- a/docs/html/guide/publishing/licensing.jd +++ b/docs/html/guide/publishing/licensing.jd @@ -100,9 +100,14 @@ application.

Application, Android Market client, and server

The licensing service is based on the capability of the Android Market server -to determine whether a given user is licensed to use a given application. The -server considers a user licensed if the user is recorded to have purchased the -application, or if the application is available for free. To properly identify +to determine whether a given user is licensed to use a given application. The licensing server +considers a user to be licensed if the user is a recorded purchaser of an application. If a paid +application has been uploaded to Android Market but saved only as a draft application (in +other words, the app is unpublished), the licensing server considers all users to be licensed users +of the application. Keep in mind, you cannot implement Android Market Licensing in a free +application.

+ +

To properly identify the user and determine the license status, the server requires information about the application and user — the application and the Android Market client work together to assemble the information and pass it to the server.

@@ -243,7 +248,7 @@ application:

@@ -698,7 +703,7 @@ haven't done that already, do it now before continuing.

Next, open the application's project properties window, as shown below. Select the "Android" properties group and click Add, then choose the LVL library project (com_android_vending_licensing) and click -OK. For more information, see +OK. For more information, see Managing Projects from Eclipse with ADT

. @@ -727,7 +732,7 @@ properties, including the reference to the library project:

--library path/to/my/library_project -

For more information about working with library projects, +

For more information about working with library projects, see Managing Projects from the Command Line

. @@ -1226,6 +1231,8 @@ whether there is a valid license response cached locally, in
  • Otherwise, the LicenseChecker initiates a license check request that is sent to the licensing server.
    • +

    Note: The licensing server always returns +LICENSED when you perform a license check of a draft application.

  • When a response is received, LicenseChecker creates a LicenseValidator that verifies the signed license data and extracts the fields of the response, then @@ -1384,7 +1391,7 @@ methods post to the Handler.

    • If you want your LicenseCheckerCallback methods to update the UI thread, -instantiate a {@link android.os.Handler} in the main Activity's +instantiate a {@link android.os.Handler} in the main Activity's {@link android.app.Activity#onCreate(android.os.Bundle) onCreate()} method, as shown below. In this example, the LVL sample application's LicenseCheckerCallback methods (see above) call displayResult() to @@ -2338,7 +2345,7 @@ Policy processServerResonse() method with a "RETRY" response code.

    In general, the RETRY response code is a signal to the application that an -error has occurred that has prevented a license check from completing. +error has occurred that has prevented a license check from completing.

    The Android Market server helps an application to manage licensing under error conditions by setting a retry "grace period" and a recommended maximum -- cgit v1.1