Kinesis SoftwareKineticFusion

[Show Table of Contents]

3 Quick Start Guide

[Hide Table of Contents]

3.1 ActionScript 2.0 Class Analysis

ActionScript 2.0 (AS2.0) is becoming increasingly important as the default representation for ActionScript classes and KineticFusion contains a sophisticated AS2.0 class analyzer and compiler. While KineticFusion is designed to build your SWF output movies fast and efficiently, a good starting point to get used to the application is to use it to analyze your existing ActionScript classes. This section will help you get started on stand-alone class analysis - this feature reads all of the specified classes and their dependents and log all the possible syntactic and semantic errors and warnings in the classes but will not generate any SWF output or modify your system in any way.

ActionScript class files are stored in folder class hierarchies and this is the first step for integration with KineticFusion. To get started, firstly configure your class paths using the two KineticFusion properties, kinesis.actionscript.systemClassPath and kinesis.actionscript.userClassPath. All configuration properties are stored in the installation /config/ file. You can find information on how to set configuration properties in the general configuration information.

While it is not necessary to define your user class path when using the GUI class analyzer it is good practice, as GUI preferences are not used when running the application on the command-line.

KineticFusion can be used immediately to aid you in coding and analyzing your AS2.0 classes. Initially, you will want to explicitly select your classes from the KineticFusion GUI, but you can also automate class analysis by analyzing your classes from the command-line.

3.1.1 Configure error and warning messages

In addition to the full syntactic analysis executed by the KineticFusion AS2.0 compiler, KineticFusion also has over one hundred configurable semantic warnings for AS2.0 analysis. The full list of these errors and their default logging levels can be found in the installed file, initially installed in the installation /config directory.

KineticFusion uses three different error levels that are described in the ActionScript documentation in more detail. Each warning message is set to a default level on installation. Initially we recommend not modifying the default levels in order to understand the scope of warnings generated by KineticFusion. Over time you can then escalate or ignore classes of warnings as you standardize on a coding practice.

3.1.2 Specify Additional Class Metadata

All ActionScript classes can be augmented with Javadoc comments and tag specifying addition constraints on classes and class members. The currently supported Javadoc tags are:

  • @abstract : specifies a class or class method is abstract
  • @final : specifies that a class or class method is final and cannot be overridden
  • @const : defines a compile-time constant that can be inlined
  • @signature : defines an optional valid signature for a class method
  • @since : defines the Player version for which a class or class member is available
  • @mixin : defines the corresponding mixin method from which to derive signature constraints

KineticFusion will automatically read all specified Javadoc comments automatically. See the information on Class Metadata for more information.