logcat日志的使用——Qt For Android

前言

最近一直用qt开发安卓app,一直无法用真机调试,可能是缺什么东西。但是如果通过Qt Creator在真机上运行,可以在电脑控制台看打印(安卓本身的日志、qDebug之类的打印),所以我是通过打印猜测问题所在,这样凑合着用。

最近换了个测试机,控制台就不打印了,包括qDebug的一些都没有,这就很难受了。

所以,就学习了一下安卓的日志工具logcat,查资料时,发现还可以与Qt的一些打印(qDebug、qInfo等)结合,都显示在命令行工具界面中,方便查看。

知识储备

Logcat 命令行工具

安卓的日志分有优先级:

  • V:详细(最低优先级)
  • D:调试
  • I:信息
  • W:警告
  • E:错误
  • F:严重错误
  • S:静默(最高优先级,绝不会输出任何内容)

如要将日志输出降低到可管理的水平,可使用过滤表达式限制日志输出。

过滤表达式采用**tag:priority ...** 格式,其中 tag 表示您感兴趣的标记,priority 表示可针对该标记报告的最低优先级。不低于指定优先级的标记的消息会写入日志。在一个过滤表达式中提供任意数量的 tag:priority 规范。一系列规范使用空格分隔

以下是一个过滤表达式的示例,该表达式会抑制除标记为"ActivityManager"、优先级不低于"信息"的日志消息,以及标记为"MyApp"、优先级不低于"调试"的日志消息以外的所有其他日志消息:

复制代码
adb logcat ActivityManager:I MyApp:D *:S

也可控制日志输出格式 :使用 -v 选项,并指定下列某一受支持的输出格式:

  • brief:显示优先级、标记以及发出消息的进程的 PID。
  • long:显示所有元数据字段,并使用空白行分隔消息。
  • process:仅显示 PID。
  • raw:显示不包含其他元数据字段的原始日志消息。
  • tag:仅显示优先级和标记。
  • thread::旧版格式,显示优先级、PID 以及发出消息的线程的 TID。
  • threadtime(默认值):显示日期、调用时间、优先级、标记、PID 以及发出消息的线程的 TID。
  • time:显示日期、调用时间、优先级、标记以及发出消息的进程的 PID。

如:

复制代码
adb logcat -v thread

常用的命令有:

  • adb logcat ,查看输出的全部日志
  • adb logcat -v time ,带日期的日志
  • adb logcat -v time -s Tag 。仅显示指定标签的日志信息,同时带有日期

详细使用说明可看官网介绍:

Logcat 命令行工具 | Android Studio | Android Developers (google.cn)

qInstallMessageHandler

Message Handler用于打印出调试消息、警告、严重和致命错误消息。也就是说 qDebug(), qInfo(), qWarning(), qCritical(), qFatal()都是通过这个消息句柄打印出来的。

Qt提供了一个函数qInstallMessageHandler 用于安装消息处理函数,也就是可用自定义的Message Handler 替代之前默认的。

具体可见帮助文档说明

<QtGlobal> - Global Qt Declarations | Qt Core 5.15.16

我们可以使用自定义的Message Handler将打印消息收集起来写入文件,作为日志。

当然,也可以做其他处理 ,比如此次是将打印信息写入安卓的日志。

代码

上面关于logcat的帮助文档中有关于写日志的描述

日志记录系统的 C/C++ 主接口是共享库 liblog 及其头文件 <android/log.h>。所有语言特定的日志记录工具(包括 android.util.Log)最终都会调用函数 __android_log_write。默认情况下,它会调用函数 __android_log_logd_logger,该函数使用套接字将日志条目发送到 logd。从 API 级别 30 开始,可通过调用 __android_set_log_writer 更改日志记录函数

复制代码
int __android_log_write(
  int prio,
  const char *tag,
  const char *text
)

Writes the constant string text to the log, with priority prio and tag tag.

下面的代码来自网络,亲测,可用:

复制代码
#ifndef QDEBUG2LOGCAT_H

#define QDEBUG2LOGCAT_H

#include <QtMsgHandler>

#ifdef ANDROID

void installLogcatMessageHandler(const char *TAG);

#else

#define installLogcatMessageHandler(TAG)

#endif

#endif // QDEBUG2LOGCAT_H

#if defined(ANDROID)

#include "qDebug2Logcat.h"

#include <android/log.h>

#include <QDebug>

#include <QByteArray>

static const char *g_TAG = 0;

static void messageOutput2Logcat(QtMsgType type,

                                 const QMessageLogContext &context,

                                 const QString &msg)

{

    int prio = ANDROID_LOG_VERBOSE;

    QByteArray localMsg = msg.toLocal8Bit();

    switch (type) {

    case QtDebugMsg:

        prio = ANDROID_LOG_DEBUG;

        break;

    case QtWarningMsg:

        prio = ANDROID_LOG_WARN;

        break;

    case QtCriticalMsg:

        prio = ANDROID_LOG_ERROR;

        break;

    case QtFatalMsg:

        prio = ANDROID_LOG_FATAL;
        break;

    case QtInfoMsg:

        prio = ANDROID_LOG_INFO;

        break;

    default:
        break;

    }

    __android_log_write(prio, g_TAG, localMsg.data());

}

void installLogcatMessageHandler(const char *TAG)

{

    g_TAG = (TAG == 0 ? "QDebug" : TAG);

    qInstallMessageHandler(messageOutput2Logcat);

}

#endif

int main(int argc, char *argv[])
{
    //注册自定义的消息处理函数
    installLogcatMessageHandler("CustomTag");

  ...

}

运行

在电脑上通过adb连接安卓设备后,调用命令行查看日志,

比如 标签为"onboardTrainingLog"的带日期等信息的日志:

复制代码
adb logcat -v -time -s onboardTrainingLog

显示如下

关于通过qInstallMessageHandler实现各个平台日志,可参考下面的博客:

Qt 在Windows/Mac/Android下使用日志------------------附赠完整代码和示例-CSDN博客

结束语

有了日志,感觉就有了底气。

相关推荐
艾莉丝努力练剑6 分钟前
【LeetCode&数据结构】单链表的应用——反转链表问题、链表的中间节点问题详解
c语言·开发语言·数据结构·学习·算法·leetcode·链表
人生游戏牛马NPC1号2 小时前
学习 Flutter (三):玩安卓项目实战 - 上
android·学习·flutter
还债大湿兄2 小时前
《C++内存泄漏8大战场:Qt/MFC实战详解 + 面试高频陷阱破解》
c++·qt·mfc
小馬佩德罗3 小时前
Android系统的问题分析笔记 - Android上的调试方式 debuggerd
android·调试
倔强青铜34 小时前
苦练Python第18天:Python异常处理锦囊
开发语言·python
清霜之辰4 小时前
安卓基于 FirebaseAuth 实现 google 登录
android·google·auth·firebase
u_topian4 小时前
【个人笔记】Qt使用的一些易错问题
开发语言·笔记·qt
GitLqr5 小时前
数码洞察 | Apple VS DMA、三星新品、Android 16KB Page Size
android·ios·samsung
alexhilton5 小时前
SnapshotFlow还是collectAsState?对于Jetpack Compose来说哪个更香?
android·kotlin·android jetpack
珊瑚里的鱼5 小时前
LeetCode 692题解 | 前K个高频单词
开发语言·c++·算法·leetcode·职场和发展·学习方法