Loading docs/html/guide/topics/manifest/manifest-element.jd +2 −1 Original line number Original line Diff line number Diff line Loading @@ -25,7 +25,8 @@ page.title=<manifest> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-element.html"><permission></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-element.html"><permission></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-group-element.html"><permission-group></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-group-element.html"><permission-group></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-tree-element.html"><permission-tree></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-tree-element.html"><permission-tree></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html"><uses-permission></a></code></dd> <br/><code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html"><uses-permission></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><uses-sdk></a></code></dd> <p> <p> <dt>description:</dt> <dt>description:</dt> Loading docs/html/guide/topics/manifest/uses-sdk-element.jd +23 −11 Original line number Original line Diff line number Diff line Loading @@ -9,10 +9,10 @@ page.title=<uses-sdk> <dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> <dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> <dt>description:</dt> <dt>description:</dt> <dd>Declares which levels of the Android API the application can run against. <dd>Lets you express an application's compatibility with one or more versions of the Android platform, The level is incremented when there are additions to the API and resource tree, by means of an API Level integer. The API Level expressed by an application will be compared to the so an application developed using level 3 of the API may not run against level API Level of a given Android system, which may vary among different Android devices. To declare your 1 or 2, but should run against level 3, 4, 5, and above. application's minimum API Level compatibility, use the <a href="#min">minSdkVersion</a> attribute. </p> </p> <p> <p> Loading @@ -35,14 +35,26 @@ Applications</a>. for the application to run. for the application to run. <p> <p> Despite its name, this attribute is set to the API level, <em>not</em> to the Despite its name, this attribute specifies the API Level, <em>not</em> the version number of the SDK (software development kit). The API level is always version number of the SDK (software development kit). The API Level is always a single integer; the SDK version may be split into major and minor components a single integer; the SDK version may be split into major and minor components (such as 1.2). You cannot derive the API level from the SDK version number (such as 1.5). You cannot derive the API Level from the SDK version number (for example, it is not the same as the major version or the sum of the major (for example, it is not the same as the major version or the sum of the major and minor versions). To learn what the API level is, check the notes that and minor versions). To learn what the API Level is, check the notes that came with the SDK you're using. came with the SDK you're using.</p> </p></dd> <p>Prior to installing an application, the Android system checks the value of this attribute and allows the installation only if the API Level is less than or equal to the API Level used by the system itself.</p> <p>If you do not declare this attribute, then a value of "1" is assumed, which indicates that your application is compatible with all versions of Android. If your application is <em>not</em> universally compatible (for instance if it uses APIs introduced in Android 1.5) and you have not declared the proper <code>minSdkVersion</code>, then when installed on a system with a lower API Level, the application will crash during runtime. For this reason, be certain to declare the appropriate API Level in the <code>minSdkVersion</code> attribute.</p> </dd> </dl></dd> </dl></dd> Loading docs/html/sdk/android-1.1.jd +8 −11 Original line number Original line Diff line number Diff line Loading @@ -34,22 +34,19 @@ stored in the system itself. This identifier, called the "API Level", allows the system to correctly determine whether an application is compatible with system to correctly determine whether an application is compatible with the system, prior to installing the application. </p> the system, prior to installing the application. </p> <p>Applications can reference a specific API Level value in their <p>Applications indicate the lowest system API Level that they are compatible with by adding manifest files, to indicate the minimum version of the Android system a value to the <code>minSdkVersion</code> attribute. required to run the app. To reference a minimum API Level, applications can add a <code>minSdkVersion</code> attribute in their manifest files. The value of the attribute is an integer corresponding to an API Level The value of the attribute is an integer corresponding to an API Level identifier. Prior to installing an application, the system then checks the value of identifier. Prior to installing an application, the system checks the value of <code>minSdkVersion</code> and allows the install only <code>minSdkVersion</code> and allows the install only if the referenced integer is less than or equal to the API Level integer stored if the referenced integer is less than or equal to the API Level integer stored in the system itself. </p> in the system itself. </p> <p>If you use the Android 1.1 system image to build an application <p>If you use the Android 1.1 system image to build an application compatible with Android-powered devices running the Android 1.1 compatible with Android-powered devices running the Android 1.1 platform, please note that you <strong><span platform, you <strong style="color:red">must</strong> set the style="color:red;">must</span></strong> set the the <code>minSdkVersion</code> attribute to "2" in order to specify that your application <code>android:minSdkVersion</code> attribute in the application's is compatible only with devices using the Android 1.1 (or greater) system image. manifest to "2", which is the API strictly associated with Android 1.1. </p> </p> <p>Specifically, you specify the <code>android:minSdkVersion</code> <p>Specifically, you specify the <code>android:minSdkVersion</code> Loading @@ -59,7 +56,7 @@ attribute looks like this: </p> <pre><code><manifest> <pre><code><manifest> ... ... <uses-sdk minSdkVersion="2" /> <uses-sdk android:minSdkVersion="2" /> ... ... </manifest></code> </manifest></code> </pre> </pre> Loading Loading
docs/html/guide/topics/manifest/manifest-element.jd +2 −1 Original line number Original line Diff line number Diff line Loading @@ -25,7 +25,8 @@ page.title=<manifest> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-element.html"><permission></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-element.html"><permission></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-group-element.html"><permission-group></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-group-element.html"><permission-group></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-tree-element.html"><permission-tree></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/permission-tree-element.html"><permission-tree></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html"><uses-permission></a></code></dd> <br/><code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html"><uses-permission></a></code> <br/><code><a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><uses-sdk></a></code></dd> <p> <p> <dt>description:</dt> <dt>description:</dt> Loading
docs/html/guide/topics/manifest/uses-sdk-element.jd +23 −11 Original line number Original line Diff line number Diff line Loading @@ -9,10 +9,10 @@ page.title=<uses-sdk> <dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> <dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> <dt>description:</dt> <dt>description:</dt> <dd>Declares which levels of the Android API the application can run against. <dd>Lets you express an application's compatibility with one or more versions of the Android platform, The level is incremented when there are additions to the API and resource tree, by means of an API Level integer. The API Level expressed by an application will be compared to the so an application developed using level 3 of the API may not run against level API Level of a given Android system, which may vary among different Android devices. To declare your 1 or 2, but should run against level 3, 4, 5, and above. application's minimum API Level compatibility, use the <a href="#min">minSdkVersion</a> attribute. </p> </p> <p> <p> Loading @@ -35,14 +35,26 @@ Applications</a>. for the application to run. for the application to run. <p> <p> Despite its name, this attribute is set to the API level, <em>not</em> to the Despite its name, this attribute specifies the API Level, <em>not</em> the version number of the SDK (software development kit). The API level is always version number of the SDK (software development kit). The API Level is always a single integer; the SDK version may be split into major and minor components a single integer; the SDK version may be split into major and minor components (such as 1.2). You cannot derive the API level from the SDK version number (such as 1.5). You cannot derive the API Level from the SDK version number (for example, it is not the same as the major version or the sum of the major (for example, it is not the same as the major version or the sum of the major and minor versions). To learn what the API level is, check the notes that and minor versions). To learn what the API Level is, check the notes that came with the SDK you're using. came with the SDK you're using.</p> </p></dd> <p>Prior to installing an application, the Android system checks the value of this attribute and allows the installation only if the API Level is less than or equal to the API Level used by the system itself.</p> <p>If you do not declare this attribute, then a value of "1" is assumed, which indicates that your application is compatible with all versions of Android. If your application is <em>not</em> universally compatible (for instance if it uses APIs introduced in Android 1.5) and you have not declared the proper <code>minSdkVersion</code>, then when installed on a system with a lower API Level, the application will crash during runtime. For this reason, be certain to declare the appropriate API Level in the <code>minSdkVersion</code> attribute.</p> </dd> </dl></dd> </dl></dd> Loading
docs/html/sdk/android-1.1.jd +8 −11 Original line number Original line Diff line number Diff line Loading @@ -34,22 +34,19 @@ stored in the system itself. This identifier, called the "API Level", allows the system to correctly determine whether an application is compatible with system to correctly determine whether an application is compatible with the system, prior to installing the application. </p> the system, prior to installing the application. </p> <p>Applications can reference a specific API Level value in their <p>Applications indicate the lowest system API Level that they are compatible with by adding manifest files, to indicate the minimum version of the Android system a value to the <code>minSdkVersion</code> attribute. required to run the app. To reference a minimum API Level, applications can add a <code>minSdkVersion</code> attribute in their manifest files. The value of the attribute is an integer corresponding to an API Level The value of the attribute is an integer corresponding to an API Level identifier. Prior to installing an application, the system then checks the value of identifier. Prior to installing an application, the system checks the value of <code>minSdkVersion</code> and allows the install only <code>minSdkVersion</code> and allows the install only if the referenced integer is less than or equal to the API Level integer stored if the referenced integer is less than or equal to the API Level integer stored in the system itself. </p> in the system itself. </p> <p>If you use the Android 1.1 system image to build an application <p>If you use the Android 1.1 system image to build an application compatible with Android-powered devices running the Android 1.1 compatible with Android-powered devices running the Android 1.1 platform, please note that you <strong><span platform, you <strong style="color:red">must</strong> set the style="color:red;">must</span></strong> set the the <code>minSdkVersion</code> attribute to "2" in order to specify that your application <code>android:minSdkVersion</code> attribute in the application's is compatible only with devices using the Android 1.1 (or greater) system image. manifest to "2", which is the API strictly associated with Android 1.1. </p> </p> <p>Specifically, you specify the <code>android:minSdkVersion</code> <p>Specifically, you specify the <code>android:minSdkVersion</code> Loading @@ -59,7 +56,7 @@ attribute looks like this: </p> <pre><code><manifest> <pre><code><manifest> ... ... <uses-sdk minSdkVersion="2" /> <uses-sdk android:minSdkVersion="2" /> ... ... </manifest></code> </manifest></code> </pre> </pre> Loading
