Lista de componentes de software
Un documento de lista de componentes de software (SBOM) es una declaración de los archivos instalados, los derechos de autor, las licencias, las versiones, los repositorios de código fuente y otra información relevante sobre una instalación de Qt. Los documentos SBOM facilitan la gestión de la cadena de suministro al compartir información sobre los componentes con los usuarios de Qt y otras partes interesadas. Los documentos SBOM de Qt resultan especialmente útiles para el cumplimiento de las licencias y la gestión de vulnerabilidades de seguridad.
A partir de Qt 6.8, el sistema de compilación de Qt puede generar documentos SBOM adaptados a diferentes plataformas y configuraciones de compilación. El Qt Online Installer coloca los documentos SBOM en un directorio sbom situado en el directorio de instalación de la versión correspondiente de Qt. Por ejemplo, para la instalación de Qt 6.12.0 para Android arm64-v8a, los documentos SBOM se encuentran en:
<INSTALL_DIR>/6.12.0/android_arm64_v8a/sbom/Para generar tú mismo documentos SBOM a partir de los fuentes de Qt, establece -sbom como opción de configuración.
Por ejemplo, durante el paso de configuración:
./configure -sbomLa generación de documentos SBOM pasa a formar parte de la instalación habitual de Qt:
ninja install
cmake --install .Este proceso de compilación crea documentos SBOM en formato JSON y tag:value, tal y como especifica el formato SPDX.
A partir de Qt 6.11, el proceso de compilación crea opcionalmente documentos SBOM de CycloneDX.
Consulte «Compilación de fuentes de Qt » y «Opciones de configuración de Qt » para obtener más información sobre el procedimiento de compilación de Qt.
Para los desarrolladores y mantenedores de Qt, la wiki de SBOM contiene información específica sobre la creación de documentos SBOM.
Módulos de Qt compatibles con REUSE
Los módulos de Qt cumplen con REUSE a partir de la versión 6.9. En concreto, la documentación de licencias y las comprobaciones de licencias forman parte del proceso de desarrollo de Qt. Diversas herramientas comprueban los repositorios de Qt en busca de licencias en los archivos o, externamente, en los archivos REUSE.toml.
La herramienta reuse-tool comprueba el cumplimiento de REUSE y genera SBOM de código fuente. Una herramienta interna comprueba que los archivos SBOM de código fuente generados cumplan con la especificación de la licencia de Qt.
Para obtener más información sobre la documentación de licencias en los fuentes de Qt, visita lo siguiente:
Formato SPDX
Los documentos SBOM están en formato SPDX 2.3. Cada documento comienza con información sobre el módulo de Qt. A continuación, aparecen los paquetes SPDX como entradas independientes.
En una instalación de Qt, un paquete SPDX puede ser:
- Módulo de Qt
- un complemento de Qt —por ejemplo, complementos de plataforma —
- herramienta de Qt —por ejemplo, moc—
- Aplicación de Qt —por ejemplo, Qt Widgets Designer
- Un componente de terceros —véase «Código de terceros utilizado en Qt»
- Dependencia de bibliotecas del sistema: opciones de configuración de Qt
Un paquete SPDX suele contener, como mínimo:
- Nombre del paquete, versión, nombre del proveedor e información de compilación
- Atribución de la licencia de Qt: un producto Qt puede estar sujeto a diferentes licencias comerciales o de código abierto. Por ejemplo, un paquete puede enumerar varias licencias suscritas:
LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-onlyLa sección de licencias de Qt ofrece más información sobre las opciones de licencia.
- Avisos de derechos de autor: los documentos SBOM incluyen los derechos de autor del código fuente de Qt y los derechos de autor de fuentes o autores externos.
- CPE (Common Platform Enumeration): un esquema de nomenclatura para la identificación de paquetes. En el caso de Qt, el formato CPE del SBOM suele ser:
cpe:<cpe_version>:<part>:<vendor>:<product>:<version>:<update>:<edition>:<language>:<sw_edition>:<target_sw>:<target_hw>:<other>Un ejemplo de identificador para un paquete de autorización de «Qt Network » es:
cpe:2.3:a:qt:qtnetworkauth:6.12.0:*:*:*:*:*:*:*Para obtener más información, consulta la página de especificaciones de CPE.
- PURL (URL del paquete): como alternativa al CPE, el PURL es un esquema de identificación que utiliza el siguiente formato:
scheme:type/namespace/name@version?qualifiers#subpathUn ejemplo de PURL para un paquete es:
pkg:generic/TheQtCompany/qtnetworkauth@6.12.0Para obtener más información, consulta la página «URL del paquete ».
- Relaciones entre paquetes, como las dependencias.
Por ejemplo, el «
DEPENDS_ON» para enumerar una relación de dependencia. Consulte la cláusula 11 del SPDX 2.3 para obtener una lista de los tipos de relación válidos.
Paquetes SPDX de terceros
Un paquete SPDX para un componente de terceros suele contener, como mínimo:
- Nombre, versión y descripción
- Página web y ubicación de descarga
- Uso en Qt
- Información sobre la licencia y los derechos de autor
- Si el componente es crítico para la seguridad (el código puede procesar código no fiable)
Ejemplo de SBOM de SPDX
A continuación se muestra un ejemplo de un documento SBOM en formato SPDX para el módulo de autorización deQt Network . El nombre del archivo SBOM es « qtnetworkauth-6.9.0.spdx » y se encuentra en el directorio « sbom » de la instalación. Ten en cuenta que el documento SBOM contiene otros paquetes que no aparecen en el siguiente ejemplo.
SPDXVersion: SPDX-2.3
DataLicense: CC0-1.0
SPDXID: SPDXRef-DOCUMENT
DocumentName: qtnetworkauth-6.9.0
DocumentNamespace: https://qt.io/spdxdocs/qtnetworkauth-6.9.0
Creator: Organization: TheQtCompany
Creator: Tool: Qt Build System
CreatorComment: <text>This SPDX document was created from CMake 3.27.7, using the qt
build system from https://code.qt.io/cgit/qt/qtbase.git/tree/cmake/QtPublicSbomHelpers.cmake</text>
Created: 2024-09-19T11:07:23Z
ExternalDocumentRef: DocumentRef-qtbase https://qt.io/spdxdocs/qtbase-6.9.0 SHA1: 3dbc51259a07d458524a976da2e9607a76fab7e7
PackageName: NetworkAuth
SPDXID: SPDXRef-Package-qtnetworkauth-qt-module-NetworkAuth
PackageDownloadLocation: git://code.qt.io/qt/qtnetworkauth.git
PackageVersion: 6.9.0
PackageSupplier: Organization: TheQtCompany
PackageLicenseConcluded: LicenseRef-Qt-Commercial OR GPL-3.0-only
PackageLicenseDeclared: LicenseRef-Qt-Commercial OR GPL-3.0-only
ExternalRef: PACKAGE-MANAGER purl pkg:github/qt/qtnetworkauth?library_name=NetworkAuth#src/oauth
ExternalRef: PACKAGE-MANAGER purl pkg:generic/TheQtCompany/qtnetworkauth-NetworkAuth?vcs_url=https://code.qt.io/qt/qtnetworkauth.git&library_name=NetworkAuth#src/oauth
FilesAnalyzed: true
PackageCopyrightText: <text>Copyright (C) 2024 The Qt Company Ltd.</text>
PrimaryPackagePurpose: LIBRARY
ExternalRef: SECURITY cpe23Type cpe:2.3:a:qt:qtnetworkauth:6.9.0:*:*:*:*:*:*:*
ExternalRef: SECURITY cpe23Type cpe:2.3:a:qt:qt:6.9.0:*:*:*:*:*:*:*
Relationship: SPDXRef-Package-qtnetworkauth-qt-module-NetworkAuth DEPENDS_ON DocumentRef-qtbase:SPDXRef-Package-qtbase-qt-module-Core
Relationship: SPDXRef-Package-qtnetworkauth-qt-module-NetworkAuth DEPENDS_ON DocumentRef-qtbase:SPDXRef-Package-qtbase-qt-module-PlatformModuleInternal
Relationship: SPDXRef-Package-qtnetworkauth-qt-module-NetworkAuth DEPENDS_ON DocumentRef-qtbase:SPDXRef-Package-qtbase-qt-module-Gui
Relationship: SPDXRef-Package-qtnetworkauth-qt-module-NetworkAuth DEPENDS_ON DocumentRef-qtbase:SPDXRef-Package-qtbase-qt-module-Network
Relationship: SPDXRef-Package-qtnetworkauth CONTAINS SPDXRef-Package-qtnetworkauth-qt-module-NetworkAuthFormato CycloneDX
A partir de Qt 6.11, el proceso de compilación crea, de forma opcional, documentos SBOM en formato CycloneDX v1.6.
Para exigir la generación de CycloneDX, configura Qt con:
./configure -sbom -sbom-cyclonedx-v1_6 -sbom-cyclonedx-v1_6-requiredLa generación de documentos CycloneDX requiere las siguientes dependencias:
- Python versión 3.9 o posterior
- Paquetes de Python:
- cyclonedx-python-lib[json-validation]
- tomli
Puedes utilizar la herramienta « pip » de Python para instalar los paquetes necesarios:
pip install 'cyclonedx-python-lib[json-validation]' tomliLos documentos de CycloneDX proporcionan información similar a la de los documentos SPDX, incluyendo componentes, licencias, dependencias y metadatos de seguridad.
En comparación con SPDX, la información de CycloneDX contiene menos detalles sobre algunos aspectos, como las licencias y los tipos de relación.
Los documentos SBOM de CycloneDX instalados tienen nombres de archivo con el formato: <module>-<version>.cdx.json.
Ejemplo de SBOM de CycloneDX
A continuación se muestra un ejemplo de un documento SBOM de CycloneDX para el módulo de autorización deQt Network . El nombre del archivo SBOM es qtnetworkauth-6.11.0.cdx.json y se encuentra en el directorio sbom de la instalación. Ten en cuenta que el documento SBOM contiene otros componentes que no aparecen en el siguiente ejemplo.
{
"components": [
{
"bom-ref": "SPDXRef-Package-qtnetworkauth-qt-module-NetworkAuth",
"copyright": "Copyright (C) The Qt Company Ltd. and other contributors.",
"cpe": "cpe:2.3:a:qt:qt:6.11.0:*:*:*:*:*:*:*",
"licenses": [
{
"license": {
"acknowledgement": "concluded",
"id": "GPL-3.0-only"
}
}
],
"name": "NetworkAuth",
"properties": [
{
"name": "qt:sbom:entity_type",
"value": "QT_MODULE"
},
{
"name": "qt:sbom:is_qt_entity_type",
"value": "true"
},
{
"name": "spdx:external-reference:package-manager:purl",
"value": "pkg:github/qt/qtnetworkauth?library_name=NetworkAuth#src/oauth"
},
{
"name": "spdx:external-reference:security:cpe23",
"value": "cpe:2.3:a:qt:qtnetworkauth:6.11.0:*:*:*:*:*:*:*"
}
],
"purl": "pkg:generic/TheQtCompany/qtnetworkauth-NetworkAuth?library_name=NetworkAuth&vcs_url=https://code.qt.io/qt/qtnetworkauth.git#src/oauth",
"supplier": {
"name": "TheQtCompany",
"url": [
"https://qt.io"
]
},
"type": "library",
"version": "6.11.0"
}
],
"dependencies": [
{
"dependsOn": [
"SPDXRef-Package-qtbase-qt-module-Core",
"SPDXRef-Package-qtbase-qt-module-Gui",
"SPDXRef-Package-qtbase-qt-module-Network",
"SPDXRef-Package-qtbase-qt-module-PlatformModuleInternal"
],
"ref": "SPDXRef-Package-qtnetworkauth-qt-module-NetworkAuth"
}
],
"serialNumber": "urn:uuid:ce0d41b5-0fe8-5383-bf31-ff353a05b8be",
"version": 1,
"$schema": "http://cyclonedx.org/schema/bom-1.6.schema.json",
"bomFormat": "CycloneDX",
"specVersion": "1.6"
}Yocto se compila con meta-qt6
Boot to Qt utiliza la capa meta-qt6 para compilar todos los módulos de Qt, y los documentos SBOM generados están disponibles como archivos SPDX al instalar Boot to Qt a través de Qt Online Installer. La ruta de instalación depende de la versión de Qt y del hardware de destino.
Por ejemplo, para el destino Raspberry Pi, los documentos SBOM .spdx se encuentran en:
<INSTALL_DIR>/6.12.0/Boot2Qt/raspberrypi-armv8/toolchain/sysroots/cortexa53-poky-linux/usr/lib/sbom/Para obtener más información, visita las siguientes páginas:
Temas relacionados
- SPDX 2.3
- Qt Wiki - SBOM - generación de documentos SBOM a partir de fuentes de Qt
- Código de terceros utilizado en Qt
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.