Doc: Make deprecated tools less prominent in Android instructions

Ant was deprecated in Qt Creator 4.3 and will be removed. The
sdkmanager and avdmanager command-line tools must be used to
manage SDKs and AVDs.

Change-Id: Ibba8bc429e5da87e3f79ce45766f4583d0a461b1
Reviewed-by: Vikas Pachdha's avatarVikas Pachdha <vikas.pachdha@qt.io>
parent a7cd002e
...@@ -57,16 +57,14 @@ ...@@ -57,16 +57,14 @@
\li \l{http://www.oracle.com/technetwork/java/javase/downloads/index.html} \li \l{http://www.oracle.com/technetwork/java/javase/downloads/index.html}
{Java SE Development Kit (JDK)} version 6, or later {Java SE Development Kit (JDK)} version 6, or later
\li A build tool for building application packages for Android devices: \li \l{http://www.gradle.org}{Gradle} for building application packages
for Android devices (APK). Gradle is delivered with Qt 5.9, and
later.
\list \note Using Ant to build APKs is still possible when developing with
Qt 5.8 or earlier together with Android SDK tools versions 25.2.5 or
\li \l{http://ant.apache.org/bindownload.cgi}{Apache Ant} 1.8.0, earlier, but Ant support has been deprecated since \QC 4.3 and will
or later be removed in a future version.
\li \l{http://www.gradle.org}{Gradle}
\endlist
\li A tool chain for building applications for Android devices provided \li A tool chain for building applications for Android devices provided
by the \l{http://developer.android.com/tools/sdk/ndk/index.html} by the \l{http://developer.android.com/tools/sdk/ndk/index.html}
...@@ -74,20 +72,10 @@ ...@@ -74,20 +72,10 @@
\li \l{http://developer.android.com/sdk/index.html}{Android SDK Tools} \li \l{http://developer.android.com/sdk/index.html}{Android SDK Tools}
After installing the Tools, update the Android SDK to get the API After installing the Tools, you can use the
and tools packages required for development. You can use the
\l{http://developer.android.com/tools/help/android.html}{android}
tool that comes with the SDK Tools package. For example, on Ubuntu
the following command starts the SDK update:
\code
./android update sdk
\endcode
\note The android tool is deprecated since SDK tools version 25.3.0.
Consider using
\l{https://developer.android.com/studio/command-line/sdkmanager.html} \l{https://developer.android.com/studio/command-line/sdkmanager.html}
{sdkmanager} instead. {sdkmanager} to get the API and tools packages required for
development.
\li On Windows, you also need the following: \li On Windows, you also need the following:
...@@ -108,33 +96,17 @@ ...@@ -108,33 +96,17 @@
\endlist \endlist
\section1 Selecting the APK Build Tool
On Android, applications are distributed in specially structured type of ZIP
packages called APK. You can use either Ant or Gradle to build APKs. Using
Gradle has the following benefits:
\list
\li It is 25 to 50 percent faster than Ant when rebuilding packages.
\li It is delivered with Qt 5.9.
\li It supports easily adding Android Extras libraries, such as
Google Play services or Android extension files (.obb) to your
project.
\endlist
\note Android SDK tools version 25.3.0 onwards do not contain Ant scripts
anymore. Therefore, Gradle builds are forced and you must use Qt 5.9 or
later when using these tools versions.
\section1 Setting Up the Development Environment \section1 Setting Up the Development Environment
You must download and install the latest Android NDK and SDK, and update the You must download and install the latest Android NDK and SDK, and update the
SDK to get the API and tools packages needed for development. In addition, SDK to get the build and platform tools needed for development. Since
you must install Qt for Android as part of Qt 5.2, or later. SDK tools version 25.3.0, \QC, you must use the
\l{https://developer.android.com/studio/command-line/sdkmanager.html}
{sdkmanager} command line tool for SDK package management and the
\l{https://developer.android.com/studio/command-line/avdmanager.html}
{avdmanager} tool for Android Virtual Device (AVD) management.
In addition, you must install Qt for Android as part of Qt 5.2, or later.
For more information, see \l{Qt for Android}. For more information, see \l{Qt for Android}.
...@@ -165,6 +137,9 @@ ...@@ -165,6 +137,9 @@
\li To use Ant, add the path to the Ant executable in the \li To use Ant, add the path to the Ant executable in the
\uicontrol {Ant executable} field. \uicontrol {Ant executable} field.
\note Ant support has been deprecated since \QC 4.3. We
recommend that you use Gradle instead.
\endlist \endlist
\li Select \uicontrol File > \uicontrol {New File or Project} > \uicontrol Application > \li Select \uicontrol File > \uicontrol {New File or Project} > \uicontrol Application >
...@@ -213,7 +188,7 @@ ...@@ -213,7 +188,7 @@
\image qtcreator-android-select-devices.png "Select Android Devices dialog" \image qtcreator-android-select-devices.png "Select Android Devices dialog"
Android Virtual Devices (AVD) are also listed. To create new AVDs, select AVDs are also listed. To create new AVDs, select
\uicontrol {Create Android Virtual Device}. \uicontrol {Create Android Virtual Device}.
To set a device as the default device for a particular Android architecture, To set a device as the default device for a particular Android architecture,
......
...@@ -131,8 +131,9 @@ ...@@ -131,8 +131,9 @@
\endlist \endlist
The Gradle wrappers and scripts are bundled only if you use The Gradle wrappers and scripts are bundled only if you use Gradle to build
\l{Selecting the APK Build Tool}{Gradle} to build the application packages. the application packages. For more information, see
\l{Connecting Android Devices}.
To view the packages that the \c androiddeployqt tool created, select the To view the packages that the \c androiddeployqt tool created, select the
\uicontrol {Open package location after build} check box. \uicontrol {Open package location after build} check box.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment