Updated for Makefile Build
authorlhauch <lhauch@de2fecce-e211-0410-80a6-f3fac2684e05>
Thu, 18 Oct 2007 21:16:11 +0000 (21:16 +0000)
committerlhauch <lhauch@de2fecce-e211-0410-80a6-f3fac2684e05>
Thu, 18 Oct 2007 21:16:11 +0000 (21:16 +0000)
git-svn-id: https://edk2.tianocore.org/svn/edk2/trunk@4167 de2fecce-e211-0410-80a6-f3fac2684e05

www/installation.html

index a62c6c2..9adeffa 100644 (file)
@@ -21,7 +21,7 @@
        </P>\r
 </UL>\r
 <H3 CLASS="heading-2"><A NAME="Requirements"></A>Requirements</H3>\r
-<P>The following are required to be able to build the EDK: \r
+<P>The following are required to be able to build the EDK II using the new Makefile build\r
 </P>\r
 <DIV ID="requirements" DIR="LTR"><A NAME="requirements_table"></A>\r
        <TABLE BORDER=1 CELLPADDING=0 CELLSPACING=0>\r
                                <P ALIGN=CENTER><B>TortoiseSVN</B></P>\r
                        </TD>\r
                        <TD>\r
-                               <P ALIGN=CENTER><B>1.3.3</B></P>\r
+                               <P ALIGN=CENTER><B>1.4.5</B></P>\r
                        </TD>\r
                        <TD>\r
-                               <P ALIGN=CENTER><A HREF="http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download">http://prdownloads.sourceforge.net/tortoisesvn/</A><BR><A HREF="http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download">TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download</A></P>\r
+                               <P ALIGN=CENTER><A HREF="http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.4.5.10425-win32-svn-1.4.5.msi?download">http://prdownloads.sourceforge.net/tortoisesvn/</A><BR><A HREF="http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.4.5.10425-win32-svn-1.4.5.msi?download">TortoiseSVN-1.4.5.10425-win32-svn-1.4.5.msi?download</A></P>\r
                        </TD>\r
                </TR>\r
+<!--\r
                <TR>\r
                        <TD>\r
                                <P ALIGN=CENTER><B>Ant</B></P>\r
                                <P ALIGN=CENTER><A HREF="http://www.apache.org/dyn/closer.cgi/xmlbeans/binaries">http://www.apache.org/dyn/closer.cgi/xmlbeans/binaries</A></P>\r
                        </TD>\r
                </TR>\r
+-->\r
        </TABLE>\r
        <P><BR><BR>\r
        </P>\r
                                        <P ALIGN=CENTER><A HREF="http://www.cygwin.com/">http://www.cygwin.com</A></P>\r
                                </TD>\r
                        </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Microsoft Visual Studio*</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>2005 Professional</B>\r
+                                       </P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://www.intel.com/">http://www.intel.com</A></P>\r
+                               </TD>\r
+                       </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Microsoft Visual Studio**</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>2005 Team Suite</B>\r
+                                       </P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://www.intel.com/">http://www.intel.com</A></P>\r
+                               </TD>\r
+                       </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Microsoft Visual Studio</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>2003 .NET</B>\r
+                                       </P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://www.intel.com/">http://www.intel.com</A></P>\r
+                               </TD>\r
+                       </TR>\r
                        <TR>\r
                                <TD>\r
                                        <P ALIGN=CENTER><B>Intel C++ Compiler for Windows</B></P>\r
                                </TD>\r
                                <TD>\r
-                                       <P ALIGN=CENTER><B>9.</B>\r
+                                       <P ALIGN=CENTER><B>9.1</B>\r
                                        </P>\r
                                </TD>\r
                                <TD>\r
                        </TR>\r
                        <TR>\r
                                <TD>\r
-                                       <P ALIGN=CENTER><B>Microsoft Driver Development Kit</B></P>\r
+                                       <P ALIGN=CENTER><B>Microsoft Driver Development Kit (DDK)</B></P>\r
                                </TD>\r
                                <TD>\r
                                        <P ALIGN=CENTER><B>3790.1830</B></P>\r
                                        <P ALIGN=CENTER><B>Microsoft ACPI Source Language Assembler</B></P>\r
                                </TD>\r
                                <TD>\r
-                                       <P ALIGN=CENTER><B>1.0.13NT</B></P>\r
+                                       <P ALIGN=CENTER><B>3.0.0NT or later</B></P>\r
                                </TD>\r
                                <TD>\r
