edk2

Proyek EDK II

Lingkungan pengembangan firmware lintas platform yang modern, kaya fitur, untuk spesifikasi UEFI dan PI dari www.uefi.org.

Status Pembuatan CI Inti

Jenis Host & Rantai Alat	Membangun Status	Status Tes	Cakupan Kode
Windows_VS2019
Ubuntu_GCC5

Informasi CI Build selengkapnya

Status Pembuatan CI Platform

Microsoft Windows VS2019

rantai alat	KONFIGURASI	DEBUG	MELEPASKAN	TIDAK
EmulatorPkg_Win_VS2019	IA32
	X64
	IA32 LENGKAP
	X64 PENUH
OvmfPkg_Menang_VS2019	IA32
	X64
	IA32X64
	IA32 X64 LENGKAP

Ubuntu 18.04 GCC5

rantai alat	KONFIGURASI	DEBUG	MELEPASKAN	TIDAK
ArmVirtPkg_Ubuntu_GCC5	AARCH64
	LENGAN
EmulatorPkg_Ubuntu_GCC5	IA32
	X64
	IA32 LENGKAP
	X64 PENUH
OvmfPkg_Ubuntu_GCC5	IA32
	X64
	IA32X64
	IA32 X64 LENGKAP

- EmulatorPkg Ubuntu GCC5 Segfault selama eksekusi.

- EmulatorPkg Ubuntu GCC5 Segfault selama eksekusi.

Informasi Pembuatan ArmVirtPkg CI Lainnya

Informasi Pembuatan EmulatorPkg CI Lainnya

Informasi Pembuatan CI OvmfPkg Lainnya

Detail Lisensi

Mayoritas konten dalam proyek open source EDK II menggunakan Lisensi Paten BSD-2-Clause Plus. Proyek sumber terbuka EDK II berisi komponen berikut yang tercakup dalam lisensi tambahan:

• BaseTools/Plugin/CodeQL/analisis
• BaseTools/Sumber/C/LzmaCompress
• BaseTools/Sumber/C/VfrCompile/Pccts
• CryptoPkgLibraryBaseCryptLibSysCallinet_pton.c
• CryptoPkgLibrarySertakancryptodso_conf.h
• CryptoPkgLibraryIncludeopensslopensslconf.h
• Pkg/Perpustakaan/FdtLib yang Tertanam. (EDK II menggunakan Lisensi BSD)
• TertanamPkg/Sertakan/fdt.h. (EDK II menggunakan Lisensi BSD)
• TertanamPkg/Sertakan/libfdt.h. (EDK II menggunakan Lisensi BSD)
• MdeModulePkg/Perpustakaan/LzmaCustomDecompressLib
• OvmfPkg

Proyek sumber terbuka EDK II menggunakan konten dari proyek hulu sebagai submodul git yang dilindungi oleh lisensi tambahan.

• BaseTools/Sumber/C/BrotliCompress/brotli
• CryptoPkg/Perpustakaan/OpensslLib/openssl
• CryptoPkg/Perpustakaan/MbedTlsLib/mbedtls
• MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
• MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
• UnitTestFrameworkPkg/Library/CmockaLib/cmocka
• UnitTestFrameworkPkg/Perpustakaan/GoogleTestLib/googletest
• UnitTestFrameworkPkg/Perpustakaan/SubhookLib/subhook
• RedfishPkg/Perpustakaan/JsonLib/jansson
• MdePkg/Perpustakaan/BaseFdtLib/libfdt
• MdePkg/Perpustakaan/MipiSysTLib/mipisyst
• SecurityPkg/DeviceSecurity/SpdmLib/libspdm

Proyek EDK II terdiri dari paket-paket. Pengelola untuk setiap paket tercantum di Managers.txt.

Sumber daya

• TianoCore
• EDK II
• Memulai dengan EDK II
• Milis
• Bugzilla TianoCore
• Bagaimana Berkontribusi
• Perencanaan Rilis

Kontribusi Kode

Untuk memberikan kontribusi pada proyek TianoCore, ikuti langkah-langkah berikut.

1. Buat deskripsi perubahan dalam format yang ditentukan di bawah ini

   gunakan di log komit kontrol sumber.

2. Pesan penerapan Anda harus menyertakan tanda tangan Signed-off-by Anda

3. Kirimkan kode Anda ke proyek TianoCore menggunakan proses tersebut

   yang didokumentasikan proyek di halaman webnya. Jika prosesnya tidak didokumentasikan, kirimkan kodenya ke daftar email pengembangan untuk proyek tersebut.

4. Sebaiknya kontribusi diserahkan menggunakan hal yang sama

   lisensi hak cipta sebagai proyek dasar. Jika hal ini tidak memungkinkan, maka kontribusi menggunakan lisensi berikut dapat diterima:

• Lisensi Apache, Versi 2.0: https://opensource.org/license/apache-2-0/
• BSD (2-klausul): https://opensource.org/license/BSD-2-Clause
• BSD (3-klausul): 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

Untuk dokumentasi:

• Lisensi Dokumentasi FreeBSD

  https://www.freebsd.org/copyright/freebsd-doc-license.html

Kontribusi kode yang dimasukkan ke dalam domain publik juga dapat diterima.

