]> git.proxmox.com Git - mirror_edk2.git/blobdiff - Tools/Java/Source/GenBuild/org/tianocore/build/FrameworkBuildTask.java
Restructuring for better separation of Tool packages.
[mirror_edk2.git] / Tools / Java / Source / GenBuild / org / tianocore / build / FrameworkBuildTask.java
diff --git a/Tools/Java/Source/GenBuild/org/tianocore/build/FrameworkBuildTask.java b/Tools/Java/Source/GenBuild/org/tianocore/build/FrameworkBuildTask.java
new file mode 100644 (file)
index 0000000..440510b
--- /dev/null
@@ -0,0 +1,448 @@
+/** @file FrameworkBuildTask.java\r
+  \r
+  The file is ANT task to find MSA or FPD file and build them. \r
\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. This program and the accompanying materials\r
+ are licensed and made available under the terms and conditions of the BSD License\r
+ which accompanies this distribution.  The full text of the license may be found at\r
+ http://opensource.org/licenses/bsd-license.php\r
+\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ **/\r
+package org.tianocore.build;\r
+\r
+import java.io.BufferedReader;\r
+import java.io.File;\r
+import java.io.IOException;\r
+import java.io.InputStreamReader;\r
+import java.util.Hashtable;\r
+import java.util.Iterator;\r
+import java.util.LinkedHashSet;\r
+import java.util.Map;\r
+import java.util.Set;\r
+\r
+import org.apache.tools.ant.BuildException;\r
+import org.apache.tools.ant.Task;\r
+import org.tianocore.build.exception.AutoGenException;\r
+import org.tianocore.build.exception.GenBuildException;\r
+import org.tianocore.build.exception.PcdAutogenException;\r
+import org.tianocore.build.exception.PlatformPcdPreprocessBuildException;\r
+import org.tianocore.build.fpd.FpdParserForThread;\r
+import org.tianocore.build.fpd.FpdParserTask;\r
+import org.tianocore.build.global.GenBuildLogger;\r
+import org.tianocore.build.global.GlobalData;\r
+import org.tianocore.build.toolchain.ConfigReader;\r
+import org.tianocore.build.toolchain.ToolChainInfo;\r
+import org.tianocore.common.definitions.ToolDefinitions;\r
+import org.tianocore.common.exception.EdkException;\r
+import org.tianocore.common.logger.EdkLog;\r
+\r
+/**\r
+  <p>\r
+  <code>FrameworkBuildTask</code> is an Ant task. The main function is finding\r
+  and processing a FPD or MSA file, then building a platform or stand-alone \r
+  module. \r
+  \r
+  <p>\r
+  The task search current directory and find out all MSA and FPD files by file\r
+  extension. Base on ACTIVE_PLATFORM policy, decide to build a platform or a\r
+  stand-alone module. The ACTIVE_PLATFORM policy is: \r
+  \r
+  <pre>\r
+  1. More than one MSA files, report error; \r
+  2. Only one MSA file, but ACTIVE_PLATFORM is not specified, report error;\r
+  3. Only one MSA file, and ACTIVE_PLATFORM is also specified, build this module;\r
+  4. No MSA file, and ACTIVE_PLATFORM is specified, build the active platform;\r
+  5. No MSA file, no ACTIVE_PLATFORM, and no FPD file, report error;\r
+  6. No MSA file, no ACTIVE_PLATFORM, and only one FPD file, build the platform;\r
+  7. No MSA file, no ACTIVE_PLATFORM, and more than one FPD files, list all platform\r
+  and let user choose one. \r
+  </pre>\r
+  \r
+  <p>\r
+  Framework build task also parse target file [${WORKSPACE_DIR}/Tools/Conf/target.txt].\r
+  And load all system environment variables to Ant properties.  \r
+  \r
+  <p>\r
+  The usage for this task is : \r
+  \r
+  <pre>\r
+  &lt;FrameworkBuild type="cleanall" /&gt;\r
+  </pre>\r
+  \r
+  @since GenBuild 1.0\r
+**/\r
+public class FrameworkBuildTask extends Task{\r
+\r
+    private Set<File> buildFiles = new LinkedHashSet<File>();\r
+    \r
+    private Set<File> fpdFiles = new LinkedHashSet<File>();\r
+    \r
+    private Set<File> msaFiles = new LinkedHashSet<File>();\r
+    \r
+    //\r
+    // This is only for none-multi-thread build to reduce overriding message\r
+    //\r
+    public static Hashtable<String, String> originalProperties = new Hashtable<String, String>();\r
+    \r
+    String toolsDefFilename = ToolDefinitions.DEFAULT_TOOLS_DEF_FILE_PATH;\r
+    \r
+    String targetFilename = ToolDefinitions.TARGET_FILE_PATH;\r
+    \r
+    String dbFilename = ToolDefinitions.FRAMEWORK_DATABASE_FILE_PATH;\r
+    \r
+    String activePlatform = null;\r
+\r
+    ///\r
+    /// The flag to present current is multi-thread enabled\r
+    ///\r
+    public static boolean multithread = false;\r
+\r
+    ///\r
+    /// The concurrent thread number\r
+    ///\r
+    public static int MAX_CONCURRENT_THREAD_NUMBER = 2;\r
+\r
+    ///\r
+    /// there are three type: all (build), clean and cleanall\r
+    ///\r
+    private String type = "all";\r
+    \r
+    public void execute() throws BuildException {\r
+        //\r
+        // set Logger\r
+        //\r
+        GenBuildLogger logger = new GenBuildLogger(getProject());\r
+        EdkLog.setLogLevel(getProject().getProperty("env.LOGLEVEL"));\r
+        EdkLog.setLogger(logger);\r
+        \r
+        try {\r
+            processFrameworkBuild();\r
+        } catch (PcdAutogenException e) {\r
+            //\r
+            // Add more logic process here\r
+            //\r
+            throw new BuildException(e.getMessage());\r
+        } catch (AutoGenException e) {\r
+            //\r
+            // Add more logic process here\r
+            //\r
+            throw new BuildException(e.getMessage());\r
+        } catch (PlatformPcdPreprocessBuildException e) {\r
+            //\r
+            // Add more logic process here\r
+            //\r
+            throw new BuildException(e.getMessage());\r
+        } catch (GenBuildException e) {\r
+            //\r
+            // Add more logic process here\r
+            //\r
+            throw new BuildException(e.getMessage());\r
+        } catch (EdkException e) {\r
+            //\r
+            // Add more logic process here\r
+            //\r
+            throw new BuildException(e.getMessage());\r
+        }\r
+    }\r
+    \r
+    private void processFrameworkBuild() throws EdkException, GenBuildException, AutoGenException, PcdAutogenException, PlatformPcdPreprocessBuildException {\r
+        //\r
+        // Seach build.xml -> .FPD -> .MSA file\r
+        //\r
+        try {\r
+            //\r
+            // Gen Current Working Directory\r
+            //\r
+            File dummyFile = new File(".");\r
+            File cwd = dummyFile.getCanonicalFile();\r
+            File[] files = cwd.listFiles();\r
+            for (int i = 0; i < files.length; i++) {\r
+                if (files[i].isFile()) {\r
+                    if (files[i].getName().equalsIgnoreCase("build.xml")) {\r
+                        //\r
+                        // First, search build.xml, if found, ANT call it\r
+                        //\r
+                        buildFiles.add(files[i]);\r
+\r
+                    } else if (files[i].getName().endsWith(ToolDefinitions.FPD_EXTENSION)) {\r
+                        //\r
+                        // Second, search FPD file, if found, build it\r
+                        //\r
+                        fpdFiles.add(files[i]);\r
+                    } else if (files[i].getName().endsWith(ToolDefinitions.MSA_EXTENSION)) {\r
+                        //\r
+                        // Third, search MSA file, if found, build it\r
+                        //\r
+                        msaFiles.add(files[i]);\r
+                    }\r
+                }\r
+            }\r
+        } catch (IOException ex) {\r
+            BuildException buildException = new BuildException("Scanning current directory error. \n" + ex.getMessage());\r
+            buildException.setStackTrace(ex.getStackTrace());\r
+            throw buildException;\r
+        }\r
+        \r
+        //\r
+        // Deal with all environment variable (Add them to properties)\r
+        //\r
+        backupSystemProperties();\r
+        \r
+        //\r
+        // Read target.txt file\r
+        //\r
+        readTargetFile();\r
+\r
+        //\r
+        // Global Data initialization\r
+        //\r
+        File workspacePath = new File(getProject().getProperty("WORKSPACE"));\r
+        getProject().setProperty("WORKSPACE_DIR", workspacePath.getPath().replaceAll("(\\\\)", "/"));\r
+        GlobalData.initInfo(dbFilename, workspacePath.getPath(), toolsDefFilename);\r
+        \r
+        //\r
+        // If find MSA file and ACTIVE_PLATFORM is set, build the module; \r
+        // else fail build. \r
+        // If without MSA file, and ACTIVE_PLATFORM is set, build the ACTIVE_PLATFORM. \r
+        // If ACTIVE_PLATFORM is not set, and only find one FPD file, build the platform; \r
+        // If find more than one FPD files, let user select one. \r
+        //\r
+        File buildFile = null;\r
+        if (msaFiles.size() > 1) {\r
+            throw new BuildException("Having more than one MSA file in a directory is not allowed!");\r
+        } else if (msaFiles.size() == 1 && activePlatform == null) {\r
+            throw new BuildException("If trying to build a single module, please set ACTIVE_PLATFORM in file [" + targetFilename + "]. ");\r
+        } else if (msaFiles.size() == 1 && activePlatform != null) {\r
+            //\r
+            // Build the single module\r
+            //\r
+            buildFile = msaFiles.toArray(new File[1])[0];\r
+        } else if (activePlatform != null) {\r
+            buildFile = new File(GlobalData.getWorkspacePath() + File.separatorChar + activePlatform);\r
+        } else if (fpdFiles.size() == 1) {\r
+            buildFile = fpdFiles.toArray(new File[1])[0];\r
+        } else if (fpdFiles.size() > 1) {\r
+            buildFile = intercommuniteWithUser();\r
+        }\r
+        //\r
+        // If there is no build files or FPD files or MSA files, stop build\r
+        //\r
+        else {\r
+            throw new BuildException("Can't find any FPD or MSA files in the current directory. ");\r
+        }\r
+\r
+        //\r
+        // Build every FPD files (PLATFORM build)\r
+        //\r
+        if (buildFile.getName().endsWith(ToolDefinitions.FPD_EXTENSION)) {\r
+            EdkLog.log(this, "Processing the FPD file [" + buildFile.getPath() + "] ..>> ");\r
+            //\r
+            // Iff for platform build will enable the multi-thread if set in target.txt\r
+            //\r
+            if (multithread && type.equalsIgnoreCase("all")) {\r
+                EdkLog.log(this, "Multi-thread build is enabled. ");\r
+                FpdParserForThread fpdParserForThread = new FpdParserForThread();\r
+                fpdParserForThread.setType(type);\r
+                fpdParserForThread.setProject(getProject());\r
+                fpdParserForThread.setFpdFile(buildFile);\r
+                fpdParserForThread.perform();\r
+                return ;\r
+            }\r
+            \r
+            FpdParserTask fpdParserTask = new FpdParserTask();\r
+            fpdParserTask.setType(type);\r
+            fpdParserTask.setProject(getProject());\r
+            fpdParserTask.setFpdFile(buildFile);\r
+            fpdParserTask.perform();\r
+            \r
+            //\r
+            // If cleanall delete the Platform_build.xml\r
+            //\r
+            if (type.compareTo("cleanall") == 0) {\r
+                File platformBuildFile = \r
+                    new File(getProject().getProperty("BUILD_DIR") \r
+                                    + File.separatorChar \r
+                                    + getProject().getProperty("PLATFORM") \r
+                                    + "_build.xml");\r
+                platformBuildFile.deleteOnExit();\r
+            }\r
+        }\r
+        \r
+        //\r
+        // Build every MSA files (SINGLE MODULE BUILD)\r
+        //\r
+        else if (buildFile.getName().endsWith(ToolDefinitions.MSA_EXTENSION)) {\r
+            if (multithread) {\r
+                EdkLog.log(this, EdkLog.EDK_WARNING, "Multi-Thead do not take effect on Stand-Alone (Single) module build. ");\r
+                multithread = false;\r
+            }\r
+            File tmpFile = new File(GlobalData.getWorkspacePath() + File.separatorChar + activePlatform);\r
+            EdkLog.log(this, "Using the FPD file [" + tmpFile.getPath() + "] for the active platform. ");\r
+            EdkLog.log(this, "Processing the MSA file [" + buildFile.getPath() + "] ..>> ");\r
+            GenBuildTask genBuildTask = new GenBuildTask();\r
+            genBuildTask.setSingleModuleBuild(true);\r
+            genBuildTask.setType(type);\r
+            getProject().setProperty("PLATFORM_FILE", activePlatform);\r
+            if( !multithread) {\r
+                originalProperties.put("PLATFORM_FILE", activePlatform);\r
+            }\r
+            genBuildTask.setProject(getProject());\r
+            genBuildTask.setMsaFile(buildFile);\r
+            genBuildTask.perform();\r
+        }\r
+    }\r
+    \r
+    /**\r
+      Transfer system environment variables to ANT properties. If system variable \r
+      already exiests in ANT properties, skip it.\r
+      \r
+    **/\r
+    private void backupSystemProperties() {\r
+        Map<String, String> sysProperties = System.getenv();\r
+        Iterator<String> iter = sysProperties.keySet().iterator();\r
+        while (iter.hasNext()) {\r
+            String name = iter.next();\r
+            \r
+            //\r
+            // If system environment variable is not in ANT properties, add it\r
+            //\r
+            if (getProject().getProperty(name) == null) {\r
+                getProject().setProperty(name, sysProperties.get(name));\r
+            }\r
+        }\r
+        \r
+        Hashtable allProperties = getProject().getProperties();\r
+        Iterator piter = allProperties.keySet().iterator();\r
+        while (piter.hasNext()) {\r
+            String name = (String)piter.next();\r
+            originalProperties.put(new String(name), new String((String)allProperties.get(name)));\r
+        }\r
+    }\r
+\r
+    private File intercommuniteWithUser(){\r
+        File file = null;\r
+        if (fpdFiles.size() > 1) {\r
+            File[] allFiles = new File[fpdFiles.size()];\r
+            int index = 0;\r
+            Iterator<File> iter = fpdFiles.iterator();\r
+            while (iter.hasNext()) {\r
+                allFiles[index] = iter.next();\r
+                index++;\r
+            }\r
+\r
+            EdkLog.log(this, "Finding " + allFiles.length + " FPD files: ");\r
+            for (int i = 0; i < allFiles.length; i++) {\r
+                System.out.println("[" + (i + 1) + "]: " + allFiles[i].getName());\r
+            }\r
+            \r
+            boolean flag = true;\r
+            EdkLog.log(this, "Please select one of the following FPD files to build:[1] ");\r
+            do{\r
+                BufferedReader br = new BufferedReader(new InputStreamReader(System.in));\r
+                try {\r
+                     String str = br.readLine();\r
+                     if (str.trim().length() == 0) {\r
+                         file = allFiles[0];\r
+                         flag = false;\r
+                         continue ;\r
+                     }\r
+                     int indexSelect = Integer.parseInt(str);\r
+                     if (indexSelect <=0 || indexSelect > allFiles.length) {\r
+                         EdkLog.log(this, "Please enter a number between [1.." + allFiles.length + "]:[1] ");\r
+                         continue ;\r
+                     } else {\r
+                         file = allFiles[indexSelect - 1];\r
+                         flag = false;\r
+                         continue ;\r
+                     }\r
+                } catch (Exception e) {\r
+                    EdkLog.log(this, "Please enter a valid number:[1] ");\r
+                    flag = true;\r
+                }\r
+            } while (flag);\r
+        } else if (fpdFiles.size() == 1) {\r
+            file = fpdFiles.toArray(new File[1])[0];\r
+        }\r
+        return file;\r
+    }\r
+    \r
+    \r
+    public void setType(String type) {\r
+        if (type.equalsIgnoreCase("clean") || type.equalsIgnoreCase("cleanall")) {\r
+            this.type = type.toLowerCase();\r
+        } else {\r
+            this.type = "all";\r
+        }\r
+    }\r
+    \r
+    private void readTargetFile() throws EdkException{\r
+        String targetFile = getProject().getProperty("WORKSPACE_DIR") + File.separatorChar + targetFilename;\r
+        \r
+        String[][] targetFileInfo = ConfigReader.parse(targetFile);\r
+        \r
+        //\r
+        // Get ToolChain Info from target.txt\r
+        //\r
+        ToolChainInfo envToolChainInfo = new ToolChainInfo(); \r
+        String str = getValue(ToolDefinitions.TARGET_KEY_TARGET, targetFileInfo);\r
+        if (str == null || str.trim().equals("")) {\r
+            envToolChainInfo.addTargets("*");\r
+        } else {\r
+            envToolChainInfo.addTargets(str);\r
+        }\r
+        str = getValue(ToolDefinitions.TARGET_KEY_TOOLCHAIN, targetFileInfo);\r
+        if (str == null || str.trim().equals("")) {\r
+            envToolChainInfo.addTagnames("*");\r
+        } else {\r
+            envToolChainInfo.addTagnames(str);\r
+        }\r
+        str = getValue(ToolDefinitions.TARGET_KEY_ARCH, targetFileInfo);\r
+        if (str == null || str.trim().equals("")) {\r
+            envToolChainInfo.addArchs("*");\r
+        } else {\r
+            envToolChainInfo.addArchs(str);\r
+        }\r
+        GlobalData.setToolChainEnvInfo(envToolChainInfo);\r
+        \r
+        str = getValue(ToolDefinitions.TARGET_KEY_TOOLS_DEF, targetFileInfo);\r
+        if (str != null && str.trim().length() > 0) {\r
+            toolsDefFilename = str;\r
+        }\r
+        \r
+        str = getValue(ToolDefinitions.TARGET_KEY_ACTIVE_PLATFORM, targetFileInfo);\r
+        if (str != null && ! str.trim().equals("")) {\r
+            if ( ! str.endsWith(".fpd")) {\r
+                throw new BuildException("FPD file's extension must be \"" + ToolDefinitions.FPD_EXTENSION + "\"!");\r
+            }\r
+            activePlatform = str;\r
+        }\r
+        \r
+        str = getValue(ToolDefinitions.TARGET_KEY_MULTIPLE_THREAD, targetFileInfo);\r
+        if (str != null && str.trim().equalsIgnoreCase("Enable")) {\r
+            multithread = true;\r
+        }\r
+\r
+        str = getValue(ToolDefinitions.TARGET_KEY_MAX_CONCURRENT_THREAD_NUMBER, targetFileInfo);\r
+        if (str != null ) {\r
+            try {\r
+                int threadNum = Integer.parseInt(str);\r
+                if (threadNum > 0) {\r
+                    MAX_CONCURRENT_THREAD_NUMBER = threadNum;\r
+                }\r
+            } catch (Exception ex) {\r
+            }\r
+        }\r
+    }\r
+    \r
+    private String getValue(String key, String[][] map) {\r
+        for (int i = 0; i < map[0].length; i++){\r
+            if (key.equalsIgnoreCase(map[0][i])) {\r
+                return map[1][i];\r
+            }\r
+        }\r
+        return null;\r
+    }\r
+}\r