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

am d6b9d078: Merge "docs: misc changes to sdk setup docs update sdk manager screenshot; update info about new manager UI; more info about the windows installer;" into gingerbread

Browse Source 
* commit 'd6b9d078ecf1b4d7cc57375830cf2ce390fc893c':
  docs: misc changes to sdk setup docs update sdk manager screenshot; update info about new manager UI; more info about the windows installer;
This commit is contained in:
Scott Main
2010-11-11 17:02:54 -08:00
committed by Android Git Automerger
parent 9acf04ab6a d6b9d078ec
commit 16555c60f7
4 changed files with 91 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
docs/html/images/sdk_manager_packages.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 78 KiB

After

Width:  |  Height:  |  Size: 86 KiB

33
docs/html/sdk/adding-components.jd
View File

@@ -98,20 +98,20 @@ complete.</p>
This will reveal all of the components 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
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 and click <strong>Install
Accepted</strong>. The components will now be installed into your existing
Android SDK directories.</li>
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
your existing Android SDK directories.</li>
</ol>
<p>New platforms are automatically saved into the
<code>&lt;<em>sdk</em>&gt;/platforms/</code> directory of your SDK;
new add-ons are saved in the <code>&lt;<em>sdk</em>&gt;/add-ons/</code>
<code>&lt;sdk&gt;/platforms/</code> directory of your SDK;
new add-ons are saved in the <code>&lt;sdk&gt;/add-ons/</code>
directory; samples are saved in the
<code>&lt;<em>sdk</em>&gt;/samples/android-&lt;<em>level</em>&gt;/</code>;
<code>&lt;sdk&gt;/samples/android-&lt;level&gt;/</code>;
and new documentation is saved in the existing
<code>&lt;<em>sdk</em>&gt;/docs/</code> directory (old docs are replaced).</p>
<code>&lt;sdk&gt;/docs/</code> directory (old docs are replaced).</p>
<h2 id="UpdatingComponents">Updating SDK Components</h2>
@@ -167,15 +167,15 @@ components that are needed by those you have selected.</p>
<h2 id="AddingSites">Adding New Sites</h2>
<p>By default, <strong>Available Packages</strong> only shows the default
repository site, which offers platforms, SDK tools, documentation, the
Google APIs Add-on, and other components. You can add other sites that host
<p>By default, <strong>Available Packages</strong> displays components 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>
<p>For example, a mobile carrier or device manufacturer might offer additional
API libraries that are supported by their own Android-powered devices. In order
to develop using their libraries, you must install their Android SDK add-on. </p>
to develop using their libraries, you must install their Android SDK add-on, if it's not already
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
@@ -183,11 +183,12 @@ Manager:</p>
<ol>
<li>Select <strong>Available Packages</strong> in the left panel.</li>
<li>Click <strong>Add Site</strong> and enter the URL of the
<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
<strong>Available Packages</strong>.</p>
<p>Any SDK components available from the site will now be listed under a new item named
<strong>User Add-ons</strong>.</p>
<h2 id="troubleshooting">Troubleshooting</h2>

3
docs/html/sdk/index.jd
View File

@@ -23,7 +23,8 @@ sdk.linux_checksum=TODO
<ol>
<li>Prepare your development computer and ensure it meets the system requirements.</li>
<li>Install the SDK starter package from the table above.</li>
<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>Explore the contents of the Android SDK (optional).</li>

129
docs/html/sdk/installing.jd
View File

