Qt on Android：让 Qt Widgets 和 Qt Quick 应用全屏显示

2022-11-25 16:04:18

Android 系统版本号非常多，较新的 4.4 ，较老的 2.3 ，都有人用。

Qt on Android 开发的 Android 应用。默认在 Android 设备上是非全屏的。

而有些应用的需求是全屏显示，比方游戏。那么怎么样才干做到这点呢？

我们须要分 Android 系统版本号来说。

Android 2.x

对于 4.0 曾经，比方 2.2 、 2.3 的系统。能够改动 AndroidManifest.xml 文件来实现全屏。

首先须要为 Qt on Android 应用生成一个 AndroidManifest.xml 文件。具体參考《 Qt on Android：图文具体解释Hello World全过程》一文。创建 AndroidManifest.xml 的示意图例如以下：

watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvZm9ydW9r/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt="" />

点击上图中标号为 7 的那个button就可以创建一个 AndroidManifest.xml 文件。

该文件默认生成在 Qt 项目文件夹下的 android 子文件夹内。

然后须要打开 AndroidManifest.xml 文件，找到 Activity 标签。为其加入以下这个属性：

android:theme="@android:style/Theme.NoTitleBar.Fullscreen"

注意和前、后的其他属性之间留空格。

在 2.x 系统上执行你的 Qt on Android 应用吧。已经全屏了。连标题栏都没有了。

Android 4.x

Android 系统版本号到了 4.0 以后，前面那种设置活动主题的方式无效了。

我们须要在 Java 代码中为 Activity 设置一个全屏的窗体标记。

这在 Java 撰写的 Android 应用上非常easy，仅仅须要在 Activity 的 onCreate() 方法中加入以下的代码：

getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);

但是到了 Qt on Android 应用，就略微有些复杂了。

一步一步说吧，这次以我们的 Qt Quick App 为例来说明。先參考《Qt Quick 之 Hello World 图文具体解释》一文创建一个项目，我演示须要，还是以 HelloQtQuickApp 为基础改动的。

先看下改动前的效果图（我在 4.0.3 系统的机顶盒上执行）：

注意到图片下方的状态栏了吧。

生成 AndroidManifest.xml

參考上一节吧。把 Activity 的 Theme 属性也设置一下。

为 Qt 项目加入 Java 文件

话说 Qt on Android 应用， Qt 部分的代码以 JNI 的方式经由 Java 代码启动的。为了能够启动 Qt 代码，进入 Qt 的世界， Qt 框架提供了 QPA 层以及必要的 Activity 、 Application 实现。详情參考《Qt on Android Episode 1（翻译）》和《Qt for Android 部署流程分析》两篇文章。

这里以 Qt 5.2.0 为例来作一简单说明。

QtActivity 简析

假设你观察 AndroidManifest.xml 文件，会发现里面的 Activity 标签，指定的 activity 名字是："org.qtproject.qt5.android.bindings.QtActivity" 。没错，就是它！

它是由 Qt 框架提供的。你 Qt on Android 应用的入口。 QtActivity 的位置在这里：

c:\qt\Qt5.2.0\5.2.0\android_armv5\src\android\java\src\org\qtproject\qt5\android\bindings\QtActivity.java

感兴趣的能够打开这个 Java 文件研究一下。

以下是 QtActivity.java 的 onCreate 函数的摘录：

...

    @Override

    public void onCreate(Bundle savedInstanceState)

    {

        super.onCreate(savedInstanceState);

        try {

            setTheme(Class.forName("android.R$style").getDeclaredField(QT_ANDROID_DEFAULT_THEME).getInt(null));

        } catch (Exception e) {

            e.printStackTrace();

        }

        if (Build.VERSION.SDK_INT > 10) {

            try {

                requestWindowFeature(Window.class.getField("FEATURE_ACTION_BAR").getInt(null));

            } catch (Exception e) {

                e.printStackTrace();

            }

        } else {

            requestWindowFeature(Window.FEATURE_NO_TITLE);

        }

    ...

    }

...

如你所见， QtActivity 区分了 SDK 版本号， 10 以上的请求 FEATURE_ACTION_BAR 特性， 10 以下（Android 2.3及以下）的版本号不要 title （太难看了。仅仅显示应用名字。木啥用）。

你懂的， Qt Creator 能够编译 Java 源代码（通过调用 Ant ）， QtActivity 就是这样编译到你的 APK 中的。所以，我们也能够加入自己的 Java 代码喽。

我们要加入全屏标记，须要继承 QtActivity 类来实现一个新的 Activity 。当然假设你想粗暴地解决问题。能够直接改动 QtActivity.java 。直接加一行代码就可以。什么代码？看以下。

实现QtFullscreenActivity

QtFullscreenActivity 继承自 QtActivity 类，代码非常easy。

例如以下：

package an.qt.helloQtQuickApp;

import android.content.Context;

import android.content.Intent;

import android.app.PendingIntent;

import android.util.Log;

import android.os.Bundle;

import android.view.WindowManager;

public class QtFullscreenActivity extends org.qtproject.qt5.android.bindings.QtActivity

{

    private final static String TAG = "QtFullscreen";

    @Override

    public void onCreate(Bundle savedInstanceState) {

          super.onCreate(savedInstanceState);

          getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);

    }

}

上面代码中 "getWindow()" 起始的那行，就是设置全屏标记的。

加入 QtFullscreenActivity 到 pro 文件

我把 QtFullscreenActivity.java 文件放在了 android/src/an/qt/helloQtQuickApp/ 以下，所以 pro 文件里相关的部分是酱紫的：

OTHER_FILES += \

    android/AndroidManifest.xml \

    android/src/an/qt/helloQtQuickApp/QtFullscreenActivity.java

须要注意的是。 Java 代码中的包名（QtFullscreenActivity第一行）。和路径是严格匹配的， Java类名则和源代码文件名称严格匹配。

然后你能够看到以下的项目视图了：

watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvZm9ydW9r/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt="" />

改动 AndroidManifest.xml

这是改动的最后一步了。

我们实现的 Activity 名字是 QtFullscreenActivity 。所以呢， AndroidManifest.xml 文件里也要改动。保持一致。

见以下：

<?xml version='1.0' encoding='utf-8'?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

    android:versionCode="1"

    android:installLocation="auto"

    package="an.qt.helloQtQuickApp"

    android:versionName="1.0">

    <application

        android:name="org.qtproject.qt5.android.bindings.QtApplication"

        android:label="@string/app_name">

        <activity

            android:name="an.qt.helloQtQuickApp.QtFullscreenActivity"

            android:configChanges="orientation|uiMode|screenLayout|screenSize|smallestScreenSize|locale|fontScale|keyboard|keyboardHidden|navigation"

            android:theme="@android:style/Theme.NoTitleBar.Fullscreen"

            android:label="@string/app_name"

            android:screenOrientation="unspecified">

            <intent-filter>

...

</manifest>

好啦，到此为止，所有改动就绪。执行我们的 HelloQtQuickApp 吧。

以下是如今执行的效果：

watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvZm9ydW9r/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt="" />

好啦，到此结束。

本系列的其他文章：

码农公寓

Android 2.x

Android 4.x

生成 AndroidManifest.xml

为 Qt 项目加入 Java 文件

QtActivity 简析

实现QtFullscreenActivity

加入 QtFullscreenActivity 到 pro 文件

改动 AndroidManifest.xml

相关文章