Projet EDK II
Un environnement de développement de micrologiciels multiplateformes moderne et riche en fonctionnalités pour les spécifications UEFI et PI sur www.uefi.org.
État de la construction de CI de base
| Type d'hôte et chaîne d'outils | Statut de construction | Statut des tests | Couverture des codes |
|---|
| Windows_VS2019 | | | |
| Ubuntu_GCC5 | | | |
Plus d’informations sur la version CI
Statut de build CI de la plateforme
Microsoft Windows VS2019
| Chaîne d'outils | CONFIGURATION | DÉBOGUER | LIBÉRER | NOOPT |
|---|
| ÉmulateurPkg_Win_VS2019 | | | | |
| | | | |
| | | | |
| | | | |
| OvmfPkg_Win_VS2019 | | | | |
| | | | |
| | | | |
| | | | |
Ubuntu 18.04 GCC5
| Chaîne d'outils | CONFIGURATION | DÉBOGUER | LIBÉRER | NOOPT |
|---|
| ArmVirtPkg_Ubuntu_GCC5 | | | | |
| | | | |
| ÉmulateurPkg_Ubuntu_GCC5 | | | | |
| | | | |
| | | | |
| | | | |
| OvmfPkg_Ubuntu_GCC5 | | | | |
| | | | |
| | | | |
| | | | |
- EmulatorPkg Ubuntu GCC5 Segfaults lors de l'exécution.
- EmulatorPkg Ubuntu GCC5 Segfaults lors de l'exécution.
Plus d’informations sur la version ArmVirtPkg CI
Plus d’informations sur la version EmulatorPkg CI
Plus d’informations sur la version OvmfPkg CI
Détails de la licence
La majorité du contenu du projet open source EDK II utilise une licence de brevet BSD-2-Clause Plus. Le projet open source EDK II contient les composants suivants qui sont couverts par des licences supplémentaires :
- BaseTools/Plugin/CodeQL/analyser
- BaseTools/Source/C/LzmaCompress
- BaseTools/Source/C/VfrCompile/Pccts
- CryptoPkgLibraryBaseCryptLibSysCallinet_pton.c
- CryptoPkgLibraryIncludecryptodso_conf.h
- CryptoPkgLibraryIncludeopensslopensslconf.h
- EmbeddedPkg/Bibliothèque/FdtLib. (EDK II utilise la licence BSD)
- EmbeddedPkg/Include/fdt.h. (EDK II utilise la licence BSD)
- EmbeddedPkg/Include/libfdt.h. (EDK II utilise la licence BSD)
- MdeModulePkg/Bibliothèque/LzmaCustomDecompressLib
- OvmfPkg
Le projet open source EDK II utilise le contenu des projets en amont en tant que sous-modules git couverts par des licences supplémentaires.
- BaseTools/Source/C/BrotliCompress/brotli
- CryptoPkg/Bibliothèque/OpensslLib/openssl
- CryptoPkg/Bibliothèque/MbedTlsLib/mbedtls
- MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
- MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
- UnitTestFrameworkPkg/Bibliothèque/CmockaLib/cmocka
- UnitTestFrameworkPkg/Library/GoogleTestLib/googletest
- UnitTestFrameworkPkg/Library/SubhookLib/subhook
- RedfishPkg/Bibliothèque/JsonLib/jansson
- MdePkg/Bibliothèque/BaseFdtLib/libfdt
- MdePkg/Bibliothèque/MipiSysTLib/mipisyst
- SecurityPkg/DeviceSecurity/SpdmLib/libspdm
Le projet EDK II est composé de packages. Les responsables de chaque package sont répertoriés dans le fichierMaintainers.txt.
Ressources
- TianoCore
- EDK II
- Premiers pas avec EDK II
- Listes de diffusion
- TianoCore Bugzilla
- Comment contribuer
- Planification des versions
Contributions au code
Pour apporter une contribution à un projet TianoCore, suivez ces étapes.
- Créez une description de modification dans le format spécifié ci-dessous pour
- utiliser dans le journal de validation du contrôle de source.
- Votre message de validation doit inclure votre signature
Signed-off-by - Soumettez votre code au projet TianoCore en utilisant le processus
- que le projet documente sur sa page Web. Si le processus n'est pas documenté, soumettez le code sur la liste de diffusion de développement pour le projet.
- Il est préférable que les contributions soient soumises en utilisant le même
- licence de droit d'auteur comme projet de base. Lorsque cela n'est pas possible, les contributions utilisant les licences suivantes peuvent être acceptées :
- Licence Apache, version 2.0 : https://opensource.org/license/apache-2-0/
- BSD (2 clauses) : https://opensource.org/license/BSD-2-Clause
- BSD (3 clauses) : https://opensource.org/license/BSD-3-Clause
- MIT : https://opensource.org/license/MIT
- Python-2.0 : https://opensource.org/license/Python-2.0
- Zlib : https://opensource.org/license/Zlib
Pour les documents :
- Licence de documentation FreeBSD
- https://www.freebsd.org/copyright/freebsd-doc-license.html
Les contributions de code mises dans le domaine public peuvent également être acceptées.
Les contributions utilisant d'autres licences pourraient être acceptées, mais un examen plus approfondi sera nécessaire.
Certificat d'origine du développeur
Votre description de modification doit utiliser le format standard d'un message de validation et doit inclure votre signature Signed-off-by .
Afin de savoir qui a fait quoi, tous les correctifs apportés doivent inclure une déclaration selon laquelle, à la connaissance du contributeur, il a le droit de le contribuer sous la licence spécifiée.
Le test pour cela est tel que spécifié dans le certificat d'origine du développeur (DCO) 1.1. Le contributeur certifie sa conformité en ajoutant une ligne disant
Signé par : Nom du développeur dé[email protected]
où Developer Name est le vrai nom du contributeur et l'adresse e-mail est celle par laquelle le développeur est joignable au moment de la contribution.
Certificat d'origine du développeur 1.1
En apportant une contribution à ce projet, j'atteste que :
(a) La contribution a été créée en totalité ou en partie par moi et je
avoir le droit de le soumettre sous la licence open source
indiqué dans le dossier ; ou
(b) La contribution est basée sur des travaux antérieurs qui, au mieux
de ma connaissance, est couvert par un open source approprié
licence et j'ai le droit, en vertu de cette licence, de soumettre ce
travailler avec des modifications, qu'elles soient créées en totalité ou en partie
par moi, sous la même licence open source (sauf si je suis
autorisé à soumettre sous une licence différente), comme indiqué
dans le dossier ; ou
(c) La contribution m'a été fournie directement par un autre
personne qui a certifié (a), (b) ou (c) et je n'ai pas modifié
il.
(d) Je comprends et j'accepte que ce projet et la contribution
sont publics et qu'un enregistrement de la contribution (y compris tous
les informations personnelles que je soumets avec, y compris ma signature) sont
maintenu indéfiniment et peut être redistribué conformément aux
ce projet ou la ou les licences open source impliquées.
Exemple de description de changement/message de validation
De : Nom du contributeur
Objet : [Dépôt/Branch PATCH] Pkg-Module : Bref résumé sur une seule ligne
Message de validation complet
Signé par : Nom du contributeur
Notes pour un exemple d'e-mail de correctif
- La première ligne du message de validation est extraite de la ligne d'objet de l'e-mail qui suit
[Repository/Branch PATCH] . La partie restante du message de validation correspond au contenu de l'e-mail. -
git format-patch est une façon de créer ce format
Définitions pour un exemple d'e-mail de correctif
-
Repository est l'identifiant du référentiel appliqué par le correctif. Cet identifiant ne doit être fourni que pour les référentiels autres que edk2 . Par exemple edk2-BuildSpecification ou staging .
-
Branch est l'identifiant de la branche appliquée par le correctif. Ce l'identifiant ne doit être fourni que pour les succursales autres que
-
edk2/master . Par exemple edk2/UDK2015 ,
-
edk2-BuildSpecification/release/1.27 , ou staging/edk2-test .
Module est un court identifiant pour le code ou la documentation concernée. Par exemple MdePkg , MdeModulePkg/UsbBusDxe , Introduction ou
EDK II INF File Format .
Brief-single-line-summary est un bref résumé du changement.
La première ligne entière doit contenir moins d’environ 70 caractères.
-
Full-commit-message un commentaire verbeux sur plusieurs lignes décrivant le changement. Chaque ligne doit contenir moins d’environ 70 caractères.
-
Signed-off-by est la signature du contributeur qui l'identifie par leur nom réel/légal et leur adresse e-mail.
Sous-modules
Les sous-modules actuellement utilisés dans EDK II sont au format .gitmodules.
Pour obtenir un référentiel EDK II complet et constructible, suivez les étapes suivantes de la commande git
git clone https://github.com/tianocore/edk2.git
cd edk2
git submodule update --init
cd ..
S'il existe une mise à jour pour les sous-modules, utilisez les commandes git suivantes pour obtenir le dernier code des sous-modules.
cd edk2
git pull
git submodule update
Remarque : lors du clonage de dépôts de sous-modules, l'option « --recursive » n'est pas recommandée. EDK II lui-même n'utilisera aucun code/fonctionnalité des sous-modules des sous-modules ci-dessus. Ainsi, l'utilisation de '--recursive' ajoute une dépendance à la capacité d'atteindre des serveurs dont nous ne voulons pas réellement de code, ainsi qu'au téléchargement inutile de code que nous n'utiliserons pas.