-                                       <P ALIGN=CENTER><A HREF="http://download.microsoft.com/download/0/e/2/0e258da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe">http://download.microsoft.com/download/0/e/2/0e2</A><BR><A HREF="http://download.microsoft.com/download/0/e/2/0e258da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe">58da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe</A></P>\r
+                                       <P ALIGN=CENTER><A HREF="http://download.microsoft.com/download/2/c/1/2c16c7e0-96c1-40f5-81fc-3e4bf7b65496/MS_ASL-Compiler_3.0.1.msi">http://download.microsoft.com/download/2/c/1/2c16c7e0-96c1-40f5-81fc-3e4bf7b65496/MS_ASL-Compiler_3.0.1.msi</A><BR><A HREF="http://download.microsoft.com/download/2/c/1/2c16c7e0-96c1-40f5-81fc-3e4bf7b65496/MS_ASL-Compiler_3.0.1.msi">http://download.microsoft.com/download/2/c/1/2c16c7e0-96c1-40f5-81fc-3e4bf7b65496/MS_ASL-Compiler_3.0.1.msi</A></P>\r
                                </TD>\r
                        </TR>\r
                        <TR>\r
                                        <P ALIGN=CENTER><B>Intel ACPI Component Architecture</B></P>\r
                                </TD>\r
                                <TD>\r
-                                       <P ALIGN=CENTER><B>20060113</B></P>\r
+                                       <P ALIGN=CENTER><B>20060113 or later</B></P>\r
                                </TD>\r
                                <TD>\r
                                        <P ALIGN=CENTER><A HREF="http://www.intel.com/technology/iapc/acpi/downloads.htm">http://www.intel.com/technology/iapc/acpi/downloads.htm</A></P>\r
                                </TD>\r
                        </TR>\r
+      <TR>\r
+        <TD ALIGN=LEFT COLSPAN=3><Sup>*</Sup>The default tool chain for the IA32 and X64 Builds</TD>\r
+      <TR>\r
+        <TD ALIGN=LEFT COLSPAN=3><Sup>**</Sup>Needed for building IPF targets if the DDK is not installed.</TD>\r
+      </TR>\r
                </TABLE>\r
                <H3 CLASS="heading-2">Install and Configure Tools on Windows XP</H3>\r
                <H3>Software Installation Order</H3>\r
                <P>After installing the compiler tools and your Subversion client,\r
-               the following required tools should be installed in this order:\r
-               <BR>Java JDK, Apache-Ant, ant-contrib, xmlbeans, saxon8</P>\r
-               <H3>Java Development Kit</H3>\r
-               <P>The Java Environment Variable must be set before attempting to\r
-               build.<BR>e.g. For Sun JDK:</P>\r
-               <PRE STYLE="margin-bottom: 0.2in">set JAVA_HOME=c:\Java\jdk1.5.0_06</PRE><P>\r
-               During installation, you should specify the install directory as\r
-               C:\Java instead of C:\Program Files (or some other drive letter.)&nbsp;\r
-               While installing to this non-standard location is not required. In\r
-               use, it seems to work more reliably.<BR><BR>NOTE: You cannot\r
-               combine the location for the JDK and the JRE, as the JRE install\r
-               removes most of the binaries and libraries installed by the JDK\r
-               install.</P>\r
-               <H3>Java Tools</H3>\r
-               <P>The Apache-ANT requires the ANT_HOME environment variable to be\r
-               set before attempting to build:<BR><BR>Unzip\r
-               <B>apache-ant-1.6.5-bin.zip</B> to a directory. We need to set an\r
-               environment variable ANT_HOME to this location: \r
-               </P>\r
-               <PRE STYLE="margin-bottom: 0.2in">set ANT_HOME=&lt;full path to where ant was unzipped&gt;</PRE><P>\r
-               Unzip the <B>ant-contrib-1.0b2-bin.zip</B> file. The\r
-               ant-contrib.jar file should be <B>copied </B>into the\r
-               %ANT_HOME%\lib directory.<BR><BR>Unzip <B>xmlbeans-2.1.0.zip</B> to\r
-               a directory. XMLBeans requires the XMLBEANS_HOME environment\r
-               variable to be set before attempting to build:</P>\r
-               <PRE STYLE="margin-bottom: 0.2in">set XMLBEANS_HOME=&lt;full path to where xmlbeans was unzipped&gt;</PRE><P>\r
-               Unzip the <B>saxonb8-1-1.zip</B> file. The saxon8.jar file should\r
-               be <B>copied </B>to the %XMLBEANS_HOME%\lib directory. Do <I>not\r
-               </I>download a later version of saxon 8. You will get the following\r
-               error message if you do:</P>\r
-               <CENTER>\r
-                       <TABLE WIDTH=80% BORDER=1 CELLPADDING=4 CELLSPACING=3 STYLE="page-break-inside: avoid">\r
-                               <COL WIDTH=256*>\r
-                               <THEAD>\r
-                                       <TR>\r
-                                               <TD WIDTH=100% VALIGN=TOP>\r
-                                                       <P><FONT FACE="Courier New, monospace">build.xml:45:\r
-                                                       java.lang.RuntimeException: Trying XBeans path engine...\r
-                                                       Trying XQRL... Trying Saxon... FAILED on declare namespace\r
-                                                       sans='http://www.TianoCore.org/2006/Edk2.0';\r
-                                                       $this/sans:FrameworkPlatformDescription/sans:Flash/sans:FvImages/sans:FvImage[@Type='ValidImageNames']/sans:FvImageNames</FONT></P>\r
-                                               </TD>\r
-                                       </TR>\r
-                               </THEAD>\r
-                       </TABLE>\r
-               </CENTER>\r
-               <P>The Ant and XMLBean tools are required to be in the path.</P>\r
-               <PRE STYLE="margin-bottom: 0.2in">set PATH=%PATH%;%ANT_HOME%\bin;%XMLBEANS_HOME%\bin</PRE><H3>\r
-               Cygwin</H3>\r
+               download the edk2, read the BuildNotes2.txt file and you will be\r
+    ready to build and image.</P> \r
+    <P>All builds are started from a command prompt window.</P>\r
+    <H3>Cygwin</H3>\r
                <P>If you optionally install cygwin (for gcc support) you should\r
                install it in &quot;Unix&quot; mode. The gcc tool chain will not\r
                compile in &quot;DOS&quot; mode.</P>\r
                <H3 CLASS="heading-2">Environment Variables</H3>\r
                <P>Environment variables are <B>case sensitive</B>. You must use\r
                the exact case as in the examples of this document. Even though\r
