am 69e24843: Merge "Licensing docs: clarifies server response for draft apps Bug 2900690" into ics-mr0

* commit '69e24843fc89dcdd35802dbb6a2b693650ec8a41':
  Licensing docs: clarifies server response for draft apps Bug 2900690
This commit is contained in:
Bill Gruber
2011-11-17 14:49:33 -08:00
committed by Android Git Automerger

View File

@@ -100,9 +100,14 @@ application. </p>
<h4>Application, Android Market client, and server</h4> <h4>Application, Android Market client, and server</h4>
<p>The licensing service is based on the capability of the Android Market server <p>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 to determine whether a given user is licensed to use a given application. The licensing server
server considers a user licensed if the user is recorded to have purchased the considers a user to be licensed if the user is a recorded purchaser of an application. If a paid
application, or if the application is available for free. To properly identify 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.</p>
<p>To properly identify
the user and determine the license status, the server requires information about the user and determine the license status, the server requires information about
the application and user &mdash; the application and the Android Market client the application and user &mdash; the application and the Android Market client
work together to assemble the information and pass it to the server. </p> work together to assemble the information and pass it to the server. </p>
@@ -243,7 +248,7 @@ application: </p>
<ul> <ul>
<li>Only paid applications published through Market can use the <li>Only paid applications published through Market can use the
service. </li> service.</li>
<li>An application can use the service only if the Android Market client is <li>An application can use the service only if the Android Market client is
installed on its host device and the device is running Android 1.5 (API level 3) installed on its host device and the device is running Android 1.5 (API level 3)
or higher.</li> or higher.</li>
@@ -258,8 +263,8 @@ practices in this document, you can help ensure that your implementation will be
secure.</li> secure.</li>
<li>Adding licensing to an application does not affect the way the application <li>Adding licensing to an application does not affect the way the application
functions when run on a device that does not offer Android Market.</li> functions when run on a device that does not offer Android Market.</li>
<li>Licensing is currently for paid apps only, since free apps are considered <li>Licensing is currently for paid apps only, since draft apps are
licensed for all users. If your application is already published as free, licensed for all users. If your application is already published as a free app,
you won't be able to upload a new version that uses licensing.</li> you won't be able to upload a new version that uses licensing.</li>
</ul> </ul>
@@ -1226,6 +1231,8 @@ whether there is a valid license response cached locally, in
<li>Otherwise, the LicenseChecker initiates a license check request that is sent <li>Otherwise, the LicenseChecker initiates a license check request that is sent
to the licensing server.</li> to the licensing server.</li>
</ul> </ul>
<p class="note"><strong>Note:</strong> The licensing server always returns
<code>LICENSED</code> when you perform a license check of a draft application.</p>
</li> </li>
<li>When a response is received, LicenseChecker creates a LicenseValidator that <li>When a response is received, LicenseChecker creates a LicenseValidator that
verifies the signed license data and extracts the fields of the response, then verifies the signed license data and extracts the fields of the response, then