@@ -56,6 +56,7 @@ function toggleDiv(link) {
<li><a href="#InstallingADT">3. Installing the ADT Plugin for Eclipse</a></li>
<li><a href="#components">4. Adding Platforms and Other Components</a>
<ol>
<li><a href="#components">Available Components</a></li>
<li><a href="#which">Recommended Components</a></li>
</ol></li>
<li><a href="#sdkContents">5. Exploring the SDK (Optional)</a></li>
@@ -119,52 +120,14 @@ href="{@docRoot}sdk/index.html">SDK download page</a>.</p>
it to a safe location on your machine. By default, the SDK files are unpacked
into a directory named <code>android-sdk-&lt;machine-platform&gt;</code>.</p>
<p>Make a note of the name and
location of the unpacked SDK directory on your system&mdash;you will need to
<p>If you downloaded the Windows installer ({@code .exe} file), run it now and it will check
whether the proper Java SE Development Kit (JDK) is installed (installing it, if necessary), then
install the SDK Tools into a default location (which you can modify).</p>
<p>Make a note of the name and location of the SDK directory on your system&mdash;you will need to
refer to the SDK directory later, when setting up the ADT plugin and when using
the SDK tools from command line.</p>
<p>Optionally, you might want to add the location of the SDK's
<code>tools/</code> directory and {@code platform-tools/} directory to your system
<code>PATH</code>. Both tool directories are located at the root of the SDK folder.
<div class="toggleable closed">
<a href="#" onclick="return toggleDiv(this)">
<img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
width="9px" />
How to update your PATH</a>
<div class="toggleme">
<p>Adding
<code>tools/</code> and {@code platform-tools/} to your path lets you run Android Debug Bridge (adb)
and the other command line <a
href="{@docRoot}guide/developing/tools/index.html">tools</a> without needing to
supply the full path to the tool directories. </p>
<ul>
<li>On Linux, edit your <code>~/.bash_profile</code> or <code>~/.bashrc</code> file. Look
for a line that sets the PATH environment variable and add the
full path to the <code>tools/</code> and {@code platform-tools/} directories to it. If you don't
see a line setting the path, you can add one:
<pre>export PATH=${PATH}:&lt;your_sdk_dir&gt;/tools:&lt;your_sdk_dir&gt;/platform-tools</pre>
</li>
<li>On a Mac OS X, look in your home directory for <code>.bash_profile</code> and
proceed as for Linux. You can create the <code>.bash_profile</code> if
you haven't already set one up on your machine. </li>
<li>On Windows, right-click on My Computer, and select Properties.
Under the Advanced tab, hit the Environment Variables button, and in the
dialog that comes up, double-click on Path (under System Variables). Add the full path to the
<code>tools/</code> and {@code platform-tools/} directories to the path. </li>
</ul>
</div><!-- end toggleme -->
</div><!-- end toggleable -->
<h2 id="InstallingADT">Step 3. Installing the ADT Plugin for Eclipse</h2>
@@ -204,28 +167,40 @@ application, you also need to download at least one Android platform and the SDK
(tools that the latest platform depend upon). However, downloading
additional components 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
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>
<p>You can launch the Android SDK and AVD Manager in one of the following ways:</p>
<ul>
<li>From within Eclipse, select <strong>Window &gt; Android SDK and AVD Manager</strong>.</li>
<li>On Windows, double-click the <code>SDK Manager.ext</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 update sdk</pre> <p>This will automatically select
the required and recommended components for you to install.</p></li>
Android SDK, then execute: <pre>android</pre> </li>
</ul>
<p>To download components, use the graphical UI of the Android SDK and AVD
Manager, shown in Figure 1, to browse the SDK repository and select new or updated
components. The Android SDK and AVD Manager will install the selected components in
your SDK environment. For information about which components you should download, see the following
section about <a href="#which">Recommended Components</a></p>
section about <a href="#which">Recommended Components</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
available for you to download into your environment.</p>
<p>The SDK repository offers these types of components:</p>
<h3 id="components">Available Components</h3>
<p>By default, there are two repositories of components 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>
<ul>
<li><strong>SDK Tools</strong> (pre-installed in the Android SDK starter
@@ -249,20 +224,14 @@ system image, sample code, emulator skins, and any version specific tools. For
detailed information about each platform, see the overview documents available
under the section "Downloadable SDK Components," at left. </li>
<li><strong>SDK Add-Ons</strong> &mdash; SDK add-ons provide a development
environment for specific Android external
library or a customized (but fully compliant) Android system image. The Android
SDK repository offers the Google APIs Add-On, which gives your application
access to powerful mapping capabilities through the
<code>com.google.android.maps</code> library. You can also add additional
repositories, so that you can download other SDK add-ons, where available. </li>
<li><strong>USB Driver for Windows</strong> &mdash; Contains driver files
<li><strong>USB Driver for Windows</strong> (Windows only) &mdash; Contains driver files
that you can install on your Windows computer, so that you can run and debug
your applications on an actual device. You <em>do not</em> need the USB driver unless
you plan to debug your application on an actual Android-powered device. If you
develop on Mac OS X or Linux, you do not need a special driver to debug
your application on an Android-powered device.</li>
your application on an Android-powered device. (See <a
href="{@docRoot}guide/developing/device.html">Developing on a Device</a> for more information
about developing on a real device.)</li>
<li><strong>Samples</strong> &mdash; Contains the sample code and apps available
for each Android development platform. If you are just getting started with
@@ -275,6 +244,11 @@ 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
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>
@@ -496,6 +470,47 @@ documentation.</td>
</table>
<p>Optionally, you might want to add the location of the SDK's <code>tools/</code> and
<code>platform-tools</code> to your <code>PATH</code> environment variable, to provide easy
access to the tools.</p>
<div class="toggleable closed">
<a href="#" onclick="return toggleDiv(this)">
<img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
width="9px" />
How to update your PATH</a>
<div class="toggleme">
<p>Adding both <code>tools/</code> and <code>platform-tools/</code> to your PATH lets you run
command line <a href="{@docRoot}guide/developing/tools/index.html">tools</a> without needing to
supply the full path to the tool directories. Depending on your operating system, you can
include these directories in your PATH in the following way:</p>
<ul>
<li>On Windows, right-click on My Computer, and select Properties.
Under the Advanced tab, hit the Environment Variables button, and in the
dialog that comes up, double-click on Path (under System Variables). Add the full path to the
<code>tools/</code> and <code>platform-tools/</code> directories to the path. </li>
<li>On Linux, edit your <code>~/.bash_profile</code> or <code>~/.bashrc</code> file. Look
for a line that sets the PATH environment variable and add the
full path to the <code>tools/</code> and <code>platform-tools</code> directories to it. If you
don't see a line setting the path, you can add one:
<pre>export PATH=${PATH}:&lt;sdk&gt;/tools:&lt;sdk&gt;/platform-tools</pre>
</li>
<li>On a Mac OS X, look in your home directory for <code>.bash_profile</code> and
proceed as for Linux. You can create the <code>.bash_profile</code> if
you don't already have one. </li>
</ul>
</div><!-- end toggleme -->
</div><!-- end toggleable -->
<h2 id="NextSteps">Next Steps</h2>
<p>Once you have completed installation, you are ready to
begin developing applications. Here are a few ways you can get started: </p>