Merge "docs: update SDK and AVD Manager strings; update android tool doc and update another AVD manager screenshot and finally change "component" to "package" for SDK manager docs" into ics-mr1
This commit is contained in:
@ -350,11 +350,11 @@ including the latest version, and provides an updater tool that you can use to
|
||||
download other platform versions as necessary. </p>
|
||||
|
||||
<p>To access the updater, use the <code>android</code> command-line tool,
|
||||
located in the <sdk>/tools directory. You can launch the Updater by using
|
||||
the <code>android</code> command without specifying any options. You can
|
||||
located in the <sdk>/tools directory. You can launch the SDK updater by
|
||||
executing <code>android sdk</code>. You can
|
||||
also simply double-click the android.bat (Windows) or android (OS X/Linux) file.
|
||||
In ADT, you can also access the updater by selecting
|
||||
<strong>Window</strong> > <strong>Android SDK and AVD
|
||||
<strong>Window</strong> > <strong>Android SDK
|
||||
Manager</strong>.</p>
|
||||
|
||||
<p>To run your application against different platform versions in the emulator,
|
||||
|
@ -202,12 +202,12 @@ ant release
|
||||
|
||||
<ol>
|
||||
<li>
|
||||
<strong>Open the SDK and AVD Manager and launch a virtual device</strong>
|
||||
<strong>Open the AVD Manager and launch a virtual device</strong>
|
||||
|
||||
<p>From your SDK's <code>platform-tools/</code> directory, execute the {@code android} tool with no
|
||||
arguments:</p>
|
||||
<p>From your SDK's <code>platform-tools/</code> directory, execute the {@code android} tool
|
||||
with the <code>avd</code> options:</p>
|
||||
<pre>
|
||||
android
|
||||
android avd
|
||||
</pre>
|
||||
|
||||
<p>In the <em>Virtual Devices</em> view, select an AVD and click <strong>Start</strong>.</p>
|
||||
@ -237,7 +237,7 @@ adb -s emulator-5554 install <em>path/to/your/app</em>.apk
|
||||
</ol>
|
||||
|
||||
<p>If you don't see your application on the emulator, try closing the emulator and launching the
|
||||
virtual device again from the SDK and AVD Manager. Sometimes when you install an application for the
|
||||
virtual device again from the AVD Manager. Sometimes when you install an application for the
|
||||
first time, it won't show up in the application launcher or be accessible by other applications.
|
||||
This is because the package manager usually examines manifests completely only on emulator
|
||||
startup.</p>
|
||||
|
@ -7,9 +7,9 @@ page.title=Managing Virtual Devices
|
||||
|
||||
<p>The easiest way to create an AVD is to use the graphical <a href=
|
||||
"{@docRoot}guide/developing/devices/managing-avds.html">AVD Manager</a>, which you launch
|
||||
from Eclipse by clicking <strong>Window > Android SDK and AVD Manager</strong>. You can also start
|
||||
the AVD Manager from the command line by calling the <code>android</code> tool in the <strong>tools</strong>
|
||||
directory of the Android SDK.</p>
|
||||
from Eclipse by clicking <strong>Window > AVD Manager</strong>. You can also start the AVD
|
||||
Manager from the command line by calling the <code>android</code> tool with the <code>avd</code>
|
||||
options, from the <strong><sdk>/tools/</strong> directory.</p>
|
||||
|
||||
<p>You can also create AVDs on the command line by passing the <code>android</code> tool options.
|
||||
For more information on how to create AVDs in this manner, see <a href=
|
||||
|
@ -42,8 +42,8 @@ parent.link=index.html
|
||||
<li>Start the AVD Manager:
|
||||
|
||||
<ul>
|
||||
<li>In Eclipse: select <strong>Window > Android SDK and AVD Manager</strong>, or click
|
||||
the Android SDK and AVD Manager icon in the Eclipse toolbar.</li>
|
||||
<li>In Eclipse: select <strong>Window > AVD Manager</strong>, or click
|
||||
the AVD Manager icon in the Eclipse toolbar.</li>
|
||||
|
||||
<li>In other IDEs: Navigate to your SDK's <code>tools/</code> directory and execute the
|
||||
<code>android</code> tool with no arguments.</li>
|
||||
@ -72,7 +72,7 @@ parent.link=index.html
|
||||
<li>Click <strong>Create AVD</strong>.</li>
|
||||
</ol>
|
||||
|
||||
<p>Your AVD is now ready and you can either close the SDK and AVD Manager, create more AVDs, or
|
||||
<p>Your AVD is now ready and you can either close the AVD Manager, create more AVDs, or
|
||||
launch an emulator with the AVD by selecting a device and clicking <strong>Start</strong>.</p>
|
||||
|
||||
<h3 id="hardwareopts">Hardware options</h3>
|
||||
|
@ -209,8 +209,8 @@ used.</dd>
|
||||
application uses code and resources from an example library project called TicTacToeLib.</p>
|
||||
|
||||
<p>To download the sample applications and run them as projects in
|
||||
your environment, use the <em>Android SDK and AVD Manager</em> to download the "Samples for
|
||||
SDK API 8" (or later) component into your SDK.</p>
|
||||
your environment, use the <em>Android SDK Manager</em> to download the "Samples for
|
||||
SDK API 8" (or later) package into your SDK.</p>
|
||||
|
||||
<p>For more information and to browse the code of the samples, see
|
||||
the <a href="{@docRoot}resources/samples/TicTacToeMain/index.html">TicTacToeMain
|
||||
@ -227,8 +227,8 @@ used.</dd>
|
||||
<p class="note"><strong>Note:</strong> You need SDK Tools r14 or newer to use the new library
|
||||
project feature that generates each library project into its own JAR file.
|
||||
You can download the tools and platforms using the
|
||||
<em>Android SDK and AVD Manager</em>, as described in
|
||||
<a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.</p>
|
||||
<em>Android SDK Manager</em>, as described in
|
||||
<a href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a>.</p>
|
||||
|
||||
<p>If you have source code and resources that are common to multiple Android projects, you
|
||||
can move them to a library project so that it is easier to maintain across applications and
|
||||
|
@ -102,9 +102,8 @@ Project site.</p>
|
||||
(<strong>Window > Open Perspective > Traceview</strong>). </li>
|
||||
|
||||
<li><a href="{@docRoot}guide/developing/tools/android.html">android</a>: Provides access to
|
||||
the Android SDK and AVD Manager. Other <code>android</code> features such as creating or
|
||||
updating projects (application and library) are integrated throughout the Eclipse IDE
|
||||
(<strong>Window > Android SDK and AVD Manager</strong>). </li>
|
||||
the Android SDK Manager and AVD Manager. Other <code>android</code> features such as creating or
|
||||
updating projects (application and library) are integrated throughout the Eclipse IDE. </li>
|
||||
|
||||
<li><a href="{@docRoot}guide/developing/debugging/debugging-ui.html#HierarchyViewer">Hierarchy
|
||||
Viewer</a>: Allows you to visualize your application's view hierarchy to find inefficiencies
|
||||
|
@ -15,9 +15,16 @@ Line</a>.</li>
|
||||
the Command Line</a>.</li>
|
||||
|
||||
<li>Update your Android SDK with new platforms, add-ons, and documentation. See <a href=
|
||||
"{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.</li>
|
||||
"{@docRoot}sdk/adding-components.html">Adding SDK Packages</a>.</li>
|
||||
</ul>If you are using Eclipse, the <code>android</code> tool's features are integrated
|
||||
into ADT, so you should not need to use this tool directly.
|
||||
|
||||
<p class="note"><strong>Note:</strong> The documentation of options below is not exhaustive
|
||||
and may be out of date. For the most current list of options, execute <code>android
|
||||
--help</code>.</p>
|
||||
|
||||
|
||||
|
||||
|
||||
<h2>Syntax</h2>
|
||||
<pre>android [global options] action [action options]</pre>
|
||||
@ -51,6 +58,26 @@ Line</a>.</li>
|
||||
<th>Comments</th>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td rowspan="6"><code>avd</code></td>
|
||||
|
||||
<td>None</td>
|
||||
|
||||
<td>Launch the AVD Manager</td>
|
||||
|
||||
<td></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td rowspan="6"><code>sdk</code></td>
|
||||
|
||||
<td>None</td>
|
||||
|
||||
<td>Launch the Android SDK Manager</td>
|
||||
|
||||
<td></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td rowspan="6"><code>create avd</code></td>
|
||||
|
||||
|
@ -12,8 +12,8 @@ latest Android platform.</p>
|
||||
<h2 id="tools-sdk">SDK Tools</h2>
|
||||
<p>The SDK tools are installed with the SDK starter package and are periodically updated.
|
||||
The SDK tools are required if you are developing Android applications. The most important SDK tools
|
||||
include the Android SDK and AVD Manager (<code>android</code>), the emulator
|
||||
(<code>emulator</code>), and the Dalvik Debug Monitor Server
|
||||
include the Android SDK Manager (<code>android sdk</code>), the AVD Manager (<code>android
|
||||
avd</code>) the emulator (<code>emulator</code>), and the Dalvik Debug Monitor Server
|
||||
(<code>ddms</code>). A short summary of some frequently-used SDK tools is provided below.</p>
|
||||
|
||||
<dl>
|
||||
|
@ -149,8 +149,8 @@ relies on these utility classes.</td>
|
||||
</table>
|
||||
|
||||
<p>The in-app billing sample application is available as a downloadable component of the Android
|
||||
SDK. To download the sample application component, launch the Android SDK and AVD Manager and then
|
||||
select the "Google Market Billing package" component (see figure 1), and click <strong>Install
|
||||
SDK. To download the sample application component, launch the Android SDK Manager and then
|
||||
select the <strong>Google Market Billing package</strong> component (see figure 1), and click <strong>Install
|
||||
Selected</strong> to begin the download.</p>
|
||||
|
||||
|
||||
@ -160,7 +160,7 @@ Selected</strong> to begin the download.</p>
|
||||
the AIDL file.
|
||||
</p>
|
||||
|
||||
<p>When the download is complete, the Android SDK and AVD Manager saves the component into the
|
||||
<p>When the download is complete, the Android SDK Manager saves the component into the
|
||||
following directory:</p>
|
||||
|
||||
<p><code><sdk>/extras/google/market_billing/</code></p>
|
||||
|
@ -58,8 +58,9 @@ information about the application and user—your application and the Google
|
||||
together to assemble the information and the Google Play client passes it to the server. </p>
|
||||
|
||||
<p>To help you add licensing to your application, the Android SDK provides a downloadable set of
|
||||
library sources that you can include in your application project: the "Google Market Licensing
|
||||
package." The License Verification Library (LVL) is a library you can add to your application that
|
||||
library sources that you can include in your application project: the Google Market
|
||||
Licensing package. The License Verification Library (LVL) is a library you can add to your
|
||||
application that
|
||||
handles all of the licensing-related communication with the Google Play licensing service. With
|
||||
the LVL added to your application, your application can determine its licensing status for the
|
||||
current user by simply calling a method and implementing a callback that receives the status
|
||||
@ -116,7 +117,7 @@ tampered with or that are spoofed.</p>
|
||||
|
||||
<h2 id="LVL">Licensing Verification Library</h2>
|
||||
|
||||
<p>The Android SDK provides a downloadable component called the "Google Market Licensing package,"
|
||||
<p>The Android SDK provides a downloadable package called the Google Market Licensing package,
|
||||
which includes the License Verification Library (LVL). The LVL greatly simplifies the process of
|
||||
adding licensing to your application and helps ensure a more secure, robust implementation for your
|
||||
application. The LVL provides internal classes that handle most of the standard operations of a
|
||||
@ -162,8 +163,8 @@ does not cache any response data and allows the application access <em>only</em>
|
||||
when the server returns a licensed response.</dd>
|
||||
</dl>
|
||||
|
||||
<p>The LVL is available as a downloadable component of the Android SDK. The
|
||||
component includes both the LVL itself and an example application that shows how
|
||||
<p>The LVL is available as a downloadable package of the Android SDK. The
|
||||
package includes both the LVL itself and an example application that shows how
|
||||
the library should be integrated with your application and how your application
|
||||
should manage response data, UI interaction, and error conditions. </p>
|
||||
|
||||
|
@ -173,25 +173,25 @@ your application without having publish it. For more information see <a
|
||||
href="#acct-signin">Signing in to an authorized account</a>, below.</p></li>
|
||||
</ul>
|
||||
|
||||
<p>Several versions of the add-on are available through the SDK Manager, but only
|
||||
<strong>Google APIs Add-On, API 8 (release 2) or higher</strong> includes the necessary Google
|
||||
<p>Several versions of the Google APIs add-on are available through the SDK Manager, but only
|
||||
the version for Android 2.2 and higher includes the necessary Google
|
||||
Play services.</p>
|
||||
|
||||
<p>To set up an emulator for adding licensing to an application, follow
|
||||
these steps: </p>
|
||||
|
||||
<ol>
|
||||
<li>Launch the Android SDK Manager. </li>
|
||||
<li>In the <strong>Available Packages</strong> panel, select and download the
|
||||
SDK component "Google APIs (Google Inc.) - API Level 8" (or higher) from the SDK
|
||||
repository.
|
||||
<p>When the download is complete, use the Android SDK Manager to
|
||||
create a new AVD based on that component, described next.</p></li>
|
||||
<li>In the <strong>Virtual
|
||||
Devices</strong> panel of the Android SDK Manager, click
|
||||
<li>Launch the Android SDK Manager (available under the Eclipse <strong>Window</strong>
|
||||
menu or by executing {@code <sdk>/tools/android sdk}).</li>
|
||||
<li>Select and download <strong>Google APIs</strong> for the Android version you'd like to target
|
||||
(must be Android 2.2 or higher).</li>
|
||||
<li>When the download is complete, open the AVD Manager (available under the Eclipse
|
||||
<strong>Window</strong>
|
||||
menu or by executing {@code <sdk>/tools/android avd}).</li>
|
||||
<li>Click
|
||||
<strong>New</strong> and set the configuration details for the new AVD. </li>
|
||||
<li>In the dialog that appears, assign a descriptive name to the AVD and then
|
||||
use the "Target" menu to choose the "Google APIs (Google Inc.) - API Level 8" as
|
||||
use the Target menu to choose the <strong>Google APIs</strong> as
|
||||
the system image to run on the new AVD. Set the other configuration details as
|
||||
needed and then click <strong>Create AVD</strong> to finish. The SDK tools
|
||||
create the new AVD configuration, which then appears in the list of available
|
||||
@ -238,8 +238,8 @@ greatly simplify the work that you need to do to add licensing to your
|
||||
application. In all cases, we recommend that you download the LVL and use it as
|
||||
the basis for the licensing implementation in your application.</p>
|
||||
|
||||
<p>The LVL is available as a downloadable component of the Android SDK. The
|
||||
component includes: </p>
|
||||
<p>The LVL is available as a downloadable package of the Android SDK. The
|
||||
package includes: </p>
|
||||
|
||||
<ul>
|
||||
<li>The LVL sources, stored inside an Android library project. </li>
|
||||
@ -248,9 +248,9 @@ project. The example illustrates how an application uses the library helper
|
||||
classes to check and enforce licensing.</li>
|
||||
</ul>
|
||||
|
||||
<p>To download the LVL component into your development environment, use the
|
||||
<p>To download the LVL package into your development environment, use the
|
||||
Android SDK Manager. Launch the Android SDK Manager and then
|
||||
select the "Google Market Licensing" component, as shown in figure 2.
|
||||
select the <strong>Google Market Licensing</strong> package, as shown in figure 2.
|
||||
Accept the terms and click <strong>Install Selected</strong> to begin the download. </p>
|
||||
|
||||
<img src="{@docRoot}images/licensing_package.png" alt=""/>
|
||||
@ -265,8 +265,8 @@ the LVL library project and the example application into these directories: </p>
|
||||
<code><<em>sdk</em>>/extras/google/market_licensing/sample/</code> (the example
|
||||
application)</p>
|
||||
|
||||
<p>If you aren't familiar with how to download components into your SDK, see the
|
||||
<a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>
|
||||
<p>If you aren't familiar with how to download packess into your SDK, see the
|
||||
<a href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a>
|
||||
document. </p>
|
||||
|
||||
|
||||
@ -676,7 +676,7 @@ credentials. </p>
|
||||
|
||||
<ol>
|
||||
<li>Open Settings > Accounts & sync</li>
|
||||
<li>Select <strong>Add Account</strong> and choose to add a "Google" account.
|
||||
<li>Select <strong>Add Account</strong> and choose to add a Google account.
|
||||
</li>
|
||||
<li>Select <strong>Next</strong> and then <strong>Sign in</strong>.</li>
|
||||
<li>Enter the username and password of either the publisher account or a test
|
||||
|
@ -108,7 +108,7 @@ SDK with the new platform:</p>
|
||||
SDK starter package now</a>.)</p>
|
||||
|
||||
<ol>
|
||||
<li><a href="{@docRoot}sdk/adding-components.html#launching">Launch the Android SDK and AVD
|
||||
<li><a href="{@docRoot}sdk/adding-components.html#launching">Launch the Android SDK
|
||||
Manager</a> and install the following:
|
||||
<ul>
|
||||
<li>SDK Platform Android 3.0</li>
|
||||
@ -147,7 +147,7 @@ Android 3.0, the emulator is still best way to evaluate your application's appea
|
||||
functionality on Android 3.0.</p>
|
||||
|
||||
<p class="note"><strong>Tip:</strong> To improve the startup time for the emulator, enable snapshots
|
||||
for the AVD when you create it with the SDK and AVD Manager (there's a checkbox in the AVD creator
|
||||
for the AVD when you create it with the AVD Manager (there's a checkbox in the AVD creator
|
||||
to <strong>Enable</strong> snapshots). Then, start the AVD from the AVD manager and check <b>Launch
|
||||
from snapshot</b> and <b>Save to snapshot</b>. This way, when you close the emulator, a snapshot of
|
||||
the AVD state is saved and used to quickly relaunch the AVD next time. However, when you choose to
|
||||
@ -281,7 +281,7 @@ to help you add features from Android 3.0 without requiring you to change your <
|
||||
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code android:minSdkVersion}</a>
|
||||
or build target, we're providing a static library called the <a
|
||||
href="{@docRoot}sdk/compatibility-library.html">Compatibility Library</a>
|
||||
(downloadable from the AVD and SDK Manager).</p>
|
||||
(downloadable from the Android SDK Manager).</p>
|
||||
<p>This library includes APIs for <a
|
||||
href="{@docRoot}guide/topics/fundamentals/fragments.html">fragments</a>, <a
|
||||
href="{@docRoot}guide/topics/fundamentals/loaders.html">loaders</a>, and some updated classes. By
|
||||
@ -421,7 +421,7 @@ href="{@docRoot}sdk/android-3.0.html">Android 3.0 Platform</a> document.</p>
|
||||
href="{@docRoot}sdk/android-3.0.html#api">Android 3.0 Platform</a> document also have accompanying
|
||||
samples that allow you to preview the effects and can help you understand how to use them. To get
|
||||
the samples, download them from the SDK repository <a href="{@docRoot}sdk/adding-components.html"
|
||||
>using the Android SDK and AVD Manager</a>. After downloading the samples ("Samples for SDK API
|
||||
>using the Android SDK Manager</a>. After downloading the samples ("Samples for SDK API
|
||||
11"), you can find them in <code><sdk_root>/samples/android-11/</code>. The following list
|
||||
provides links to the browsable source code for some of the samples:</p>
|
||||
|
||||
|
@ -1242,12 +1242,12 @@ have to buy various devices just to test your application's screen support.</p>
|
||||
<p>To set up an environment for testing your application's screen support, you should create a
|
||||
series of AVDs (Android Virtual Devices), using emulator skins and screen configurations that
|
||||
emulate the screen sizes and densities you want your application to support. To do so, you can use
|
||||
the Android SDK and AVD Manager to create the AVDs and launch them with a graphical interface.</p>
|
||||
the AVD Manager to create the AVDs and launch them with a graphical interface.</p>
|
||||
|
||||
<p>To launch the Android SDK and AVD Manager, execute the {@code
|
||||
<p>To launch the Android SDK Manager, execute the {@code
|
||||
SDK Manager.exe} from your Android SDK directory (on Windows only) or execute {@code android} from
|
||||
the {@code <sdk>/tools/} directory (on all platforms). Figure 6 shows the Android SDK and
|
||||
AVD Manager with a selection of AVDs, for testing various screen configurations.</p>
|
||||
the {@code <sdk>/tools/} directory (on all platforms). Figure 6 shows the AVD
|
||||
Manager with a selection of AVDs, for testing various screen configurations.</p>
|
||||
|
||||
<p>Table 3 shows the various emulator skins that are available in the Android SDK, which you can use
|
||||
to emulate some of the most common screen configurations.</p>
|
||||
@ -1340,7 +1340,7 @@ dashboard.</p>
|
||||
<div class="figure" style="width:204px">
|
||||
<img src="{@docRoot}images/screens_support/avd-start.png" alt="" />
|
||||
<p class="img-caption"><strong>Figure 7.</strong>
|
||||
Size and density options you can set, when starting an AVD from the Android SDK and AVD
|
||||
Size and density options you can set, when starting an AVD from the AVD
|
||||
Manager.</p>
|
||||
</div>
|
||||
|
||||
@ -1349,12 +1349,12 @@ up to run at a physical size that closely matches an actual device. This makes
|
||||
it a lot easier to compare the results at various sizes and densities. To
|
||||
do so you need to know the approximate density, in dpi, of your computer
|
||||
monitor (for instance, a 30" Dell monitor has a density of about 96 dpi). When you launch an AVD
|
||||
from the Android SDK and AVD Manager, you can specify the screen size for the emulator and your
|
||||
from the AVD Manager, you can specify the screen size for the emulator and your
|
||||
monitor dpi in the Launch Options, as shown in figure 7.</p>
|
||||
|
||||
<p>If you would like to test your application on a screen that uses a resolution
|
||||
or density not supported by the built-in skins, you can create an AVD that uses a custom resolution
|
||||
or density. When creating the AVD from the Android SDK and AVD Manager, specify the Resolution,
|
||||
or density. When creating the AVD from the AVD Manager, specify the Resolution,
|
||||
instead of selecting a Built-in Skin.</p>
|
||||
|
||||
<p>If you are launching your AVD from the command line, you can specify the scale for
|
||||
|
@ -98,7 +98,7 @@ Google APIs add-on, visit</p>
|
||||
href="http://code.google.com/android/add-ons/google-apis">http://code.google.com/android/add-ons/google-apis</a></p>
|
||||
|
||||
<p>For your convenience, the Google APIs add-on is also available as a downloadable component from
|
||||
the Android SDK and AVD Manager (see <a href="{@docRoot}sdk/adding-components.html">Adding SDK
|
||||
the Android SDK Manager (see <a href="{@docRoot}sdk/adding-components.html">Adding SDK
|
||||
Components</a>).</p>
|
||||
|
||||
<p class="note"><strong>Note:</strong> In order to display Google Maps data in a
|
||||
|
@ -501,7 +501,7 @@ If you are using SDK Tools r8 or higher, you can find <code>aapt</code> in the
|
||||
<p class="note"><strong>Note:</strong> You must use the version of
|
||||
<code>aapt</code> that is provided for the latest Platform-Tools component available. If
|
||||
you do not have the latest Platform-Tools component, download it using the <a
|
||||
href="{@docRoot}sdk/adding-components.html">Android SDK and AVD Manager</a>.
|
||||
href="{@docRoot}sdk/adding-components.html">Android SDK Manager</a>.
|
||||
</p></li>
|
||||
<li>Run <code>aapt</code> using this syntax: </li>
|
||||
</ol>
|
||||
|
@ -14,8 +14,8 @@ location:</p>
|
||||
href="http://code.google.com/android/add-ons/google-apis">http://code.google.com/android/add-ons/google-apis</a></p>
|
||||
|
||||
<p>The Google APIs add-on requires Android 1.5 SDK or later release. After
|
||||
installing the add-on in your SDK, set your project properties to use the build
|
||||
target called "Google APIs Add-on". See the instructions for setting a build
|
||||
installing the add-on in your SDK, set your project properties to use a <strong>Google
|
||||
APIs</strong> build target. See the instructions for setting a build
|
||||
target in <a href="{@docRoot}guide/developing/eclipse-adt.html">Developing in
|
||||
Eclipse with ADT</a> or <a
|
||||
href="{@docRoot}guide/developing/other-ide.html">Developing in Other IDEs</a>,
|
||||
|
Binary file not shown.
Before Width: | Height: | Size: 57 KiB After Width: | Height: | Size: 65 KiB |
@ -40,7 +40,7 @@ tools</li>
|
||||
<p>Follow the guide to <a href="{@docRoot}sdk/installing.html">Installing the Android SDK</a>, which
|
||||
will help you setup your development environment.</p>
|
||||
|
||||
<h3>If you've installed new SDK components using the SDK and AVD Manager</h3>
|
||||
<h3>If you've installed new SDK components using the Android SDK Manager</h3>
|
||||
|
||||
<p>There's no additional setup.</p>
|
||||
|
||||
|
@ -26,15 +26,15 @@ needed!</p>
|
||||
<p>The SDK sample code is available to you as a set of downloadable SDK
|
||||
components, each of which contains the samples for a specific Android platform
|
||||
version. Once you have installed the SDK, you can download one or more samples
|
||||
component(s) into your SDK environment using the Android SDK and AVD Manager
|
||||
component(s) into your SDK environment using the Android SDK Manager
|
||||
tool, which is pre-installed in the SDK. </p>
|
||||
|
||||
<p>To download the samples, launch the Android SDK and AVD Manager tool and
|
||||
<p>To download the samples, launch the Android SDK Manager tool and
|
||||
select one of the samples components from the <strong>Available
|
||||
Packages</strong> panel, for example "Samples for SDK API 7". Select
|
||||
<strong>Install Selected</strong>, verify and accept the download, then select
|
||||
<strong>Install Accepted</strong> to download the component into your SDK. If
|
||||
you aren't familiar with the Android SDK and AVD Manager and how to launch or
|
||||
you aren't familiar with the Android SDK Manager and how to launch or
|
||||
use it, please read the <a href="{@docRoot}sdk/adding-components.html">Adding
|
||||
SDK Components</a> document. </p>
|
||||
|
||||
@ -74,7 +74,7 @@ From there you can read a short summary of each sample application and what
|
||||
types of concepts, features, or APIs it includes. Then, use the links provided
|
||||
to move through the directories and files of each sample. The browseable source
|
||||
is generated from the same source code that is downloadable through the Android
|
||||
SDK and AVD Manager, as described above. </p>
|
||||
SDK Manager, as described above. </p>
|
||||
|
||||
<p>The browseable samples files are available online, at the Android Developers
|
||||
site only and are not included in the downloadable offline documentation.
|
||||
|
@ -42,7 +42,7 @@ you need to do it now.</p>
|
||||
|
||||
<ol>
|
||||
|
||||
<li>In the Android SDK and AVD Manager, choose <strong>Available
|
||||
<li>In the Android SDK Manager, choose <strong>Available
|
||||
Packages</strong> in the left panel.</li>
|
||||
|
||||
<li>In the right panel, expand the Android Repository list to display
|
||||
@ -72,7 +72,7 @@ device settings used by the emulator.</p>
|
||||
|
||||
<p>To create an AVD:</p>
|
||||
<ol>
|
||||
<li>In Eclipse, select <strong>Window > Android SDK and AVD Manager</strong>.</li>
|
||||
<li>In Eclipse, select <strong>Window > AVD Manager</strong>.</li>
|
||||
<li>Select <strong>Virtual Devices</strong> in the left panel.</li>
|
||||
|
||||
<li>Click <strong>New...</strong>.
|
||||
|
@ -163,7 +163,7 @@ parent.link=../../browser.html?tag=tutorial
|
||||
open the Android SDK and AVD Manager and check in the
|
||||
<strong>Installed Packages</strong> panel.
|
||||
If aren't sure how to download a platform into your SDK,
|
||||
read <a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.
|
||||
read <a href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a>.
|
||||
</p>
|
||||
</li>
|
||||
</ul>
|
||||
|
@ -1,4 +1,4 @@
|
||||
page.title=Adding SDK Components
|
||||
page.title=Adding SDK Packages
|
||||
@jd:body
|
||||
|
||||
|
||||
@ -6,74 +6,74 @@ page.title=Adding SDK Components
|
||||
<div id="qv">
|
||||
<h2>Quickview</h2>
|
||||
<ul>
|
||||
<li>Use the Android SDK and AVD Manager to
|
||||
<li>Use the Android SDK Manager to
|
||||
set up your SDK and keep it up-to-date.</li>
|
||||
</ul>
|
||||
|
||||
<h2>In this document</h2>
|
||||
<ol>
|
||||
<li><a href="#launching">Launching the Android SDK and AVD Manager</a>
|
||||
<li><a href="#InstallingComponents">Installing SDK Components</a>
|
||||
<li><a href="#UpdatingComponents">Updating SDK Components</a>
|
||||
<li><a href="#dependencies">Component Dependencies</a></li>
|
||||
<li><a href="#launching">Launching the Android SDK Manager</a>
|
||||
<li><a href="#InstallingComponents">Installing SDK Packages</a>
|
||||
<li><a href="#UpdatingComponents">Updating SDK Packages</a>
|
||||
<li><a href="#dependencies">Package Dependencies</a></li>
|
||||
<li><a href="#AddingSites">Adding New Sites</a></li>
|
||||
<li><a href="#troubleshooting">Troubleshooting</a></li>
|
||||
</ol>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<p>Adding and updating components in your Android SDK is fast and easy. To add or
|
||||
update the individual SDK components that you need, use the <em>Android SDK and AVD
|
||||
<p>Adding and updating packages in your Android SDK is fast and easy. To add or
|
||||
update the individual SDK packages that you need, use the <em>Android SDK
|
||||
Manager</em> (included in the SDK Tools).</p>
|
||||
|
||||
<p>It only takes a couple of clicks to install individual versions of the
|
||||
Android platform, new development tools, new documentation, and SDK add-ons. The
|
||||
new SDK components are automatically installed into your existing SDK directory,
|
||||
new SDK packages are automatically installed into your existing SDK directory,
|
||||
so you don't need to update your development environment to specify a new SDK
|
||||
location.</p>
|
||||
|
||||
<p>If you're setting up your Android SDK for the first time,
|
||||
see <a href="{@docRoot}sdk/installing.html#components">Installing the SDK</a> for information about
|
||||
what components to install.</p>
|
||||
what packages to install.</p>
|
||||
|
||||
<p class="note"><strong>Note:</strong> If you develop in Eclipse, you might also need
|
||||
to update your ADT plugin when you update your development tools. See the revisions listed in the
|
||||
<a href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin for Eclipse</a> document.</p>
|
||||
|
||||
<img src="{@docRoot}images/sdk_manager_packages.png" alt="" />
|
||||
<p class="img-caption"><strong>Figure 1.</strong> The Android SDK and AVD Manager's
|
||||
<strong>Available Packages</strong> panel, which shows the SDK components that are
|
||||
<p class="img-caption"><strong>Figure 1.</strong> The Android SDK Manager's
|
||||
<strong>Available Packages</strong> panel, which shows the SDK packages that are
|
||||
available for you to download into your environment. </p>
|
||||
</div>
|
||||
|
||||
<h2 id="launching">Launching the Android SDK and AVD Manager</h2>
|
||||
<h2 id="launching">Launching the Android SDK Manager</h2>
|
||||
|
||||
<p>The Android SDK and AVD Manager is the tool that you use to install and
|
||||
upgrade SDK components in your development environment. </p>
|
||||
<p>The Android SDK Manager is the tool that you use to install and
|
||||
upgrade SDK packages in your development environment. </p>
|
||||
|
||||
<p>You can launch the Android SDK and AVD Manager in one of the following ways.</p>
|
||||
<p>You can launch the Android SDK Manager in one of the following ways.</p>
|
||||
|
||||
<h4>Launching from Eclipse/ADT</h4>
|
||||
|
||||
<p>If you are developing in Eclipse and have already installed the ADT Plugin,
|
||||
follow these steps to access the Android SDK and AVD Manager tool:</p>
|
||||
follow these steps to access the Android SDK Manager tool:</p>
|
||||
|
||||
<ol>
|
||||
<li>Open Eclipse</li>
|
||||
<li>Select <strong>Window</strong> > <strong>Android SDK and AVD
|
||||
<li>Select <strong>Window</strong> > <strong>Android SDK
|
||||
Manager</strong>.</li>
|
||||
</ol>
|
||||
|
||||
<h4>Launching from the SDK Manager script (Windows only)</h4>
|
||||
|
||||
<p>For Windows only, the SDK includes a script that invokes the Android SDK and
|
||||
AVD Manager. To launch the tool using the script, double-click {@code SDK
|
||||
<p>For Windows only, the SDK includes a script that invokes the Android SDK Manager. To launch the
|
||||
tool using the script, double-click {@code SDK
|
||||
Manager.exe} at the root of the the SDK directory.</p>
|
||||
|
||||
<h4>Launching from a command line</h4>
|
||||
|
||||
<p>In all development environments, follow these steps to access the Android SDK
|
||||
and AVD Manager tool from the command line: </p>
|
||||
<p>In all development environments, follow these steps to access the Android SDK Manager tool from
|
||||
the command line: </p>
|
||||
|
||||
<ol>
|
||||
<li>Navigate to the <code><<em>sdk</em>>/tools/</code> directory.</li>
|
||||
@ -82,26 +82,26 @@ and AVD Manager tool from the command line: </p>
|
||||
</ol>
|
||||
|
||||
|
||||
<h2 id="InstallingComponents">Installing SDK Components</h2>
|
||||
<h2 id="InstallingComponents">Installing SDK Packages</h2>
|
||||
|
||||
<p class="caution"><strong>Caution:</strong> Before you install SDK components,
|
||||
<p class="caution"><strong>Caution:</strong> Before you install SDK packages,
|
||||
we recommend that you disable any antivirus software that may be running on
|
||||
your computer. There are cases in which antivirus software on Windows is known to interfere with the
|
||||
installation process, so we suggest you disable your antivirus until installation is
|
||||
complete.</p>
|
||||
|
||||
<p>Follow these steps to install new SDK components in your environment:</p>
|
||||
<p>Follow these steps to install new SDK packages in your environment:</p>
|
||||
|
||||
<ol>
|
||||
<li>Launch the Android SDK and AVD Manager as described in the section above.</li>
|
||||
<li>Launch the Android SDK Manager as described in the section above.</li>
|
||||
<li>Select <strong>Available Packages</strong> in the left panel.
|
||||
This will reveal all of the components that are currently available for download
|
||||
This will reveal all of the packages that are currently available for download
|
||||
from the SDK repository.</li>
|
||||
<li>Select the component(s) you'd like to install and click <strong>Install
|
||||
<li>Select the package(s) you'd like to install and click <strong>Install
|
||||
Selected</strong>. (If you aren't sure which packages to select, read <a
|
||||
href="installing.html#which">Recommended Components</a>.)</li>
|
||||
<li>Verify and accept the components you want (ensure each one is selected with a green
|
||||
checkmark) and click <strong>Install</strong>. The components will now be installed into
|
||||
href="installing.html#which">Recommended Packages</a>.)</li>
|
||||
<li>Verify and accept the packages you want (ensure each one is selected with a green
|
||||
checkmark) and click <strong>Install</strong>. The packages will now be installed into
|
||||
your existing Android SDK directories.</li>
|
||||
</ol>
|
||||
|
||||
@ -114,60 +114,60 @@ and new documentation is saved in the existing
|
||||
<code><sdk>/docs/</code> directory (old docs are replaced).</p>
|
||||
|
||||
|
||||
<h2 id="UpdatingComponents">Updating SDK Components</h2>
|
||||
<h2 id="UpdatingComponents">Updating SDK Packages</h2>
|
||||
|
||||
<p>From time to time, new revisions of existing SDK components are released and
|
||||
<p>From time to time, new revisions of existing SDK packages are released and
|
||||
made available to you through the SDK repository. In most cases, if you have those
|
||||
components installed in your environment, you will want
|
||||
packages installed in your environment, you will want
|
||||
to download the new revisions as soon as possible. </p>
|
||||
|
||||
<p>You can learn about the release of new revisions in two ways: </p>
|
||||
|
||||
<ul>
|
||||
<li>You can watch for updates listed in the "SDK" tab of the Android Developers
|
||||
site, in the "Downloadable SDK Components" section. </li>
|
||||
site, in the "Downloadable SDK Packages" section. </li>
|
||||
<li>You can watch for updates listed in the <strong>Available Packages</strong>
|
||||
panel of the Android SDK and AVD Manager. </li>
|
||||
panel of the Android SDK Manager. </li>
|
||||
</ul>
|
||||
|
||||
<p>When you see that a new revision is available, you can use the Android SDK
|
||||
and AVD Manager to quickly download it to your environment. Follow the same
|
||||
procedure as given in <a href="#InstallingComponents">Installing SDK Components</a>, above. The new
|
||||
component is installed in place of the old, but without impacting your
|
||||
<p>When you see that a new revision is available, you can use the Android SDK Manager to quickly
|
||||
download it to your environment. Follow the same
|
||||
procedure as given in <a href="#InstallingComponents">Installing SDK Packages</a>, above. The new
|
||||
package is installed in place of the old, but without impacting your
|
||||
applications. </p>
|
||||
|
||||
<p class="note"><strong>Tip:</strong>
|
||||
Use the "Display updates only" checkbox to show only the components
|
||||
Use the "Display updates only" checkbox to show only the packages
|
||||
you do not have.</p>
|
||||
|
||||
|
||||
<h2 id="dependencies">SDK Component Dependencies</h2>
|
||||
<h2 id="dependencies">SDK Package Dependencies</h2>
|
||||
|
||||
<p>In some cases, an SDK component may require a specific minimum revision of
|
||||
another component or SDK tool. Where such dependencies exist, they are
|
||||
documented in the revision notes for each component, available from the links in
|
||||
the "Downloadable SDK Components" section at left.</p>
|
||||
<p>In some cases, an SDK package may require a specific minimum revision of
|
||||
another package or SDK tool. Where such dependencies exist, they are
|
||||
documented in the revision notes for each package, available from the links in
|
||||
the "Downloadable SDK packages" section at left.</p>
|
||||
|
||||
<p>For example, there may be a dependency between the ADT Plugin for Eclipse and
|
||||
the SDK Tools component. When you install the SDK Tools
|
||||
component, you should also upgrade to the required version of ADT (if you
|
||||
the SDK Tools package. When you install the SDK Tools
|
||||
package, you should also upgrade to the required version of ADT (if you
|
||||
are developing in Eclipse). In this case, the major version number for your ADT plugin should
|
||||
always match the revision number of your SDK Tools (for example, ADT 8.x requires SDK Tools r8).
|
||||
</p>
|
||||
|
||||
<p>Also make sure that, each time you install a new version of the Android platform, you have
|
||||
the latest version of the SDK Platform-tools component. The SDK Platform-tools contain
|
||||
the latest version of the SDK Platform-tools package. The SDK Platform-tools contain
|
||||
tools that are backward compatible with all versions of the Android platform and are
|
||||
often updated to support new features in the latest version of the Android platform.</p>
|
||||
|
||||
<p>The development tools will notify you with debug warnings if there is dependency that you need to
|
||||
address. The SDK and AVD Manager also enforces dependencies by requiring that you download any
|
||||
components that are needed by those you have selected.</p>
|
||||
address. The Android SDK Manager also enforces dependencies by requiring that you download any
|
||||
packages that are needed by those you have selected.</p>
|
||||
|
||||
|
||||
<h2 id="AddingSites">Adding New Sites</h2>
|
||||
|
||||
<p>By default, <strong>Available Packages</strong> displays components available from the
|
||||
<p>By default, <strong>Available Packages</strong> displays packages available from the
|
||||
<em>Android Repository</em> and <em>Third party Add-ons</em>. You can add other sites that host
|
||||
their own Android SDK add-ons, then download the SDK add-ons
|
||||
from those sites.</p>
|
||||
@ -178,7 +178,7 @@ to develop using their libraries, you must install their Android SDK add-on, if
|
||||
available under <em>Third party Add-ons</em>. </p>
|
||||
|
||||
<p>If a carrier or device manufacturer has hosted an SDK add-on repository file
|
||||
on their web site, follow these steps to add their site to the SDK and AVD
|
||||
on their web site, follow these steps to add their site to the Android SDK
|
||||
Manager:</p>
|
||||
|
||||
<ol>
|
||||
@ -186,7 +186,7 @@ Manager:</p>
|
||||
<li>Click <strong>Add Add-on Site</strong> and enter the URL of the
|
||||
{@code repository.xml} file. Click <strong>OK</strong>.</li>
|
||||
</ol>
|
||||
<p>Any SDK components available from the site will now be listed under a new item named
|
||||
<p>Any SDK packages available from the site will now be listed under a new item named
|
||||
<strong>User Add-ons</strong>.</p>
|
||||
|
||||
|
||||
@ -194,12 +194,12 @@ Manager:</p>
|
||||
|
||||
<p><strong>Problems connecting to the SDK repository</strong></p>
|
||||
|
||||
<p>If you are using the SDK and AVD Manager to download components and are encountering
|
||||
<p>If you are using the Android SDK Manager to download packages and are encountering
|
||||
connection problems, try connecting over http, rather than https. To switch the
|
||||
protocol used by the SDK and AVD Manager, follow these steps: </p>
|
||||
protocol used by the Android SDK Manager, follow these steps: </p>
|
||||
|
||||
<ol>
|
||||
<li>With the Android SDK and AVD Manager window open, select "Settings" in the
|
||||
<li>With the Android SDK Manager window open, select "Settings" in the
|
||||
left pane. </li>
|
||||
<li>On the right, in the "Misc" section, check the checkbox labeled "Force
|
||||
https://... sources to be fetched using http://..." </li>
|
||||
|
@ -25,7 +25,8 @@ Differences Report »</a> </li>
|
||||
|
||||
<h2>See Also</h2>
|
||||
<ol>
|
||||
<li><a href="{@docRoot}guide/practices/optimizing-for-3.0.html">Optimizing Apps for Android 3.0</a></li>
|
||||
<li><a href="{@docRoot}guide/practices/tablets-and-handsets.html">Supporting Tablets and
|
||||
Handsets</a></li>
|
||||
</ol>
|
||||
|
||||
</div>
|
||||
@ -41,7 +42,7 @@ libraries.</p>
|
||||
|
||||
<p>To get started developing or testing against Android {@sdkPlatformVersion}, use the Android SDK
|
||||
Manager to download the platform into your SDK. For more information, see <a
|
||||
href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>. If you are new to Android, <a
|
||||
href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a>. If you are new to Android, <a
|
||||
href="{@docRoot}sdk/index.html">download the SDK Starter Package</a> first.</p>
|
||||
|
||||
<p>For a high-level introduction to Android {@sdkPlatformVersion}, see the <a
|
||||
@ -52,8 +53,8 @@ Highlights</a>.</p>
|
||||
If you've already published an Android application, please test and optimize your application on
|
||||
Android 3.0 as soon as possible. You should do so to be sure your application provides the best
|
||||
experience possible on the latest Android-powered devices. For information about what you can do,
|
||||
read <a href="{@docRoot}guide/practices/optimizing-for-3.0.html">Optimizing Apps for Android
|
||||
3.0</a>.</p>
|
||||
read <a href="{@docRoot}guide/practices/tablets-and-handsets.html">Supporting Tablets and
|
||||
Handsets</a>.</p>
|
||||
|
||||
|
||||
<h2 id="relnotes">Revisions</h2>
|
||||
|
@ -330,13 +330,13 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w
|
||||
|
||||
<h2 id="Downloading">Downloading the Support Package</h2>
|
||||
|
||||
<p>The Support Package is provided as a downloadable package from the Android SDK and AVD
|
||||
<p>The Support Package is provided as a downloadable package from the Android SDK
|
||||
Manager. To install:</p>
|
||||
|
||||
<ol>
|
||||
<li>Launch the SDK and AVD Manager.
|
||||
<li>Launch the Android SDK Manager.
|
||||
<p>From Eclipse, you can select <strong>Window</strong>
|
||||
> <strong>Android SDK and AVD Manager</strong>. Or, launch {@code SDK Manager.exe} from
|
||||
> <strong>Android SDK Manager</strong>. Or, launch {@code SDK Manager.exe} from
|
||||
the {@code <sdk>/} directory (on Windows only) or {@code android} from the {@code
|
||||
<sdk>/tools/} directory.</p></li>
|
||||
<li>Expand the Android Repository, check <strong>Android Support package</strong>
|
||||
|
@ -36,7 +36,7 @@ that is designed to give you a powerful, integrated environment in which
|
||||
to build Android applications.</p>
|
||||
|
||||
<p>ADT extends the capabilities of Eclipse to let you quickly set up new Android
|
||||
projects, create an application UI, add components based on the Android
|
||||
projects, create an application UI, add packages based on the Android
|
||||
Framework API, debug your applications using the Android SDK tools, and even
|
||||
export signed (or unsigned) {@code .apk} files in order to distribute your application.</p>
|
||||
|
||||
@ -468,7 +468,7 @@ ADT 12.0.0</a> <em>(July 2011)</em>
|
||||
|
||||
<dd>ADT 12.0.0 is designed for use with <a href="{@docRoot}sdk/tools-notes.html">SDK Tools r12</a>. If you haven't
|
||||
already installed SDK Tools r12 into your SDK, use
|
||||
the Android SDK and AVD Manager to do so.</dd>
|
||||
the Android SDK Manager to do so.</dd>
|
||||
|
||||
<dt>Visual Layout Editor:</dt>
|
||||
<dd>
|
||||
@ -520,7 +520,7 @@ ADT 11.0.0</a> <em>(June 2011)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<dd>ADT 11.0.0 is designed for use with SDK Tools r11. If you haven't
|
||||
already installed SDK Tools r11 into your SDK, use the Android SDK and AVD Manager to do
|
||||
already installed SDK Tools r11 into your SDK, use the Android SDK Manager to do
|
||||
so.</dd>
|
||||
|
||||
<dt>Visual Refactoring:</dt>
|
||||
@ -656,7 +656,7 @@ ADT 10.0.1</a> <em>(March 2011)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<dd>ADT 10.0.1 is designed for use with SDK Tools r10. If you haven't
|
||||
already installed SDK Tools r10 into your SDK, use the Android SDK and AVD Manager to do
|
||||
already installed SDK Tools r10 into your SDK, use the Android SDK Manager to do
|
||||
so.</dd>
|
||||
|
||||
<dt>General notes:</dt>
|
||||
@ -686,7 +686,7 @@ ADT 10.0.0</a> <em>(February 2011)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<dd>ADT 10.0.0 is designed for use with SDK Tools r10. If you haven't
|
||||
already installed SDK Tools r10 into your SDK, use the Android SDK and AVD Manager to do
|
||||
already installed SDK Tools r10 into your SDK, use the Android SDK Manager to do
|
||||
so.</dd>
|
||||
|
||||
<dt>General notes:</dt>
|
||||
@ -736,7 +736,7 @@ ADT 9.0.0</a> <em>(January 2011)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<dd>ADT 9.0.0 is designed for use with SDK Tools r9. If you haven't
|
||||
already installed SDK Tools r9 into your SDK, use the Android SDK and AVD Manager to do
|
||||
already installed SDK Tools r9 into your SDK, use the Android SDK Manager to do
|
||||
so.</dd>
|
||||
|
||||
<dt>General notes:</dt>
|
||||
@ -845,7 +845,7 @@ ADT 8.0.1</a> <em>(December 2010)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<p><p>ADT 8.0.1 is designed for use with SDK Tools r8. If you haven't
|
||||
already installed SDK Tools r8 into your SDK, use the Android SDK and AVD Manager to do
|
||||
already installed SDK Tools r8 into your SDK, use the Android SDK Manager to do
|
||||
so.</p></dd>
|
||||
|
||||
<dt>General notes:</dt>
|
||||
@ -874,7 +874,7 @@ ADT 8.0.0</a> <em>(December 2010)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<p><p>ADT 8.0.0 is designed for use with SDK Tools r8. If you haven't
|
||||
already installed SDK Tools r8 into your SDK, use the Android SDK and AVD Manager to do
|
||||
already installed SDK Tools r8 into your SDK, use the Android SDK Manager to do
|
||||
so.</p></dd>
|
||||
|
||||
<dt>General notes:</dt>
|
||||
@ -1020,8 +1020,8 @@ ADT 0.9.6</a> <em>(March 2010)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<dd><p>ADT 0.9.6 is designed for use with SDK Tools r5 and later. Before
|
||||
updating to ADT 0.9.6, we highly recommend that you use the Android SDK and
|
||||
AVD Manager to install SDK Tools r5 into your SDK.</p></dd>
|
||||
updating to ADT 0.9.6, we highly recommend that you use the Android SDK Manager to install SDK
|
||||
Tools r5 into your SDK.</p></dd>
|
||||
|
||||
<dt>General Notes:</dt>
|
||||
<dd>
|
||||
@ -1038,8 +1038,8 @@ first time with the SDK Usage panel.</li>
|
||||
<dt>AVD/SDK Manager:</dt>
|
||||
<dd>
|
||||
<ul>
|
||||
<li>Adds support for platform samples components.</li>
|
||||
<li>Improves support for dependency between components.</li>
|
||||
<li>Adds support for platform samples packages.</li>
|
||||
<li>Improves support for dependency between packages.</li>
|
||||
<li>AVDs now sorted by API level.</li>
|
||||
<li>The AVD creation dialog now enforces a minimum SD card size of 9MB.</li>
|
||||
<li>Prevents deletion of running AVDs.</li>
|
||||
@ -1087,9 +1087,9 @@ ADT 0.9.5</a> <em>(December 2009)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<dd><p>ADT 0.9.5 requires features provided in SDK Tools r4 or higher. If you install
|
||||
ADT 0.9.5, which is highly recommended, you should use the Android SDK and AVD
|
||||
ADT 0.9.5, which is highly recommended, you should use the Android SDK
|
||||
Manager to download the latest SDK Tools into your SDK. For more information,
|
||||
see <a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.</p>
|
||||
see <a href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a>.</p>
|
||||
</dd>
|
||||
|
||||
<dt>General notes:</dt>
|
||||
@ -1114,9 +1114,9 @@ ADT 0.9.4</a> <em>(October 2009)</em>
|
||||
<dt>Dependencies:</dt>
|
||||
|
||||
<dd><p>ADT 0.9.4 requires features provided in SDK Tools r3 or higher. If you install
|
||||
ADT 0.9.4, which is highly recommended, you should use the Android SDK and AVD
|
||||
ADT 0.9.4, which is highly recommended, you should use the Android SDK
|
||||
Manager to download the latest SDK Tools into your SDK. For more information,
|
||||
see <a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.</p>
|
||||
see <a href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a>.</p>
|
||||
</dd>
|
||||
|
||||
<dt>Project Creation Wizard:</dt>
|
||||
@ -1318,9 +1318,9 @@ to follow these steps again instead of the default update instructions.</p>
|
||||
<h4>Other install errors</h4>
|
||||
|
||||
<p>Note that there are features of ADT that require some optional
|
||||
Eclipse components (for example, WST). If you encounter an error when
|
||||
installing ADT, your Eclipse installion might not include these components.
|
||||
For information about how to quickly add the necessary components to your
|
||||
Eclipse packages (for example, WST). If you encounter an error when
|
||||
installing ADT, your Eclipse installion might not include these packages.
|
||||
For information about how to quickly add the necessary packages to your
|
||||
Eclipse installation, see the troubleshooting topic
|
||||
<a href="{@docRoot}resources/faq/troubleshooting.html#installeclipsecomponents">ADT
|
||||
Installation Error: "requires plug-in org.eclipse.wst.sse.ui"</a>.</p>
|
||||
@ -1345,9 +1345,9 @@ you should update to it as soon as convenient. </p>
|
||||
|
||||
<p>In some cases, a new revision of ADT will have a dependency on a specific
|
||||
revision of the Android SDK Tools. If such dependencies exist, you will need to
|
||||
update the SDK Tools component of the SDK after installing the new revision of
|
||||
ADT. To update the SDK Tools component, use the Android SDK and AVD Manager, as
|
||||
described in <a href="adding-components.html">Adding SDK Components</a>.</p>
|
||||
update the SDK Tools package of the SDK after installing the new revision of
|
||||
ADT. To update the SDK Tools package, use the Android SDK Manager, as
|
||||
described in <a href="adding-components.html">Adding SDK Packages</a>.</p>
|
||||
|
||||
<p>To learn about new features of each ADT revision and also any dependencies on
|
||||
the SDK Tools, see the listings in the <a href="#notes">Revisions</a>
|
||||
|
@ -28,7 +28,7 @@ sdk.linux_checksum=14e99dfa8eb1a8fadd2f3557322245c4
|
||||
<li>Install the SDK starter package from the table above. (If you're on Windows, download the
|
||||
installer for help with the initial setup.)</li>
|
||||
<li>Install the ADT Plugin for Eclipse (if you'll be developing in Eclipse).</li>
|
||||
<li>Add Android platforms and other components to your SDK.</li>
|
||||
<li>Add Android platforms and other packages to your SDK.</li>
|
||||
<li>Explore the contents of the Android SDK (optional).</li>
|
||||
</ol>
|
||||
|
||||
|
@ -53,10 +53,10 @@ function toggleDiv(link) {
|
||||
<li><a href="#Preparing">1. Preparing Your Development Computer</a></li>
|
||||
<li><a href="#Installing">2. Downloading the SDK Starter Package</a></li>
|
||||
<li><a href="#InstallingADT">3. Installing the ADT Plugin for Eclipse</a></li>
|
||||
<li><a href="#AddingComponents">4. Adding Platforms and Other Components</a>
|
||||
<li><a href="#AddingComponents">4. Adding Platforms and Other Packages</a>
|
||||
<ol>
|
||||
<li><a href="#components">Available Components</a></li>
|
||||
<li><a href="#which">Recommended Components</a></li>
|
||||
<li><a href="#components">Available Packages</a></li>
|
||||
<li><a href="#which">Recommended Packages</a></li>
|
||||
</ol></li>
|
||||
<li><a href="#sdkContents">5. Exploring the SDK (Optional)</a></li>
|
||||
<li><a href="#NextSteps">Next Steps</a></li>
|
||||
@ -66,7 +66,7 @@ function toggleDiv(link) {
|
||||
<h2>See also</h2>
|
||||
<ol>
|
||||
<li><a href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin for Eclipse</a></li>
|
||||
<li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a></li>
|
||||
<li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a></li>
|
||||
</ol>
|
||||
|
||||
</div>
|
||||
@ -81,9 +81,9 @@ this page.</p>
|
||||
|
||||
<h4>Updating?</h4>
|
||||
|
||||
<p>If you already have an Android SDK, use the Android SDK and AVD Manager tool to install
|
||||
<p>If you already have an Android SDK, use the Android SDK Manager tool to install
|
||||
updated tools and new Android platforms into your existing environment. For information about how to
|
||||
do that, see <a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.</p>
|
||||
do that, see <a href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a>.</p>
|
||||
|
||||
|
||||
<h2 id="Preparing">Step 1. Preparing Your Development Computer</h2>
|
||||
@ -111,7 +111,7 @@ RCP version of Eclipse is recommended.</p>
|
||||
|
||||
<p>The SDK starter package is not a full
|
||||
development environment—it includes only the core SDK Tools, which you can
|
||||
use to download the rest of the SDK components (such as the latest Android platform).</p>
|
||||
use to download the rest of the SDK packages (such as the latest Android platform).</p>
|
||||
|
||||
<p>If you haven't already, get the latest version of the SDK starter package from the <a
|
||||
href="{@docRoot}sdk/index.html">SDK download page</a>.</p>
|
||||
@ -154,53 +154,53 @@ developing in Eclipse or other IDEs.</p>
|
||||
|
||||
|
||||
|
||||
<h2 id="AddingComponents">Step 4. Adding Platforms and Other Components</h2>
|
||||
<h2 id="AddingComponents">Step 4. Adding Platforms and Other Packages</h2>
|
||||
|
||||
<p>The last step in setting up your SDK is using the Android SDK and AVD Manager (a
|
||||
tool included in the SDK starter package) to download essential SDK components into your development
|
||||
<p>The last step in setting up your SDK is using the Android SDK Manager (a
|
||||
tool included in the SDK starter package) to download essential SDK packages into your development
|
||||
environment.</p>
|
||||
|
||||
<p>The SDK uses a modular structure that separates the major parts of the SDK—Android platform
|
||||
versions, add-ons, tools, samples, and documentation—into a set of separately installable
|
||||
components. The SDK starter package, which you've already downloaded, includes only a single
|
||||
component: the latest version of the SDK Tools. To develop an Android application, you also need to
|
||||
packages. The SDK starter package, which you've already downloaded, includes only a single
|
||||
package: the latest version of the SDK Tools. To develop an Android application, you also need to
|
||||
download at least one Android platform and the associated platform tools. You can add other
|
||||
components and platforms as well, which is highly recommended.</p>
|
||||
packages and platforms as well, which is highly recommended.</p>
|
||||
|
||||
<p>If you used the Windows installer, when you complete the installation wizard, it will launch the
|
||||
Android SDK and AVD Manager with a default set of platforms and other components selected
|
||||
Android SDK Manager with a default set of platforms and other packages selected
|
||||
for you to install. Simply click <strong>Install</strong> to accept the recommended set of
|
||||
components and install them. You can then skip to <a href="#sdkContents">Step 5</a>, but we
|
||||
recommend you first read the section about the <a href="#components">Available Components</a> to
|
||||
better understand the components available from the Android SDK and AVD Manager.</p>
|
||||
packages and install them. You can then skip to <a href="#sdkContents">Step 5</a>, but we
|
||||
recommend you first read the section about the <a href="#components">Available Packages</a> to
|
||||
better understand the packages available from the Android SDK Manager.</p>
|
||||
|
||||
<p>You can launch the Android SDK and AVD Manager in one of the following ways:</p>
|
||||
<p>You can launch the Android SDK Manager in one of the following ways:</p>
|
||||
<ul>
|
||||
<li>From within Eclipse, select <strong>Window > Android SDK and AVD Manager</strong>.</li>
|
||||
<li>From within Eclipse, select <strong>Window > Android SDK Manager</strong>.</li>
|
||||
<li>On Windows, double-click the <code>SDK Manager.exe</code> file at the root of the Android
|
||||
SDK directory.</li>
|
||||
<li>On Mac or Linux, open a terminal and navigate to the <code>tools/</code> directory in the
|
||||
Android SDK, then execute: <pre>android</pre> </li>
|
||||
</ul>
|
||||
|
||||
<p>To download components, use the graphical UI of the Android SDK and AVD
|
||||
<p>To download packages, use the graphical UI of the Android SDK
|
||||
Manager to browse the SDK repository and select new or updated
|
||||
components (see figure 1). The Android SDK and AVD Manager installs the selected components in
|
||||
your SDK environment. For information about which components you should download, see <a
|
||||
href="#which">Recommended Components</a>.</p>
|
||||
packages (see figure 1). The Android SDK Manager installs the selected packages in
|
||||
your SDK environment. For information about which packages you should download, see <a
|
||||
href="#which">Recommended Packages</a>.</p>
|
||||
|
||||
<img src="/images/sdk_manager_packages.png" />
|
||||
<p class="img-caption"><strong>Figure 1.</strong> The Android SDK and AVD Manager's
|
||||
<strong>Available Packages</strong> panel, which shows the SDK components that are
|
||||
<p class="img-caption"><strong>Figure 1.</strong> The Android SDK Manager's
|
||||
<strong>Available Packages</strong> panel, which shows the SDK packages that are
|
||||
available for you to download into your environment.</p>
|
||||
|
||||
|
||||
<h3 id="components">Available Components</h3>
|
||||
<h3 id="components">Available Packages</h3>
|
||||
|
||||
<p>By default, there are two repositories of components for your SDK: <em>Android
|
||||
<p>By default, there are two repositories of packages for your SDK: <em>Android
|
||||
Repository</em> and <em>Third party Add-ons</em>.</p>
|
||||
|
||||
<p>The <em>Android Repository</em> offers these types of components:</p>
|
||||
<p>The <em>Android Repository</em> offers these types of packages:</p>
|
||||
|
||||
<ul>
|
||||
<li><strong>SDK Tools</strong> — Contains tools for debugging and testing your application
|
||||
@ -219,9 +219,9 @@ developer guide.</li>
|
||||
|
||||
<li><strong>Android platforms</strong> — An SDK platform is
|
||||
available for every production Android platform deployable to Android-powered devices. Each
|
||||
SDK platform component includes a fully compliant Android library, system image, sample code,
|
||||
SDK platform package includes a fully compliant Android library, system image, sample code,
|
||||
and emulator skins. To learn more about a specific platform, see the list of platforms that appears
|
||||
under the section "Downloadable SDK Components" on the left part of this page.</li>
|
||||
under the section "Downloadable SDK Packages" on the left part of this page.</li>
|
||||
|
||||
<li><strong>USB Driver for Windows</strong> (Windows only) — Contains driver files
|
||||
that you can install on your Windows computer, so that you can run and debug
|
||||
@ -243,16 +243,16 @@ tutorials. --></li>
|
||||
multiversion documentation for the Android framework API. </li>
|
||||
</ul>
|
||||
|
||||
<p>The <em>Third party Add-ons</em> provide components that allow you to create a development
|
||||
<p>The <em>Third party Add-ons</em> provide packages that allow you to create a development
|
||||
environment using a specific Android external library (such as the Google Maps library) or a
|
||||
customized (but fully compliant) Android system image. You can add additional Add-on repositories by
|
||||
clicking <strong>Add Add-on Site</strong>.</p>
|
||||
|
||||
|
||||
<h3 id="which">Recommended Components</h3>
|
||||
<h3 id="which">Recommended Packages</h3>
|
||||
|
||||
<p>The SDK repository contains a range of components that you can download.
|
||||
Use the table below to determine which components you need, based on whether you
|
||||
<p>The SDK repository contains a range of packages that you can download.
|
||||
Use the table below to determine which packages you need, based on whether you
|
||||
want to set up a basic, recommended, or full development environment:
|
||||
</p>
|
||||
|
||||
@ -260,7 +260,7 @@ want to set up a basic, recommended, or full development environment:
|
||||
|
||||
<tr>
|
||||
<th>Environment</th>
|
||||
<th>SDK Component</th>
|
||||
<th>SDK Package</th>
|
||||
<th>Comments</th>
|
||||
</tr>
|
||||
|
||||
@ -268,8 +268,8 @@ want to set up a basic, recommended, or full development environment:
|
||||
<td rowspan="3" style="font-size:.9em;background-color:#FFE;">Basic</td>
|
||||
<td style="font-size:.9em;background-color:#FFE;">SDK Tools</td>
|
||||
<td style="font-size:.9em;background-color:#FFE;">If you've just installed
|
||||
the SDK starter package, then you already have the latest version of this component. The
|
||||
SDK Tools component is required to develop an Android application. Make sure you keep this up to
|
||||
the SDK starter package, then you already have the latest version of this package. The
|
||||
SDK Tools package is required to develop an Android application. Make sure you keep this up to
|
||||
date.</td>
|
||||
</tr>
|
||||
|
||||
@ -300,21 +300,21 @@ style="border:none"></td>
|
||||
<tr>
|
||||
<td rowspan="3">Recommended<br/>(plus Basic)</td>
|
||||
<td>Documentation</td>
|
||||
<td>The Documentation component is useful because it lets you work offline and
|
||||
<td>The Documentation package is useful because it lets you work offline and
|
||||
also look up API reference information from inside Eclipse.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td>Samples</td>
|
||||
<td>The Samples components give you source code that you can use to learn about
|
||||
<td>The Samples packages give you source code that you can use to learn about
|
||||
Android, load as a project and run, or reuse in your own app. Note that multiple
|
||||
samples components are available — one for each Android platform version. When
|
||||
you are choosing a samples component to download, select the one whose API Level
|
||||
samples packages are available — one for each Android platform version. When
|
||||
you are choosing a samples package to download, select the one whose API Level
|
||||
matches the API Level of the Android platform that you plan to use.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Usb Driver</td>
|
||||
<td>The Usb Driver component is needed only if you are developing on Windows and
|
||||
<td>The Usb Driver package is needed only if you are developing on Windows and
|
||||
have an Android-powered device on which you want to install your application for
|
||||
debugging and testing. For Mac OS X and Linux platforms, no
|
||||
special driver is needed.</td>
|
||||
@ -344,12 +344,12 @@ applications on different platforms by running in an Android Virtual Device
|
||||
|
||||
</table>
|
||||
|
||||
<p>Once you've installed at least the basic configuration of SDK components, you're ready to start
|
||||
<p>Once you've installed at least the basic configuration of SDK packages, you're ready to start
|
||||
developing Android apps. The next section describes the contents of the Android SDK to familiarize
|
||||
you with the components you've just installed.</p>
|
||||
you with the packages you've just installed.</p>
|
||||
|
||||
<p>For more information about using the Android SDK and AVD Manager, see the <a
|
||||
href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a> document. </p>
|
||||
<p>For more information about using the Android SDK Manager, see the <a
|
||||
href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a> document. </p>
|
||||
|
||||
|
||||
<h2 id="sdkContents">Step 5. Exploring the SDK (Optional)</h2>
|
||||
@ -358,7 +358,7 @@ href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a> document.
|
||||
and add-ons that you need, we suggest that you open the SDK directory and take a look at what's
|
||||
inside.</p>
|
||||
|
||||
<p>The table below describes the full SDK directory contents, with components
|
||||
<p>The table below describes the full SDK directory contents, with packages
|
||||
installed. </p>
|
||||
|
||||
<table>
|
||||
@ -405,20 +405,21 @@ platform version.</td>
|
||||
<tr>
|
||||
<td colspan="3"><code>tools/</code></td>
|
||||
<td>Contains the set of development and profiling tools that are platform-independent, such
|
||||
as the emulator, the Android SDK and AVD Manager, <code>ddms</code>, <code>hierarchyviewer</code>
|
||||
and more. The tools in this directory may be updated at any time using the Android SDK and AVD
|
||||
as the emulator, the Android SDK Manager, the AVD Manager, <code>ddms</code>,
|
||||
<code>hierarchyviewer</code>
|
||||
and more. The tools in this directory may be updated at any time using the Android SDK
|
||||
Manager and are independent of platform releases.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td colspan="3"><code>SDK Readme.txt</code></td>
|
||||
<td>A file that explains how to perform the initial setup of your SDK,
|
||||
including how to launch the Android SDK and AVD Manager tool on all
|
||||
including how to launch the Android SDK Manager tool on all
|
||||
platforms.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td colspan="3"><code>SDK Manager.exe</code></td>
|
||||
<td>Windows SDK only. A shortcut that launches the Android SDK and AVD
|
||||
Manager tool, which you use to add components to your SDK.</td>
|
||||
<td>Windows SDK only. A shortcut that launches the Android SDK
|
||||
Manager tool, which you use to add packages to your SDK.</td>
|
||||
</tr>
|
||||
<!--<tr>
|
||||
<td colspan="3"><code>documentation.html</code></td>
|
||||
@ -531,7 +532,7 @@ second step in getting started with Android development. </p>
|
||||
<li>The Android SDK includes sample code and applications for each platform
|
||||
version. You can browse the samples in the <a
|
||||
href="{@docRoot}resources/index.html">Resources</a> tab or download them
|
||||
into your SDK using the Android SDK and AVD Manager. Once you've downloaded the
|
||||
into your SDK using the Android SDK Manager. Once you've downloaded the
|
||||
samples, you'll find them in
|
||||
<code><em><sdk></em>/samples/<em><platform>/</em></code>. </li>
|
||||
</ul>
|
||||
|
@ -55,7 +55,7 @@ class="new">new!</span></li>
|
||||
/if ?>
|
||||
<li>
|
||||
<span class="heading">
|
||||
<span class="en">Downloadable SDK Components</span>
|
||||
<span class="en">Downloadable SDK Packages</span>
|
||||
<span style="display:none" class="de"></span>
|
||||
<span style="display:none" class="es"></span>
|
||||
<span style="display:none" class="fr"></span>
|
||||
@ -66,7 +66,7 @@ class="new">new!</span></li>
|
||||
</span>
|
||||
<ul>
|
||||
<li><a href="<?cs var:toroot ?>sdk/adding-components.html">
|
||||
<span class="en">Adding SDK Components</span>
|
||||
<span class="en">Adding SDK Packages</span>
|
||||
<span style="display:none" class="de"></span>
|
||||
<span style="display:none" class="es"></span>
|
||||
<span style="display:none" class="fr"></span>
|
||||
|
@ -12,7 +12,7 @@ page.title=Google USB Driver
|
||||
<ol>
|
||||
<li><a href="{@docRoot}sdk/oem-usb.html#InstallingDriver">Installing a USB Driver</a></li>
|
||||
<li><a href="{@docRoot}guide/developing/device.html">Using Hardware Devices</a></li>
|
||||
<li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a></li>
|
||||
<li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Packages</a></li>
|
||||
</ol>
|
||||
</div>
|
||||
</div>
|
||||
@ -51,7 +51,7 @@ for Windows. </p>
|
||||
<p>The sections below provide notes about successive revisions of the USB Driver
|
||||
for Windows, as denoted by revision number. To determine what revision of the
|
||||
USB Driver for Windows you are using, refer to the "Installed Packages" listing
|
||||
in the Android SDK and AVD Manager.</p>
|
||||
in the Android SDK Manager.</p>
|
||||
|
||||
<script type="text/javascript">
|
||||
function toggleDiv(link) {
|
||||
@ -149,7 +149,7 @@ for the T-Mobile G1 and myTouch 3G (and similar devices).</p></dt>
|
||||
|
||||
<div class="figure" style="width:536px;margin:0">
|
||||
<img src="{@docRoot}images/developing/sdk-usb-driver.png" alt="" />
|
||||
<p class="img-caption"><strong>Figure 1.</strong> The SDK and AVD Manager
|
||||
<p class="img-caption"><strong>Figure 1.</strong> The SDK Manager
|
||||
with the Google USB Driver selected.</p>
|
||||
</div>
|
||||
|
||||
@ -158,10 +158,10 @@ component. You need the driver only if you are developing on Windows and
|
||||
want to connect an Android-powered device (ADP, Nexus One, or Nexus S) to your
|
||||
development environment over USB. </p>
|
||||
|
||||
<p>To download the driver, use the Android SDK and AVD Manager tool that is
|
||||
<p>To download the driver, use the Android SDK Manager tool that is
|
||||
included with the <a href="{@docRoot}sdk/index.html">Android SDK</a>:</p>
|
||||
<ol>
|
||||
<li>Launch the SDK and AVD Manager by double-clicking <code>SDK Manager.exe</code>,
|
||||
<li>Launch the Android SDK Manager by double-clicking <code>SDK Manager.exe</code>,
|
||||
at the root of your SDK directory.</li>
|
||||
<li>Expand <em>Extras</em>.</li>
|
||||
<li>Check <strong>Google USB Driver package</strong> and click <strong>Install</strong>.</li>
|
||||
|
Reference in New Issue
Block a user