Projeto EDK II
Um ambiente de desenvolvimento de firmware moderno, rico em recursos e multiplataforma para as especificações UEFI e PI de www.uefi.org.
Status de compilação do CI principal
| Tipo de host e conjunto de ferramentas | Status de construção | Status do teste | Cobertura de código |
|---|
| Windows_VS2019 | | | |
| Ubuntu_GCC5 | | | |
Mais informações sobre construção de CI
Status de compilação do CI da plataforma
Microsoft Windows VS2019
| Conjunto de ferramentas | CONFIGURAÇÃO | DEPURAR | LIBERAR | NOOPT |
|---|
| EmuladorPkg_Win_VS2019 | | | | |
| | | | |
| | | | |
| | | | |
| OvmfPkg_Win_VS2019 | | | | |
| | | | |
| | | | |
| | | | |
Ubuntu 18.04 GCC5
| Conjunto de ferramentas | CONFIGURAÇÃO | DEPURAR | LIBERAR | NOOPT |
|---|
| ArmVirtPkg_Ubuntu_GCC5 | | | | |
| | | | |
| EmuladorPkg_Ubuntu_GCC5 | | | | |
| | | | |
| | | | |
| | | | |
| OvmfPkg_Ubuntu_GCC5 | | | | |
| | | | |
| | | | |
| | | | |
- EmulatorPkg Ubuntu GCC5 Segfaults durante a execução.
- EmulatorPkg Ubuntu GCC5 Segfaults durante a execução.
Mais informações sobre a compilação do ArmVirtPkg CI
Mais informações sobre a compilação do EmulatorPkg CI
Mais informações sobre a compilação de CI do OvmfPkg
Detalhes da licença
A maior parte do conteúdo do projeto de código aberto EDK II usa uma licença de patente BSD-2-Clause Plus. O projeto de código aberto EDK II contém os seguintes componentes cobertos por licenças adicionais:
- BaseTools/Plugin/CodeQL/analisar
- BaseTools/Source/C/LzmaCompress
- BaseTools/Source/C/VfrCompile/Pccts
- CryptoPkgLibraryBaseCryptLibSysCallinet_pton.c
- CryptoPkgLibraryIncludecryptodso_conf.h
- CryptoPkgLibraryIncludeopensslopensslconf.h
- EmbeddedPkg/Library/FdtLib. (EDK II usa licença BSD)
- EmbeddedPkg/Include/fdt.h. (EDK II usa licença BSD)
- EmbeddedPkg/Include/libfdt.h. (EDK II usa licença BSD)
- MdeModulePkg/Library/LzmaCustomDecompressLib
- OvmfPkg
O projeto de código aberto EDK II usa conteúdo de projetos upstream como submódulos git que são cobertos por licenças adicionais.
- BaseTools/Source/C/BrotliCompress/brotli
- CryptoPkg/Library/OpensslLib/openssl
- CryptoPkg/Library/MbedTlsLib/mbedtls
- MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
- MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
- UnitTestFrameworkPkg/Library/CmockaLib/cmocka
- UnitTestFrameworkPkg/Library/GoogleTestLib/googletest
- UnitTestFrameworkPkg/Library/SubhookLib/subhook
- RedfishPkg/Library/JsonLib/jansson
- MdePkg/Library/BaseFdtLib/libfdt
- MdePkg/Library/MipiSysTLib/mipisyst
- SecurityPkg/DeviceSecurity/SpdmLib/libspdm
O Projeto EDK II é composto por pacotes. Os mantenedores de cada pacote estão listados em Mantenedores.txt.
Recursos
- TianoCore
- EDK II
- Introdução ao EDK II
- Listas de discussão
- TianoCore Bugzilla
- Como contribuir
- Planejamento de lançamento
Contribuições de código
Para fazer uma contribuição para um projeto TianoCore, siga estas etapas.
- Crie uma descrição de alteração no formato especificado abaixo para
- use no log de confirmação do controle de origem.
- Sua mensagem de commit deve incluir sua assinatura
Signed-off-by - Envie seu código para o projeto TianoCore usando o processo
- que o projeto documenta em sua página web. Se o processo não estiver documentado, envie o código na lista de e-mail de desenvolvimento do projeto.
- É preferível que as contribuições sejam enviadas usando o mesmo
- licença de direitos autorais como projeto base. Quando isso não for possível, poderão ser aceitas contribuições usando as seguintes licenças:
- Licença Apache, versão 2.0: https://opensource.org/license/apache-2-0/
- BSD (2 cláusulas): https://opensource.org/license/BSD-2-Clause
- BSD (3 cláusulas): 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
Para documentação:
- Licença de documentação do FreeBSD
- https://www.freebsd.org/copyright/freebsd-doc-license.html
Contribuições de código colocado em domínio público também podem ser aceitas.
Contribuições usando outras licenças poderão ser aceitas, mas será necessária uma análise mais aprofundada.
Certificado de Origem do Desenvolvedor
A descrição da sua mudança deve usar o formato padrão para uma mensagem de commit e deve incluir sua assinatura Signed-off-by .
Para manter o controle de quem fez o quê, todos os patches contribuídos devem incluir uma declaração de que, tanto quanto é do conhecimento do contribuidor, ele tem o direito de contribuir sob a licença especificada.
O teste para isso é especificado no Certificado de Origem do Desenvolvedor (DCO) 1.1. O contribuidor certifica a conformidade adicionando uma linha dizendo
Assinado por: Nome do desenvolvedor [email protected]
onde Developer Name é o nome real do contribuidor e o endereço de e-mail é aquele pelo qual o desenvolvedor pode ser acessado no momento da contribuição.
Certificado de Origem do Desenvolvedor 1.1
Ao contribuir para este projeto, certifico que:
(a) A contribuição foi criada no todo ou em parte por mim e eu
tem o direito de enviá-lo sob a licença de código aberto
indicado no arquivo; ou
(b) A contribuição é baseada em trabalhos anteriores que, na melhor das hipóteses,
que eu saiba, é coberto por um código aberto apropriado
licença e tenho o direito, sob essa licença, de enviar essa
trabalhar com modificações, sejam elas criadas no todo ou em parte
por mim, sob a mesma licença de código aberto (a menos que eu seja
permitido enviar sob uma licença diferente), conforme indicado
no arquivo; ou
(c) A contribuição me foi fornecida diretamente por algum outro
pessoa que certificou (a), (b) ou (c) e eu não modifiquei
isto.
(d) Entendo e concordo que este projeto e a contribuição
são públicos e que um registro da contribuição (incluindo todos
informações pessoais que envio junto com ele, incluindo minha assinatura) são
mantido indefinidamente e pode ser redistribuído de acordo com
este projeto ou a(s) licença(s) de código aberto envolvidas.
Exemplo de descrição de alteração/mensagem de confirmação
De: Nome do Colaborador
Assunto: [Repositório/Branch PATCH] Pkg-Module: Breve resumo de linha única
Mensagem de confirmação completa
Assinado por: Nome do Colaborador
Notas para exemplo de e-mail de patch
- A primeira linha da mensagem de commit é retirada da linha de assunto do e-mail após
[Repository/Branch PATCH] . A parte restante da mensagem de commit é o conteúdo do email. -
git format-patch é uma maneira de criar este formato
Definições para amostra de email de patch
-
Repository é o identificador do repositório ao qual o patch aplica. Este identificador só deve ser fornecido para repositórios diferentes de edk2 . Por exemplo edk2-BuildSpecification ou staging .
-
Branch é o identificador do branch ao qual o patch se aplica. Esse O identificador só deve ser fornecido para sucursais que não sejam
-
edk2/master . Por exemplo edk2/UDK2015 ,
-
edk2-BuildSpecification/release/1.27 ou staging/edk2-test .
Module é um identificador curto para o código ou documentação afetada. Por exemplo MdePkg , MdeModulePkg/UsbBusDxe , Introduction ou
EDK II INF File Format .
Brief-single-line-summary é um breve resumo da mudança.
A primeira linha inteira deve ter menos de aproximadamente 70 caracteres.
-
Full-commit-message um comentário detalhado de várias linhas que descreve a mudança. Cada linha deve ter menos de aproximadamente 70 caracteres.
-
Signed-off-by é a assinatura do colaborador que o identifica por seu nome real/legal e endereço de e-mail.
Submódulos
Os submódulos atuais usados no EDK II estão em .gitmodules.
Para obter um repositório EDK II completo e montável, use as seguintes etapas do comando git
git clone https://github.com/tianocore/edk2.git
cd edk2
git submodule update --init
cd ..
Se houver atualização para submódulos, use os seguintes comandos git para obter o código dos submódulos mais recente.
cd edk2
git pull
git submodule update
Nota: Ao clonar repositórios de submódulos, a opção '--recursive' não é recomendada. O próprio EDK II não usará nenhum código/recurso dos submódulos dos submódulos acima. Portanto, usar '--recursive' adiciona uma dependência de ser capaz de acessar servidores dos quais não queremos nenhum código, bem como baixar desnecessariamente códigos que não usaremos.
