QInstaller 命名空间

包含用于实现 Qt 安装框架和安装程序 UI 核心功能的类。 更多...

头文件 #include <QInstaller>

命名空间

namespaceProtocol
namespaceTaskRole
namespaceUi

Types

AutoDependencyHash
enumDefaultFilePermissions { NonExecutable, Executable }
enumDownloadType { All, CompressedPackage }
enumJobError { InvalidUrl, Timeout, DownloadError, InvalidUpdatesXml, InvalidMetaInfo, …, CacheError }
LocalDependencyHash
LocalPackagesMap
Operation
OperationList
Package
PackagesList
RepoHash

函数

boolcanCreateSymbolicLinks()
QStringListcheckMutualOptions(const CommandLineParser &parser, const QStringList &options)
QStringhtmlToString(const QString &html)
QStringhumanReadableSize(const qint64 &size, int precision = 2)
voidinit()
QStringListloggingCategories()
hashValueqHash(const QInstaller::PackageSource &key, hashValue seed)
hashValueqHash(const QInstaller::Repository &repository)
hashValueqHash(const QInstaller::RepositoryCategory &repository)
hashValueqHash(const QInstaller::AliasSource &key, hashValue seed)
boolreceivePacket(QIODevice *device, QByteArray *command, QByteArray *data)
voidremoveSystemGeneratedFiles(const QString &path)
voidreplaceHighDpiImage(QString &imagePath)
QStringreplacePath(const QString &path, const QString &before, const QString &after, bool cleanPath = true)
voidsendPacket(QIODevice *device, const QByteArray &command, const QByteArray &data)
boolsetDefaultFilePermissions(const QString &fileName, QInstaller::DefaultFilePermissions permissions)
boolsetDefaultFilePermissions(QFile *file, QInstaller::DefaultFilePermissions permissions)
boolstartDetached(const QString &program, const QStringList &arguments, const QString &workingDirectory, qint64 *pid = 0)
voidtrimmedCopyConfigData(const QString &source, const QString &target, const QStringList &elementsToRemoveTags)
QDataStream &operator<<(QDataStream &ostream, const QInstaller::ArchiveEntry &entry)
QDebugoperator<<(QDebug dbg, QInstaller::Component *component)
booloperator==(const QInstaller::PackageSource &lhs, const QInstaller::PackageSource &rhs)
booloperator==(const QInstaller::ArchiveEntry &lhs, const QInstaller::ArchiveEntry &rhs)
booloperator==(const QInstaller::AliasSource &lhs, const QInstaller::AliasSource &rhs)
QDataStream &operator>>(QDataStream &istream, QInstaller::ArchiveEntry &entry)

详细说明

命名空间

namespace QInstaller::Protocol

namespace QInstaller::TaskRole

namespace QInstaller::Ui

class AbstractArchive

AbstractArchive类是表示不同存档文件的类的基类。它不能独立实例化,但定义了API并提供子类化时的常见功能。更多...

class AbstractFileTask

AbstractFileTask类是文件相关任务的基类。更多...

class AbstractOperationTracer

AbstractOperationTracer是一个纯虚基类,用于跟踪安装操作的开始和结束。更多...

class AliasFinder

根据版本和源优先级从解析的别名源文件中创建组件别名对象。更多...

class AliasSource

描述别名声明的源。更多...

class ArchiveEntry

ArchiveEntry结构体表示存档文件中的条目,例如文件或目录。更多...

class ArchiveFactory

ArchiveFactory类用于根据给定文件名的后缀创建存档对象。更多...

class AspectRatioLabel

AspectRatioLabel类提供了一个用于显示维持原始宽高比的位图的标签。更多...

class BinaryContent

BinaryContent类处理嵌入到可执行文件中的二进制信息。更多...

class BinaryFormatEngine

BinaryFormatEngine类是访问资源集合和资源文件的默认文件引擎。更多...

class BinaryFormatEngineHandler

BinaryFormatEngineHandler类提供了一种注册资源集合和资源文件的方式。更多...

class BinaryLayout

