diff options
Diffstat (limited to 'docs/html/guide/topics/manifest/uses-permission-element.jd')
| -rw-r--r-- | docs/html/guide/topics/manifest/uses-permission-element.jd | 41 |
1 files changed, 39 insertions, 2 deletions
diff --git a/docs/html/guide/topics/manifest/uses-permission-element.jd b/docs/html/guide/topics/manifest/uses-permission-element.jd index aec765c..085b9f0 100644 --- a/docs/html/guide/topics/manifest/uses-permission-element.jd +++ b/docs/html/guide/topics/manifest/uses-permission-element.jd @@ -2,6 +2,38 @@ page.title=<uses-permission> @jd:body <dl class="xml"> + + <div class="sidebox-wrapper"> + <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;"> + <p style="color:#669999;"><code style="color:#669999;"><uses-permission></code> and filtering on Android Market. </p> + +<p style="margin-top:1em;">In some cases, the permissions that you request +through <code><uses-permission></code> can affect how +your application is filtered by Android Market.</p> + +<p style="margin-top:1em;">If you request a hardware-related permission — +<code>CAMERA</code>, for example — Android Market assumes that your +application requires the underlying hardware feature and filters the application +from devices that do not offer it.</p> + +<p style="margin-top:1em;">To control filtering, always explicitly declare +hardware features in <code><uses-feature></code> elements, rather than +relying on Android Market to "discover" the requirements in +<code><uses-permission></code> elements. Then, if you want to disable +filtering for a particular feature, you can add a +<code>android:required="false"</code> attribute to the +<code><uses-feature></code> declaration.</p> + +<p style="margin-top:1em;" class="caution">For a list of permissions that imply +hardware features, see the documentation for the <a +href="{@docRoot}guide/topics/manifest/uses-feature-element.html#permissions-features"> +<code><uses-feature></code></a> element.</p> +</div> +</div> + + <dt>syntax:</dt> <dd><pre class="stx"><uses-permission android:<a href="#nm">name</a>="<i>string</i>" /></pre></dd> @@ -10,7 +42,7 @@ page.title=<uses-permission> <dt>description:</dt> <dd>Requests a permission that the application must be granted in -order for it to operate correctly. Permissions are granted when the +order for it to operate correctly. Permissions are granted by the user when the application is installed, not while it's running. <p> @@ -38,6 +70,11 @@ a permission name typically includes the package name as a prefix.</dd> <dd>API Level 1</dd> <dt>see also:</dt> -<dd><code><a href="{@docRoot}guide/topics/manifest/permission-element.html"><permission></a></code></dd> +<dd> +<ul> + <li><code><a href="{@docRoot}guide/topics/manifest/permission-element.html"><permission></a></code></li> + <li><code><a href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><uses-feature></a></code></li> +</ul> +</dd> </dl> |