/usr/share/qt5/doc/qtdoc/androidgs.html is in qt5-doc-html 5.2.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- android.qdoc -->
<title>Getting Started with Qt for Android | QtDoc 5.2</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li><a href="index.html">Qt 5.2</a></li>
<li>Getting Started with Qt for Android</li>
<li id="buildversion">
Qt 5.2.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#requirements">Requirements</a></li>
<li class="level1"><a href="#installing-qt-for-android">Installing Qt for Android</a></li>
<li class="level1"><a href="#configuring-qt-creator">Configuring Qt Creator</a></li>
</ul>
</div>
<h1 class="title">Getting Started with Qt for Android</h1>
<span class="subtitle"></span>
<!-- $$$androidgs.html-description -->
<div class="descr"> <a name="details"></a>
<a name="requirements"></a>
<h2>Requirements</h2>
<p>In order to use Qt for Android, you need the following:</p>
<ul>
<li><a href="http://developer.android.com/sdk/index.html">The Android SDK Tools</a></li>
<li><a href="http://developer.android.com/tools/sdk/ndk/index.html">The Android NDK</a></li>
<li><a href="http://ant.apache.org/bindownload.cgi">Apache Ant</a> v1.8 or later</li>
<li><a href="http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html">Java SE Development Kit</a> (JDK) v6 or later. You can also use <a href="http://openjdk.java.net">OpenJDK</a> on Linux.</li>
<li>On Windows, you need the following additional installations:<ul>
<li><a href="http://www.mingw.org/">MinGW</a> v4.8.0 revision 2</li>
<li>Android Debug Bridge (ADB) driver on the Windows platform to enable USB debugging. The default USB driver on Windows does not allow debugging. For details about how to get the USB driver, see <a href="http://developer.android.com/sdk/win-usb.html">http://developer.android.com/sdk/win-usb.html</a>.<p>After installing the driver, try running a few basic <a href="http://developer.android.com/tools/help/adb.html">adb</a> commands and check whether your device responds to it.</p>
</li>
</ul>
</li>
</ul>
<p><b>Note: </b>You must set the <tt>JAVA_HOME</tt> environment variable to the JDK install directory path so that Qt Creator finds the binaries required to build your application.</p><p>After installing these tools, update the Android SDK to get the API and tools packages required for development. You can update the SDK using the <a href="http://developer.android.com/tools/help/android.html">android</a> tool that comes with the SDK Tools package. For example, on Ubuntu the following command starts the <a href="http://developer.android.com/sdk/installing/adding-packages.html">Android SDK Manager</a>, which enables you to select the packages you want to install:</p>
<pre class="cpp"><span class="operator">.</span><span class="operator">/</span>android update sdk</pre>
<a name="installing-qt-for-android"></a>
<h2>Installing Qt for Android</h2>
<p>You can install the binary package for Qt 5.1 or later to get Qt for Android. The <a href="qtinstaller.html">installer</a> containing the open-source binary packages are available for download from the <a href="http://qt-project.org/downloads">Qt project Downloads</a> page.</p>
<p><b>Note: </b>Enterprise packages are available from the <a href="http://qt.digia.com/Try-Qt-Now/">Try Qt Enterprise</a> page. Qt for Android is also available as part of Qt Mobile Edition, see <a href="http://qt.digia.com/">qt.digia.com</a> for details.</p><p>You can also choose to build the binaries from the Qt sources, that is, cross-compile Qt 5.x for Android on <a href="linux.html">Linux (X11)</a> , <a href="windows-support.html">Windows</a>, and <a href="macosx.html">Mac OS X</a> platforms. If you chose to do so, follow these instructions:</p>
<ol class="1">
<li>Install the required tools, SDK, and the compiler toolchains listed in the <a href="#requirements">Requirements</a> section.<p><b>Note: </b>Ensure that your build environment fulfills the requirement for the platform (<a href="linux.html">Linux</a>, <a href="macosx.html">Mac OS X</a>, and <a href="windows-support.html">Windows</a>) you have chosen.</p></li>
<li>Set the following environment variables if your build platform is Windows:<ul>
<li><tt>ANDROID_NDK_HOST=windows</tt> or <tt>windows-x86-64</tt> depending on which NDK you are using.</li>
<li><tt>PATH=%JAVA_HOME%\bin;<MINGW_ROOT>\bin;%PATH%</tt></li>
</ul>
</li>
<li>Download the Qt 5 sources either from the <a href="http://qt-project.org/downloads">Downloads</a> page or from the Git repository.<p><b>Note: </b>If you are downloading the sources from the Git repository, you must initialize your Git clone using the <tt>perl init-repository</tt> command to pull the latest sources for all the Qt 5.x modules. Ensure that you have perl v5.14 or later installed.</p></li>
<li>Run the following command to configure the Qt 5.x sources to cross-compile Qt for Android:<p>On Linux/X11 and Mac OS X:</p>
<pre class="cpp"> <span class="operator">.</span><span class="operator">/</span>configure <span class="operator">-</span>developer<span class="operator">-</span>build <span class="operator">-</span>xplatform android<span class="operator">-</span>g<span class="operator">+</span><span class="operator">+</span> <span class="operator">-</span>nomake tests <span class="operator">-</span>nomake examples <span class="operator">-</span>android<span class="operator">-</span>ndk <span class="operator"><</span>path<span class="operator">/</span>to<span class="operator">/</span>ndk<span class="operator">></span> <span class="operator">-</span>android<span class="operator">-</span>sdk <span class="operator"><</span>path<span class="operator">/</span>to<span class="operator">/</span>sdk<span class="operator">></span>
<span class="operator">-</span>android<span class="operator">-</span>toolchain<span class="operator">-</span>version <span class="operator"><</span>e<span class="operator">.</span>g<span class="operator">.</span> <span class="number">4.8</span><span class="operator">></span> <span class="operator">-</span>skip qttranslations <span class="operator">-</span>skip qtwebkit <span class="operator">-</span>skip qtserialport <span class="operator">-</span>skip qtwebkit<span class="operator">-</span>examples</pre>
<p>On Windows:</p>
<pre class="cpp"> configure<span class="operator">.</span>bat <span class="operator">-</span>developer<span class="operator">-</span>build <span class="operator">-</span>platform win32<span class="operator">-</span>g<span class="operator">+</span><span class="operator">+</span> <span class="operator">-</span>xplatform android<span class="operator">-</span>g<span class="operator">+</span><span class="operator">+</span> <span class="operator">-</span>android<span class="operator">-</span>ndk <span class="operator"><</span>ANDROID_NDK_ROOT<span class="operator">></span>
<span class="operator">-</span>android<span class="operator">-</span>sdk <span class="operator"><</span>ANDROID_SDK<span class="operator">></span> <span class="operator">-</span>opensource <span class="operator">-</span>confirm<span class="operator">-</span>license <span class="operator">-</span>nomake tests <span class="operator">-</span>nomake examples <span class="operator">-</span>skip qttranslations <span class="operator">-</span>skip qtwebkit <span class="operator">-</span>skip qtserialport <span class="operator">-</span>skip qtwebkit<span class="operator">-</span>examples</pre>
<p><b>Note: </b>If you want to use OpenSSL in your application, use the <tt>-openssl</tt> option with your <tt>configure</tt> command to build Qt binaries with runtime support for OpenSSL. For more information about how to add OpenSSL support to your application, see <a href="opensslsupport.html">Adding OpenSSL Support</a>.</p></li>
<li>Start the build by using the <tt>make</tt> or <tt>mingw32-make</tt> (on Windows) utility with the <tt>-j<N></tt> switch (used to speedup building).</li>
</ol>
<p>The binaries are installed to the <i>qtbase/bin</i> directory by default for the developer builds. You can check the install paths using the <tt>qmake -query</tt> command.</p>
<a name="configuring-qt-creator"></a>
<h2>Configuring Qt Creator</h2>
<p>After installing the Qt for Android binaries either using the installer or by cross-compiling, Qt Creator must be configured to start developing your first Qt application for Android.</p>
<p><b>Note: </b>You must install Qt Creator separately (either using the stand-alone or Qt 5 installer provided by Qt project, or by building it from the source) if you built the Qt 5.x binaries from the sources. Use the 3.0 git branch if you are building it from the source.</p><p>See <a href="http://qt-project.org/doc/qtcreator/creator-developing-android.html">Qt Creator Manual</a> for instructions to configure and test your setup by creating a simple Qt Quick application. You can also try running an example on the Android target to test the setup. Use the <tt>android</tt> keyword in the search field under the <b>Examples</b> tab in Qt Creator <b>Welcome</b> mode to list all the examples tested for Android.</p>
</div>
<!-- @@@androidgs.html -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Digia, Qt and their respective logos are trademarks of Digia Plc in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|