BinaryLayout类描述附加到文件中的二进制内容。更多...

class CacheableItem

CacheableItem是一个纯虚类,它定义了一个接口,用于一个适合与GenericDataCache类一起存储的类型。更多...

class Component

Component类表示当前组件。更多...

ComponentAlias

ComponentAlias类表示单组件或多组件的别名。更多...

ComponentModel

ComponentModel类用于存储可安装组件的可视化表示的数据模型。更多...

ComponentSelectionPage

ComponentSelectionPage类用于更改组件的选中状态。更多...

ComponentSortFilterProxyModel

ComponentSortFilterProxyModel提供了对另一个模型和视图之间传递的数据进行排序和过滤的支持。更多...

ConcurrentOperationRunner

ConcurrentOperationRunner类可用于并发执行安装程序操作。更多...

ConcurrentOperationTracer

ConcurrentOperationTracer类会在异步操作开始时打印跟踪输出。更多...

DirectoryGuard

RAII类用于创建目录,并在销毁时删除它(除非释放)。更多...

FileGuard

FileGuard类为文件路径提供了基本访问序列化。更多...

FileGuardLocker

FileGuardLocker类用于锁定文件路径,并在销毁时释放它。更多...

FileTaskItem

FileTaskItem类表示文件任务对象中的一个条目。更多...

FileTaskResult

FileTaskResult类表示文件任务的结果。更多...

FinishedPage

FinishedPage类完成了安装向导。更多...

GenericDataCache

GenericDataCache是一个基于校验和的存储项的模板类,用于磁盘上的存储。更多...

IntroductionPage

IntroductionPage类显示有关要安装的产品信息。更多...

Lib7zArchive

Lib7zArchive类表示由LZMA软件开发工具包处理的存档文件。更多...

LibArchiveArchive

LibArchiveArchive类表示由libarchive存档和压缩库处理的存档文件。更多...

LibArchiveWrapper

LibArchiveWrapper类提供了一个用于与使用libarchive存档和压缩库处理的存档进行交互的接口。更多...

LicenseAgreementPage

LicenseAgreementPage向最终用户展示许可协议以供接受。更多...

LoggingHandler

LoggingHandler类提供了用于操作应用程序范围打印调试信息的详尽性和格式的各种方法。更多...

MessageBoxHandler

MessageBoxHandler类提供了通知用户或询问问题的模式对话框,并接收答案。更多...

Metadata

Metadata类表示从存储库中获取的元数据。更多信息...

MetadataCache

MetadataCache类是一个基于校验和的存储在磁盘上的Metadata对象的类。更多信息...

OperationBlob

OperationBlob类是Qt安装程序框架可以实例化和执行的操作的文本表示。更多信息...

OperationTracer

OperationTracer类在操作开始时打印跟踪输出,并在销毁时自动指示完成。更多信息...

PackageManagerCore

PackageManagerCore类提供了Qt安装程序框架的核心功能。更多信息...

PackageManagerGui

PackageManagerGui类为非交互式安装提供了核心功能。更多信息...

PackageManagerPage

PackageManagerPage类显示关于要安装的产品信息。更多信息...

PackageSource

PackageSource类指定单个包源。更多信息...

PerformInstallationForm

PerformInstallationForm类显示安装状态的进度信息。更多信息...

PerformInstallationPage

PerformInstallationPage类显示安装状态的进度信息。更多信息...

ReadyForInstallationPage

ReadyForInstallationPage类向最终用户通知可以开始安装。更多信息...

Resource

Resource类是一个将文件作为只读设备封装的接口。更多信息...

ResourceCollection

ResourceCollection类是一个将一组资源组合在一起的抽象。更多信息...

ResourceCollectionManager

ResourceCollectionManager类是一个将多个资源集合组合在一起的抽象。更多信息...

RestartPage

RestartPage类启用安装程序的重启。更多信息...

ScriptEngine

ScriptEngine类用于准备和运行组件脚本。更多信息...

StartMenuDirectoryPage

StartMenuDirectoryPage类指定窗口启动菜单中产品的程序组。更多信息...