-               windows does not care about case, Java does.<BR><BR>You need to set\r
+               windows does not care about case, other operating systems that\r
+    are supported do care about case.<BR><BR>You need to set\r
                WORKSPACE to the location of the edk2 directory that you pulled\r
                from Subversion. For example</P>\r
                <PRE STYLE="margin-bottom: 0.2in">set WORKSPACE=c:\workspace\edk2\</PRE><P>\r
                above into a script that you can launch each time you begin to do\r
                development in your EDK II workspace.</P>\r
                <H3 CLASS="heading-2">The first build</H3>\r
-               <P>You will need to edit the text file, msft_tools_def.txt, located\r
-               in the Tools/Conf directory. This file contains the names of the\r
+               <P>You will need to edit the text file, tools_def.txt, located\r
+               in the \%WORKSPACE\%/Conf directory. This file contains the names of the\r
                compiler tool chains and the location of the compiler binaries. It\r
                has been pre-populated with the standard location for the Microsoft\r
                tool chains and includes the standard location of the Intel C\r
                are set, and you have the ant executable in your path, you can try\r
                a build.</P>\r
                <OL>\r
-                       <LI><P STYLE="margin-bottom: 0in">cd to %WORKSPACE% \r
-                       </P>\r
-                       <LI><P STYLE="margin-bottom: 0in">run edksetup.bat (this will\r
-                       build several tools that are used in edk2 development. It will\r
+                       <LI><P STYLE="margin-bottom: 0in">cd to %WORKSPACE%</P>\r
+                       <LI><P STYLE="margin-bottom: 0in">run edksetup.bat newbuild (this\r
+      will set the PATH to point to the directory containing the Win32\r
+      binaries of the EDK II tools used in edk2 development.) It will\r
                        fail if the external tools above are not properly installed.)</P>\r
-                       <LI><P STYLE="margin-bottom: 0in">cd EdkNt32Pkg \r
-                       </P>\r
+                       <LI><P STYLE="margin-bottom: 0in">If your Visual Studio installation\r
+      did not setup the environment globally, you will need to run the\r
+      vsvars32.bat file to setup standard C FLAGS, Library and Include\r
+      locations to build the Nt32 emulation environment.  Note if you\r
+      do not want to build the Nt32 emulation environment, you do not\r
+      need to run vsvars32.bat.</P>\r
+                       <LI><P STYLE="margin-bottom: 0in">cd Nt32Pkg</P>\r
                        <LI><P>type build \r
                        </P>\r
                </OL>\r
        </DIV>\r
 </DIV>\r
 </BODY>\r
-</HTML>
\ No newline at end of file
+</HTML>\r