sprout 1.0.35.pre → 1.1.2.pre

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of sprout might be problematic. Click here for more details.

Files changed (234) hide show
  1. data/Gemfile +1 -1
  2. data/Gemfile.lock +0 -2
  3. data/README.textile +1 -1
  4. data/VERSION +1 -1
  5. data/lib/sprout/concern.rb +5 -7
  6. data/lib/sprout/daemon.rb +183 -143
  7. data/lib/sprout/executable/base.rb +564 -0
  8. data/lib/sprout/executable.rb +1 -550
  9. data/lib/sprout/generator/base.rb +2 -3
  10. data/lib/sprout/generator.rb +2 -1
  11. data/lib/sprout/generators/ruby/templates/ruby_base.rb +1 -2
  12. data/lib/sprout/library.rb +3 -3
  13. data/lib/sprout/output_buffer.rb +35 -0
  14. data/lib/sprout/process_runner.rb +68 -17
  15. data/lib/sprout/progress_bar.rb +5 -5
  16. data/lib/sprout/remote_file_target.rb +1 -1
  17. data/lib/sprout/system/base_system.rb +3 -3
  18. data/lib/sprout/system/unix_system.rb +1 -1
  19. data/lib/sprout/{test/sprout_test_case.rb → test_helper.rb} +214 -14
  20. data/lib/sprout/version.rb +1 -1
  21. data/lib/sprout.rb +133 -2
  22. data/rakefile.rb +2 -0
  23. data/test/fixtures/examples/echo_inputs.rb +1 -2
  24. data/test/fixtures/executable/fdb.rb +7 -9
  25. data/test/fixtures/executable/flex3sdk_gem/fdb +49 -18
  26. data/test/fixtures/executable/mxmlc.rb +1 -2
  27. data/test/fixtures/executable/subclass/executable_subclass.rb +0 -1
  28. data/test/fixtures/executable/subclass/executable_superclass.rb +1 -2
  29. data/test/fixtures/specification/flex4sdk.rb +35 -24
  30. data/test/unit/archive_unpacker_test.rb +1 -1
  31. data/test/unit/boolean_param_test.rb +1 -1
  32. data/test/unit/daemon_test.rb +35 -3
  33. data/test/unit/executable_option_parser_test.rb +2 -3
  34. data/test/unit/executable_param_test.rb +1 -1
  35. data/test/unit/executable_test.rb +8 -15
  36. data/test/unit/fake_other_executable.rb +1 -2
  37. data/test/unit/file_param_test.rb +1 -1
  38. data/test/unit/file_target_test.rb +1 -1
  39. data/test/unit/files_param_test.rb +1 -1
  40. data/test/unit/generator_generator_test.rb +1 -1
  41. data/test/unit/generator_test.rb +1 -1
  42. data/test/unit/library_generator_test.rb +1 -1
  43. data/test/unit/library_test.rb +1 -1
  44. data/test/unit/osx_system_test.rb +1 -1
  45. data/test/unit/path_param_test.rb +1 -1
  46. data/test/unit/paths_param_test.rb +1 -1
  47. data/test/unit/platform_test.rb +1 -1
  48. data/test/unit/process_runner_test.rb +1 -1
  49. data/test/unit/rdoc_parser_test.rb +1 -1
  50. data/test/unit/remote_file_loader_test.rb +1 -1
  51. data/test/unit/remote_file_target_test.rb +1 -1
  52. data/test/unit/ruby_feature_test.rb +1 -1
  53. data/test/unit/ruby_generator_test.rb +1 -1
  54. data/test/unit/specification_test.rb +8 -1
  55. data/test/unit/sprout_test.rb +2 -2
  56. data/test/unit/string_param_test.rb +1 -1
  57. data/test/unit/string_test.rb +1 -1
  58. data/test/unit/strings_param_test.rb +1 -1
  59. data/test/unit/test_helper.rb +33 -1
  60. data/test/unit/tool_generator_test.rb +1 -1
  61. data/test/unit/unix_system_test.rb +1 -1
  62. data/test/unit/user_test.rb +1 -1
  63. data/test/unit/vista_system_test.rb +1 -1
  64. data/test/unit/win_nix_system_test.rb +1 -1
  65. data/test/unit/win_system_test.rb +1 -1
  66. data/test-stderr.log +1 -0
  67. data/test-stdout.log +237 -0
  68. metadata +15 -190
  69. data/doc/Dir.html +0 -288
  70. data/doc/Rake/Task.html +0 -184
  71. data/doc/Sprout/ArchiveUnpacker.html +0 -1246
  72. data/doc/Sprout/Base/ClassMethods.html +0 -434
  73. data/doc/Sprout/Base.html +0 -126
  74. data/doc/Sprout/Concern.html +0 -353
  75. data/doc/Sprout/Daemon/ClassMethods.html +0 -244
  76. data/doc/Sprout/Daemon/InstanceMethods.html +0 -601
  77. data/doc/Sprout/Daemon.html +0 -166
  78. data/doc/Sprout/Errors/ArchiveUnpackerError.html +0 -125
  79. data/doc/Sprout/Errors/DestinationExistsError.html +0 -133
  80. data/doc/Sprout/Errors/DuplicateMemberError.html +0 -132
  81. data/doc/Sprout/Errors/ExecutableError.html +0 -125
  82. data/doc/Sprout/Errors/ExecutableRegistrationError.html +0 -132
  83. data/doc/Sprout/Errors/ExecutionError.html +0 -121
  84. data/doc/Sprout/Errors/GeneratorError.html +0 -125
  85. data/doc/Sprout/Errors/InvalidArgumentError.html +0 -132
  86. data/doc/Sprout/Errors/LoadError.html +0 -121
  87. data/doc/Sprout/Errors/MissingArgumentError.html +0 -132
  88. data/doc/Sprout/Errors/MissingExecutableError.html +0 -132
  89. data/doc/Sprout/Errors/MissingGeneratorError.html +0 -132
  90. data/doc/Sprout/Errors/MissingTemplateError.html +0 -132
  91. data/doc/Sprout/Errors/ProcessRunnerError.html +0 -121
  92. data/doc/Sprout/Errors/RemoteFileLoaderError.html +0 -110
  93. data/doc/Sprout/Errors/SproutError.html +0 -114
  94. data/doc/Sprout/Errors/UnknownArchiveType.html +0 -122
  95. data/doc/Sprout/Errors/UsageError.html +0 -121
  96. data/doc/Sprout/Errors/ValidationError.html +0 -121
  97. data/doc/Sprout/Errors/VersionRequirementNotMetError.html +0 -121
  98. data/doc/Sprout/Errors.html +0 -101
  99. data/doc/Sprout/Executable/Boolean.html +0 -483
  100. data/doc/Sprout/Executable/ClassMethods.html +0 -417
  101. data/doc/Sprout/Executable/CollectionParam.html +0 -483
  102. data/doc/Sprout/Executable/FileParam.html +0 -484
  103. data/doc/Sprout/Executable/Files.html +0 -292
  104. data/doc/Sprout/Executable/InstanceMethods.html +0 -2006
  105. data/doc/Sprout/Executable/Number.html +0 -141
  106. data/doc/Sprout/Executable/Param.html +0 -2818
  107. data/doc/Sprout/Executable/ParameterFactory.html +0 -232
  108. data/doc/Sprout/Executable/Path.html +0 -223
  109. data/doc/Sprout/Executable/Paths.html +0 -253
  110. data/doc/Sprout/Executable/StringParam.html +0 -213
  111. data/doc/Sprout/Executable/Strings.html +0 -167
  112. data/doc/Sprout/Executable/Url.html +0 -160
  113. data/doc/Sprout/Executable/Urls.html +0 -170
  114. data/doc/Sprout/Executable.html +0 -173
  115. data/doc/Sprout/FileTarget.html +0 -1109
  116. data/doc/Sprout/Generator/Base.html +0 -1626
  117. data/doc/Sprout/Generator/Command.html +0 -690
  118. data/doc/Sprout/Generator/DirectoryManifest.html +0 -476
  119. data/doc/Sprout/Generator/FileManifest.html +0 -572
  120. data/doc/Sprout/Generator/Manifest.html +0 -377
  121. data/doc/Sprout/Generator/TemplateManifest.html +0 -196
  122. data/doc/Sprout/Generator.html +0 -689
  123. data/doc/Sprout/GeneratorGenerator.html +0 -1018
  124. data/doc/Sprout/Library.html +0 -1141
  125. data/doc/Sprout/LibraryGenerator.html +0 -309
  126. data/doc/Sprout/Log.html +0 -496
  127. data/doc/Sprout/MXMLC.html +0 -6373
  128. data/doc/Sprout/Platform.html +0 -714
  129. data/doc/Sprout/ProcessRunner.html +0 -1352
  130. data/doc/Sprout/ProgressBar.html +0 -376
  131. data/doc/Sprout/ProgressBarImpl.html +0 -2119
  132. data/doc/Sprout/ProgressBarManager.html +0 -434
  133. data/doc/Sprout/ProgressBarOutputStream.html +0 -416
  134. data/doc/Sprout/RDocParser.html +0 -211
  135. data/doc/Sprout/RemoteFileLoader.html +0 -172
  136. data/doc/Sprout/RemoteFileTarget.html +0 -679
  137. data/doc/Sprout/ReversedProgressBar.html +0 -194
  138. data/doc/Sprout/RubyFeature/ClassMethods.html +0 -1065
  139. data/doc/Sprout/RubyFeature.html +0 -155
  140. data/doc/Sprout/RubyGenerator.html +0 -764
  141. data/doc/Sprout/Specification.html +0 -767
  142. data/doc/Sprout/System/BaseSystem.html +0 -1455
  143. data/doc/Sprout/System/JavaSystem.html +0 -122
  144. data/doc/Sprout/System/OSXSystem.html +0 -335
  145. data/doc/Sprout/System/ThreadMock.html +0 -193
  146. data/doc/Sprout/System/UnixSystem.html +0 -584
  147. data/doc/Sprout/System/VistaSystem.html +0 -251
  148. data/doc/Sprout/System/WinNixSystem.html +0 -325
  149. data/doc/Sprout/System/WinSystem.html +0 -571
  150. data/doc/Sprout/System.html +0 -191
  151. data/doc/Sprout/ToolGenerator.html +0 -931
  152. data/doc/Sprout/VERSION.html +0 -128
  153. data/doc/Sprout.html +0 -144
  154. data/doc/SproutTestCase.html +0 -1412
  155. data/doc/String.html +0 -286
  156. data/doc/_index.html +0 -1035
  157. data/doc/class_list.html +0 -36
  158. data/doc/css/common.css +0 -1
  159. data/doc/css/full_list.css +0 -53
  160. data/doc/css/style.css +0 -310
  161. data/doc/file.README.html +0 -96
  162. data/doc/file.archive_unpacker.html +0 -288
  163. data/doc/file.base.html +0 -208
  164. data/doc/file.base_system.html +0 -278
  165. data/doc/file.boolean.html +0 -135
  166. data/doc/file.collection_param.html +0 -139
  167. data/doc/file.command.html +0 -126
  168. data/doc/file.concern.html +0 -136
  169. data/doc/file.daemon.html +0 -309
  170. data/doc/file.dir.html +0 -76
  171. data/doc/file.directory_manifest.html +0 -122
  172. data/doc/file.errors.html +0 -147
  173. data/doc/file.executable.html +0 -638
  174. data/doc/file.file_manifest.html +0 -109
  175. data/doc/file.file_param.html +0 -120
  176. data/doc/file.file_target.html +0 -140
  177. data/doc/file.files.html +0 -85
  178. data/doc/file.generator.html +0 -296
  179. data/doc/file.generator_class.html +0 -72
  180. data/doc/file.generator_generator.html +0 -137
  181. data/doc/file.generator_test.html +0 -92
  182. data/doc/file.generator_test_helper.html +0 -67
  183. data/doc/file.java_system.html +0 -62
  184. data/doc/file.library.html +0 -291
  185. data/doc/file.library_generator.html +0 -74
  186. data/doc/file.log.html +0 -100
  187. data/doc/file.manifest.html +0 -67
  188. data/doc/file.mxmlc.html +0 -740
  189. data/doc/file.number.html +0 -67
  190. data/doc/file.osx_system.html +0 -79
  191. data/doc/file.param.html +0 -491
  192. data/doc/file.parameter_factory.html +0 -119
  193. data/doc/file.path.html +0 -81
  194. data/doc/file.paths.html +0 -80
  195. data/doc/file.platform.html +0 -124
  196. data/doc/file.process_runner.html +0 -224
  197. data/doc/file.progress_bar.html +0 -390
  198. data/doc/file.rdoc_parser.html +0 -145
  199. data/doc/file.remote_file_loader.html +0 -117
  200. data/doc/file.remote_file_target.html +0 -176
  201. data/doc/file.ruby_base.html +0 -64
  202. data/doc/file.ruby_feature.html +0 -244
  203. data/doc/file.ruby_generator.html +0 -118
  204. data/doc/file.ruby_input.html +0 -62
  205. data/doc/file.ruby_test_case.html +0 -78
  206. data/doc/file.ruby_test_helper.html +0 -61
  207. data/doc/file.specification.html +0 -248
  208. data/doc/file.sprout.html +0 -64
  209. data/doc/file.sprout_test_case.html +0 -280
  210. data/doc/file.string.html +0 -72
  211. data/doc/file.string_param.html +0 -76
  212. data/doc/file.strings.html +0 -71
  213. data/doc/file.system.html +0 -86
  214. data/doc/file.template_manifest.html +0 -67
  215. data/doc/file.tool.html +0 -92
  216. data/doc/file.tool_generator.html +0 -90
  217. data/doc/file.unix_system.html +0 -128
  218. data/doc/file.url.html +0 -71
  219. data/doc/file.urls.html +0 -70
  220. data/doc/file.version.html +0 -71
  221. data/doc/file.vista_system.html +0 -69
  222. data/doc/file.win_nix_system.html +0 -88
  223. data/doc/file.win_system.html +0 -129
  224. data/doc/file_list.html +0 -230
  225. data/doc/frames.html +0 -13
  226. data/doc/index.html +0 -96
  227. data/doc/js/app.js +0 -202
  228. data/doc/js/full_list.js +0 -149
  229. data/doc/js/jquery.js +0 -154
  230. data/doc/method_list.html +0 -3355
  231. data/doc/top-level-namespace.html +0 -192
  232. data/lib/sprout/base.rb +0 -121
  233. data/lib/sprout/log.rb +0 -46
  234. data/test/unit/sprout_test_helper.rb +0 -33