SystemInfo

提供关于操作系统的信息。更多信息...

TargetDirectoryPage

TargetDirectoryPage类指定安装的目标目录。更多信息...

类型文档

QInstaller::AutoDependencyHash

QHash<QString, QStringList>的同义词。哈希键是组件名称,其他组件自动依赖于它。值可以包含多个组件名称,这些名称作为自动依赖项安装。例如

<Name>A</Name> //Hash value
<AutoDependOn>B</AutoDependOn> //Hash key

枚举 QInstaller::DefaultFilePermissions

常量描述
QInstaller::NonExecutable0x6644非可执行文件的默认权限。
QInstaller::Executable0x7755可执行文件的默认权限。

枚举 QInstaller::DownloadType

常量
QInstaller::All0
QInstaller::CompressedPackage1

枚举 QInstaller::JobError

常量
QInstaller::InvalidUrl0x24B04
QInstaller::Timeout0x24b05
QInstaller::DownloadError0x24b06
QInstaller::InvalidUpdatesXml0x24b07
QInstaller::InvalidMetaInfo0x24b08
QInstaller::ExtractionError0x24b09
QInstaller::UserIgnoreError0x24b0a
QInstaller::RepositoryUpdatesReceived0x24b0b
QInstaller::CacheError0x24b0c

QInstaller::LocalDependencyHash

QHash 的同义词。哈希键是组件名称,其他组件依赖于它。值可以包含多个组件名称,它们依赖于键。例如

<Name>A</Name> //Hash value
<Dependencies>B</Dependencies> //Hash key

QInstaller::LocalPackagesMap

QMap 的同义词。地图键是组件名称,值包含本地包的信息。

QInstaller::Operation

KDUpdater::UpdateOperation 的同义词。

QInstaller::OperationList

QList 的同义词。

QInstaller::Package

KDUpdater::Update 的同义词。

QInstaller::PackagesList

QList 的同义词。

QInstaller::RepoHash

QHash> 的同义词。描述了一个带有支持键字符串 replaceremoveadd 的存储库更新。

函数文档

在 Windows 上检查用户帐户是否具有创建符号链接所需的权限。如果拥有权限,则返回 true,否则返回 false

在 Unix 平台上始终返回 true

QStringList QInstaller::checkMutualOptions(const CommandLineParser &parser, const QStringList &options)

如果至少设置了一个互斥选项对,则返回传递给 parser 的互斥选项列表。否则返回空的 QStringList。提供 options 给较低端的选项。

QString QInstaller::htmlToString(const QString &html)

将一个包含HTML文档的HTML字符串转换并返回为普通文本。

QString QInstaller::humanReadableSize(const qint64 &size, int precision = 2)

以测量单位后缀和可读格式返回给定的sizeprecision标记展示的小数位数。

void QInstaller::init()

初始化7z库和安装器资源。注册自定义操作并安装自定义消息处理器。

QStringList QInstaller::loggingCategories()

返回可用的日志分类。

hashValue QInstaller::qHash(const QInstaller::PackageSource &key, hashValue seed)

使用seed进行计算种子,返回key的哈希值。

hashValue QInstaller::qHash(const QInstaller::Repository &repository)

返回repository的哈希值。

hashValue QInstaller::qHash(const QInstaller::RepositoryCategory &repository)

返回仓库分类repository的哈希值。

hashValue QInstaller::qHash(const QInstaller::AliasSource &key, hashValue seed)

使用seed进行计算种子,返回key的哈希值。

bool QInstaller::receivePacket(QIODevice *device, QByteArray *command, QByteArray *data)

device中读取数据包,并存储其内容到commanddata中。

如果设备缓冲框中的数据包内容还不完整则返回false,否则返回true

注意:客户端和服务器需要具有相同的字节序。

void QInstaller::removeSystemGeneratedFiles(const QString &path)

从Windows和macOS上的path路径删除系统生成的文件。在Linux上不做任何操作。

void QInstaller::replaceHighDpiImage(QString &imagePath)

