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
97
98
99
100
101
102
103
104
105
106
107
108
109
|
// Copyright (C) 2017 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
#include "assistant.h"
#include <QApplication>
#include <QByteArray>
#include <QDir>
#include <QLibraryInfo>
#include <QMessageBox>
#include <QStandardPaths>
using namespace Qt::StringLiterals;
//! [0]
Assistant::~Assistant()
{
if (!m_process.isNull() && m_process->state() == QProcess::Running) {
QObject::disconnect(m_process.data(), &QProcess::finished, nullptr, nullptr);
m_process->terminate();
m_process->waitForFinished(3000);
}
}
//! [0]
//! [1]
void Assistant::showDocumentation(const QString &page)
{
if (!startAssistant())
return;
QByteArray ba("SetSource ");
ba.append("qthelp://org.qt-project.examples.simpletextviewer/doc/");
m_process->write(ba + page.toLocal8Bit() + '\n');
}
//! [1]
static QString documentationDirectory()
{
QStringList paths;
#ifdef SRCDIR
paths.append(QLatin1StringView(SRCDIR));
#endif
paths.append(QLibraryInfo::path(QLibraryInfo::ExamplesPath));
paths.append(QCoreApplication::applicationDirPath());
paths.append(QStandardPaths::standardLocations(QStandardPaths::AppDataLocation));
for (const auto &dir : std::as_const(paths)) {
const QString path = dir + "/documentation"_L1;
if (QFileInfo::exists(path))
return path;
}
return {};
}
//! [2]
bool Assistant::startAssistant()
{
if (m_process.isNull()) {
m_process.reset(new QProcess);
QObject::connect(m_process.data(), &QProcess::finished,
m_process.data(), [this](int exitCode, QProcess::ExitStatus status) {
finished(exitCode, status);
});
}
if (m_process->state() != QProcess::Running) {
QString app = QLibraryInfo::path(QLibraryInfo::BinariesPath);
#ifndef Q_OS_DARWIN
app += "/assistant"_L1;
#else
app += "/Assistant.app/Contents/MacOS/Assistant"_L1;
#endif
const QString collectionDirectory = documentationDirectory();
if (collectionDirectory.isEmpty()) {
showError(tr("The documentation directory cannot be found"));
return false;
}
const QStringList args{"-collectionFile"_L1,
collectionDirectory + "/simpletextviewer.qhc"_L1,
"-enableRemoteControl"_L1};
m_process->start(app, args);
if (!m_process->waitForStarted(3000)) {
showError(tr("Unable to launch Qt Assistant (%1): %2")
.arg(QDir::toNativeSeparators(app), m_process->errorString()));
return false;
}
}
return true;
}
//! [2]
void Assistant::showError(const QString &message)
{
QMessageBox::critical(QApplication::activeWindow(), tr("Simple Text Viewer"), message);
}
void Assistant::finished(int exitCode, QProcess::ExitStatus status)
{
const QString stdErr = QString::fromLocal8Bit(m_process->readAllStandardError());
if (status != QProcess::NormalExit)
showError(tr("Assistant crashed: %1").arg(stdErr));
else if (exitCode != 0)
showError(tr("Assistant exited with %1: %2").arg(exitCode).arg(stdErr));
}
|