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.