UEFI开发与调试---edk2中的Package

在开始编写UEFI APP之前，我们需要先对UEFI包和模块的概念有个了解。

在edk2的根目录下，我们可以发现有很多*Pkg命令的目录，这些实际上都是各个不同的包，每个包中都是一组模块的集合，每个包中都有对应的描述文件（.dsc），声明文件（.dec）。当然如果这个包是用来生成固件Image或者Option Rom Image，那么这个包还需要包含一个.fdf文件（Flash Description File），此文件是用来生成固件Image，Option Rom Image或者可启动Image的。

包的编译过程包括：

build 命令利用.dsc和.dec以及一个或者多个.inf文件来编译Package
GenFW 命令用来生成固件，利用.dec和.fdf文件来生成一个目标Image

描述文件(.dsc)

.dsc文件用于编译Package，它包含了[Defines]，[LibraryClasses]，[Components]几个必须部分以及[PCD]，[BuildOptions]等可选部分。

[Defines]
定义用于描述该包的全局变量，它必须是dsc文件的第一个描述项目，必须定义的宏变量如下：

[Defines]
PLATFORM_NAME                  = Ovmf
PLATFORM_GUID                  = 5a9e7754-d81b-49ea-85ad-69eaa7b1539b
PLATFORM_VERSION               = 0.1
DSC_SPECIFICATION              = 0x00010005
SUPPORTED_ARCHITECTURES        = X64
BUILD_TARGETS                  = NOOPT|DEBUG|RELEASE
SKUID_IDENTIFIER               = DEFAULT

当然也有可选择定义的宏，如下列出两个常用的：

OUTPUT_DIRECTORY               = Build/OvmfX64
FLASH_DEFINITION               = OvmfPkg/OvmfPkgX64.fdf
......

[LibraryClasses]
该块中定义引用的Library，格式需要指定库的名字已经对应的.inf路径，这里定义的Library，可以被包中所有的Components所引用。
```
[LibraryClasses]PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.infTimerLib|OvmfPkg/Library/AcpiTimerLib/BaseAcpiTimerLib.infPrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.infBaseMemoryLib|MdePkg/Library/BaseMemoryLibRepStr/BaseMemoryLibRepStr.infBaseLib|MdePkg/Library/BaseLib/BaseLib.infSafeIntLib|MdePkg/Library/BaseSafeIntLib/BaseSafeIntLib.inf
```
如上所示，Library的定义需要name和.inf文件路径，并且中间以一个|符号分割开。也可以通过[LibraryClasses.$(ARCH).$(MODULE_TYPE)]来区分不同的Arch和Module Type。
[Components]
列出本包中所有的模块组件，各个模块是通过指定对应的.inf文件来加入到包中的：
```
[Components]
OvmfPkg/ResetVector/ResetVector.inf# SEC Phase modulesOvmfPkg/Sec/SecMain.inf {<LibraryClasses>NULL|MdeModulePkg/Library/LzmaCustomDecompressLib/LzmaCustomDecompressLib.inf
}# PEI Phase modulesMdeModulePkg/Core/Pei/PeiMain.inf
MdeModulePkg/Universal/PCD/Pei/Pcd.inf  {<LibraryClasses>PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
}
MdeModulePkg/Universal/ReportStatusCodeRouter/Pei/ReportStatusCodeRouterPei.inf {<LibraryClasses>PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
}
```
如上所示，除了能够指定对应的模块inf文件，还可以通过{}来包含该模块的一些私有属性，比如在{}中定义的，这里的库是仅给父模块引用的，对包中其他的模块没有影响，而.dsc中定义的[LibraryClasses]块，则整个包中的模块都可以引用，如果模块私有引用了相同库名，但不同路径下的库，那么会覆盖公共区定义的引用。

[BuildOptions]
定义编译选项，此处定义的编译选项对该包中的所有模块都有效，格式如下：

[BuildOptions.$(Arch).$(CodeBase)]
[编译器]：[$(Target)]_[Tool]_[$(Arch)]_[CC|DLINK]_FLAGS=

实例：

[BuildOptions]
GCC:*_UNIXGCC_*_CC_FLAGS             = -DMDEPKG_NDEBUG
GCC:RELEASE_*_*_CC_FLAGS             = -DMDEPKG_NDEBUG
INTEL:RELEASE_*_*_CC_FLAGS           = /D MDEPKG_NDEBUG
MSFT:RELEASE_*_*_CC_FLAGS            = /D MDEPKG_NDEBUG

PCD Section
用于定义平台配置数据，其中定义的变量是可以直接被源程序通过接口获取到，其目的是在不改动.inf文件和源文件的情况下完成对平台的配置。这样就达到灵活配置平台选项，不用为了兼容不同平台而去修改代码，[PcdsFeatureFlag]，[PcdsFixedAtBuild]， [PcdsDynamicDefault]这三个都属于PCD Section的可选部分。

声明文件(.dec)

声明文件用来定义公开的数据和接口，供其他模块使用,包含必需块[Defines]以及可选块[Includes]，[LibraryClasses]，[Guids]，[Protocols]，[Ppis]，[PCD]。.dec文件需要被调用模块.inf文件所包含。

[Defines]
提供包的名字，版本号，GUID：

[Defines]
DEC_SPECIFICATION              = 0x00010005
PACKAGE_NAME                   = OvmfPkg
PACKAGE_GUID                   = 2daf5f34-50e5-4b9d-b8e3-5562334d87e5
PACKAGE_VERSION                = 0.1

[Includes]
头文件所在目录，起始于.dec所在目录的相对目录:
```
[Includes]
Include
```
[LibraryClasses]
该包对外提供的库的集合，格式为：库名 | 头文件
```
[LibraryClasses]
LoadLinuxLib|Include/Library/LoadLinuxLib.h
```
[Guids]
在Package/Include/Guid目录中有很多文件，每个文件内定义了一个或者多个GUID，例如OvmfPkg/Include/Guid/OvmfPlatformConfig.h头文件中:
```
extern EFI_GUID gOvmfPlatformConfigGuid;
```
可以看到这里仅仅是一个声明，那么它的定义就是在本块中完成的：
```
[Guids]
gOvmfPlatformConfigGuid      = {0x7235c51c, 0x0c80, 0x4cab, {0x87, 0xac, 0x3b, 0x08, 0x4a, 0x63, 0x04, 0xb1}}
```
[Protocols]
和Guids配置方法类似，在Package/Include/Protocols目录定义了Protocol的头文件，比如头文件/OvmfPkg/Include/Protocol/VirtioDevice.h：
```
extern EFI_GUID gVirtioDeviceProtocolGuid;
```
头文件仅仅是声明，定义在dec文件中：
```
[Protocols]
gVirtioDeviceProtocolGuid           = {0xfa920010, 0x6785, 0x4941, {0xb6, 0xec, 0x49, 0x8c, 0x57, 0x9f, 0x16, 0x0a}}
```
[Ppis]
定义源文件中用到的PPI（PEI模块之间通信的接口），语法类似Protocols。
[PCD]
此块是对dsc文件中[PCD]块的补充。