FlexMonkey FAQ

• How is FlexMonkey licensed?

FlexMonkey is licensed under the GNU General Public License.

• Where can I download FlexMonkey?
  • Right here

• How do I get help?
  • Check out the FlexMonkey Forum
  • Warning sales pitch ahead :-)  Gorilla Logic also offers the following resources to help your team.
    • Quick Start - 1-2 week onsite intensives to train your team in FlexMonkey and to make your application(s) test automation ready.
    • FlexMonkey Annual Support Contract
    • To learn more click here

• Where can I find FlexMonkey documentation?

Documentation is here

• Why am I getting the compiler error: "Unable to resolve a class for RequiresLicense handler: mx.automation:AutomationLicesneHandler."?

You will get this error on some platforms if you don't explicit include automation_agent.swc in your compiler args. Enusre your compiler args are similar to the following:

Flex 4.x
-locale en_US -include-libraries libs/automation_monkey4.x.swc ${flexlib}/libs/automation/automation_agent.swc

Flex 3.x
-locale en_US -include-libraries libs/automation_monkey4.x.swc ${flexlib}/libs/automation_agent.swc

• Why am I getting the error "License not present. With Trial version only limited records are allowed"?
  • This is not a FlexMonkey error message. It is actually generated by the Adobe Automation API.

    FlexMonkey requires the Adobe Automation framework, which is included with Flash Builder Premium edition. If you receive this message, it means you compiled your application with Flash Builder Standard edition (which limits recording and playback to 25 actions). Compiling instead with Flash Builder Premium (or Flex Builder Professional) will eliminate the eror.

     

• I'm getting error #2302 when I try to load my application:

  • You need to merge frameworks into your code, vs. using RSLs (runtime shared libraries). In Flex 4.0, RSLs are the default. In FleashBuilder, select Project->Properties->Flex Build Path->Framework Linkage, and set it to "Merged into code".

• Why does the Monkey Connection light in the FlexMonkey console never turning green?

  • Be sure you are using the correct version of automation_monkey.swc from the Monkey Accessories download, to match the Flex SDK version you are using (3.3, 3.4.1, or 4.0)
  • Then:
    • Launch a browser, and navigate to an HTML page containing your target SWF
    • The FlexMonkey console's "Monkey Connection" light should turn green.
    • You can now record or playback tests.

• Why is the connection light flashing yellow and green?

  • Your SWF is probably running in more than one browser window or tab. Close all other browser windows or tabs that contain FlexMonkey-enabled SWF's.

• Why isn't recording working for all components in my application?

  • You probably need to add IAutomationObject methods to a container as discussed here. Also, see "Fix #1" here.

• I'm getting the red border around a containing component when I try to interactively create a verify, but not on components contained within it. Why?

  • You probably need to add IAutomationObject methods to a container as discussed here. Also, see "Fix #1" here.

• How do I run my FlexMonkey tests from Ant?

  • First, you will need to  generate AS3 code for your tests so you can run them using FlexUnit.
  • Then, you can steal from the appropriate sample project from the continuous integration page to setup your project.

• Does FlexMonkey work with custom components?

  • FlexMonkey works with most custom components that extend concrete Flex Components. Custom components that descend directly from UIComponent require special handling as explained in InstrumentingForFlexMonkey.
  • Another good resource is Rani Kumar's blog (Rani is the Adobe engineer responsible for the Flex Automation Framework.

• Why do I get the error "Unable to resolve id..." when playing back a test?

  • See http://code.google.com/p/flexmonkey/wiki/UserGuide?ts=1242918275&updated....

• How can I debug when running generated AS3 tests?

  • See the documentation here.

• Why do I get the message "License not present. With the trial verison only limited replays are allowed."?

  • This message is not from FlexMonkey itself. It is from the Adobe Automation framework. You need a Flex or Flash Builder Professional or Premium license to use the Adobe Automation framework. FB Standard edition only includes a demo license which enforces this replay restriction.

• How do I reference my FB Professional or Premium license on my build server?

  • See http://stackoverflow.com/questions/1616141/how-do-i-license-the-data-vis....

• Why do I get "Error: Unable to find automation method?"

  • Unable to find automation method errors are usually related to mis-configurations in the FlexMonkeyEnv.xml file. To use an event for record and playback, the event type has to be defined for the visual component or in its hierarchy (in the FlexMonkeyEnv.xml file). So, if you receive this error in relation to an event, you typically need to add an XML description of the event on the component that you are attempting to record or playback against.
  • Learn more about the FlexMonkeyEnv.xml file on the How FlexMonkey Works page. 

• Does FlexMonkey work with (non-Flex) Flash apps too?

  • No. FlexMonkey depends on the Adobe Automation API, which only supports automating classes that are subclasses of the Flex UIComponent class.

• I have a custom ItemRenderer on a DataGroup or List, how do I record and playback on it?

         override public function get automationValue():Array {
             return [data.field1];
         }			
      

  • You must implement the automationValue method:

• How do I run FlexMonkey tests on a "headless" server?

  • Use a virtual framebuffer such as xvfb.