diff options
| -rw-r--r-- | docs/html/guide/appendix/market-filters.jd | 18 | ||||
| -rw-r--r-- | docs/html/guide/publishing/licensing.jd | 27 |
2 files changed, 26 insertions, 19 deletions
diff --git a/docs/html/guide/appendix/market-filters.jd b/docs/html/guide/appendix/market-filters.jd index dc79d95..6610f5f 100644 --- a/docs/html/guide/appendix/market-filters.jd +++ b/docs/html/guide/appendix/market-filters.jd @@ -25,7 +25,7 @@ manifest file to the configurations defined by the device, as well as other fact </ol> <h2>See also</h2> - <ol> + <ol> <li><a href="{@docRoot}guide/practices/compatibility.html">Android Compatibility</a></li> <li><code><a @@ -48,7 +48,7 @@ href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><uses-sdk></c <img id="rule" src="{@docRoot}assets/images/grad-rule-qv.png"> <div id="qv-sub-rule"> <img src="{@docRoot}assets/images/icon_market.jpg" style="float:left;margin:0;padding:0 5px;"> - <h2 style="color:#669999;">Interested in publishing your app on Android Market?</h2> + <h2 style="color:#669999;">Interested in publishing your app on Android Market?</h2> <p><a id="publish-link" href="http://market.android.com/publish">Go to Android Market</a> to create a publisher account and upload your app.</p></div> @@ -83,7 +83,7 @@ restrictions and dependencies expressed by the application's manifest file and publishing details. If the application is compatible with the device according to the filter rules, Market displays the application to the user. Otherwise, Market hides your application from search -results and category browsing, even if a user specifically requests +results and category browsing, even if a user specifically requests the app by clicking a deep link that points directly to the app's ID within Market..</p> <p class="note"><strong>Note:</strong> When users browse the <a @@ -108,7 +108,7 @@ available.</p> <p>Most Market filters are triggered by elements within an application's manifest file, <a -href="{@docRoot}guide/topics/manifest/manifest-intro.html">AndroidManifest.xml</a> +href="{@docRoot}guide/topics/manifest/manifest-intro.html">AndroidManifest.xml</a> (although not everything in the manifest file can trigger filtering). Table 1 lists the manifest elements that you should use to trigger Android Market filtering, and explains how the filtering for each element works.</p> @@ -173,7 +173,7 @@ default.</li> </strong>The manifest declares <code><uses-sdk android:minSdkVersion="3" android:targetSdkVersion="4"></code> and does not include a <code><supports-screens></code> element. - <strong>Result</strong>: Android Market will show the app to users on all + <strong>Result</strong>: Android Market will show the app to users on all devices, unless other filters apply. </p> <p><strong>Example 3<br /> </strong>The manifest declares <code><uses-sdk android:minSdkVersion="4"></code> @@ -402,9 +402,9 @@ country (as determined by SIM carrier) in which paid apps are available.</p></td visible on devices that support that platform. For details about the NDK and using native libraries, see <a href="{@docRoot}sdk/ndk/index.html#overview">What is the Android NDK?</a></p> </tr> <tr> - <td valign="top">Forward-Locked Applications</td> <td valign="top"><p>To - forward lock an application, set copy protection to "On" when you upload the - application to Market. Market will not show copy-protected applications on + <td valign="top">Copy-Protected Applications</td> <td valign="top"><p>To + copy protect an application, set copy protection to "On" when you configure publishing +options for your application. Market will not show copy-protected applications on developer devices or unreleased devices.</p></td> </tr> </table> @@ -431,7 +431,7 @@ href="{@docRoot}guide/topics/manifest/supports-gl-texture-element.html">{@code <p>By using the <a href="{@docRoot}guide/topics/manifest/supports-screens-element.html">{@code <supports-screens>}</a> or <a href="{@docRoot}guide/topics/manifest/compatible-screens-element.html">{@code -<compatible-screens>}</a> element.</p> +<compatible-screens>}</a> element.</p> </li> <li>API level <p>By using the <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html">{@code 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. </p> <h4>Application, Android Market client, and server</h4> <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 -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.</p> + +<p>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. </p> @@ -243,7 +248,7 @@ application: </p> <ul> <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 installed on its host device and the device is running Android 1.5 (API level 3) or higher.</li> @@ -258,8 +263,8 @@ practices in this document, you can help ensure that your implementation will be secure.</li> <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> -<li>Licensing is currently for paid apps only, since free apps are considered -licensed for all users. If your application is already published as free, +<li>Licensing is currently for paid apps only, since draft apps are +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> </ul> @@ -698,7 +703,7 @@ haven't done that already, do it now before continuing. </p> <p>Next, open the application's project properties window, as shown below. Select the "Android" properties group and click <strong>Add</strong>, then choose the LVL library project (com_android_vending_licensing) and click -<strong>OK</strong>. For more information, see +<strong>OK</strong>. For more information, see <a href="{@docRoot}guide/developing/projects/projects-eclipse.html#SettingUpLibraryProject"> Managing Projects from Eclipse with ADT</a></p>. @@ -727,7 +732,7 @@ properties, including the reference to the library project:</p> --library <em>path/to/my/library_project</em> </pre> -<p>For more information about working with library projects, +<p>For more information about working with library projects, see <a href="{@docRoot}guide/developing/projects/projects-cmdline.html#SettingUpLibraryProject"> Managing Projects from the Command Line</a></p>. @@ -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 to the licensing server.</li> </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>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.</li> </ol> <p>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 <code>displayResult()</code> to @@ -2338,7 +2345,7 @@ Policy <code>processServerResonse()</code> method with a "RETRY" response code. </p> <p>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. <p>The Android Market server helps an application to manage licensing under error conditions by setting a retry "grace period" and a recommended maximum |