QML - Урок 020. Старт роботи з Android Manifest в Qt Creator

Android Manifest, Android, Qt, QML, manifest

Коли приходить час вести розробку під Android на Qt, то Ми рано чи пізно приходимо до необхідності працювати з файлом AndroidManifest.xml . В даному файлі Ми маємо можливість вказати певні принципові настройки поведінки для нашого застосування, наприклад орієнтацію екрану, або основну тему програми.

Але за замовчуванням Android Manifest в Qt Creator НЕ створюється. Щоб почати з ним працювати, необхідно буде його створити в параметрах збірки проекту.

Покрокова робота з Android Manifest

Перший крок

Для цього необхідно зайти у вкладку Проекти і в ній знайти необхідний нам комплект збірки. Вибрати пункт Збірка і в ньому знайти пункт Зібрати Android APK . Розгорнемо цей пункт клікнувши на "Детальніше" .

Тут Ви зможете вибрати цільовий рівень SDK і налаштувати параметри збірки APK.

Другий крок

Але щоб створити файл AndroidManifest.xml , Вам знадобиться клікнути на кнопку "Створити шаблони" . І після цього вибрати папку, де буде створено Android Manifest .

Третій крок

У структурі проекту Ви побачите файл AndroidManifest.xml . А праворуч від структури буде відкрита настройка даного файлу. Тут Ви зможете задати мінімальний необхідний SDK пристрою, на яке буде проводитися установка додатки, а також задати значок програми і включити необхідні для додатка дозволу. Наприклад, виклики, доступ в інтернет, робота з Wi-Fi і т.д.

Четвертий крок

Після того, як Ви налаштуєте основні параметри програми, пропоную поглянути на сам xml код файлу, який згенерував QtCreator . Це код буде аналогічний тому коду, який Ви побачите в AndroidManifst.xml при розробці програми під Android на Java . Тому настройка даного файлу буде аналогічна розробці під Java. І, наприклад, настройка фікісрованной орієнтації екрану буде виглядати наступним чином:

<activity 
...
android:screenOrientation="landscape" >
...
</activity>

Ну а повний код отриманого Android Manifest у мене виглядав наступним чином.

<?xml version="1.0"?>
<manifest package="org.qtproject.example" xmlns:android="http://schemas.android.com/apk/res/android" android:versionName="1.0" android:versionCode="1" android:installLocation="auto">
    <application android:hardwareAccelerated="true" android:name="org.qtproject.qt5.android.bindings.QtApplication" android:label="-- %%INSERT_APP_NAME%% --">
        <activity android:configChanges="orientation|uiMode|screenLayout|screenSize|smallestScreenSize|layoutDirection|locale|fontScale|keyboard|keyboardHidden|navigation" android:name="org.qtproject.qt5.android.bindings.QtActivity" android:label="-- %%INSERT_APP_NAME%% --" android:screenOrientation="unspecified" android:launchMode="singleTop">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
            <meta-data android:name="android.app.lib_name" android:value="-- %%INSERT_APP_LIB_NAME%% --"/>
            <meta-data android:name="android.app.qt_sources_resource_id" android:resource="@array/qt_sources"/>
            <meta-data android:name="android.app.repository" android:value="default"/>
            <meta-data android:name="android.app.qt_libs_resource_id" android:resource="@array/qt_libs"/>
            <meta-data android:name="android.app.bundled_libs_resource_id" android:resource="@array/bundled_libs"/>
            <!-- Deploy Qt libs as part of package -->
            <meta-data android:name="android.app.bundle_local_qt_libs" android:value="-- %%BUNDLE_LOCAL_QT_LIBS%% --"/>
            <meta-data android:name="android.app.bundled_in_lib_resource_id" android:resource="@array/bundled_in_lib"/>
            <meta-data android:name="android.app.bundled_in_assets_resource_id" android:resource="@array/bundled_in_assets"/>
            <!-- Run with local libs -->
            <meta-data android:name="android.app.use_local_qt_libs" android:value="-- %%USE_LOCAL_QT_LIBS%% --"/>
            <meta-data android:name="android.app.libs_prefix" android:value="/data/local/tmp/qt/"/>
            <meta-data android:name="android.app.load_local_libs" android:value="-- %%INSERT_LOCAL_LIBS%% --"/>
            <meta-data android:name="android.app.load_local_jars" android:value="-- %%INSERT_LOCAL_JARS%% --"/>
            <meta-data android:name="android.app.static_init_classes" android:value="-- %%INSERT_INIT_CLASSES%% --"/>
            <!--  Messages maps -->
            <meta-data android:value="@string/ministro_not_found_msg" android:name="android.app.ministro_not_found_msg"/>
            <meta-data android:value="@string/ministro_needed_msg" android:name="android.app.ministro_needed_msg"/>
            <meta-data android:value="@string/fatal_error_msg" android:name="android.app.fatal_error_msg"/>
            <!--  Messages maps -->
 
            <!-- Splash screen -->
            <!--
            <meta-data android:name="android.app.splash_screen_drawable" android:resource="@drawable/logo"/>
            -->
            <!-- Splash screen -->
 
            <!-- Background running -->
            <!-- Warning: changing this value to true may cause unexpected crashes if the
                          application still try to draw after
                          "applicationStateChanged(Qt::ApplicationSuspended)"
                          signal is sent! -->
            <meta-data android:name="android.app.background_running" android:value="false"/>
            <!-- Background running -->
        </activity>
    </application>
    <uses-sdk android:targetSdkVersion="14"/>
    <supports-screens android:largeScreens="true" android:normalScreens="true" android:anyDensity="true" android:smallScreens="true"/>
 
    <!-- The following comment will be replaced upon deployment with default permissions based on the dependencies of the application.
         Remove the comment if you do not require these default permissions. -->
    <!-- %%INSERT_PERMISSIONS -->
 
    <!-- The following comment will be replaced upon deployment with default features based on the dependencies of the application.
         Remove the comment if you do not require these default features. -->
    <!-- %%INSERT_FEATURES -->
 
</manifest>

Висновок

Робота з AndroidManifest.xml під Qt має свою специфіку, але при цьому все-таки не так сильно відрізняється від того, як якщо б Ми вели розробку на Java .

Також можете глянути профайл проекту. У ньому Ви побачите, як підключений до проекту Ваш Android Manifest.