diff --git a/docs/html/about/versions/android-4.0-highlights.jd b/docs/html/about/versions/android-4.0-highlights.jd old mode 100644 new mode 100755 index f2b35ace91b3c..c980af6cd9fda --- a/docs/html/about/versions/android-4.0-highlights.jd +++ b/docs/html/about/versions/android-4.0-highlights.jd @@ -143,7 +143,7 @@ content from the home screen. favorites tray
New home screen folders offer a new way for users to group -their apps and shortcuts logically, just by dragging one onto another. Also, +their apps and shortcuts logically, just by dragging one onto another. Also, in All Apps launcher, users can now simply drag an app to get information about it or immediately uninstall it, or disable a pre-installed app.
@@ -210,7 +210,7 @@ engine lets you dictate continously.Improved text input and spell-checking
- +The soft keyboard in Android 4.0 makes text input even faster and more accurate. Error correction and word suggestion are improved through a new set of default dictionaries and more accurate heuristics for handling cases such as @@ -693,7 +693,7 @@ development across the range of Android-powered devices.
Android 4.0 extends social and sharing features to any application on the -device. Applications can integrate contacts, profile data, stream items, +device. Applications can integrate contacts, profile data, stream items, and calendar events from any of the user’s activities or social networks.
@@ -914,8 +914,8 @@ supporting flatter view hierarchies that are faster to layout and render. Because hierarchies are flatter, developers can also manage alignments between components that are visually related to each other even when they are not logically related, for precise control over application UI. GridLayout is also -specifically designed to be configured by drag-and-drop design tools such as the -ADT Plug-in for Eclipse. +specifically designed to be configured by drag-and-drop design tools such as +Android Studio.OpenGL ES texture @@ -998,7 +998,7 @@ properties such as parent and child nodes, available states, supported actions, screen position, and more. Applications can also request changes to certain properties to help manage focus and selected state. For example, an accessibility service could use these new capabilities to add convenient -features such as screen-search by text.
+features such as screen-search by text.Text-to-speech diff --git a/docs/html/google/play/expansion-files.jd b/docs/html/google/play/expansion-files.jd old mode 100644 new mode 100755 index fcdb71562f6ed..6d1de7e75451a --- a/docs/html/google/play/expansion-files.jd +++ b/docs/html/google/play/expansion-files.jd @@ -450,37 +450,36 @@ receives updates about the download progress. download two packages from the SDK Manager and add the appropriate libraries to your application.
-First, open the Android SDK Manager, expand -Extras and download:
+First, open the Android SDK Manager +(Tools > Android > SDK Manager), and under +Appearance & Behavior > System Settings > Android SDK, select +the SDK Tools tab to select and download:
If you're using Eclipse, create a project for each library and add it to your app:
+Create a new library module for the License Verification Library and Downloader +Library. For each library:
Note: The Downloader Library depends on the License Verification Library. Be sure to add the License -Verification Library to the Downloader Library's project properties (same process as -steps 2 and 3 below).
+Verification Library to the Downloader Library's project properties. -Or, from a command line, update your project to include the libraries:
diff --git a/docs/html/guide/practices/app-design/seamlessness.jd b/docs/html/guide/practices/app-design/seamlessness.jd old mode 100644 new mode 100755 index ec6b7fdff73c9..16879625f6780 --- a/docs/html/guide/practices/app-design/seamlessness.jd +++ b/docs/html/guide/practices/app-design/seamlessness.jd @@ -41,10 +41,10 @@ display the dialog in front of whatever the user was doing (such as dialing a phone call, for example). That behavior would not work for your application or for the user. -To avoid these problems, your application should use the proper system -facility for notifying the user — the +
To avoid these problems, your application should use the proper system +facility for notifying the user — the {@link android.app.Notification Notification} classes. Using -notifications, your application can signal the user that an event has +notifications, your application can signal the user that an event has taken place, by displaying an icon in the status bar rather than taking focus and interrupting the user.
@@ -140,7 +140,7 @@ the application is hung and offers to kill it for the user. on the event handler thread, effectively blocking the event handler. This will delay input processing, and result in the ANR dialogs. To avoid this, move your computations to a thread. This Design for Responsiveness document +href="responsiveness.html">Design for Responsiveness document discusses how to do that..Different Android-powered devices will support different screen resolutions. -Some will even be able to change resolutions on the fly, such as by switching -to landscape mode. It's important to make sure your layouts and drawables +
Different Android-powered devices will support different screen resolutions. +Some will even be able to change resolutions on the fly, such as by switching +to landscape mode. It's important to make sure your layouts and drawables are flexible enough to display properly on a variety of device screens.
-Fortunately, this is very easy to do. In brief, what you must do is -provide different versions of your artwork (if you use any) for the key -resolutions, and then design your layout to accommodate various dimensions. -(For example, avoid using hard-coded positions and instead use relative -layouts.) If you do that much, the system handles the rest, and your +
Fortunately, this is very easy to do. In brief, what you must do is +provide different versions of your artwork (if you use any) for the key +resolutions, and then design your layout to accommodate various dimensions. +(For example, avoid using hard-coded positions and instead use relative +layouts.) If you do that much, the system handles the rest, and your application looks great on any device.
To avoid these problems, your application should use the proper system -facility for notifying the user — the +
To avoid these problems, your application should use the proper system +facility for notifying the user — the {@link android.app.Notification Notification} classes. Using -notifications, your application can signal the user that an event has +notifications, your application can signal the user that an event has taken place, by displaying an icon in the status bar rather than taking focus and interrupting the user.
@@ -141,7 +141,7 @@ the application is hung and offers to kill it for the user. on the event handler thread, effectively blocking the event handler. This will delay input processing, and result in the ANR dialogs. To avoid this, move your computations to a thread. This Design for Responsiveness document +href="responsiveness.html">Design for Responsiveness document discusses how to do that..Different Android-powered devices will support different screen resolutions. -Some will even be able to change resolutions on the fly, such as by switching -to landscape mode. It's important to make sure your layouts and drawables +
Different Android-powered devices will support different screen resolutions. +Some will even be able to change resolutions on the fly, such as by switching +to landscape mode. It's important to make sure your layouts and drawables are flexible enough to display properly on a variety of device screens.
-Fortunately, this is very easy to do. In brief, what you must do is -provide different versions of your artwork (if you use any) for the key -resolutions, and then design your layout to accommodate various dimensions. -(For example, avoid using hard-coded positions and instead use relative -layouts.) If you do that much, the system handles the rest, and your +
Fortunately, this is very easy to do. In brief, what you must do is +provide different versions of your artwork (if you use any) for the key +resolutions, and then design your layout to accommodate various dimensions. +(For example, avoid using hard-coded positions and instead use relative +layouts.) If you do that much, the system handles the rest, and your application looks great on any device.
To distinguish animation files that use the new property animation APIs from those that use the legacy view animation framework, starting with Android 3.1, you should save the XML files for property animations in the {@code -res/animator/} directory (instead of {@code res/anim/}). Using the {@code animator} directory name -is optional, but necessary if you want to use the layout editor tools in the Eclipse ADT plugin (ADT -11.0.0+), because ADT only searches the {@code res/animator/} directory for property animation -resources.
+res/animator/} directory.The following property animation classes have XML declaration support with the following XML tags:
diff --git a/docs/html/guide/topics/location/strategies.jd b/docs/html/guide/topics/location/strategies.jd old mode 100644 new mode 100755 index f1eb66e878d9a..32be463e687cb --- a/docs/html/guide/topics/location/strategies.jd +++ b/docs/html/guide/topics/location/strategies.jd @@ -402,20 +402,23 @@ dynamic set of data is updated each time the user location updates. user location works. This is most easily done using a real Android-powered device. If, however, you don't have a device, you can still test your location-based features by mocking location data in the Android emulator. There are three different ways to send your application mock location -data: using Eclipse, DDMS, or the "geo" command in the emulator console. +data: using Android Studio, DDMS, or the "geo" command in the emulator console.Note: Providing mock location data is injected as GPS location
data, so you must request location updates from GPS_PROVIDER in order for mock location
data to work.
Select Window > Show View > Other > Emulator Control.
+Select Tools > Android > AVD Manager. In the Android Virtual +Device Manager window, choose your AVD and launch it in the emulator by selecting the green +play arrow in the Actions column.
-In the Emulator Control panel, enter GPS coordinates under Location Controls as individual -lat/long coordinates, with a GPX file for route playback, or a KML file for multiple place marks. -(Be sure that you have a device selected in the Devices panel—available from Window -> Show View > Other > Devices.)
+Then, select Tools > Android > Android Device Monitor. +Select the Emulator Control tab in the Android Device Monitor window, and enter GPS coordinates +under Location Controls as individual lat/long coordinates, with a GPX file for route playback, +or a KML file for multiple place marks. +
For Android Studio or Gradle-based builds
For Eclipse
--renderscript.target=18 -renderscript.support.mode=true -sdk.buildtools=18.1.0 -- -
The settings listed above control specific behavior in the Android build process:
- -To install and run the application in Eclipse:
- -app directory, click Open to close that dialog and then
- click Finish.Note: Even though the add-on is labeled as - 2.3.3, the newest Google API add-on library for API level 10 adds USB Open - Accessory API support for 2.3.4 devices.
-You can now interact with the ADK board by moving the color LED or servo sliders (make sure +
After the application is installed, you can interact with the ADK board by moving the color + LED or servo sliders (make sure the servos are connected) or by pressing the relay buttons in the application. On the ADK shield, you can press the buttons and move the joystick to see their outputs displayed in the application.
diff --git a/docs/html/tools/support-library/features.jd b/docs/html/tools/support-library/features.jd old mode 100644 new mode 100755 index 61240f10d6ded..d0c09655464aa --- a/docs/html/tools/support-library/features.jd +++ b/docs/html/tools/support-library/features.jd @@ -38,7 +38,7 @@ page.title=Support Library Features Support Library RevisionsTo use any of the following libraries, you must download the library files to your +
In order to use any of the following libraries, you must download the library files to your Android SDK installation. Follow the directions for downloading the Support Libraries in Support Library Setup to complete this step. You must take additional steps to include a specific Support Library in @@ -204,8 +204,7 @@ com.android.support:multidex:1.0.0
Note: - This library depends on the v4 Support Library. If you are using Ant or Eclipse, make sure - you include the v4 Support Library as part of this library's classpath. + This library depends on the v4 Support Library.
Here are a few of the key classes included in the v7 appcompat library:
@@ -308,12 +307,10 @@ with a dependency on the v7 appcompat library, so you'll need to include both libraries in your build path when setting up your project. For more information on how to set up your project, follow the instructions in Adding libraries -with resources. If you are developing in Eclipse/ADT, make sure to include -both theandroid-support-v7-mediarouter.jar and
-android-support-v7-appcompat.jar files.
+with resources.
-If you are using Android Studio, all you need to do is specify the Gradle build
-script dependency identifier com.android.support:support-v7-mediarouter:<revision>,
+
The Gradle builder script dependency identifier is as follows:
+com.android.support:support-v7-mediarouter:<revision>,
where "<revision>" is the minimum revision at which the library is available. For example:
@@ -352,8 +349,8 @@ com.android.support:palette-v7:23.1.0The recyclerview library adds the {@link android.support.v7.widget.RecyclerView} class. This class provides support for the -RecyclerView widget, a view -for efficiently displaying large data sets by providing a +RecyclerView +widget, a view for efficiently displaying large data sets by providing a limited window of data items.
After you download the Android Support Libraries, this library is located in the @@ -423,7 +420,7 @@ com.android.support:preference-v7:23.1.0
Note: Use of RenderScript with the support library is supported with Android - Studio and Gradle-based builds, as well as the Eclipse plugin and Ant build tools. The + Studio and Gradle-based builds. The renderscript library is located in the
diff --git a/docs/html/tools/testing/contentprovider_testing.jd b/docs/html/tools/testing/contentprovider_testing.jd old mode 100644 new mode 100755 index a6440df0f4c4c..28aef919ad8ba --- a/docs/html/tools/testing/contentprovider_testing.jd +++ b/docs/html/tools/testing/contentprovider_testing.jd @@ -48,10 +48,6 @@ parent.link=index.html href="{@docRoot}tools/testing/testing_android.html"> Testing Fundamentalsbuild-tools/$VERSION/renderscript/folder.
@@ -204,9 +197,7 @@ classes.
- To learn how to set up and run tests in Eclipse, please refer to -Testing from Eclipse with ADT. - If you're not working in Eclipse, refer to + To learn how to set up and run tests from other IDEs, please refer to Testing From Other IDEs.
diff --git a/docs/html/tools/testing/index.jd b/docs/html/tools/testing/index.jd old mode 100644 new mode 100755 index 56de4cf80658b..185727c27ecfa --- a/docs/html/tools/testing/index.jd +++ b/docs/html/tools/testing/index.jd @@ -3,7 +3,7 @@ page.title=Testing
The Android framework includes an integrated testing framework that helps you test all aspects of your application and the SDK tools include tools for setting up and running test applications. -Whether you are working in Eclipse with ADT or working from the command line, the SDK tools help you +Whether you are working in Android Studio or working from the command line, the SDK tools help you set up and run your tests within an emulator or the device you are targeting.
If you aren't yet familiar with the Android testing framework, start by reading
See Also
-
See also
-
- A test project is a directory or Eclipse project in which you create the source code, manifest - file, and other files for a test package. The Android SDK contains tools for Eclipse with ADT + A test project is a directory in which you create the source code, manifest + file, and other files for a test package. The Android SDK contains tools for Android Studio and for the command line that create and update test projects for you. The tools create the directories you use for source code and resources and the manifest file for the test package. - The command-line tools also create the Ant build files you need.
You should always use Android tools to create a test project. Among other benefits,
@@ -488,7 +483,7 @@ parent.link=index.html
in the shared library android.test.runner, which is not normally linked to
Android code. To include it, you must specify it in a
<uses-library>
- element. You do not have to set up these elements yourself. Both Eclipse with ADT and the
+ element. You do not have to set up these elements yourself. Both Android Studio and the
android command-line tool construct them automatically and add them to your
test package's manifest file.
To run {@link android.test.InstrumentationTestRunner}, you use internal system classes called by - Android tools. When you run a test in Eclipse with ADT, the classes are called automatically. + Android tools. When you run a test in Android Studio the classes are called automatically. When you run a test from the command line, you run these classes with Android Debug Bridge (adb).
@@ -509,7 +504,7 @@ parent.link=index.html application under test. They then pass control to {@link android.test.InstrumentationTestRunner}, which runs each test case class in the test package. You can also control which test cases and - methods are run using settings in Eclipse with ADT, or using flags with the command-line tools. + methods are run using settings in Android Studio or using flags with the command-line tools.Neither the system classes nor {@link android.test.InstrumentationTestRunner} run @@ -521,16 +516,14 @@ parent.link=index.html Activity that displays a Spinner widget.
- To learn more about running tests, please read the topics - - Testing from Eclipse with ADT or + To learn more about running tests, please read Testing from Other IDEs.
The Android testing framework returns test results back to the tool that started the test.
- If you run a test in Eclipse with ADT, the results are displayed in a new JUnit view pane. If
+ If you run a test in Android Studio, the results are displayed in a new JUnit view pane. If
you run a test from the command line, the results are displayed in STDOUT. In
both cases, you see a test summary that displays the name of each test case and method that
was run. You also see all the assertion failures that occurred. These include pointers to the
@@ -538,10 +531,8 @@ parent.link=index.html
value and actual value.
- The test results have a format that is specific to the IDE that you are using. The test - results format for Eclipse with ADT is described in - - Testing from Eclipse with ADT. The test results format for tests run from the + The test results have a format that is specific to the IDE that you are using. The test +results format for tests run from the command line is described in Testing from Other IDEs. @@ -628,12 +619,7 @@ The UI/Application Exerciser Monkey Android Virtual Devices configured for the hardware, screens, and versions you want to test.
- To learn how to set up and run tests in Eclipse, please refer to -Testing from Eclipse with ADT. - If you're not working in Eclipse, refer to -Testing from Other IDEs. -
+If you want a step-by-step introduction to Android testing, try the Activity Testing Tutorial. diff --git a/docs/html/tools/testing/testing_otheride.jd b/docs/html/tools/testing/testing_otheride.jd old mode 100644 new mode 100755 index a77408747f808..8a3eb05defd96 --- a/docs/html/tools/testing/testing_otheride.jd +++ b/docs/html/tools/testing/testing_otheride.jd @@ -25,7 +25,7 @@ parent.link=index.html Running Tests
This document describes how to create and run tests directly from the command line. - You can use the techniques described here if you are developing in an IDE other than Eclipse + You can use the techniques described here if you are developing in an IDE other than Android Studio or if you prefer to work from the command line. This document assumes that you already know how to create a Android application in your programming environment. Before you start this document, you should read the topic @@ -66,19 +66,17 @@ parent.link=index.html which provides an overview of Android testing.
- If you are developing in Eclipse with ADT, you can set up and run your tests - directly in Eclipse. For more information, please read - - Testing from Eclipse with ADT. + If you are developing in Android Studio, you can set up and run your tests + directly in Android Studio.
You use the android tool to create test projects.
You also use android to convert existing test code into an Android test project,
- or to add the test Ant target to an existing Android test project.
+ or to add the test Gradle target to an existing Android test project.
These operations are described in more detail in the section
Updating a test project. The test target is described in
- Quick build and run with Ant.
+ Quick build and run with Gradle.
@@ -193,7 +191,7 @@ $ android create test-project -m ../HelloAndroid -n HelloAndroidTest -p HelloAnd
You use the android tool when you need to change the path to the
project of the application under test. If you are changing an existing test project created in
- Eclipse with ADT so that you can also build and run it from the command line, you must use the
+ Android Studio so that you can also build and run it from the command line, you must use the
"create" operation. See the section Creating a test project.
@@ -293,13 +291,13 @@ $ android create test-project -m ../HelloAndroid -n HelloAndroidTest -p HelloAnd
- You run tests from the command line, either with Ant or with an + You run tests from the command line, either with Gradle or with an Android Debug Bridge (adb) shell.
-
- You can use Ant to run all the tests in your test project, using the target
+ You can use Gradle to run all the tests in your test project, using the target
test, which is created automatically when you create a test project with
the android tool.
Developing applications for Android devices is facilitated by a group of tools that are - provided with the SDK. You can access these tools through an Eclipse plugin called ADT (Android - Development Tools) or from the command line. Developing with Eclipse is the preferred method because + provided with the SDK. You can access these tools through Android Studio or from the command line. Developing with Android Studio is the preferred method because it can directly invoke the tools that you need while developing applications.
However, you may choose to develop with another IDE or a simple text editor and invoke the tools on the command line or with scripts. This is a less streamlined way to develop because you will sometimes have to call command line tools manually, but you will have access to the same - number of features that you would have in Eclipse.
+ number of features that you would have in Android Studio.
The basic steps for developing applications (with or without Eclipse) are shown in figure 1. The +
The basic steps for developing applications (with or without Android Studio) are shown in figure 1. The development steps encompass four development phases, which include:
During this phase you build your project into a debuggable .apk package that you
- can install and run on the emulator or an Android-powered device. If you are using Eclipse,
- builds are generated each time you project is saved. If you're using another IDE,
- you can build your project using Ant and install it on a device using
- adb. For more information, see
+ can install and run on the emulator or an Android-powered device. Android Studio uses
+ a build system based on Gradle
+ that provides flexibility, customized build variants, dependency resolution, and much more.
+ If you're using another IDE, you can build your project using Gradle and install it on a device
+ using adb. For more information, see
Build and run your application.
Next, you debug your application using a JDWP-compliant debugger along with the debugging - and logging tools that are provided with the Android SDK. Eclipse already comes packaged with + and logging tools that are provided with the Android SDK. Android Studio already comes packaged with a compatible debugger. For more information see, Debug your application with the SDK debugging and logging tools.
@@ -62,7 +62,7 @@ development steps encompass four development phases, which include:When developing in IDEs or editors other than Eclipse, be familiar with +
When developing in IDEs or editors other than Android Studio, be familiar with all of the tools below, because you will have to run them from the command line.
If you are using Eclipse and ADT, tools such as adb and android
- are automatically called by Eclipse and ADT so you don't have to manually invoke these tools.
+
If you are using Android Studio, tools such as adb and android
+ are automatically called by Android Studio, so you don't have to manually invoke these tools.
You need to be familiar with adb, however, because certain functions are not
accessible from
- Eclipse, such as the adb shell commands. You might also need to call Keytool and
+ Android Studio, such as the adb shell commands. You might also need to call Keytool and
Jarsigner to
- sign your applications, but you can set up Eclipse to do this automatically as well.
For more information on the tools provided with the Android SDK, see the Tools section of the documentation.
@@ -147,4 +147,3 @@ src="{@docRoot}images/developing/intellijidea_android_ide.png"/> IntelliJ IDEA Android Tutorials