Skip to content

Commit 4143781

Browse files
committed
docs: add docs for market OBB
includes splitting the Licensing dev guide into multiple pages; Turned original licensing doc into a redirect to the new files that are under guide/market/licensing/; Fix all links pointing to app licensing Change-Id: Ic49493f0e560db225dd7a382ffabc904a2fa1228
1 parent e5e11fd commit 4143781

File tree

16 files changed

+3825
-2397
lines changed

16 files changed

+3825
-2397
lines changed

docs/html/guide/appendix/install-location.jd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,7 @@ external storage, it can never receive this broadcast.</dd>
174174
<dt>Copy Protection</dt>
175175
<dd>Your application cannot be installed to a device's SD card if it uses Android Market's
176176
Copy Protection feature. However, if you use Android Market's
177-
<a href="{@docRoot}guide/publishing/licensing.html">Application Licensing</a> instead, your
177+
<a href="{@docRoot}guide/market/licensing/index.html">Application Licensing</a> instead, your
178178
application <em>can</em> be installed to internal or external storage, including SD cards.</dd>
179179
</dl>
180180

docs/html/guide/developing/tools/proguard.jd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ parent.link=index.html
3939
sized <code>.apk</code> file that is more difficult to reverse engineer. Because ProGuard makes your
4040
application harder to reverse engineer, it is important that you use it
4141
when your application utilizes features that are sensitive to security like when you are
42-
<a href="{@docRoot}guide/publishing/licensing.html">Licensing Your Applications</a>.</p>
42+
<a href="{@docRoot}guide/market/licensing/index.html">Licensing Your Applications</a>.</p>
4343

4444
<p>ProGuard is integrated into the Android build system, so you do not have to invoke it
4545
manually. ProGuard runs only when you build your application in release mode, so you do not

docs/html/guide/guide_toc.cs

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -451,8 +451,24 @@ localized titles are added in the language order specified below.
451451
<li><a href="<?cs var:toroot ?>guide/publishing/publishing.html">
452452
<span class="en">Publishing on Android Market</span>
453453
</a></li>
454-
<li><a href="<?cs var:toroot ?>guide/publishing/licensing.html">
454+
<li class="toggle-list">
455+
<div><a href="<?cs var:toroot ?>guide/market/licensing/index.html">
455456
<span class="en">Application Licensing</span></a>
457+
</div>
458+
<ul>
459+
<li><a href="<?cs var:toroot?>guide/market/licensing/overview.html">
460+
<span class="en">Licensing Overview</span></a>
461+
</li>
462+
<li><a href="<?cs var:toroot?>guide/market/licensing/setting-up.html">
463+
<span class="en">Setting Up for Licensing</span></a>
464+
</li>
465+
<li><a href="<?cs var:toroot?>guide/market/licensing/adding-licensing.html">
466+
<span class="en">Adding Licensing to Your App</span></a>
467+
</li>
468+
<li><a href="<?cs var:toroot?>guide/market/licensing/licensing-reference.html">
469+
<span class="en">Licensing Reference</span></a>
470+
</li>
471+
</ul>
456472
</li>
457473
<li class="toggle-list">
458474
<div><a href="<?cs var:toroot?>guide/market/billing/index.html">
@@ -485,6 +501,10 @@ localized titles are added in the language order specified below.
485501
<li><a href="<?cs var:toroot ?>guide/market/publishing/multiple-apks.html">
486502
<span class="en">Multiple APK Support</span></a>
487503
</li>
504+
<li><a href="<?cs var:toroot ?>guide/market/expansion-files.html">
505+
<span class="en">APK Expansion Files</span></a>
506+
<span class="new">new!</span>
507+
</li>
488508
</ul>
489509
</li>
490510

docs/html/guide/market/expansion-files.jd

Lines changed: 1259 additions & 0 deletions
Large diffs are not rendered by default.

docs/html/guide/market/licensing/adding-licensing.jd

Lines changed: 1072 additions & 0 deletions
Large diffs are not rendered by default.
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
page.title=Application Licensing
2+
@jd:body
3+
4+
5+
<p>Android Market offers a licensing service that lets you enforce licensing policies for
6+
applications that you publish on Android Market. With Android Market Licensing, your application can
7+
query Android Market at run time to obtain the licensing status for the current user, then allow or
8+
disallow further use as appropriate. </p>
9+
10+
<p>Using the service, you can apply a flexible licensing policy on an application-by-application
11+
basis&mdash;each application can enforce licensing in the way most appropriate for it. If necessary,
12+
an application can apply custom constraints based on the licensing status obtained from Android
13+
Market. For example, an application can check the licensing status and then apply custom constraints
14+
that allow the user to run it unlicensed for a specific validity period. An application can also
15+
restrict use of the application to a specific device, in addition to any other constraints. </p>
16+
17+
<p>The licensing service is a secure means of controlling access to your applications. When an
18+
application checks the licensing status, the Android Market server signs the licensing status
19+
response using a key pair that is uniquely associated with the publisher account. Your application
20+
stores the public key in its compiled <code>.apk</code> file and uses it to verify the licensing
21+
status response.</p>
22+
23+
<p>Any application that you publish through Android Market can use the Android Market Licensing
24+
service. No special account or registration is needed. Additionally, because the service uses no
25+
dedicated framework APIs, you can add licensing to any application that uses a minimum API level of
26+
3 or higher.</p>
27+
28+
<p class="note"><strong>Note:</strong> The Android Market Licensing service is primarily intended
29+
for paid applications that wish to verify that the current user did in fact pay for the application
30+
on Android Market. However, any application (including free apps) may use the licensing service
31+
to initiate the download of an APK expansion file. In which case, the request that your application
32+
sends to the licensing service is not to check whether the user paid for the app, but to request the
33+
URL of the expansion files. For information about downloading expansion files for your application,
34+
read the guide to <a href="{@docRoot}guide/market/expansion-files.html">APK Expansion Files</a>.</p>
35+
36+
37+
<p>To learn more about Android Market's application licensing service and start integrating it into
38+
your applications, read the following documents:</p>
39+
40+
<dl>
41+
<dt><strong><a href="{@docRoot}guide/market/licensing/overview.html">Licensing
42+
Overview</a></strong></dt>
43+
<dd>Describes how the service works and what a typical licensing implementation looks
44+
like.</dd>
45+
<dt><strong><a href="{@docRoot}guide/market/licensing/setting-up.html">Setting Up for
46+
Licensing</a></strong></dt>
47+
<dd>Explains how to set up your Android Market account, development environment, and
48+
testing environment in order to add licensing to your app.</dd>
49+
<dt><strong><a href="{@docRoot}guide/market/licensing/adding-licensing.html">Adding
50+
Licensing to Your App</a></strong></dt>
51+
<dd>Provides a step-by-step guide to add licensing verification to your application.</dd>
52+
<dt><strong><a href="{@docRoot}guide/market/licensing/licensing-reference.html">Licensing
53+
Reference</a></strong></dt>
54+
<dd>Provides detailed information about the licensing library's classes and the service response
55+
codes.</dd>
56+
</dl>
57+
58+
59+
60+
61+

0 commit comments

Comments
 (0)