Kontribusi yang menggunakan lisensi lain mungkin diterima, namun peninjauan lebih lanjut akan diperlukan.

Surat Keterangan Asal Pengembang

Deskripsi perubahan Anda harus menggunakan format standar untuk pesan penerapan, dan harus menyertakan Signed-off-by .

Untuk melacak siapa yang melakukan apa, semua patch yang dikontribusikan harus menyertakan pernyataan bahwa sepanjang pengetahuan kontributor mereka berhak untuk mengkontribusikannya berdasarkan lisensi yang ditentukan.

Pengujian untuk hal ini sebagaimana ditentukan dalam Surat Keterangan Asal Pengembang (DCO) 1.1. Kontributor mengesahkan kepatuhan dengan menambahkan baris kalimat

Ditandatangani oleh: Nama Pengembang [email protected]

dengan Developer Name adalah nama asli kontributor, dan alamat email adalah alamat email yang dapat dihubungi oleh pengembang pada saat berkontribusi.

 Surat Keterangan Asal Pengembang 1.1

Dengan memberikan kontribusi pada proyek ini, saya menyatakan bahwa:

(a) Kontribusi tersebut dibuat seluruhnya atau sebagian oleh saya dan saya
    memiliki hak untuk mengirimkannya di bawah lisensi sumber terbuka
    ditunjukkan dalam file; atau

(b) Kontribusi tersebut didasarkan pada pekerjaan sebelumnya yang terbaik
    sepengetahuan saya, tercakup dalam sumber terbuka yang sesuai
    lisensi dan saya mempunyai hak berdasarkan lisensi itu untuk menyerahkannya
    bekerja dengan modifikasi, baik dibuat seluruhnya atau sebagian
    oleh saya, di bawah lisensi sumber terbuka yang sama (kecuali saya
    diizinkan untuk mengirimkan di bawah lisensi yang berbeda), seperti yang ditunjukkan
    dalam berkas; atau

(c) Kontribusi tersebut diberikan langsung kepada saya oleh orang lain
    orang yang menyatakan (a), (b) atau (c) dan saya belum memodifikasi
    dia.

(d) Saya memahami dan menyetujui proyek ini dan kontribusinya
    bersifat publik dan catatan kontribusinya (termasuk semua
    informasi pribadi yang saya serahkan, termasuk tanda tangan saya) adalah
    dipertahankan tanpa batas waktu dan dapat didistribusikan kembali sesuai dengan
    proyek ini atau lisensi sumber terbuka yang terlibat.

Contoh Deskripsi Perubahan / Pesan Komit

 Dari: Nama Kontributor 
Perihal: [Repositori/PATCH Cabang] Modul Pkg: Ringkasan-baris-tunggal-ringkasan

Pesan komitmen penuh

Ditandatangani oleh: Nama Kontributor 

Catatan untuk contoh email patch

• Baris pertama pesan komit diambil dari baris subjek email setelah [Repository/Branch PATCH] . Bagian sisa dari pesan komit adalah konten email.
• git format-patch adalah salah satu cara untuk membuat format ini

Definisi untuk contoh email patch

• Repository adalah pengidentifikasi repositori tempat patch diterapkan.

  Pengidentifikasi ini hanya boleh disediakan untuk repositori selain edk2 . Misalnya edk2-BuildSpecification atau staging .

• Branch adalah pengidentifikasi cabang yang diterapkan patch. Ini

  pengenal hanya boleh diberikan untuk cabang selain

  edk2/master .

  Misalnya edk2/UDK2015 ,

  edk2-BuildSpecification/release/1.27 , atau

  staging/edk2-test .

• Module adalah pengidentifikasi singkat untuk kode atau dokumentasi yang terpengaruh. Misalnya MdePkg , MdeModulePkg/UsbBusDxe , Introduction , atau

  EDK II INF File Format .

• Brief-single-line-summary adalah ringkasan singkat dari perubahan tersebut.

• Keseluruhan baris pertama harus kurang dari ~70 karakter.

• Full-commit-message yang menjelaskan komentar beberapa baris yang panjang lebar

  perubahan. Setiap baris harus kurang dari ~70 karakter.

• Signed-off-by adalah tanda tangan kontributor yang mengidentifikasi mereka

  dengan nama asli/legal dan alamat email mereka.

Submodul

Submodul yang saat ini digunakan di EDK II ada di .gitmodules.

Untuk mendapatkan repositori EDK II yang lengkap dan dapat dibangun, gunakan langkah-langkah perintah git berikut

git clone https://github.com/tianocore/edk2.git
cd edk2
git submodule update --init
cd ..

Jika ada pembaruan untuk submodul, gunakan perintah git berikut untuk mendapatkan kode submodul terbaru.

 cd edk2
git pull
git submodule update

Catatan: Saat mengkloning repo submodul, opsi '--rekursif' tidak disarankan. EDK II sendiri tidak akan menggunakan kode/fitur apapun dari submodul pada submodul di atas. Jadi menggunakan '--recursive' menambah ketergantungan pada kemampuan menjangkau server yang sebenarnya tidak kita inginkan kodenya, serta mengunduh kode yang tidak perlu yang tidak akan kita gunakan.