diff options
Diffstat (limited to 'doc/src')
-rw-r--r-- | doc/src/android/androiddev.qdoc | 23 | ||||
-rw-r--r-- | doc/src/android/deploying-android.qdoc | 38 |
2 files changed, 47 insertions, 14 deletions
diff --git a/doc/src/android/androiddev.qdoc b/doc/src/android/androiddev.qdoc index ac2a77a3fe..00737d5ef2 100644 --- a/doc/src/android/androiddev.qdoc +++ b/doc/src/android/androiddev.qdoc @@ -1,6 +1,6 @@ /**************************************************************************** ** -** Copyright (C) 2018 The Qt Company Ltd. +** Copyright (C) 2019 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt Creator documentation. @@ -66,10 +66,10 @@ \note Android SDK Tools have issues with JDK versions later than 8. \li \l{http://www.gradle.org}{Gradle} for building application packages - for Android devices (APK). Gradle is delivered with Qt 5.9, and - later. Because Gradle scripts are not delivered with Android SDK - Tools since version 26.0.0, they are delivered with Qt 5.9 and - 5.6.3. + (APK) and app bundles (AAB) for Android devices. Gradle is delivered + with Qt 5.9, and later. Because Gradle scripts are not delivered + with Android SDK tools since version 26.0.0, they are delivered + with Qt 5.9 and 5.6.3. \note Using Ant to build APKs is no longer supported. @@ -77,6 +77,9 @@ by the \l{http://developer.android.com/tools/sdk/ndk/index.html} {Android NDK} from Google. + \note To develop with Qt 5.14.0 or later, you need Android NDK r20 + or later. + \li \l{http://developer.android.com/sdk/index.html}{Android SDK Tools} The following Android SDK packages and tools are required for @@ -167,7 +170,7 @@ \li In the \uicontrol {JDK location} field, add the path to the JDK. - You can use the \inlineimage download.png + Select the \inlineimage icons/download-icon.png (\uicontrol Download) button to go to the site where you can download the JDK. \QC checks the JDK installation and reports errors. @@ -175,9 +178,8 @@ \li In the \uicontrol {Android Settings} group, add paths to the Android NDK and SDK. - You can use the \inlineimage download.png - (\uicontrol Download) buttons to go to the sites where you can download - the Android NDK and SDK. + Select \inlineimage icons/download-icon.png + to go to the sites where you can download the Android NDK and SDK. The SDK Manager checks the Android NDK and SDK installations, reports errors, and offers to install the necessary packages. @@ -192,7 +194,8 @@ \li Select \uicontrol File > \uicontrol {New File or Project} > \uicontrol Application > \uicontrol {Qt Quick Application} > \uicontrol Choose, and - follow the instructions of the wizard. For more information, see + follow the instructions of the wizard to create a project. For more + information, see \if defined(qtcreator) \l{Creating Qt Quick Projects}. \else diff --git a/doc/src/android/deploying-android.qdoc b/doc/src/android/deploying-android.qdoc index 998cc7f210..7690b435a6 100644 --- a/doc/src/android/deploying-android.qdoc +++ b/doc/src/android/deploying-android.qdoc @@ -1,6 +1,6 @@ /**************************************************************************** ** -** Copyright (C) 2018 The Qt Company Ltd. +** Copyright (C) 2019 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt Creator documentation. @@ -32,9 +32,19 @@ \title Deploying Applications to Android Devices - On Android, applications are distributed in a specially structured type of - ZIP package called an APK. \QC supports the following methods of deployment - for Android applications: + On Android, applications are distributed in specially structured types of + ZIP packages called Application Packages (APK) or Android App Bundles (AAB). + APK files can be downloaded to and executed on a device, whereas AAB is + intended to be interpreted by the Google Play store and is used to generate + APK files. + + \l{Qt for Android} has binaries for armv7a, arm64-v8a, x86, and x86-64. + To support several different ABIs in your application, build an AAB that + contains binaries for each of the ABIs. The Google Play store uses the + AAB to generate optimized APK packages for the devices issuing the download + request and automatically signs them with your publisher key. + + \QC supports the following methods of deployment for Android applications: \list @@ -44,6 +54,9 @@ The Ministro tool downloads the necessary Qt libraries from a repository of your choice. + \li Since Qt 5.14.0, as an app bundle (AAB), intended for distribution + in the Google Play store. + \endlist To specify settings for application packages, select \uicontrol Projects > @@ -137,6 +150,23 @@ the \uicontrol {Compile Output} pane. To view additional information, select the \uicontrol {Verbose output} check box. + \section3 Building AABs + + For testing the application locally, use the APK format, because + the package can be uploaded directly to the device and run. For + distribution to the Google Play store, create an AAB by selecting + the \uicontrol {Build .aab (Android App Bundle)} check box. + + When building with CMake, you can select the ABIs to build the application + for in the \uicontrol CMake settings: + + \image qtcreator-android-cmake-settings.png "CMake settings for building AABs" + + When building with qmake, you can select the ABIs in the \uicontrol ABIs + field in the \uicontrol {Build Steps}: + + \image qtcreator-android-build-steps.png "Android Build Steps" + \section3 Selecting API Level In the \uicontrol {Android build SDK} field, you can select the API level to use |