878ddf1f |
1 | /** @file\r |
2 | File is FileProcess class which is used to generate ANT script to build \r |
3 | source files. \r |
4 | \r |
5 | Copyright (c) 2006, Intel Corporation\r |
6 | All rights reserved. This program and the accompanying materials\r |
7 | are licensed and made available under the terms and conditions of the BSD License\r |
8 | which accompanies this distribution. The full text of the license may be found at\r |
9 | http://opensource.org/licenses/bsd-license.php\r |
10 | \r |
11 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r |
12 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r |
13 | **/\r |
14 | package org.tianocore.build;\r |
15 | \r |
16 | import java.io.File;\r |
878ddf1f |
17 | \r |
a29c47e0 |
18 | import org.apache.tools.ant.BuildException;\r |
878ddf1f |
19 | import org.apache.tools.ant.Project;\r |
20 | import org.w3c.dom.Document;\r |
21 | import org.w3c.dom.Element;\r |
22 | import org.w3c.dom.Node;\r |
23 | \r |
24 | /**\r |
25 | <p><code>FileProcess</code> is class to generate ANT script to build source\r |
26 | files.</p>\r |
27 | \r |
28 | <p>If file does not specify file type, <code>FileProcess</code> will judge \r |
29 | by its extension. Following is the current supported extensions. </p>\r |
30 | \r |
31 | <pre> \r |
a29c47e0 |
32 | Source File Suffix File Type Description\r |
33 | .h CHeader C header file\r |
34 | .c CCode C source file\r |
35 | .inc ASMHeader Assembly header file\r |
36 | .asm ASM Assembly source file, usually for IA32 and X64 Arch and MSFT tool chain\r |
37 | .S ASM Assembly source file, usually for IPF Arch\r |
38 | .s ASM Assembly source file, usually for IA32 and X64 Arch and GCC tool chain\r |
39 | .uni UNI Unicode file\r |
40 | .vfr VFR Visual Forms Representation File\r |
41 | .fv FV Firmware Volume\r |
42 | .SEC FFS Firmware File System file\r |
43 | .PEI FFS Firmware File System file\r |
44 | .DXE FFS Firmware File System file\r |
45 | .APP FFS Firmware File System file\r |
46 | .FVI FFS Firmware File System file\r |
47 | .FFS FFS Firmware File System file\r |
48 | .bmp BMP Graphic File\r |
49 | .i PPCode IPF PreProcessor Code\r |
878ddf1f |
50 | </pre>\r |
51 | \r |
52 | @since GenBuild 1.0\r |
53 | **/\r |
54 | public class FileProcess {\r |
55 | ///\r |
56 | /// The mapping information about source suffix, result suffix, file type.\r |
57 | ///\r |
a29c47e0 |
58 | public final String[][] fileTypes = { {".h", "", "CHeader" }, \r |
59 | {".c", "", "CCode" },\r |
60 | {".inc", "", "ASMHeader" },\r |
61 | {".asm", "", "ASM" }, \r |
62 | {".S", "", "ASM" },\r |
63 | {".s", "", "ASM" },\r |
64 | {".uni", "", "UNI" },\r |
65 | {".vfr", "", "VFR" },\r |
136adffc |
66 | {".Vfr", "", "VFR" },\r |
a29c47e0 |
67 | {".dxs", "", "DPX"},\r |
68 | {".fv", "", "FV" },\r |
69 | {".efi", "", "EFI" },\r |
70 | {".SEC", "", "FFS" },\r |
71 | {".PEI", "", "FFS" },\r |
72 | {".DXE", "", "FFS" },\r |
73 | {".APP", "", "FFS" },\r |
74 | {".FYI", "", "FFS" },\r |
75 | {".FFS", "", "FFS" },\r |
76 | {".bmp", "", "BMP" },\r |
77 | {".i", "", "PPCode"}};\r |
878ddf1f |
78 | ///\r |
79 | /// Current ANT context. \r |
80 | ///\r |
81 | private Project project;\r |
82 | \r |
83 | ///\r |
84 | /// Current module's include pathes\r |
85 | ///\r |
bf3a7173 |
86 | private String[] includes;\r |
878ddf1f |
87 | \r |
88 | ///\r |
89 | /// Xml Document.\r |
90 | ///\r |
91 | private Document document;\r |
92 | \r |
93 | ///\r |
94 | /// The flag to ensure all unicode files build before others. \r |
95 | ///\r |
96 | private boolean unicodeFirst = true;\r |
97 | \r |
98 | ///\r |
99 | /// The flag present whether current module contains Unicode files or not.\r |
100 | ///\r |
101 | private boolean unicodeExist = false;\r |
102 | \r |
103 | /**\r |
104 | Initialize the project, includes, sourceFiles, document members.\r |
105 | \r |
106 | @param project ANT project\r |
107 | @param includes Module include pathes\r |
108 | @param sourceFiles Modules source files\r |
109 | @param document XML document\r |
110 | **/\r |
bf3a7173 |
111 | public void init(Project project, String[] includes, Document document) {\r |
878ddf1f |
112 | this.document = document;\r |
113 | this.includes = includes;\r |
114 | this.project = project;\r |
878ddf1f |
115 | }\r |
116 | \r |
117 | /**\r |
118 | Parse file without file type. \r |
119 | \r |
120 | @param filename Source file name\r |
121 | @param root Root node\r |
122 | @param unicodeFirst whether build Unicode file firstly or not\r |
123 | **/\r |
124 | public synchronized void parseFile(String filename, Node root, boolean unicodeFirst) {\r |
125 | this.unicodeFirst = unicodeFirst;\r |
126 | parseFile(filename, root);\r |
127 | }\r |
128 | \r |
129 | /**\r |
130 | Get whether current module contains Unicode files or not.\r |
131 | \r |
132 | @return Whether current module contains Unicode files or not\r |
133 | **/\r |
134 | public boolean isUnicodeExist() {\r |
135 | return unicodeExist;\r |
136 | }\r |
137 | \r |
138 | /**\r |
139 | Parse file.\r |
140 | \r |
141 | @param filename Source file name\r |
142 | @param filetype Source file type\r |
143 | @param root Root node\r |
144 | @param unicodeFirst whether build Unicode file firstly or not\r |
145 | **/\r |
146 | public synchronized void parseFile(String filename, String filetype, Node root, boolean unicodeFirst) {\r |
147 | this.unicodeFirst = unicodeFirst;\r |
148 | parseFile(filename, filetype, root);\r |
149 | }\r |
150 | \r |
151 | /**\r |
152 | Find out source file's type. \r |
153 | \r |
154 | @param filename Source file name\r |
155 | @param root Root node\r |
156 | **/\r |
a29c47e0 |
157 | public synchronized void parseFile(String filename, Node root) throws BuildException {\r |
878ddf1f |
158 | for (int i = 0; i < fileTypes.length; i++) {\r |
a29c47e0 |
159 | if (filename.endsWith(fileTypes[i][0])) {\r |
878ddf1f |
160 | parseFile(filename, fileTypes[i][2], root);\r |
82516887 |
161 | return ;\r |
878ddf1f |
162 | }\r |
163 | }\r |
878ddf1f |
164 | }\r |
165 | \r |
166 | /**\r |
167 | Parse file. If flag <code>unicodeFirst</code> is true, then build all\r |
168 | unicode files firstly. \r |
169 | \r |
170 | <p>Note that AutoGen.c is processed specially. It's output path is always\r |
171 | <code>${DEST_DIR_OUTPUT}</code>, others are <code>${DEST_DIR_OUTPUT}</code>\r |
172 | and relative to module path. </p>\r |
173 | \r |
174 | @param filename Source file name\r |
175 | @param filetype Source file type\r |
176 | @param root Root node\r |
177 | **/\r |
178 | public synchronized void parseFile(String filename, String filetype, Node root) {\r |
179 | if (unicodeFirst) {\r |
a29c47e0 |
180 | if ( ! filetype.equalsIgnoreCase("UNI")){\r |
878ddf1f |
181 | return ;\r |
182 | }\r |
183 | unicodeExist= true;\r |
184 | } else {\r |
a29c47e0 |
185 | if (filetype.equalsIgnoreCase("UNI")){\r |
878ddf1f |
186 | return ;\r |
187 | }\r |
188 | }\r |
a29c47e0 |
189 | \r |
190 | //\r |
191 | // If file is C or ASM header file, skip it\r |
192 | //\r |
193 | if (filetype.equalsIgnoreCase("CHeader") || filetype.equalsIgnoreCase("ASMHeader")) {\r |
878ddf1f |
194 | return;\r |
195 | }\r |
a29c47e0 |
196 | \r |
197 | //\r |
198 | // If file is pre-processor file, skip it\r |
199 | // \r |
200 | if (filetype.equalsIgnoreCase("PPCode")) {\r |
878ddf1f |
201 | return;\r |
202 | }\r |
a29c47e0 |
203 | \r |
204 | //\r |
205 | // If define CC_EXT in tools_def.txt file, the source file with \r |
206 | // different suffix is skipped\r |
207 | //\r |
208 | String toolsDefExtName = project.getProperty(filetype + "_EXT");\r |
209 | if (toolsDefExtName != null) {\r |
210 | String[] exts = toolsDefExtName.split(" ");\r |
211 | for (int i = 0; i < exts.length; i++) {\r |
212 | if ( ! filename.endsWith(exts[i])) {\r |
213 | return ;\r |
214 | }\r |
215 | }\r |
216 | }\r |
217 | \r |
878ddf1f |
218 | String module_path = project.getProperty("MODULE_DIR");\r |
219 | File moduleFile = new File(module_path);\r |
220 | File sourceFile = new File(filename);\r |
a29c47e0 |
221 | \r |
222 | //\r |
878ddf1f |
223 | // If source file is AutoGen.c, then Filepath is .\r |
a29c47e0 |
224 | //\r |
225 | String sourceFilepath = "";\r |
226 | String sourceFilename = "";\r |
227 | String sourceFileext = "";\r |
878ddf1f |
228 | if (sourceFile.getPath().endsWith("AutoGen.c")) {\r |
229 | sourceFilepath = ".";\r |
230 | sourceFilename = "AutoGen";\r |
a29c47e0 |
231 | sourceFileext = ".c";\r |
878ddf1f |
232 | filetype = "AUTOGEN";\r |
233 | } else {\r |
234 | // sourceFile.\r |
235 | String str = sourceFile.getPath().substring(moduleFile.getPath().length() + 1);\r |
236 | int index = str.lastIndexOf(File.separatorChar);\r |
237 | sourceFilepath = ".";\r |
238 | if (index > 0) {\r |
239 | sourceFilepath = str.substring(0, index);\r |
240 | str = str.substring(index + 1);\r |
241 | }\r |
242 | sourceFilename = str;\r |
243 | index = str.lastIndexOf('.');\r |
244 | if (index > 0) {\r |
245 | sourceFilename = str.substring(0, index);\r |
a29c47e0 |
246 | sourceFileext = str.substring(index);\r |
878ddf1f |
247 | }\r |
248 | }\r |
249 | // <Build_filetype FILEPATH="" FILENAME="" />\r |
250 | Element ele = document.createElement("Build_" + filetype);\r |
251 | ele.setAttribute("FILEPATH", sourceFilepath);\r |
252 | ele.setAttribute("FILENAME", sourceFilename);\r |
a29c47e0 |
253 | ele.setAttribute("FILEEXT", sourceFileext.substring(1));\r |
878ddf1f |
254 | Element includesEle = document.createElement("EXTRA.INC");\r |
bf3a7173 |
255 | for (int i = 0; i < includes.length; i++) {\r |
878ddf1f |
256 | Element includeEle = document.createElement("includepath");\r |
bf3a7173 |
257 | includeEle.setAttribute("path", project.replaceProperties(includes[i]));\r |
878ddf1f |
258 | includesEle.appendChild(includeEle);\r |
259 | }\r |
260 | ele.appendChild(includesEle);\r |
261 | root.appendChild(ele);\r |
262 | }\r |
263 | } |