用高DPI图像替换imagePath。如果没有提供高DPI图像或高DPI屏幕未在使用,则返回原始值。

QString QInstaller::replacePath(const QString &path, const QString &before, const QString &after, bool cleanPath = true)

将路径 before 替换为路径 after 并返回替换后的路径。如果 beforepath 中找不到,则返回原始值。如果 cleanPathtrue,则返回的路径具有归一化的目录分隔符(即,将平台原生的分隔符转换为"/")并删除多余的重复分隔符,并解析 "." 和 ".."(尽可能做到)。如果 cleanPathfalse,则返回原始路径。默认值为 true

void QInstaller::sendPacket(QIODevice *device, const QByteArray &command, const QByteArray &data)

将包含 commanddata 的数据包写入 device

注意:客户端和服务器需要具有相同的字节序。

bool QInstaller::setDefaultFilePermissions(const QString &fileName, QInstaller::DefaultFilePermissions permissions)

根据 permissions 的值将指定 fileName 的文件或目录的权限设置为 644755

成功时返回 true,否则返回 false

bool QInstaller::setDefaultFilePermissions(QFile *file, QInstaller::DefaultFilePermissions permissions)

根据 permissions 的值将指定 file 的文件或目录的权限设置为 644755。这仅在 Unix 平台有效,因为 setPermissions() 不会操作 ACL。在 Windows NTFS 卷上,这仅取消设置了传统只读标志,不管 permissions 的值是多少。

成功时返回 true,否则返回 false

bool QInstaller::startDetached(const QString &program, const QStringList &arguments, const QString &workingDirectory, qint64 *pid = 0)

以新进程启动程序 program 并传递参数 arguments,然后从进程中分离出来。成功则返回 true;否则返回 false。如果调用进程退出,分离的进程将继续运行。

注意,含有空格的参数不会作为单独的参数传递给进程。

Unix:启动的进程将在自己的会话中运行,就像守护进程一样。Windows:含有空格的参数将被引号包围。启动的进程将作为一个常规的独立进程运行。

进程将在目录 workingDirectory 中启动。

如果函数调用成功,则 pid 被设置为启动进程的进程标识符。

附加说明:与QProcess的等效函数相比,在Windows中使用该函数的差异显现出来。尽管此函数可以真正地分离出来并且不会为启动的过程显示GUI窗口,但QProcess版本会显示。

void QInstaller::trimmedCopyConfigData(const QString &source, const QString &target, const QStringList &elementsToRemoveTags)

将内部配置文件从source复制到target。指定由elementsToRemoveTags中指定的XML元素及其子元素将从目标文件中删除。所有在源配置文件中引用的相对文件名将与目标文件的位置一起复制。

如果失败,将抛出QInstaller::Error

QDataStream &QInstaller::operator<<(QDataStream &ostream, const QInstaller::ArchiveEntry &entry)

entry写入指定的ostream。返回ostream的引用。

QDebug QInstaller::operator<<(QDebug dbg, QInstaller::Component *component)

返回组件component的调试输出流dbg

bool QInstaller::operator==(const QInstaller::PackageSource &lhs, const QInstaller::PackageSource &rhs)

如果lhsrhs相等,则返回true;否则返回false

bool QInstaller::operator==(const QInstaller::ArchiveEntry &lhs, const QInstaller::ArchiveEntry &rhs)

如果左侧的条目lhs等于右侧的条目rhs,则返回true

bool QInstaller::operator==(const QInstaller::AliasSource &lhs, const QInstaller::AliasSource &rhs)

如果lhsrhs相等,则返回true;否则返回false

QDataStream &QInstaller::operator>>(QDataStream &istream, QInstaller::ArchiveEntry &entry)

从指定的istream中读取条目entry。返回istream的引用。

©2021 年 Qt 公司有限公司的文档贡献均为各自所有者的版权。本提供的文档根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 条款进行许可。Qt 公司、Qt 及其相应标志是芬兰以及全球其他地区的 Qt 公司有限公司的商标。所有其他商标均为各自所有者的财产。