data/doc/file.mxmlc.html DELETED
@@ -1,740 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
- <head>
5
- <meta name="Content-Type" content="text/html; charset=utf-8" />
6
- <title>File: mxmlc</title>
7
- <link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
8
- <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
9
-
10
- <script type="text/javascript" charset="utf-8">
11
- relpath = '';
12
- if (relpath != '') relpath += '/';
13
- </script>
14
- <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
15
- <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
16
-
17
- </head>
18
- <body>
19
- <script type="text/javascript" charset="utf-8">
20
- if (window.top.frames.main) document.body.className = 'frames';
21
- </script>
22
-
23
- <div id="header">
24
- <div id="menu">
25
-
26
- <a href="_index.html" title="Index">Index</a> &raquo;
27
- <span class="title">File: mxmlc</span>
28
-
29
-
30
- <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
31
- </div>
32
-
33
- <div id="search">
34
- <a id="class_list_link" href="#">Class List</a>
35
- <a id="method_list_link" href="#">Method List</a>
36
- <a id ="file_list_link" href="#">File List</a>
37
- </div>
38
-
39
- <div class="clear"></div>
40
- </div>
41
-
42
- <iframe id="search_frame"></iframe>
43
-
44
- <div id="content"><div id='filecontents'>
45
- <p>module Sprout</p>
46
-
47
- <pre class="code"><span class='comment'># The MXMLC task provides a rake front end to the Flex MXMLC command line compiler.
48
- </span><span class='comment'># This task is integrated with the LibraryTask so that if any dependencies are
49
- </span><span class='comment'># library tasks, they will be automatically added to the library_path or source_path
50
- </span><span class='comment'># depending on whether they provide a swc or sources.
51
- </span><span class='comment'>#
52
- </span><span class='comment'># The entire MXMLC advanced interface has been provided here. All parameter names should be
53
- </span><span class='comment'># identical to what is available on the regular compiler except dashes have been replaced
54
- </span><span class='comment'># by underscores.
55
- </span><span class='comment'>#
56
- </span><span class='comment'># The following example can be pasted in a file named 'rakefile.rb' which should be placed in
57
- </span><span class='comment'># the same folder as an ActionScript 3.0 class named 'SomeProject.as' that extends
58
- </span><span class='comment'># flash.display.Sprite.
59
- </span><span class='comment'>#
60
- </span><span class='comment'># # Create a remote library dependency on the corelib swc.
61
- </span><span class='comment'># library :corelib
62
- </span><span class='comment'>#
63
- </span><span class='comment'># # Alias the compilation task with one that is easier to type
64
- </span><span class='comment'># task :compile =&gt; 'SomeProject.swf'
65
- </span><span class='comment'>#
66
- </span><span class='comment'># # Create an MXMLC named for the output file that it creates. This task depends on the
67
- </span><span class='comment'># # corelib library and will automatically add the corelib.swc to it's library_path
68
- </span><span class='comment'># mxmlc 'SomeProject.swf' =&gt; :corelib do |t|
69
- </span><span class='comment'># t.input = 'SomeProject.as'
70
- </span><span class='comment'># t.default_size = '800 600'
71
- </span><span class='comment'># t.default_background_color = &quot;#FFFFFF&quot;
72
- </span><span class='comment'># end
73
- </span><span class='comment'>#
74
- </span><span class='comment'># Note: Be sure to check out the features of the Executable to learn more about gem_version and preprocessor
75
- </span><span class='comment'>#
76
- </span><span class='comment'># Interface and descriptions found here:
77
- </span><span class='comment'># http://livedocs.adobe.com/flex/2/docs/wwhelp/wwhimpl/common/html/wwhelp.htm?context=LiveDocs_Parts&amp;file=00001481.html
78
- </span><span class='comment'>#
79
- </span><span class='kw'>class</span> <span class='const'>MXMLC</span>
80
- <span class='id include'>include</span> <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>Executable</span>
81
-
82
- <span class='comment'>##
83
- </span> <span class='comment'># Enables accessibility features when compiling the Flex application or SWC file. The default value is false.
84
- </span> <span class='comment'>#
85
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:accessible</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:hidden_value</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
86
-
87
- <span class='comment'>##
88
- </span> <span class='comment'># Sets the file encoding for ActionScript files. For more information see: http://livedocs.adobe.com/flex/2/docs/00001503.html#149244
89
- </span> <span class='comment'>#
90
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:actionscript_file_encoding</span><span class='comma'>,</span> <span class='const'>String</span>
91
-
92
- <span class='comment'>##
93
- </span> <span class='comment'># Checks if a source-path entry is a subdirectory of another source-path entry. It helps make the package names of MXML components unambiguous. This is an advanced option.
94
- </span> <span class='comment'>#
95
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:allow_source_path_overlap</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:hidden_value</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
96
-
97
- <span class='comment'>##
98
- </span> <span class='comment'># Use the ActionScript 3.0 class-based object model for greater performance and better error reporting. In the class-based object model, most built-in functions are implemented as fixed methods of classes.
99
- </span> <span class='comment'>#
100
- </span> <span class='comment'># The default value is true. If you set this value to false, you must set the es option to true.
101
- </span> <span class='comment'>#
102
- </span> <span class='comment'># This is an advanced option.
103
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:as3</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:default</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:show_on_false</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
104
-
105
- <span class='comment'>##
106
- </span> <span class='comment'># Prints detailed compile times to the standard output. The default value is true.
107
- </span> <span class='comment'>#
108
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:benchmark</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:default</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:show_on_false</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
109
-
110
- <span class='comment'>##
111
- </span> <span class='comment'># Sets the value of the {context.root} token in channel definitions in the flex-services.xml file. If you do not specify the value of this option, Flex uses an empty string.
112
- </span> <span class='comment'>#
113
- </span> <span class='comment'># For more information on using the {context.root} token, see http://livedocs.adobe.com/flex/2/docs/00001446.html#205687.
114
- </span> <span class='comment'>#
115
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:context_root</span><span class='comma'>,</span> <span class='const'>Path</span>
116
-
117
- <span class='comment'>##
118
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380).
119
- </span> <span class='comment'>#
120
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:contributor</span><span class='comma'>,</span> <span class='const'>String</span>
121
-
122
- <span class='comment'>##
123
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files. (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380)
124
- </span> <span class='comment'>#
125
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:creator</span><span class='comma'>,</span> <span class='const'>String</span>
126
-
127
- <span class='comment'>##
128
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files. (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380)
129
- </span> <span class='comment'>#
130
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:date</span><span class='comma'>,</span> <span class='const'>String</span>
131
-
132
- <span class='comment'>##
133
- </span> <span class='comment'># Generates a debug SWF file. This file includes line numbers and filenames of all the source files. When a run-time error occurs, the stacktrace shows these line numbers and filenames. This information is also used by the command-line debugger and the Flex Builder debugger. Enabling the debug option generates larger SWF files.
134
- </span> <span class='comment'>#
135
- </span> <span class='comment'># For the mxmlc compiler, the default value is false. For the compc compiler, the default value is true.
136
- </span> <span class='comment'>#
137
- </span> <span class='comment'># For SWC files generated with the compc compiler, set this value to true, unless the target SWC file is an RSL. In that case, set the debug option to false.
138
- </span> <span class='comment'>#
139
- </span> <span class='comment'># For information about the command-line debugger, see Using the Command-Line Debugger (http://livedocs.adobe.com/flex/2/docs/00001540.html#181846).
140
- </span> <span class='comment'>#
141
- </span> <span class='comment'># Flex also uses the verbose-stacktraces setting to determine whether line numbers are added to the stacktrace.
142
- </span> <span class='comment'>#
143
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:debug</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:hidden_value</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
144
-
145
- <span class='comment'>##
146
- </span> <span class='comment'># Lets you engage in remote debugging sessions with the Flash IDE. This is an advanced option.
147
- </span> <span class='comment'>#
148
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:debug_password</span><span class='comma'>,</span> <span class='const'>String</span>
149
-
150
- <span class='comment'>##
151
- </span> <span class='comment'># Sets the application's background color. You use the 0x notation to set the color, as the following example shows:
152
- </span> <span class='comment'>#
153
- </span> <span class='comment'># -default-background-color=0xCCCCFF
154
- </span> <span class='comment'>#
155
- </span> <span class='comment'># The default value is null. The default background of a Flex application is an image of a gray gradient. You must override this image for the value of the default-background-color option to be visible. For more information, see Editing application settings (http://livedocs.adobe.com/flex/2/docs/00001504.html#138781).
156
- </span> <span class='comment'>#
157
- </span> <span class='comment'># This is an advanced option.
158
- </span> <span class='comment'>#
159
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:default_background_color</span><span class='comma'>,</span> <span class='const'>String</span>
160
-
161
- <span class='comment'>##
162
- </span> <span class='comment'># Sets the application's frame rate. The default value is 24. This is an advanced option.
163
- </span> <span class='comment'>#
164
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:default_frame_rate</span><span class='comma'>,</span> <span class='const'>Number</span>
165
-
166
- <span class='comment'>##
167
- </span> <span class='comment'># Defines the application's script execution limits.
168
- </span> <span class='comment'>#
169
- </span> <span class='comment'># The max-recursion-depth value specifies the maximum depth of Adobe Flash Player call stack before Flash Player stops. This is essentially the stack overflow limit. The default value is 1000.
170
- </span> <span class='comment'>#
171
- </span> <span class='comment'># The max-execution-time value specifies the maximum duration, in seconds, that an ActionScript event handler can execute before Flash Player assumes that it is hung, and aborts it. The default value is 60 seconds. You cannot set this value above 60 seconds.
172
- </span> <span class='comment'>#
173
- </span> <span class='comment'># Example:
174
- </span> <span class='comment'>#
175
- </span> <span class='comment'># # 900 is new max-recursion-depth
176
- </span> <span class='comment'># # 20 is new max-execution-time
177
- </span> <span class='comment'># t.default_script_limits = '900 20'
178
- </span> <span class='comment'>#
179
- </span> <span class='comment'># You can override these settings in the application.
180
- </span> <span class='comment'>#
181
- </span> <span class='comment'># This is an advanced option.
182
- </span> <span class='comment'>#
183
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:default_script_limits</span><span class='comma'>,</span> <span class='const'>String</span>
184
-
185
- <span class='comment'>##
186
- </span> <span class='comment'># Defines the default application size, in pixels for example: default_size = '950 550'. This is an advanced option.
187
- </span> <span class='comment'>#
188
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:default_size</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:delimiter</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'> </span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span>
189
-
190
- <span class='comment'>##
191
- </span> <span class='comment'># Defines the location of the default style sheet. Setting this option overrides the implicit use of the defaults.css style sheet in the framework.swc file.
192
- </span> <span class='comment'>#
193
- </span> <span class='comment'># For more information on the defaults.css file, see Using Styles and Themes (http://livedocs.adobe.com/flex/2/docs/00000751.html#241755) in Flex 2 Developer's Guide.
194
- </span> <span class='comment'>#
195
- </span> <span class='comment'># This is an advanced option.
196
- </span> <span class='comment'>#
197
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:default_css_url</span><span class='comma'>,</span> <span class='const'>Url</span>
198
-
199
- <span class='comment'>##
200
- </span> <span class='comment'># This parameter is normally called 'define' but thanks to scoping issues with Sprouts and Rake, we needed to rename it and chose: 'define_conditional'.
201
- </span> <span class='comment'>#
202
- </span> <span class='comment'># Define a global AS3 conditional compilation definition, e.g. -define=CONFIG::debugging,true or -define+=CONFIG::debugging,true (to append to existing definitions in flex-config.xml) (advanced, repeatable)
203
- </span> <span class='comment'>#
204
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:define_conditional</span><span class='comma'>,</span> <span class='const'>Strings</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:shell_name</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>-define</span><span class='tstring_end'>&quot;</span></span> <span class='rbrace'>}</span>
205
-
206
- <span class='comment'>##
207
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380).
208
- </span> <span class='comment'>#
209
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:description</span><span class='comma'>,</span> <span class='const'>String</span>
210
-
211
- <span class='comment'>##
212
- </span> <span class='comment'># Outputs the compiler options in the flex-config.xml file to the target path; for example:
213
- </span> <span class='comment'>#
214
- </span> <span class='comment'># mxmlc -dump-config myapp-config.xml
215
- </span> <span class='comment'>#
216
- </span> <span class='comment'># This is an advanced option.
217
- </span> <span class='comment'>#
218
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:dump_config</span><span class='comma'>,</span> <span class='const'>File</span>
219
-
220
- <span class='comment'>##
221
- </span> <span class='comment'># Use the ECMAScript edition 3 prototype-based object model to allow dynamic overriding of prototype properties. In the prototype-based object model, built-in functions are implemented as dynamic properties of prototype objects.
222
- </span> <span class='comment'>#
223
- </span> <span class='comment'># You can set the strict option to true when you use this model, but it might result in compiler errors for references to dynamic properties.
224
- </span> <span class='comment'>#
225
- </span> <span class='comment'># The default value is false. If you set this option to true, you must set the es3 option to false.
226
- </span> <span class='comment'>#
227
- </span> <span class='comment'># This is an advanced option.
228
- </span> <span class='comment'>#
229
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:es</span><span class='comma'>,</span> <span class='const'>Boolean</span>
230
-
231
- <span class='comment'>##
232
- </span> <span class='comment'># Sets a list of symbols to exclude from linking when compiling a SWF file.
233
- </span> <span class='comment'>#
234
- </span> <span class='comment'># This option provides compile-time link checking for external references that are dynamically linked.
235
- </span> <span class='comment'>#
236
- </span> <span class='comment'># For more information about dynamic linking, see About linking (http://livedocs.adobe.com/flex/2/docs/00001521.html#205852).
237
- </span> <span class='comment'>#
238
- </span> <span class='comment'># This is an advanced option.
239
- </span> <span class='comment'>#
240
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:externs</span><span class='comma'>,</span> <span class='const'>Strings</span>
241
-
242
- <span class='comment'>##
243
- </span> <span class='comment'># Specifies a list of SWC files or directories to exclude from linking when compiling a SWF file. This option provides compile-time link checking for external components that are dynamically linked.
244
- </span> <span class='comment'>#
245
- </span> <span class='comment'># For more information about dynamic linking, see About linking (http://livedocs.adobe.com/flex/2/docs/00001521.html#205852).
246
- </span> <span class='comment'>#
247
- </span> <span class='comment'># You can use the += operator to append the new SWC file to the list of external libraries.
248
- </span> <span class='comment'>#
249
- </span> <span class='comment'># This parameter has been aliased as +el+.
250
- </span> <span class='comment'>#
251
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:external_library_path</span><span class='comma'>,</span> <span class='const'>Files</span>
252
-
253
- <span class='comment'>##
254
- </span> <span class='comment'># Alias for external_library_path
255
- </span> <span class='comment'>#
256
- </span> <span class='id add_param_alias'>add_param_alias</span> <span class='symbol'>:el</span><span class='comma'>,</span> <span class='symbol'>:external_library_path</span>
257
-
258
- <span class='comment'>##
259
- </span> <span class='comment'># Specifies source files to compile. This is the default option for the mxmlc compiler.
260
- </span> <span class='comment'>#
261
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:file_specs</span><span class='comma'>,</span> <span class='const'>Files</span>
262
-
263
- <span class='comment'>##
264
- </span> <span class='comment'># Specifies the range of Unicode settings for that language. For more information, see Using Styles and Themes (http://livedocs.adobe.com/flex/2/docs/00000751.html#241755) in Flex 2 Developer's Guide.
265
- </span> <span class='comment'>#
266
- </span> <span class='comment'># This is an advanced option.
267
- </span> <span class='comment'>#
268
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:fonts_languages_language_range</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:shell_name</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>-compiler.fonts.languages.language-range</span><span class='tstring_end'>&quot;</span></span> <span class='rbrace'>}</span>
269
-
270
- <span class='comment'>##
271
- </span> <span class='comment'># Defines the font manager. The default is flash.fonts.JREFontManager. You can also use the flash.fonts.BatikFontManager. For more information, see Using Styles and Themes in Flex 2 Developer's Guide (http://livedocs.adobe.com/flex/2/docs/00000751.html#241755).
272
- </span> <span class='comment'>#
273
- </span> <span class='comment'># This is an advanced option.
274
- </span> <span class='comment'>#
275
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:fonts_managers</span><span class='comma'>,</span> <span class='const'>Strings</span>
276
-
277
- <span class='comment'>##
278
- </span> <span class='comment'># Sets the maximum number of fonts to keep in the server cache. For more information, see Caching fonts and glyphs (http://livedocs.adobe.com/flex/2/docs/00001469.html#208457).
279
- </span> <span class='comment'>#
280
- </span> <span class='comment'># This is an advanced option.
281
- </span> <span class='comment'>#
282
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:fonts_max_cached_fonts</span><span class='comma'>,</span> <span class='const'>Number</span>
283
-
284
- <span class='comment'>##
285
- </span> <span class='comment'># Sets the maximum number of character glyph-outlines to keep in the server cache for each font face. For more information, see Caching fonts and glyphs (http://livedocs.adobe.com/flex/2/docs/00001469.html#208457).
286
- </span> <span class='comment'>#
287
- </span> <span class='comment'># This is an advanced option.
288
- </span> <span class='comment'>#
289
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:fonts_max_glyphs_per_face</span><span class='comma'>,</span> <span class='const'>Number</span>
290
-
291
- <span class='comment'>##
292
- </span> <span class='comment'># Specifies a SWF file frame label with a sequence of class names that are linked onto the frame.
293
- </span> <span class='comment'>#
294
- </span> <span class='comment'># For example: frames_frame = 'someLabel MyProject OtherProject FoodProject'
295
- </span> <span class='comment'>#
296
- </span> <span class='comment'># This is an advanced option.
297
- </span> <span class='comment'>#
298
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:frames_frame</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:shell_name</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>-frames.frame</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span>
299
-
300
- <span class='comment'>##
301
- </span> <span class='comment'># Toggles the generation of an IFlexBootstrap-derived loader class.
302
- </span> <span class='comment'>#
303
- </span> <span class='comment'># This is an advanced option.
304
- </span> <span class='comment'>#
305
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:generate_frame_loader</span><span class='comma'>,</span> <span class='const'>Boolean</span>
306
-
307
- <span class='comment'>##
308
- </span> <span class='comment'># Enables the headless implementation of the Flex compiler. This sets the following:
309
- </span> <span class='comment'>#
310
- </span> <span class='comment'># System.setProperty('java.awt.headless', 'true')
311
- </span> <span class='comment'>#
312
- </span> <span class='comment'># The headless setting (java.awt.headless=true) is required to use fonts and SVG on UNIX systems without X Windows.
313
- </span> <span class='comment'>#
314
- </span> <span class='comment'># This is an advanced option.
315
- </span> <span class='comment'>#
316
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:headless_server</span><span class='comma'>,</span> <span class='const'>Boolean</span>
317
-
318
- <span class='comment'>##
319
- </span> <span class='comment'># Links all classes inside a SWC file to the resulting application SWF file, regardless of whether or not they are used.
320
- </span> <span class='comment'>#
321
- </span> <span class='comment'># Contrast this option with the library-path option that includes only those classes that are referenced at compile time.
322
- </span> <span class='comment'>#
323
- </span> <span class='comment'># To link one or more classes whether or not they are used and not an entire SWC file, use the includes option.
324
- </span> <span class='comment'>#
325
- </span> <span class='comment'># This option is commonly used to specify resource bundles.
326
- </span> <span class='comment'>#
327
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:include_libraries</span><span class='comma'>,</span> <span class='const'>Files</span>
328
-
329
- <span class='comment'>##
330
- </span> <span class='comment'># Links one or more classes to the resulting application SWF file, whether or not those classes are required at compile time.
331
- </span> <span class='comment'>#
332
- </span> <span class='comment'># To link an entire SWC file rather than individual classes, use the include-libraries option.
333
- </span> <span class='comment'>#
334
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:includes</span><span class='comma'>,</span> <span class='const'>Strings</span>
335
-
336
- <span class='comment'>##
337
- </span> <span class='comment'># Define one or more directory paths for include processing. For each path that is provided, all .as and .mxml files found forward of that path will
338
- </span> <span class='comment'># be included in the SWF regardless of whether they are imported or not.
339
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:include_path</span><span class='comma'>,</span> <span class='const'>Paths</span>
340
-
341
- <span class='comment'>##
342
- </span> <span class='comment'># Enables incremental compilation. For more information, see About incremental compilation (http://livedocs.adobe.com/flex/2/docs/00001506.html#153980).
343
- </span> <span class='comment'>#
344
- </span> <span class='comment'># This option is true by default for the Flex Builder application compiler. For the command-line compiler, the default is false. The web-tier compiler does not support incremental compilation.
345
- </span> <span class='comment'>#
346
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:incremental</span><span class='comma'>,</span> <span class='const'>Boolean</span>
347
-
348
- <span class='comment'>##
349
- </span> <span class='comment'># Keep the specified metadata in the SWF (advanced, repeatable).
350
- </span> <span class='comment'>#
351
- </span> <span class='comment'># Example:
352
- </span> <span class='comment'>#
353
- </span> <span class='comment'># Rakefile:
354
- </span> <span class='comment'>#
355
- </span> <span class='comment'># mxmlc 'bin/SomeProject.swf' do |t|
356
- </span> <span class='comment'># t.keep_as3_metadata &lt;&lt; 'Orange'
357
- </span> <span class='comment'># end
358
- </span> <span class='comment'>#
359
- </span> <span class='comment'># Source Code:
360
- </span> <span class='comment'>#
361
- </span> <span class='comment'># [Orange(isTasty=true)]
362
- </span> <span class='comment'># public function eatOranges():void {
363
- </span> <span class='comment'># // do something
364
- </span> <span class='comment'># }
365
- </span> <span class='comment'>#
366
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:keep_as3_metadata</span><span class='comma'>,</span> <span class='const'>Strings</span>
367
-
368
- <span class='comment'>##
369
- </span> <span class='comment'># Determines whether to keep the generated ActionScript class files.
370
- </span> <span class='comment'>#
371
- </span> <span class='comment'># The generated class files include stubs and classes that are generated by the compiler and used to build the SWF file.
372
- </span> <span class='comment'>#
373
- </span> <span class='comment'># The default location of the files is the /generated subdirectory, which is directly below the target MXML file. If the /generated directory does not exist, the compiler creates one.
374
- </span> <span class='comment'>#
375
- </span> <span class='comment'># The default names of the primary generated class files are filename-generated.as and filename-interface.as.
376
- </span> <span class='comment'>#
377
- </span> <span class='comment'># The default value is false.\nThis is an advanced option.
378
- </span> <span class='comment'>#
379
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:keep_generated_actionscript</span><span class='comma'>,</span> <span class='const'>Boolean</span>
380
-
381
- <span class='comment'>##
382
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380).
383
- </span> <span class='comment'>#
384
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:language</span><span class='comma'>,</span> <span class='const'>String</span>
385
-
386
- <span class='comment'>##
387
- </span> <span class='comment'># Enables ABC bytecode lazy initialization.
388
- </span> <span class='comment'>#
389
- </span> <span class='comment'># The default value is false.
390
- </span> <span class='comment'>#
391
- </span> <span class='comment'># This is an advanced option.
392
- </span> <span class='comment'>#
393
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:lazy_init</span><span class='comma'>,</span> <span class='const'>Boolean</span>
394
-
395
- <span class='comment'>##
396
- </span> <span class='comment'># &lt;product&gt; &lt;serial-number&gt;
397
- </span> <span class='comment'>#
398
- </span> <span class='comment'># Specifies a product and a serial number. (repeatable)
399
- </span> <span class='comment'>#
400
- </span> <span class='comment'># This is an advanced option.
401
- </span> <span class='comment'>#
402
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:license</span><span class='comma'>,</span> <span class='const'>String</span>
403
-
404
- <span class='comment'>##
405
- </span> <span class='comment'># Links SWC files to the resulting application SWF file. The compiler only links in those classes for the SWC file that are required.
406
- </span> <span class='comment'>#
407
- </span> <span class='comment'># The default value of the library-path option includes all SWC files in the libs directory and the current locale. These are required.
408
- </span> <span class='comment'>#
409
- </span> <span class='comment'># To point to individual classes or packages rather than entire SWC files, use the source-path option.
410
- </span> <span class='comment'>#
411
- </span> <span class='comment'># If you set the value of the library-path as an option of the command-line compiler, you must also explicitly add the framework.swc and locale SWC files. Your new entry is not appended to the library-path but replaces it.
412
- </span> <span class='comment'>#
413
- </span> <span class='comment'># You can use the += operator to append the new argument to the list of existing SWC files.
414
- </span> <span class='comment'>#
415
- </span> <span class='comment'># In a configuration file, you can set the append attribute of the library-path tag to true to indicate that the values should be appended to the library path rather than replace it.
416
- </span> <span class='comment'>#
417
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:library_path</span><span class='comma'>,</span> <span class='const'>Files</span>
418
-
419
- <span class='comment'>##
420
- </span> <span class='comment'># Alias to library_path
421
- </span> <span class='comment'>#
422
- </span> <span class='id add_param_alias'>add_param_alias</span> <span class='symbol'>:l</span><span class='comma'>,</span> <span class='symbol'>:library_path</span>
423
-
424
- <span class='comment'>##
425
- </span> <span class='comment'># Prints linking information to the specified output file.
426
- </span> <span class='comment'># This file is an XML file that contains
427
- </span> <span class='comment'>#
428
- </span> <span class='comment'># &lt;def&gt;, &lt;pre&gt;, and &lt;ext&gt;
429
- </span> <span class='comment'>#
430
- </span> <span class='comment'># symbols showing linker dependencies in the final SWF file.
431
- </span> <span class='comment'>#
432
- </span> <span class='comment'># The file format output by this command can be used to write a file for input to the load-externs option.
433
- </span> <span class='comment'>#
434
- </span> <span class='comment'># For more information on the report, see Examining linker dependencies (http://livedocs.adobe.com/flex/2/docs/00001394.html#211202).
435
- </span> <span class='comment'>#
436
- </span> <span class='comment'># This is an advanced option.
437
- </span> <span class='comment'>#
438
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:link_report</span><span class='comma'>,</span> <span class='const'>File</span>
439
-
440
- <span class='comment'>##
441
- </span> <span class='comment'># Specifies the location of the configuration file that defines compiler options.
442
- </span> <span class='comment'>#
443
- </span> <span class='comment'># If you specify a configuration file, you can override individual options by setting them on the command line.
444
- </span> <span class='comment'>#
445
- </span> <span class='comment'># All relative paths in the configuration file are relative to the location of the configuration file itself.
446
- </span> <span class='comment'>#
447
- </span> <span class='comment'># Use the += operator to chain this configuration file to other configuration files.
448
- </span> <span class='comment'>#
449
- </span> <span class='comment'># For more information on using configuration files to provide options to the command-line compilers, see About configuration files (http://livedocs.adobe.com/flex/2/docs/00001490.html#138195).
450
- </span> <span class='comment'>#
451
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:load_config</span><span class='comma'>,</span> <span class='const'>Files</span>
452
-
453
- <span class='comment'>##
454
- </span> <span class='comment'># Specifies the location of an XML file that contains
455
- </span> <span class='comment'>#
456
- </span> <span class='comment'># &lt;def&gt;, &lt;pre&gt;, and &lt;ext&gt;
457
- </span> <span class='comment'>#
458
- </span> <span class='comment'># symbols to omit from linking when compiling a SWF file.
459
- </span> <span class='comment'>#
460
- </span> <span class='comment'># The XML file uses the same syntax as the one produced by the link-report option.
461
- </span> <span class='comment'>#
462
- </span> <span class='comment'># For more information on the report, see Examining linker dependencies (http://livedocs.adobe.com/flex/2/docs/00001394.html#211202).
463
- </span> <span class='comment'>#
464
- </span> <span class='comment'># This option provides compile-time link checking for external components that are dynamically linked.
465
- </span> <span class='comment'>#
466
- </span> <span class='comment'># For more information about dynamic linking, see About linking (http://livedocs.adobe.com/flex/2/docs/00001521.html#205852).
467
- </span> <span class='comment'>#
468
- </span> <span class='comment'># This is an advanced option.
469
- </span> <span class='comment'>#
470
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:load_externs</span><span class='comma'>,</span> <span class='const'>File</span>
471
-
472
- <span class='comment'>##
473
- </span> <span class='comment'># Specifies the locale that should be packaged in the SWF file (for example, en_EN).
474
- </span> <span class='comment'>#
475
- </span> <span class='comment'># You run the mxmlc compiler multiple times to create SWF files for more than one locale,
476
- </span> <span class='comment'># with only the locale option changing.
477
- </span> <span class='comment'>#
478
- </span> <span class='comment'># For more information, see Localizing Flex Applicationsin (http://livedocs.adobe.com/flex/2/docs/00000898.html#129288) Flex 2 Developer's Guide.
479
- </span> <span class='comment'>#
480
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:locale</span><span class='comma'>,</span> <span class='const'>String</span>
481
-
482
- <span class='comment'>##
483
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380).
484
- </span> <span class='comment'>#
485
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:localized_description</span><span class='comma'>,</span> <span class='const'>String</span>
486
-
487
- <span class='comment'>##
488
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380).&quot;
489
- </span> <span class='comment'>#
490
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:localized_title</span><span class='comma'>,</span> <span class='const'>String</span>
491
-
492
- <span class='comment'>##
493
- </span> <span class='comment'># Specifies a namespace for the MXML file. You must include a URI and the location of the manifest file that defines the contents of this namespace. This path is relative to the MXML file.
494
- </span> <span class='comment'>#
495
- </span> <span class='comment'># For more information about manifest files, see About manifest files (http://livedocs.adobe.com/flex/2/docs/00001519.html#134676).
496
- </span> <span class='comment'>#
497
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:namespaces_namespace</span><span class='comma'>,</span> <span class='const'>String</span>
498
-
499
- <span class='comment'>##
500
- </span> <span class='comment'># Enables the ActionScript optimizer. This optimizer reduces file size and increases performance by optimizing the SWF file's bytecode.
501
- </span> <span class='comment'>#
502
- </span> <span class='comment'># The default value is false.
503
- </span> <span class='comment'>#
504
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:optimize</span><span class='comma'>,</span> <span class='const'>Boolean</span>
505
-
506
- <span class='comment'>##
507
- </span> <span class='comment'># Specifies the output path and filename for the resulting file. If you omit this option, the compiler saves the SWF file to the directory where the target file is located.
508
- </span> <span class='comment'>#
509
- </span> <span class='comment'># The default SWF filename matches the target filename, but with a SWF file extension.
510
- </span> <span class='comment'>#
511
- </span> <span class='comment'># If you use a relative path to define the filename, it is always relative to the current working directory, not the target MXML application root.
512
- </span> <span class='comment'>#
513
- </span> <span class='comment'># The compiler creates extra directories based on the specified filename if those directories are not present.
514
- </span> <span class='comment'>#
515
- </span> <span class='comment'># When using this option with the component compiler, the output is a SWC file rather than a SWF file.
516
- </span> <span class='comment'>#
517
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:output</span><span class='comma'>,</span> <span class='const'>File</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:file_task_name</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
518
-
519
- <span class='comment'>##
520
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380).
521
- </span> <span class='comment'>#
522
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:publisher</span><span class='comma'>,</span> <span class='const'>String</span>
523
-
524
- <span class='comment'>##
525
- </span> <span class='comment'># XML text to store in the SWF metadata (overrides metadata.* configuration) (advanced)
526
- </span> <span class='comment'>#
527
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:raw_metadata</span><span class='comma'>,</span> <span class='const'>String</span>
528
-
529
- <span class='comment'>##
530
- </span> <span class='comment'># Prints a list of resource bundles to input to the compc compiler to create a resource bundle SWC file. The filename argument is the name of the file that contains the list of bundles.
531
- </span> <span class='comment'>#
532
- </span> <span class='comment'># For more information, see Localizing Flex Applications (http://livedocs.adobe.com/flex/2/docs/00000898.html#129288) in Flex 2 Developer's Guide.
533
- </span> <span class='comment'>#
534
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:resource_bundle_list</span><span class='comma'>,</span> <span class='const'>File</span>
535
-
536
- <span class='comment'>##
537
- </span> <span class='comment'># Specifies a list of run-time shared libraries (RSLs) to use for this application. RSLs are dynamically-linked at run time.
538
- </span> <span class='comment'>#
539
- </span> <span class='comment'># You specify the location of the SWF file relative to the deployment location of the application. For example, if you store a file named library.swf file in the web_root/libraries directory on the web server, and the application in the web root, you specify libraries/library.swf.
540
- </span> <span class='comment'>#
541
- </span> <span class='comment'># For more information about RSLs, see Using Runtime Shared Libraries. (http://livedocs.adobe.com/flex/2/docs/00001520.html#168690)
542
- </span> <span class='comment'>#
543
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:runtime_shared_libraries</span><span class='comma'>,</span> <span class='const'>Strings</span>
544
-
545
- <span class='comment'>##
546
- </span> <span class='comment'># Alias for runtime_shared_libraries
547
- </span> <span class='comment'>#
548
- </span> <span class='id add_param_alias'>add_param_alias</span> <span class='symbol'>:rsl</span><span class='comma'>,</span> <span class='symbol'>:runtime_shared_libraries</span>
549
-
550
- <span class='comment'>##
551
- </span> <span class='comment'># Runtime shared library path.
552
- </span> <span class='comment'>#
553
- </span> <span class='comment'># t.runtime_shared_library_path &lt;&lt; &quot;[path-element] [rsl-url] [policy-file-url]&quot;
554
- </span> <span class='comment'>#
555
- </span> <span class='comment'># @see Sprout::MXMLC#rslp
556
- </span> <span class='comment'>#
557
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:runtime_shared_library_path</span><span class='comma'>,</span> <span class='const'>Strings</span>
558
-
559
- <span class='comment'>##
560
- </span> <span class='comment'># Alias for #runtime_shared_library_path
561
- </span> <span class='comment'>#
562
- </span> <span class='id add_param_alias'>add_param_alias</span> <span class='symbol'>:rslp</span><span class='comma'>,</span> <span class='symbol'>:runtime_shared_library_path</span>
563
-
564
- <span class='comment'>##
565
- </span> <span class='comment'># Specifies the location of the services-config.xml file. This file is used by Flex Data Services.
566
- </span> <span class='comment'>#
567
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:services</span><span class='comma'>,</span> <span class='const'>File</span>
568
-
569
- <span class='comment'>##
570
- </span> <span class='comment'># Shows warnings for ActionScript classes.
571
- </span> <span class='comment'>#
572
- </span> <span class='comment'># The default value is true.
573
- </span> <span class='comment'>#
574
- </span> <span class='comment'># For more information about viewing warnings and errors, see Viewing warnings and errors (http://livedocs.adobe.com/flex/2/docs/00001517.html#182413).
575
- </span> <span class='comment'>#
576
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:show_actionscript_warnings</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:default</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:show_on_false</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
577
-
578
- <span class='comment'>##
579
- </span> <span class='comment'># Shows a warning when Flash Player cannot detect changes to a bound property.
580
- </span> <span class='comment'>#
581
- </span> <span class='comment'># The default value is true.
582
- </span> <span class='comment'>#
583
- </span> <span class='comment'># For more information about compiler warnings, see Using SWC files (http://livedocs.adobe.com/flex/2/docs/00001505.html#158337).
584
- </span> <span class='comment'>#
585
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:show_binding_warnings</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:default</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:show_on_false</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
586
-
587
- <span class='comment'>##
588
- </span> <span class='comment'># Shows deprecation warnings for Flex components. To see warnings for ActionScript classes, use the show-actionscript-warnings option.
589
- </span> <span class='comment'>#
590
- </span> <span class='comment'># The default value is true.
591
- </span> <span class='comment'>#
592
- </span> <span class='comment'># For more information about viewing warnings and errors, see Viewing warnings and errors.
593
- </span> <span class='comment'>#
594
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:show_deprecation_warnings</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:default</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:show_on_false</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
595
-
596
- <span class='comment'>##
597
- </span> <span class='comment'># Adds directories or files to the source path. The Flex compiler searches directories in the source path for MXML or AS source files that are used in your Flex applications and includes those that are required at compile time.
598
- </span> <span class='comment'>#
599
- </span> <span class='comment'># You can use wildcards to include all files and subdirectories of a directory.
600
- </span> <span class='comment'>#
601
- </span> <span class='comment'># To link an entire library SWC file and not individual classes or directories, use the library-path option.
602
- </span> <span class='comment'>#
603
- </span> <span class='comment'># The source path is also used as the search path for the component compiler's include-classes and include-resource-bundles options.
604
- </span> <span class='comment'>#
605
- </span> <span class='comment'># You can also use the += operator to append the new argument to the list of existing source path entries.
606
- </span> <span class='comment'>#
607
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:source_path</span><span class='comma'>,</span> <span class='const'>Paths</span>
608
-
609
- <span class='id add_param_alias'>add_param_alias</span> <span class='symbol'>:sp</span><span class='comma'>,</span> <span class='symbol'>:source_path</span>
610
-
611
- <span class='comment'>##
612
- </span> <span class='comment'># Statically link the libraries specified by the -runtime-shared-libraries-path option.
613
- </span> <span class='comment'>#
614
- </span> <span class='comment'># alias -static-rsls
615
- </span> <span class='comment'>#
616
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:static_link_runtime_shared_libraries</span><span class='comma'>,</span> <span class='const'>Boolean</span>
617
-
618
- <span class='comment'>##
619
- </span> <span class='comment'># Alias for static_link_runtime_shared_libraries
620
- </span> <span class='comment'>#
621
- </span> <span class='id add_param_alias'>add_param_alias</span> <span class='symbol'>:static_rsls</span><span class='comma'>,</span> <span class='symbol'>:static_link_runtime_shared_libraries</span>
622
-
623
- <span class='comment'>##
624
- </span> <span class='comment'># Prints undefined property and function calls; also performs compile-time type checking on assignments and options supplied to method calls.
625
- </span> <span class='comment'>#
626
- </span> <span class='comment'># The default value is true.
627
- </span> <span class='comment'>#
628
- </span> <span class='comment'># For more information about viewing warnings and errors, see Viewing warnings and errors (http://livedocs.adobe.com/flex/2/docs/00001517.html#182413).
629
- </span> <span class='comment'>#
630
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:strict</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:default</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:show_on_false</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
631
-
632
- <span class='comment'>##
633
- </span> <span class='comment'># Specifies the version of the player the application is targeting.
634
- </span> <span class='comment'>#
635
- </span> <span class='comment'># Features requiring a later version will not be compiled into the application. The minimum value supported is &quot;9.0.0&quot;.
636
- </span> <span class='comment'>#
637
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:target_player</span><span class='comma'>,</span> <span class='const'>String</span>
638
-
639
- <span class='comment'>##
640
- </span> <span class='comment'># Specifies a list of theme files to use with this application. Theme files can be SWC files with CSS files inside them or CSS files.
641
- </span> <span class='comment'>#
642
- </span> <span class='comment'># For information on compiling a SWC theme file, see Using Styles and Themes (http://livedocs.adobe.com/flex/2/docs/00000751.html#241755) in Flex 2 Developer's Guide.
643
- </span> <span class='comment'>#
644
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:theme</span><span class='comma'>,</span> <span class='const'>Files</span>
645
-
646
- <span class='comment'>##
647
- </span> <span class='comment'># Sets metadata in the resulting SWF file. For more information, see Adding metadata to SWF files (http://livedocs.adobe.com/flex/2/docs/00001502.html#145380).
648
- </span> <span class='comment'>#
649
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:title</span><span class='comma'>,</span> <span class='const'>String</span>
650
-
651
- <span class='comment'>##
652
- </span> <span class='comment'># Specifies that the current application uses network services.
653
- </span> <span class='comment'>#
654
- </span> <span class='comment'># The default value is true.
655
- </span> <span class='comment'>#
656
- </span> <span class='comment'># When the use-network property is set to false, the application can access the local filesystem (for example, use the XML.load() method with file: URLs) but not network services. In most circumstances, the value of this property should be true.
657
- </span> <span class='comment'>#
658
- </span> <span class='comment'># For more information about the use-network property, see Applying Flex Security (http://livedocs.adobe.com/flex/2/docs/00001328.html#137544).
659
- </span> <span class='comment'>#
660
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:use_network</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:default</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:show_on_false</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
661
-
662
- <span class='comment'>##
663
- </span> <span class='comment'># Generates source code that includes line numbers. When a run-time error occurs, the stacktrace shows these line numbers.
664
- </span> <span class='comment'>#
665
- </span> <span class='comment'># Enabling this option generates larger SWF files.\nThe default value is false.
666
- </span> <span class='comment'>#
667
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:verbose_stacktraces</span><span class='comma'>,</span> <span class='const'>Boolean</span>
668
-
669
- <span class='comment'>##
670
- </span> <span class='comment'># Verifies the libraries loaded at runtime are the correct ones.
671
- </span> <span class='comment'>#
672
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:verify_digests</span><span class='comma'>,</span> <span class='const'>Boolean</span>
673
-
674
- <span class='comment'>##
675
- </span> <span class='comment'># Enables specified warnings. For more information, see Viewing warnings and errors (http://livedocs.adobe.com/flex/2/docs/00001517.html#182413).
676
- </span> <span class='comment'>#
677
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:warn_warning_type</span><span class='comma'>,</span> <span class='const'>Boolean</span>
678
-
679
- <span class='comment'>##
680
- </span> <span class='comment'># Enables all warnings. Set to false to disable all warnings. This option overrides the warn-warning_type options.
681
- </span> <span class='comment'>#
682
- </span> <span class='comment'># The default value is true.
683
- </span> <span class='comment'>#
684
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:warnings</span><span class='comma'>,</span> <span class='const'>Boolean</span>
685
-
686
- <span class='kw'>def</span> <span class='id library_added'>library_added</span> <span class='id path_or_paths'>path_or_paths</span>
687
- <span class='kw'>if</span><span class='lparen'>(</span><span class='id path_or_paths'>path_or_paths</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\.swc$</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span>
688
- <span class='kw'>self</span><span class='period'>.</span><span class='id library_path'>library_path</span> <span class='op'>&lt;&lt;</span> <span class='id path_or_paths'>path_or_paths</span>
689
- <span class='kw'>else</span>
690
- <span class='kw'>self</span><span class='period'>.</span><span class='id source_path'>source_path</span> <span class='op'>&lt;&lt;</span> <span class='id path_or_paths'>path_or_paths</span>
691
- <span class='kw'>end</span>
692
- <span class='kw'>end</span>
693
-
694
- <span class='comment'>##
695
- </span> <span class='comment'># Main source file to send compiler&quot;
696
- </span> <span class='comment'># This must be the last item in this list
697
- </span> <span class='id add_param'>add_param</span> <span class='symbol'>:input</span><span class='comma'>,</span> <span class='const'>File</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:required</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:hidden_name</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
698
-
699
- <span class='id set'>set</span> <span class='symbol'>:default_prefix</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>-</span><span class='tstring_end'>'</span></span>
700
-
701
- <span class='comment'>##
702
- </span> <span class='comment'># The default gem name
703
- </span> <span class='comment'>#
704
- </span> <span class='id set'>set</span> <span class='symbol'>:pkg_name</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>flex4sdk</span><span class='tstring_end'>'</span></span>
705
-
706
- <span class='comment'>##
707
- </span> <span class='comment'># The default gem version
708
- </span> <span class='comment'>#
709
- </span> <span class='id set'>set</span> <span class='symbol'>:pkg_version</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>&gt;= 1.0.pre</span><span class='tstring_end'>'</span></span>
710
-
711
- <span class='comment'>##
712
- </span> <span class='comment'># The default executable target
713
- </span> <span class='comment'>#
714
- </span> <span class='id set'>set</span> <span class='symbol'>:executable</span><span class='comma'>,</span> <span class='symbol'>:mxmlc</span>
715
-
716
- <span class='kw'>end</span></pre>
717
-
718
- <p>end</p>
719
-
720
- <p>## # Rake task helper that delegates to # the MXMLC executable. # #
721
- mxmlc ‘bin/SomeProject.swf’ do |t| # t.input =
722
- ‘src/SomeProject.as’ # t.source_path &lt;&lt; ‘lib/corelib’ #
723
- t.library_path &lt;&lt; ‘lib/SomeLib.swc’ # end # def mxmlc *args,
724
- &amp;block</p>
725
-
726
- <pre class="code"><span class='id mxmlc_tool'>mxmlc_tool</span> <span class='op'>=</span> <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>MXMLC</span><span class='period'>.</span><span class='id new'>new</span>
727
- <span class='id mxmlc_tool'>mxmlc_tool</span><span class='period'>.</span><span class='id to_rake'>to_rake</span><span class='lparen'>(</span><span class='op'>*</span><span class='id args'>args</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span><span class='rparen'>)</span>
728
- <span class='id mxmlc_tool'>mxmlc_tool</span></pre>
729
-
730
- <p>end</p>
731
- </div></div>
732
-
733
- <div id="footer">
734
- Generated on Tue Dec 21 11:02:51 2010 by
735
- <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
736
- 0.6.3 (ruby-1.9.2).
737
- </div>
738
-
739
- </body>
740
- </html>