Added executing Python tools from source

[mirror_edk2.git] / BuildNotes2.txt

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