View comments | RSS feed

Configuring Flash Debug Player

You configure the error-reporting mechanism of Flash Debug Player using the mm.cfg text file. This file is typically located in the same directory as the flashlog.txt file.

Two Microsoft Windows environment variables define the location of this directory:

HOMEDRIVE Specifies the drive letter of the path to the home directory. In most Microsoft Windows systems, the default value is C:, the primary hard drive.

HOMEPATH Specifies the path to the home directory, relative to HOMEDRIVE. On Microsoft Windows 2000, the default is \. In Microsoft Windows XP, the default is \Documents and Settings\user_name where user_name is your system user name.

Therefore, the default home directory is C:\ in Microsoft Windows 2000 and C:\Documents and Settings\user_name in Microsoft Windows XP.

For information on setting these two environment variables, see the Flex installation instructions.

The following mm.cfg file enables error reporting and configures Flash Debug Player to write error messages to the flashlog.txt, where flashlog.txt is in the same directory as mm.cfg:

ErrorReportingEnable=1
TraceOutputFileEnable=1

The following table lists the properties that you can set in the mm.cfg file:

Property Description
ErrorReportingEnable

Set ErrorReportingEnable to 1 to enable error reporting. Disable it by setting it to 0. Error reporting is disabled by default.

MaxWarnings

Set MaxWarnings to override the default message limit. For example, you can set it to 500 to capture 500 error messages.

By default, Flash Debug Player logs 100 error messages to the log file. After 100 messages, Flash Debug Player writes a message to the file stating that further error messages will be suppressed.

Set the MaxWarnings to 0 to remove the limit so that all error messages are recorded.

TraceOutputFileEnable

Set TraceOutputFileEnable to 1 to enable Flash Player to write error messages to the log file. Disable it by setting TraceOutputFileEnable to 0.

TraceOutputFileName

Set TraceOutputFileName to override the default name and location of the log file by specifying a new location and name in the form:

TraceOutputFileName=<fully qualified path/filename> 

By default, Flash Player writes error messages to a file named flashlog.txt located in the directory specified by the environment variables HOMEDRIVE and HOMEPATH.


Version 1.5

Comments


porieux said on Jun 9, 2005 at 7:21 PM :
And on Mac?
mpeterson said on Jun 10, 2005 at 1:27 PM :
Regarding the previous comment,
Flex development is not supported on the Macintosh platform.

Mike Peterson
Flex documentation team
No screen name said on Aug 2, 2005 at 6:35 AM :
Concerning Mac
TraceOutputFileName=MacHD:Users:username:Desktop:flashLog.txt

more at:
http://www.actionscript.org/tutorials/beginner/trace_and_debug_from_your_browser/index.shtml
spindlenine said on Sep 7, 2005 at 8:18 PM :
That's a great article. FYI, if you name the file "flashLog.log" instead of
"flashLog.txt", you can use the Console application to track changes to
the file. Just open "Console" (it's in Applications/Utilities), and go to File
=> Open, then select "flashLog.log" on your desktop.

The other issue with the article is that it says "Swapping "MacHD" with
your computer name...", when in fact it is your hard disk name, not your
computer name. For example, my hard disk is named "Macintosh HD",
so my mm.cfg file looks like this:

ErrorReportingEnable=1
MaxWarnings=50
TraceOutputFileEnable=1
TraceOutputFileName=Macintosh HD:Users:porgesm:Desktop:
flashLog.log
No screen name said on Mar 8, 2006 at 9:34 AM :
On a mac, I use tail -f /path/to/flashLog.txt to watch trace events in real time.
egeddes said on Nov 19, 2006 at 10:51 AM :
With version 9.0.28.0 on OSX, the location for the flashlog file is
[MacHD]:Users:[User]:Library:Preferences:Macromedia:Flash Player:Logs:flashlog.txt

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flex/15/flex_docs_en/00000794.htm