diff options
| -rw-r--r-- | docs/html/guide/topics/manifest/uses-feature-element.jd | 91 |
1 files changed, 66 insertions, 25 deletions
diff --git a/docs/html/guide/topics/manifest/uses-feature-element.jd b/docs/html/guide/topics/manifest/uses-feature-element.jd index fec6a980e305..ef98a6a0316f 100644 --- a/docs/html/guide/topics/manifest/uses-feature-element.jd +++ b/docs/html/guide/topics/manifest/uses-feature-element.jd @@ -3,6 +3,32 @@ parent.title=The AndroidManifest.xml File parent.link=manifest-intro.html @jd:body +<div id="qv-wrapper"> +<div id="qv"> + + +<h2>In this document</h2> +<ol> + <li><a href="#market-feature-filtering">Android Market and Feature-Based Filtering</a> + <ol> + <li><a href="#declared">Filtering based on explicitly declared features</a></li> + <li><a href="#implicit">Filtering based on implicit features</a></li> + <li><a href="#bt-permission-handling">Special handling for Bluetooth feature</a></li> + <li><a href="#testing">Testing the features required by your application</a></li> + </ol> + </li> + <li><a href="#features-reference">Features Reference</a> + <ol> + <li><a href="#hw-features">Hardware features</a></li> + <li><a href="#sw-features">Software features</a></li> + <li><a href="#permissions">Permissions that Imply Feature Requirements</a></li> + </ol> + </li> +</ol> +</div> +</div> + + <dl class="xml"> <dt>syntax:</dt> @@ -452,7 +478,7 @@ feature support, for all devices.</dd> -<h3>Testing the features required by your application</h3> +<h3 id="testing">Testing the features required by your application</h3> <p>You can use the <code>aapt</code> tool, included in the Android SDK, to determine how Android Market will filter your application, based on its declared @@ -516,7 +542,7 @@ in a separate <code><uses-feature></code> element. </p> <tr> <th>Feature Type</th> <th>Feature Descriptor</th> - <th>Description</th> + <th style="min-width:170px">Description</th> <th>Comments</th> </tr> <tr> @@ -545,9 +571,9 @@ is sensitive to delays or lag in sound input or output.</td> <tr> <td><code>android.hardware.camera.autofocus</code></td> <td>Subfeature. The application uses the device camera's autofocus capability.</td> - <td rowspan="3">If declared with the <code>"android:required="true"</code> -attribute, these subfeatures implicitly declare the -<code>android.hardware.camera</code> parent feature. </td> + <td rowspan="3">These subfeatures implicitly declare the +<code>android.hardware.camera</code> parent feature, unless declared with +<code>android:required="false"</code>.</td> </tr> <tr> <td><code>android.hardware.camera.flash</code></td> @@ -569,9 +595,9 @@ location, such as GPS location, network location, or cell location.</td> <td><code>android.hardware.location.network</code></td> <td>Subfeature. The application uses coarse location coordinates obtained from a network-based geolocation system supported on the device.</td> - <td rowspan="2">If declared with the <code>"android:required="true"</code> -attribute, these subfeatures implicitly declare the -<code>android.hardware.location</code> parent feature. </td> + <td rowspan="2">These subfeatures implicitly declare the +<code>android.hardware.location</code> parent feature, unless declared with +<code>android:required="false"</code>. </td> </tr> <tr> <td><code>android.hardware.location.gps</code></td> @@ -586,9 +612,9 @@ from a Global Positioning System receiver on the device. </td> <td></td> </tr> <tr> - <td>Near Field Communications</td> + <td>NFC</td> <td><code>android.hardware.nfc</td> - <td>The application uses NFC radio features in the device.</td> + <td>The application uses Near Field Communications radio features in the device.</td> <td></td> </tr> <tr> @@ -635,9 +661,9 @@ radio with data communication services.</td> <td><code>android.hardware.telephony.cdma</code></td> <td>Subfeature. The application uses CDMA telephony radio features on the device. </td> - <td rowspan="2">If declared with the <code>"android:required="true"</code> -attribute, these subfeatures implicitly declare the -<code>android.hardware.telephony</code> parent feature. </td> + <td rowspan="2">These subfeatures implicitly declare the +<code>android.hardware.telephony</code> parent feature, unless declared with +<code>android:required="false"</code>. </td> </tr> <tr> <td><code>android.hardware.telephony.gsm</code></td> @@ -654,32 +680,33 @@ up", and drag.</td> emulated touchscreen (or better). A device that offers an emulated touchscreen provides a user input system that can emulate a subset of touchscreen capabilities. An example of such an input system is a mouse or remote control that drives an on-screen cursor. If your application does not require -complicated gestures and you want your application available to devices with an emulated -touchscreen, you should declare this feature.</td> +complicated gestures and you want your application available to devices that use an on-screen +cursor to emulate touch events, you should declare this feature.</td> </tr> <tr> <td><code>android.hardware.touchscreen</code></td> <td>The application uses touchscreen capabilities, for gestures more interactive than basic touches, such as a fling. This is a superset of the faketouch features.</td> - <td></td> + <td>By default, this is assumed to be required, unless you declare +<code>android.hardware.faketouch</code> (the subset touch mode). As such, your application is +<em>not</em> available to devices that provide only an emulated touch interface ("fake touch") by +default.</td> </tr> <tr> <td><code>android.hardware.touchscreen.multitouch</code></td> <td>The application uses basic two-point multitouch capabilities on the device screen, such as for pinch gestures, but does not need to track touches independently. This is a superset of touchscreen features.</td> - <td>If declared with the <code>"android:required="true"</code> attribute, this -implicitly declares the <code>android.hardware.touchscreen</code> -parent feature. </td> + <td>This implicitly declares the <code>android.hardware.touchscreen</code> parent feature, unless +declared with <code>android:required="false"</code>. </td> </tr> <tr> <td><code>android.hardware.touchscreen.multitouch.distinct</code></td> <td>Subfeature. The application uses advanced multipoint multitouch capabilities on the device screen, such as for tracking two or more points fully independently. This is a superset of multitouch features.</td> - <td rowspan="2">If declared with the <code>"android:required="true"</code> attribute, this -implicitly declares the -<code>android.hardware.touchscreen.multitouch</code> parent feature. </td> + <td rowspan="2">This implicitly declares the <code>android.hardware.touchscreen.multitouch</code> +parent feature, unless declared with <code>android:required="false"</code>. </td> </tr> <tr> <td><code>android.hardware.touchscreen.multitouch.jazzhand</code></td> @@ -689,6 +716,21 @@ independently. This is a superset of distinct multitouch features.</td> </tr> <tr> + <td rowspan="2">USB</td> + <td><code>android.hardware.usb.host</code></td> + <td>The application uses USB host mode features (behaves as the host and connects to USB +devices).</td> + <td></td> +</tr> + +<tr> + <td><code>android.hardware.usb.accessory</code></td> + <td>The application uses USB accessory features (behaves as the USB device and connects to USB +hosts).</td> + <td></td> +</tr> + +<tr> <td>Wifi</td> <td><code>android.hardware.wifi</code></td> <td>The application uses 802.11 networking (wifi) features on the device.</td> @@ -729,9 +771,8 @@ in a separate <code><uses-feature></code> element. </p> <td><code>android.software.sip.voip</code></td> <td>Subfeature. The application uses SIP-based VOIP service on the device. </td> - <td>If declared with the <code>"android:required="true"</code> attribute, this -subfeature implicitly declares the <code>android.software.sip</code> -parent feature.</td> + <td>This subfeature implicitly declares the <code>android.software.sip</code> parent feature, +unless declared with <code>android:required="false"</code>.</td> </tr> </table> |