Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

am c4c42eef: docs: add default value and compatibility info for installLocation

Browse Source 
Merge commit 'c4c42eef9a62846a152094d61987e6dd2728e417' into froyo-plus-aosp

* commit 'c4c42eef9a62846a152094d61987e6dd2728e417':
  docs: add default value and compatibility info for installLocation
This commit is contained in:
Scott Main
2010-05-10 09:43:47 -07:00
committed by Android Git Automerger
parent d2f2a80e9f c4c42eef9a
commit fe5921aa7e
1 changed files with 21 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
docs/html/guide/topics/manifest/manifest-element.jd
View File

@@ -110,7 +110,6 @@ the significant version number used internally.
<dt><a name="install"></a>{@code android:installLocation}</dt> <dt><a name="install"></a>{@code android:installLocation}</dt>
<dd>The default install location for the application. <dd>The default install location for the application.
<p>This attribute was introduced in API Level 8.</p>
<p>The following keyword strings are accepted:</p> <p>The following keyword strings are accepted:</p>
@@ -118,24 +117,32 @@ the significant version number used internally.
<tr> <tr>
<th>Value</th> <th>Value</th>
<th>Description</th> <th>Description</th>
</tr><tr>
<td>"{@code auto}"</td>
<td>Let the system decide the ideal install location. This will usually be based on the user's
saved preference.</td>
</tr><tr> </tr><tr>
<td>"{@code internalOnly}"</td> <td>"{@code internalOnly}"</td>
<td>The application requests to be installed on the internal device storage only. If this is set, <td>The application must be installed on the internal device storage only. If this is set,
then the application will never be installed on the external storage (SD card). If the internal the application will never be installed on the external storage. If the internal
storage is full, then the system will not install the application.</td> storage is full, then the system will not install the application. This is also the default behavior
if you do not define {@code android:installLocation}.</td>
</tr><tr>
<td>"{@code auto}"</td>
<td>The application may be installed on the external storage, but the system will install the
application on the internal storage by default. If the internal storage is full, then the system
will install it on the external storage. Once installed, the user can move the application
to either internal or external storage through the system settings.</td>
</tr><tr> </tr><tr>
<td>"{@code preferExternal}"</td> <td>"{@code preferExternal}"</td>
<td>The application prefers to be installed on the external storage (SD card). There is no <td>The application prefers to be installed on the external storage (SD card). There is no
guarantee that the system will honor this request. The application might be installed on internal guarantee that the system will honor this request. The application might be installed on internal
storage if the external media is unavailable or full, or if the application uses the forward-locking storage if the external media is unavailable or full, or if the application uses the forward-locking
mechanism (not supported on external storage).</td> mechanism (not supported on external storage). Once installed, the user can move the application to
either internal or external storage through the system settings.</td>
</tr> </tr>
</table> </table>
<p class="note"><strong>Note:</strong> By default, your application will be installed on the
internal storage and cannot be installed on the external storage unless you define this attribute
to be either "{@code auto}" or "{@code preferExternal}".</p>
<p>When an application is installed on the external storage:</p> <p>When an application is installed on the external storage:</p>
<ul> <ul>
<li>The {@code .apk} file is saved <li>The {@code .apk} file is saved
@@ -150,8 +157,9 @@ multiple SD cards can be used with the same device.</li>
<p>The user may also request to move an application from the internal storage to the external <p>The user may also request to move an application from the internal storage to the external
storage. However, the system will not allow the user to move the application to external storage if storage. However, the system will not allow the user to move the application to external storage if
this attribute is set to {@code internalOnly}. this attribute is set to {@code internalOnly}, which is the default setting.</p>
</p>
<p>Introduced in: API Level 8.</p>
</dd> </dd>
@@ -164,6 +172,7 @@ this attribute is set to {@code internalOnly}.
<p> <p>
<dt>see also:</dt> <dt>see also:</dt>
<dd><code><a href="{@docRoot}guide/topics/manifest/application-element.html">&lt;application&gt;</a></code></dd> <dd><a href="{@docRoot}guide/appendix/install-location.html">App Install Location</a><br/>
<code><a href="{@docRoot}guide/topics/manifest/application-element.html">&lt;application&gt;</a></code></dd>
</dl> </dl>