{"id":9511,"date":"2016-06-21T15:31:22","date_gmt":"2016-06-21T13:31:22","guid":{"rendered":"http:\/\/fdt.powerflasher.com\/?p=9511"},"modified":"2016-06-21T15:31:22","modified_gmt":"2016-06-21T13:31:22","slug":"library-project-template","status":"publish","type":"post","link":"https:\/\/fdt.powerflasher.com\/blog\/2016\/06\/library-project-template\/","title":{"rendered":"Library Project Template"},"content":{"rendered":"

This new FDT release contains features to support a more fluent development of SWC libraries. The primary starting point to develop a library is the new Library Project Template for AIR or Web:\"LibraryProjectTemplate\"<\/a> This template creates an empty library project containing two source folders:\"LibraryProjectEmptyStructure\"<\/a> All compilation units to include into the library should be placed into the source folder src<\/i>. The test source folder testSrc<\/i> should contain all test classes.<\/p>\n

 <\/p>\n

Exclude SDK SWCs from export<\/strong><\/p>\n

After adding AS3 source files the Evaluator<\/i> example has this structure:\"LibraryProjectStructure\"<\/a> With this new version FDT offers the ability to exclude SDK libraries (marked with \"over_not_export\") from export. In this example the new ability is used since the final SWC should not contain any SDK SWC. The test resources (marked with \"over_test_resource\") \u00a0are disregarded during normal compilation. They are only added to compilations for test runs whereas in other compilations they are fully disregarded. In this example the FlexUnit libraries and the source folder testSrc<\/i> are test resources.<\/p>\n

This is the SWC launcher to compile the final SWC of the Evaluator<\/i> example:\"LibraryProjectLauncher\"<\/a> Inside the Compiler Arguments<\/i> tab the option Auto add exclude (-externs)<\/i> is active by default. If this option is active the options –externs<\/i> and –compiler.external-library-path<\/i> are automatically added as compiler arguments to exclude compilation units or libraries marked with \"over_not_export\". Starting this SWC launcher the compilation includes only the source folder src<\/i>:<\/p>\n

\"LibraryProjectResult\"<\/a> All libraries are external due to the compiler option –compiler.external-library-path<\/i> and so the final library output Evaluator.swc<\/i> is kept small. All test resources are skipped and they are not even available as externals. This is why SDK SWCs are not marked as test resources in this example since they are required as externals to compile against them.<\/p>\n

 <\/p>\n

Library Test Run<\/b><\/h2>\n

Compilations for test runs can be forced to include all test resources like the FlexUnit libraries and the test classes as you can see in the following FlexUnit test launcher of the Evaluator<\/i> example:\"LibraryProjectTestLauncher\"<\/a> For test launchers the options Force include all test resources<\/i> and Use the project specific compiler arguments<\/i> are active by default.<\/p>\n

In the Evaluator<\/i> example the test run also includes the SDK SWCs even if they are all marked with\u00a0\"over_not_export\" to be excluded. This is the case since the project properties have this default:\"LibraryProjectCompilerOptions\"<\/a> Inside the project compiler properties (for SWF files) the option Auto add exclude (-externs)<\/i> is inactive by default. As consequence the compilations for applications and test runs (both output SWFs) ignore the exclusion by default and instead will also include resources marked with \"over_not_export\".<\/p>\n

All together this leads to this test run compilation for the Evaluator<\/i> example:\"LibraryProjectTestRun\"<\/a> In the end the output SWF TestDepthCounterVisitor.swf <\/i>includes both source folders (src <\/i>and testSrc<\/i>) and all libraries (SDK SWCs and the FlexUnit libraries) defined in the Evaluator<\/i> example. Any test launch starts the test runner (here it is FDT\u2019s default test runner class FdtFlexUnitSpriteRunner<\/i>) using the library FdtFlexUnit.swc <\/i>to connect to FDT. It invokes all tests in a FlexUnit environment and reports back test results to FDT. Since library FdtFlexUnit.swc <\/i>and all test runners are dependent on the FlexUnit libraries they have to be included in all test launch compilations.<\/p>\n","protected":false},"excerpt":{"rendered":"

This new FDT release contains features to support a more fluent development of SWC libraries. The primary starting point to develop a library is the new Library Project Template for AIR or Web: This template creates an empty library project containing two source folders: All compilation units to include into the library should be placed […]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[9],"tags":[],"_links":{"self":[{"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/posts\/9511"}],"collection":[{"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/comments?post=9511"}],"version-history":[{"count":10,"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/posts\/9511\/revisions"}],"predecessor-version":[{"id":9534,"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/posts\/9511\/revisions\/9534"}],"wp:attachment":[{"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/media?parent=9511"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/categories?post=9511"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fdt.powerflasher.com\/blog\/wp-json\/wp\/v2\/tags?post=9511"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}