am 5f89ce64: am 3e40a27e: Merge "Docs: Fixing files that didn\'t merge properly from mnc-preview-docs" into mnc-dev
* commit '5f89ce649c6385bd6463641c5408cc7a274b0eb6': Docs: Fixing files that didn't merge properly from mnc-preview-docs
This commit is contained in:
@@ -64,10 +64,10 @@ So before you can start, there are a few packages you should add to your Android
|
|||||||
|
|
||||||
<p>To start adding packages, launch the Android SDK Manager in one of the following ways:</p>
|
<p>To start adding packages, launch the Android SDK Manager in one of the following ways:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li>In Eclipse or Android Studio, click <strong>SDK Manager</strong>
|
<li>In Android Studio, click <strong>SDK Manager</strong>
|
||||||
<img src="{@docRoot}images/tools/sdk-manager-studio.png"
|
<img src="{@docRoot}images/tools/sdk-manager-studio.png"
|
||||||
style="vertical-align:bottom;margin:0;height:17px" /> in the toolbar.</li>
|
style="vertical-align:bottom;margin:0;height:17px" /> in the toolbar.</li>
|
||||||
<li>If you're not using Eclipse or Android Studio:
|
<li>If you're not using Android Studio:
|
||||||
<ul>
|
<ul>
|
||||||
<li>Windows: Double-click the <code>SDK Manager.exe</code> file at the root of the Android
|
<li>Windows: Double-click the <code>SDK Manager.exe</code> file at the root of the Android
|
||||||
SDK directory.</li>
|
SDK directory.</li>
|
||||||
@@ -77,7 +77,7 @@ style="vertical-align:bottom;margin:0;height:17px" /> in the toolbar.</li>
|
|||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<p>When you open the SDK Manager for the first time, several packages will be selected by
|
<p>When you open the SDK Manager for the first time, several packages are selected by
|
||||||
default. Leave these selected, but be sure you have everything you need
|
default. Leave these selected, but be sure you have everything you need
|
||||||
to get started by following these steps:</p>
|
to get started by following these steps:</p>
|
||||||
|
|
||||||
|
|||||||
@@ -87,7 +87,7 @@ where they are installed. For example:</p>
|
|||||||
|
|
||||||
<p><b>To set up Android Studio on Mac OSX:</b></p>
|
<p><b>To set up Android Studio on Mac OSX:</b></p>
|
||||||
<ol>
|
<ol>
|
||||||
<li>Unzip the downloaded zip file, {@code android-studio-ide-<version>-mac.zip}.</li>
|
<li>Launch the {@code .dmg} file you just downloaded.</li>
|
||||||
<li>Drag and drop Android Studio into the Applications folder.
|
<li>Drag and drop Android Studio into the Applications folder.
|
||||||
<li>Open Android Studio and follow the setup wizard to install any necessary SDK tools.
|
<li>Open Android Studio and follow the setup wizard to install any necessary SDK tools.
|
||||||
<p>
|
<p>
|
||||||
@@ -97,13 +97,11 @@ where they are installed. For example:</p>
|
|||||||
<strong>Allow applications downloaded from</strong>, select <strong>Anywhere</strong>.
|
<strong>Allow applications downloaded from</strong>, select <strong>Anywhere</strong>.
|
||||||
Then open Android Studio again.</p>
|
Then open Android Studio again.</p>
|
||||||
</li>
|
</li>
|
||||||
<li>Follow the links to install the SDK outside of the Android Studio directories.</li>
|
|
||||||
</ol>
|
</ol>
|
||||||
|
|
||||||
<p>The individual tools and other SDK packages are saved outside the Android Studio application
|
<p>If you need use the Android SDK tools from a command line,
|
||||||
directory. If you need access the tools directly, use a terminal to navigate into the location
|
you can access them at:</p>
|
||||||
where they are installed. For example:</p>
|
<p><code>/Users/<user>/Library/Android/sdk/</code></p>
|
||||||
<p><code>/Applications/sdk/</code></p>
|
|
||||||
|
|
||||||
|
|
||||||
</div><!-- end mac -->
|
</div><!-- end mac -->
|
||||||
@@ -114,7 +112,7 @@ where they are installed. For example:</p>
|
|||||||
<p><b>To set up Android Studio on Linux:</b></p>
|
<p><b>To set up Android Studio on Linux:</b></p>
|
||||||
|
|
||||||
<ol>
|
<ol>
|
||||||
<li>Unpack the downloaded Tar file, {@code android-studio-ide-<version>-linux.zip}, into an
|
<li>Unpack the downloaded ZIP file into an
|
||||||
appropriate location for your applications.
|
appropriate location for your applications.
|
||||||
<li>To launch Android Studio, navigate to the {@code android-studio/bin/} directory
|
<li>To launch Android Studio, navigate to the {@code android-studio/bin/} directory
|
||||||
in a terminal and execute {@code studio.sh}.
|
in a terminal and execute {@code studio.sh}.
|
||||||
|
|||||||
@@ -1,381 +0,0 @@
|
|||||||
page.title=Building and Running from the Command Line
|
|
||||||
parent.title=Building and Running
|
|
||||||
parent.link=index.html
|
|
||||||
@jd:body
|
|
||||||
|
|
||||||
<div id="qv-wrapper">
|
|
||||||
<div id="qv">
|
|
||||||
<h2>In this document</h2>
|
|
||||||
<ol>
|
|
||||||
<li><a href="#DebugMode">Building in Debug Mode</a></li>
|
|
||||||
<li><a href="#ReleaseMode">Building in Release Mode</a>
|
|
||||||
<ol>
|
|
||||||
<li><a href="#ManualReleaseMode">Build unsigned</a></li>
|
|
||||||
<li><a href="#AutoReleaseMode">Build signed and aligned</a></li>
|
|
||||||
<li><a href="#OnceBuilt">Once built and signed in release mode</a></li>
|
|
||||||
</ol>
|
|
||||||
</li>
|
|
||||||
<li><a href="#RunningOnEmulator">Running on the Emulator</a></li>
|
|
||||||
<li><a href="#RunningOnDevice">Running on a Device</a></li>
|
|
||||||
<li><a href="#Signing">Application Signing</a></li>
|
|
||||||
<li><a href="#AntReference">Ant Command Reference</a></li>
|
|
||||||
</ol>
|
|
||||||
<h2>See also</h2>
|
|
||||||
<ol>
|
|
||||||
<li><a href="{@docRoot}tools/devices/managing-avds-cmdline.html">Managing AVDs from
|
|
||||||
the Command Line</a></li>
|
|
||||||
<li><a href="{@docRoot}tools/devices/emulator.html">Using the Android
|
|
||||||
Emulator</a></li>
|
|
||||||
<li><a href="{@docRoot}tools/publishing/app-signing.html">Signing Your Applications</a></li>
|
|
||||||
</ol>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<p>There are two ways to build your application using the Ant build script: one for
|
|
||||||
testing/debugging your application — <em>debug mode</em> — and one for building your
|
|
||||||
final package for release — <em>release mode</em>. Regardless of which way you build your application,
|
|
||||||
it must be signed before it can install on an emulator or device—with a debug key when building
|
|
||||||
in debug mode and with your own private key when building in release mode.</p>
|
|
||||||
|
|
||||||
<p>Whether you're building in debug mode or release mode, you need to use the Ant tool to compile
|
|
||||||
and build your project. This will create the .apk file that you can install on an emulator or device.
|
|
||||||
When you build in debug mode, the .apk file is automatically signed by the SDK tools with
|
|
||||||
a debug key, so it's instantly ready for installation onto an emulator or attached
|
|
||||||
development device. You cannot distribute an application that is signed with a debug key.
|
|
||||||
When you build in release mode, the .apk file is <em>unsigned</em>, so you
|
|
||||||
must manually sign it with your own private key, using Keytool and Jarsigner.</p>
|
|
||||||
|
|
||||||
<p>It's important that you read and understand <a href=
|
|
||||||
"{@docRoot}tools/publishing/app-signing.html">Signing Your Applications</a>, particularly once
|
|
||||||
you're ready to release your application and share it with end-users. That document describes the
|
|
||||||
procedure for generating a private key and then using it to sign your .apk file. If you're just
|
|
||||||
getting started, however, you can quickly run your applications on an emulator or your own
|
|
||||||
development device by building in debug mode.</p>
|
|
||||||
|
|
||||||
<p>If you don't have Ant, you can obtain it from the <a href="http://ant.apache.org/">Apache Ant
|
|
||||||
home page</a>. Install it and make sure it is in your executable PATH. Before calling Ant, you
|
|
||||||
need to declare the JAVA_HOME environment variable to specify the path to where the JDK is
|
|
||||||
installed.</p>
|
|
||||||
|
|
||||||
<p class="note"><strong>Note:</strong> When installing JDK on Windows, the default is to install
|
|
||||||
in the "Program Files" directory. This location will cause <code>ant</code> to fail, because of
|
|
||||||
the space. To fix the problem, you can specify the JAVA_HOME variable like this:
|
|
||||||
<pre>set JAVA_HOME=c:\Progra~1\Java\<jdkdir></pre>
|
|
||||||
|
|
||||||
<p>The easiest solution, however, is to install JDK in a non-space directory, for example:</p>
|
|
||||||
|
|
||||||
<pre>c:\java\jdk1.7</pre>
|
|
||||||
|
|
||||||
<h2 id="DebugMode">Building in Debug Mode</h2>
|
|
||||||
|
|
||||||
<p>For immediate application testing and debugging, you can build your application in debug mode
|
|
||||||
and immediately install it on an emulator. In debug mode, the build tools automatically sign your
|
|
||||||
application with a debug key and optimize the package with {@code zipalign}.</p>
|
|
||||||
|
|
||||||
<p>To build in debug mode:</p>
|
|
||||||
|
|
||||||
<ol>
|
|
||||||
<li>Open a command-line and navigate to the root of your project directory.</li>
|
|
||||||
<li>Use Ant to compile your project in debug mode:
|
|
||||||
<pre>
|
|
||||||
ant debug
|
|
||||||
</pre>
|
|
||||||
|
|
||||||
<p>This creates your debug <code>.apk</code> file inside the project <code>bin/</code> directory, named
|
|
||||||
<code><your_project_name>-debug.apk</code>. The file is already signed with
|
|
||||||
the debug key and has been aligned with
|
|
||||||
<a href="{@docRoot}tools/help/zipalign.html"><code>zipalign</code></a>.
|
|
||||||
</p>
|
|
||||||
</li>
|
|
||||||
</ol>
|
|
||||||
|
|
||||||
<p>Each time you change a source file or resource, you must run Ant again in order to package up
|
|
||||||
the latest version of the application.</p>
|
|
||||||
|
|
||||||
<p>To install and run your application on an emulator, see the following section about <a href=
|
|
||||||
"#RunningOnEmulator">Running on the Emulator</a>.</p>
|
|
||||||
|
|
||||||
<h2 id="ReleaseMode">Building in Release Mode</h2>
|
|
||||||
|
|
||||||
<p>When you're ready to release and distribute your application to end-users, you must build your
|
|
||||||
application in release mode. Once you have built in release mode, it's a good idea to perform
|
|
||||||
additional testing and debugging with the final .apk.</p>
|
|
||||||
|
|
||||||
<p>Before you start building your application in release mode, be aware that you must sign the
|
|
||||||
resulting application package with your private key, and should then align it using the {@code
|
|
||||||
zipalign} tool. There are two approaches to building in release mode: build an unsigned package
|
|
||||||
in release mode and then manually sign and align the package, or allow the build script to sign
|
|
||||||
and align the package for you.</p>
|
|
||||||
|
|
||||||
<h3 id="ManualReleaseMode">Build unsigned</h3>
|
|
||||||
|
|
||||||
<p>If you build your application <em>unsigned</em>, then you will need to manually sign and align
|
|
||||||
the package.</p>
|
|
||||||
|
|
||||||
<p>To build an <em>unsigned</em> .apk in release mode:</p>
|
|
||||||
|
|
||||||
<ol>
|
|
||||||
<li>Open a command-line and navigate to the root of your project directory.</li>
|
|
||||||
|
|
||||||
<li>Use Ant to compile your project in release mode:
|
|
||||||
<pre>
|
|
||||||
ant release
|
|
||||||
</pre>
|
|
||||||
</li>
|
|
||||||
</ol>
|
|
||||||
|
|
||||||
<p>This creates your Android application .apk file inside the project <code>bin/</code>
|
|
||||||
directory, named <code><em><your_project_name></em>-unsigned.apk</code>.</p>
|
|
||||||
|
|
||||||
<p class="note"><strong>Note:</strong> The .apk file is <em>unsigned</em> at this point and can't
|
|
||||||
be installed until signed with your private key.</p>
|
|
||||||
|
|
||||||
<p>Once you have created the unsigned .apk, your next step is to sign the .apk with your private
|
|
||||||
key and then align it with {@code zipalign}. To complete this procedure, read <a href=
|
|
||||||
"{@docRoot}tools/publishing/app-signing.html">Signing Your Applications</a>.</p>
|
|
||||||
|
|
||||||
<p>When your <code>.apk</code> has been signed and aligned, it's ready to be distributed to end-users.
|
|
||||||
You should test the final build on different devices or AVDs to ensure that it
|
|
||||||
runs properly on different platforms.</p>
|
|
||||||
|
|
||||||
<h3 id="AutoReleaseMode">Build signed and aligned</h3>
|
|
||||||
|
|
||||||
<p>If you would like, you can configure the Android build script to automatically sign and align
|
|
||||||
your application package. To do so, you must provide the path to your keystore and the name of
|
|
||||||
your key alias in your project's {@code ant.properties} file. With this information provided,
|
|
||||||
the build script will prompt you for your keystore and alias password when you build in release
|
|
||||||
mode and produce your final application package, which will be ready for distribution.</p>
|
|
||||||
|
|
||||||
<p class="caution"><strong>Caution:</strong> Due to the way Ant handles input, the password that
|
|
||||||
you enter during the build process <strong>will be visible</strong>. If you are concerned about
|
|
||||||
your keystore and alias password being visible on screen, then you may prefer to perform the
|
|
||||||
application signing manually, via Jarsigner (or a similar tool). To instead perform the signing
|
|
||||||
procedure manually, <a href="#ManualReleaseMode">build unsigned</a> and then continue with
|
|
||||||
<a href="{@docRoot}tools/publishing/app-signing.html">Signing Your Applications</a>.</p>
|
|
||||||
|
|
||||||
<p>To specify your keystore and alias, open the project {@code ant.properties} file (found in
|
|
||||||
the root of the project directory) and add entries for {@code key.store} and {@code key.alias}.
|
|
||||||
For example:</p>
|
|
||||||
<pre>
|
|
||||||
key.store=path/to/my.keystore
|
|
||||||
key.alias=mykeystore
|
|
||||||
</pre>
|
|
||||||
|
|
||||||
<p>Save your changes. Now you can build a <em>signed</em> .apk in release mode:</p>
|
|
||||||
|
|
||||||
<ol>
|
|
||||||
<li>Open a command-line and navigate to the root of your project directory.</li>
|
|
||||||
|
|
||||||
<li>Use Ant to compile your project in release mode:
|
|
||||||
<pre>
|
|
||||||
ant release
|
|
||||||
</pre>
|
|
||||||
</li>
|
|
||||||
|
|
||||||
<li>When prompted, enter you keystore and alias passwords.
|
|
||||||
|
|
||||||
<p class="caution"><strong>Caution:</strong> As described above, your password will be
|
|
||||||
visible on the screen.</p>
|
|
||||||
</li>
|
|
||||||
</ol>
|
|
||||||
|
|
||||||
<p>This creates your Android application .apk file inside the project <code>bin/</code>
|
|
||||||
directory, named <code><em><your_project_name></em>-release.apk</code>. This .apk file has
|
|
||||||
been signed with the private key specified in {@code ant.properties} and aligned with {@code
|
|
||||||
zipalign}. It's ready for installation and distribution.</p>
|
|
||||||
|
|
||||||
<h3 id="OnceBuilt">Once built and signed in release mode</h3>
|
|
||||||
|
|
||||||
<p>Once you have signed your application with a private key, you can install and run it on an
|
|
||||||
<a href="#RunningOnEmulator">emulator</a> or <a href="#RunningOnDevice">device</a>. You can
|
|
||||||
also try installing it onto a device from a web server. Simply upload the signed .apk to a web
|
|
||||||
site, then load the .apk URL in your Android web browser to download the application and begin
|
|
||||||
installation. (On your device, be sure you have enabled
|
|
||||||
<em>Settings > Applications > Unknown sources</em>.)</p>
|
|
||||||
|
|
||||||
<h2 id="RunningOnEmulator">Running on the Emulator</h2>
|
|
||||||
|
|
||||||
<p>Before you can run your application on the Android Emulator, you must <a href=
|
|
||||||
"{@docRoot}tools/devices/managing-avds.html">create an AVD</a>.</p>
|
|
||||||
|
|
||||||
<p>To run your application:</p>
|
|
||||||
|
|
||||||
<ol>
|
|
||||||
<li>
|
|
||||||
<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 the <code>avd</code> options:</p>
|
|
||||||
<pre>
|
|
||||||
android avd
|
|
||||||
</pre>
|
|
||||||
|
|
||||||
<p>In the <em>Virtual Devices</em> view, select an AVD and click <strong>Start</strong>.</p>
|
|
||||||
</li>
|
|
||||||
|
|
||||||
<li>
|
|
||||||
<strong>Install your application</strong>
|
|
||||||
|
|
||||||
<p>From your SDK's <code>tools/</code> directory, install the {@code .apk} on the
|
|
||||||
emulator:</p>
|
|
||||||
<pre>
|
|
||||||
adb install <em><path_to_your_bin></em>.apk
|
|
||||||
</pre>
|
|
||||||
|
|
||||||
<p>Your .apk file (signed with either a release or debug key) is in your project {@code bin/}
|
|
||||||
directory after you build your application.</p>
|
|
||||||
|
|
||||||
<p>If there is more than one emulator running, you must specify the emulator upon which to
|
|
||||||
install the application, by its serial number, with the <code>-s</code> option. For
|
|
||||||
example:</p>
|
|
||||||
<pre>
|
|
||||||
adb -s emulator-5554 install <em>path/to/your/app</em>.apk
|
|
||||||
</pre>
|
|
||||||
|
|
||||||
<p>To see a list of available device serial numbers, execute {@code adb devices}.</p>
|
|
||||||
</li>
|
|
||||||
</ol>
|
|
||||||
|
|
||||||
<p>If you don't see your application on the emulator, try closing the emulator and launching 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>
|
|
||||||
|
|
||||||
<p>Be certain to create multiple AVDs upon which to test your application. You should have one
|
|
||||||
AVD for each platform and screen type with which your application is compatible. For instance, if
|
|
||||||
your application compiles against the Android 4.0 (API Level 14) platform, you should create an
|
|
||||||
AVD for each platform equal to and greater than 4.0 and an AVD for each <a href=
|
|
||||||
"{@docRoot}guide/practices/screens_support.html">screen type</a> you support, then test your
|
|
||||||
application on each one.</p>
|
|
||||||
|
|
||||||
<p class="note"><strong>Tip:</strong> If you have <em>only one</em> emulator running, you can
|
|
||||||
build your application and install it on the emulator in one simple step. Navigate to the root of
|
|
||||||
your project directory and use Ant to compile the project with <em>install mode</em>: <code>ant
|
|
||||||
install</code>. This will build your application, sign it with the debug key, and install it on
|
|
||||||
the currently running emulator.</p>
|
|
||||||
|
|
||||||
<h2 id="RunningOnDevice">Running on a Device</h2>
|
|
||||||
|
|
||||||
<p>Before you can run your application on a device, you must perform some basic setup for your
|
|
||||||
device:</p>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li>Enable <strong>USB debugging</strong> on your device.
|
|
||||||
<ul>
|
|
||||||
<li>On most devices running Android 3.2 or older, you can find the option under
|
|
||||||
<strong>Settings > Applications > Development</strong>.</li>
|
|
||||||
<li>On Android 4.0 and newer, it's in <strong>Settings > Developer options</strong>.
|
|
||||||
<p class="note"><strong>Note:</strong> On Android 4.2 and newer, <strong>Developer
|
|
||||||
options</strong> is hidden by default. To make it available, go
|
|
||||||
to <strong>Settings > About phone</strong> and tap <strong>Build number</strong>
|
|
||||||
seven times. Return to the previous screen to find <strong>Developer options</strong>.</p>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
|
|
||||||
<li>Ensure that your development computer can detect your device when connected via USB</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>Read <a href="{@docRoot}tools/device.html#setting-up">Setting up a Device for
|
|
||||||
Development</a> for more information.</p>
|
|
||||||
|
|
||||||
<p>Once your device is set up and connected via USB, navigate to your SDK's <code>platform-tools/</code>
|
|
||||||
directory and install the <code>.apk</code> on the device:</p>
|
|
||||||
<pre>
|
|
||||||
adb -d install <em>path/to/your/app</em>.apk
|
|
||||||
</pre>
|
|
||||||
|
|
||||||
<p>The {@code -d} flag specifies that you want to use the attached device (in case you also have
|
|
||||||
an emulator running).</p>
|
|
||||||
|
|
||||||
<p>For more information on the tools used above, please see the following documents:</p>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li><a href="{@docRoot}tools/help/android.html">android Tool</a></li>
|
|
||||||
|
|
||||||
<li><a href="{@docRoot}tools/devices/emulator.html">Android Emulator</a></li>
|
|
||||||
|
|
||||||
<li><a href="{@docRoot}tools/help/adb.html">Android Debug Bridge</a> (ADB)</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2 id="Signing">Application Signing</h2>
|
|
||||||
|
|
||||||
<p>As you begin developing Android applications, understand that all Android applications must be
|
|
||||||
digitally signed before the system will install them on an emulator or device. There are two ways
|
|
||||||
to do this: with a <em>debug key</em> (for immediate testing on an emulator or development
|
|
||||||
device) or with a <em>private key</em> (for application distribution).</p>
|
|
||||||
|
|
||||||
<p>The Android build tools help you get started by automatically signing your .apk files with a
|
|
||||||
debug key at build time. This means that you can compile your application and install it on the
|
|
||||||
emulator without having to generate your own private key. However, please note that if you intend
|
|
||||||
to publish your application, you <strong>must</strong> sign the application with your own private
|
|
||||||
key, rather than the debug key generated by the SDK tools.</p>
|
|
||||||
|
|
||||||
<p>The ADT plugin helps you get started quickly by signing your .apk files with a debug key,
|
|
||||||
prior to installing them on an emulator or development device. This means that you can quickly
|
|
||||||
run your application from Eclipse without having to generate your own private key. No specific
|
|
||||||
action on your part is needed, provided ADT has access to Keytool. However, please note that if
|
|
||||||
you intend to publish your application, you <strong>must</strong> sign the application with your
|
|
||||||
own private key, rather than the debug key generated by the SDK tools.</p>
|
|
||||||
|
|
||||||
<p>Please read <a href="{@docRoot}tools/publishing/app-signing.html">Signing Your
|
|
||||||
Applications</a>, which provides a thorough guide to application signing on Android and what it
|
|
||||||
means to you as an Android application developer. The document also includes a guide to exporting
|
|
||||||
and signing your application with the ADT's Export Wizard.</p>
|
|
||||||
|
|
||||||
<h2 id="AntReference">Ant Command Reference</h2>
|
|
||||||
<dt><code>ant clean</code></dt>
|
|
||||||
<dd>Cleans the project. If you include the <code>all</code> target before <code>clean</code>
|
|
||||||
(<code>ant all clean</code>), other projects are also cleaned. For instance if you clean a
|
|
||||||
test project, the tested project is also cleaned.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant debug</code></dt>
|
|
||||||
<dd>Builds a debug package. Works on application, library, and test projects and compiles
|
|
||||||
dependencies as needed.</dd>
|
|
||||||
|
|
||||||
<dt id="emma"><code>ant emma debug</code></dt>
|
|
||||||
<dd>Builds a test project while building the tested project with instrumentation turned on.
|
|
||||||
This is used to run tests with code coverage enabled.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant release</code></dt>
|
|
||||||
<dd>Builds a release package.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant instrument</code>
|
|
||||||
</dt>
|
|
||||||
<dd>Builds an instrumented debug package. This is generally called automatically when building a
|
|
||||||
test project with code coverage enabled (with the <code>emma</code>
|
|
||||||
target)</dd>
|
|
||||||
|
|
||||||
<dt><code>ant <build_target> install</code></dt>
|
|
||||||
<dd>Builds and installs a package. Using <code>install</code> by itself fails.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant installd</code></dt>
|
|
||||||
<dd>Installs an already compiled debug package. This fails if the <code>.apk</code> is not
|
|
||||||
already built.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant installr</code></dt>
|
|
||||||
<dd>Installs an already compiled release package. This fails if the <code>.apk</code> is not
|
|
||||||
already built.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant installt</code></dt>
|
|
||||||
<dd>Installs an already compiled test package. Also installs the <code>.apk</code> of the
|
|
||||||
tested application. This fails if the <code>.apk</code> is not already built.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant installi</code></dt>
|
|
||||||
<dd>Installs an already compiled instrumented package. This is generally not used manually as
|
|
||||||
it's called when installing a test package. This fails if the <code>.apk</code> is not already
|
|
||||||
built.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant test</code></dt>
|
|
||||||
<dd>Runs the tests (for test projects). The tested and test <code>.apk</code> files must be
|
|
||||||
previously installed.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant debug installt test</code></dt>
|
|
||||||
<dd>Builds a test project and the tested project, installs both <code>.apk</code> files, and
|
|
||||||
runs the tests.</dd>
|
|
||||||
|
|
||||||
<dt><code>ant emma debug install test</code></dt>
|
|
||||||
<dd>Builds a test project and the tested project, installs both <code>.apk</code> files, and
|
|
||||||
runs the tests with code coverage enabled.</dd>
|
|
||||||
|
|
||||||
@@ -34,12 +34,12 @@ parent.link=index.html
|
|||||||
<p>This document shows you how to run your application on an emulator or a real device
|
<p>This document shows you how to run your application on an emulator or a real device
|
||||||
from Eclipse—all of which is done using the debug version of your application.
|
from Eclipse—all of which is done using the debug version of your application.
|
||||||
For more information about how to sign your application with a private key for release, see <a href=
|
For more information about how to sign your application with a private key for release, see <a href=
|
||||||
"{@docRoot}tools/workflow/publishing/app-signing.html#ExportWizard">Signing Your Applications</a></p>
|
"{@docRoot}tools/publishing/app-signing.html#ExportWizard">Signing Your Applications</a></p>
|
||||||
|
|
||||||
<h2 id="RunningOnEmulatorEclipse">Running on the emulator</h2>
|
<h2 id="RunningOnEmulatorEclipse">Running on the emulator</h2>
|
||||||
|
|
||||||
<p>Before you can run your application on the Android Emulator, you must <a href=
|
<p>Before you can run your application on the Android Emulator, you must <a href=
|
||||||
"{@docRoot}tools/workflow/devices/managing-avds.html">create an AVD</a>.</p>
|
"{@docRoot}tools/devices/managing-avds.html">create an AVD</a>.</p>
|
||||||
|
|
||||||
<p>To run (or debug) your application, select <strong>Run</strong> > <strong>Run</strong> (or
|
<p>To run (or debug) your application, select <strong>Run</strong> > <strong>Run</strong> (or
|
||||||
<strong>Run</strong> > <strong>Debug</strong>) from the Eclipse menu bar. The ADT plugin will
|
<strong>Run</strong> > <strong>Debug</strong>) from the Eclipse menu bar. The ADT plugin will
|
||||||
@@ -100,7 +100,7 @@ parent.link=index.html
|
|||||||
<li>Ensure that your development computer can detect your device when connected via USB</li>
|
<li>Ensure that your development computer can detect your device when connected via USB</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<p>Read <a href="{@docRoot}tools/workflow/devices/device.html">Using Hardware Devices</a>
|
<p>Read <a href="{@docRoot}tools/device.html">Using Hardware Devices</a>
|
||||||
for more information.</p>
|
for more information.</p>
|
||||||
|
|
||||||
<p>Once set up and your device is connected via USB, install your application on the device by
|
<p>Once set up and your device is connected via USB, install your application on the device by
|
||||||
|
|||||||
@@ -24,8 +24,6 @@ next.link=running-app.html
|
|||||||
<h2>You should also read</h2>
|
<h2>You should also read</h2>
|
||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="{@docRoot}sdk/installing/index.html">Installing the
|
|
||||||
SDK</a></li>
|
|
||||||
<li><a href="{@docRoot}tools/projects/index.html">Managing Projects</a></li>
|
<li><a href="{@docRoot}tools/projects/index.html">Managing Projects</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
@@ -34,8 +32,7 @@ SDK</a></li>
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
<p>An Android project contains all the files that comprise the source code for your Android
|
<p>An Android project contains all the files that comprise the source code for your Android
|
||||||
app. The Android SDK tools make it easy to start a new Android project with a set of
|
app.</p>
|
||||||
default project directories and files.</p>
|
|
||||||
|
|
||||||
<p>This lesson
|
<p>This lesson
|
||||||
shows how to create a new project either using Android Studio or using the
|
shows how to create a new project either using Android Studio or using the
|
||||||
|
|||||||
@@ -12,7 +12,7 @@ helpoutsWidget=true
|
|||||||
<div id="tb-wrapper">
|
<div id="tb-wrapper">
|
||||||
<div id="tb">
|
<div id="tb">
|
||||||
|
|
||||||
<h2>Dependencies and prerequisites</h2>
|
<h2>Dependencies</h2>
|
||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="{@docRoot}sdk/index.html">Android Studio</a></li>
|
<li><a href="{@docRoot}sdk/index.html">Android Studio</a></li>
|
||||||
@@ -37,14 +37,11 @@ to:</p>
|
|||||||
<a href="{@docRoot}tools/help/sdk-manager.html">SDK Manager</a>.</li>
|
<a href="{@docRoot}tools/help/sdk-manager.html">SDK Manager</a>.</li>
|
||||||
</ol>
|
</ol>
|
||||||
|
|
||||||
<p class="note"><strong>Note:</strong> Make sure you install the most recent versions of Android
|
<p class="note"><strong>Note:</strong> Although most of this training class
|
||||||
Studio and the Android SDK before you start this class. The procedures described in this class may
|
expects that you're using Android Studio, some procedures include alternative
|
||||||
not apply to earlier versions.</p>
|
instructions for using
|
||||||
|
the SDK tools from the command line instead.</p>
|
||||||
|
|
||||||
<p>If you haven't already done these tasks, start by downloading the
|
<p>This class uses a tutorial format to create a small Android app that teaches
|
||||||
<a href="{@docRoot}sdk/index.html">Android SDK</a> and following the install steps.
|
|
||||||
Once you've finished the setup, you're ready to begin this class.</p>
|
|
||||||
|
|
||||||
<p>This class uses a tutorial format that incrementally builds a small Android app that teaches
|
|
||||||
you some fundamental concepts about Android development, so it's important that you follow each
|
you some fundamental concepts about Android development, so it's important that you follow each
|
||||||
step.</p>
|
step.</p>
|
||||||
|
|||||||
@@ -25,7 +25,7 @@ helpoutsWidget=true
|
|||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="{@docRoot}tools/device.html">Using Hardware Devices</a></li>
|
<li><a href="{@docRoot}tools/device.html">Using Hardware Devices</a></li>
|
||||||
<li><a href="{@docRoot}tools/devices/index.html">Managing Virtual Devices</a></li>
|
<li><a href="{@docRoot}tools/devices/managing-avds.html">Managing AVDs with AVD Manager</a></li>
|
||||||
<li><a href="{@docRoot}tools/projects/index.html">Managing Projects</a></li>
|
<li><a href="{@docRoot}tools/projects/index.html">Managing Projects</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
@@ -128,10 +128,6 @@ to first create an <a href="{@docRoot}tools/devices/index.html">Android Virtual
|
|||||||
AVD is a device configuration for the Android emulator that allows you to model a specific
|
AVD is a device configuration for the Android emulator that allows you to model a specific
|
||||||
device.</p>
|
device.</p>
|
||||||
|
|
||||||
<div class="figure" style="width:457px">
|
|
||||||
<img src="{@docRoot}images/screens_support/as-mac-avds-config.png" />
|
|
||||||
<p class="img-caption"><strong>Figure 1.</strong> The AVD Manager showing a virtual device.</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<h3>Create an AVD</h3>
|
<h3>Create an AVD</h3>
|
||||||
<ol>
|
<ol>
|
||||||
@@ -161,19 +157,11 @@ device.</p>
|
|||||||
</li>
|
</li>
|
||||||
<li>Verify the configuration settings, then click <strong>Finish</strong>.
|
<li>Verify the configuration settings, then click <strong>Finish</strong>.
|
||||||
</li>
|
</li>
|
||||||
<li>In the <strong>Android Virtual Device Manager</strong> window, click <strong>Create</strong>.</li>
|
|
||||||
<li>Enter an <strong>AVD Name</strong>.</li>
|
|
||||||
<li>Select a <strong>Device</strong> type.
|
|
||||||
<p>When you select a device type, most of the fields auto-populate.</p>
|
|
||||||
<li>For <strong>Skin</strong> select <strong>HVGA</strong>.</li>
|
|
||||||
<li>For <strong>SD Card</strong>, enter something small, like 10 MiB.
|
|
||||||
<p>It really doesn't matter what you enter here since you're not using any storage. But if you
|
|
||||||
reuse this AVD, you might have to adjust this setting.</p></li>
|
|
||||||
<li>Ignore the <strong>Emulation Options</strong> and click <strong>OK</strong>.</li>
|
|
||||||
<li>In the <strong>Result</strong> screen, click <strong>OK</strong>.</li>
|
|
||||||
<li>Close the <strong>Android Virtual Device Manager</strong> window.</li>
|
|
||||||
</ol>
|
</ol>
|
||||||
|
|
||||||
|
<p>For more information about using AVDs, see
|
||||||
|
<a href="{@docRoot}tools/devices/managing-avds.html">Managing AVDs with AVD Manager</a>.</p>
|
||||||
|
|
||||||
<h3>Run the app from Android Studio</h3>
|
<h3>Run the app from Android Studio</h3>
|
||||||
<ol>
|
<ol>
|
||||||
<li>In <strong>Android Studio</strong>, select your project and click <strong>Run</strong>
|
<li>In <strong>Android Studio</strong>, select your project and click <strong>Run</strong>
|
||||||
|
|||||||
Reference in New Issue
Block a user