X-Git-Url: https://git.proxmox.com/?p=mirror_edk2.git;a=blobdiff_plain;f=BuildNotes2.txt;h=c6e49cede83fec0c9770819b35087af5d88cd686;hp=200bf820e9056da1c61244b0f611434692be1e23;hb=273393ca7d413b563419fc3216061ce4ed2e003a;hpb=e4d8dbc920d22408bdb6c272eb17d03bc27be8ec diff --git a/BuildNotes2.txt b/BuildNotes2.txt index 200bf820e9..c6e49cede8 100644 --- a/BuildNotes2.txt +++ b/BuildNotes2.txt @@ -17,8 +17,6 @@ EDK II Prime packages are in the development phase. They consist of: IntelFrameworkPkg - Framework headers and libraries MdeModulePkg - Reference drivers -Currently, only module build supported, and only IA32 architecture supported. - ------------------------------------------------------------------------------- Quick Start @@ -28,7 +26,9 @@ NOTE: Please confirm you have already installed Python on your machine. In a command window, change to the top-level directory of the EDK II source. -First, set up your workspace +First, set up your workspace. If you have had a setup, please make sure that +you don't have newer *.template in WORKSPACE\BaseTools\Conf. Otherwise remove +*.txt files in WORKSPACE\Conf in advance. c:\MyWork\edk2\> edksetup newbuild Second, go to the module directory (For example, MdeModulePkg\Application\HelloWorld), @@ -48,4 +48,45 @@ and then go to MdePkg\Library\BaseLib directory and build c:\MyWork\edk2\> cd MdePkg\Library\BaseLib c:\MyWork\edk2\> build +If you want build a platform, ACTIVE_PLATFORM must be set to your desired platform dsc file, +go to directory which must be not a module's directory, and run "build" command. + +------------------------------------------------------------------------------- +Tools in Python +--------------- + +* Run buld tool written in Python from source + The build tool written in Python can be executed from its source directly as long as you +have the Python interpreter (version 2.5) installed. The source of Python code is locating at + + https://buildtools.tianocore.org/svn/buildtools/trunk/BaseTools/Source/Python + + where: + + MyBuild.py - The temporary "build" tool from which the "build.exe" is coming + AutoGen.py - Generate AutoGen.c/.h and makefile only + + "MyBuild.py" steps: + 1. Run "edksetup.bat newbuild" + 2. Set ACTIVE_PLATFORM in WORKSPACE\Conf + 3. Go to platform or module directory + 4. Run " \MyBuild.py" or "\MyBuild.py" + directly. + + "AutoGen.py" steps: + 1. Run "edksetup.bat newbuild" + 2. Set ACTIVE_PLATFORM in WORKSPACE\Conf + 4. Run " \AutoGen.py" or "\AutoGen.py" + +* Convert Python source to exe file + The tools written in Python can be coverted into executable program which can be executed +without Python interpreter. One of the convertion tools is called cx_Freeze at + + http://sourceforge.net/projects/cx-freeze/ + + Suppose you have installed cx_Freeze at c:\cx_Freeze-3.0.3. Use following command line to convert MyBuild.py + + c:\cx_Freeze-3.0.3\FreezePython.exe --include-modules=encodings.cp437,encodings.gbk,encodings.utf_16,encodings.utf_8 --install-dir=.\mybuild MyBuild.py + + The generated .exe files are put in "mybuild" subdirectory.