Updated Dec 01, 2009 by kleppe
Labels:	Phase-Implementation, Phase-Deploy, Featured

ThunderBoltAS2

ThunderBolt AS2 for logging ActionScript 2 applications.

ThunderBolt

ThunderBolt AS2 is a logger extension for Flash ActionScript 2 based on MTASC´s trace facilitiy and the superb Firebug add-on for Firefox.

Debug Information

`description`	`my.package.MyClass::myMethod[123] : type @ 18:59:59`
`file`	`./path/to/my/class/file.as`
`fullClass`	`my.package.MyClass`
`frame`	`12`
`line`	`123`
`method`	`myMethod`
`time`	`18:59:59`
`type`	`string`

Log Levels

By passing an extra literal to your trace actions, you can achieve multiple debug levels.

d	debug	`trace('d This is a simple debug message.');`
i	info	`trace('i An info icon will appear next to this line.');`
w	warn	`trace('w This message is highlighted.');`
e	error	`trace('e Red and highlited messages.');`

Debug in Browser

Run this two commands to get more information on your objects during runtime:

// inspect obejcts and set attributes
ThundeBolt.inspect("Sample.APP.profileObject"); 				// inspect object
ThundeBolt.set("_root.logo._x", 20); 						// set new position
ThundeBolt.set("_root.logo.label.text", "Live hacking made possible!"); 	// change text

// set context for later inspection
ThundeBolt.cd("_root.logo.label"); 						// set new context
ThundeBolt.inspect("_x"); 							// x position of current content
ThundeBolt.cd(".."); 								// select parent movieclip

// execute methods
ThundeBolt.run("Sample.APP.randomizeAlpha(100)"); 				// run a method
ThundeBolt.run("Sample.APP.restoreAlpha()"); 					// run another method

// test performance
ThundeBolt.profile("Sample.APP.profileObject"); 				// start profiling for all methods in object
ThundeBolt.run("Sample.APP.profileObject.method2()"); 				// execute profiling test
ThundeBolt.profileEnd(); 							// stop profiling and see results

Acknowledgment

Comment by spurgeonworld, Feb 22, 2008

I'm no stranger to Flash ActionScript?, ActionScript? debugging, or using Firebug. But I'm clueless as to how to install ThunderBolt?. Any instructions?

Comment by pwrsrg, Mar 31, 2009

Could someone please explain the simplest way to implement this in an AS2 project? I have been trying this all day with no success, but cannot seem to get it to work (or even compile without errors) since there is absolutely no AS2 documentation here. I am trying to import the class in a BLANK project using "import org.osflash.thunderbolt.Logger;" but get a bunch of errors. Any help would be greatly appreciated!

Comment by andresalrevez, Aug 25, 2009

i agree, how can use this on any AS2 Project?

Comment by sectore, Aug 27, 2009

@pwrsrg, @andresalrevez: If you have any issues, please post it on Google Thunderbolt Group (http://groups.google.com/group/flash-thunderbolt) to get in contact with Martin, who is the owner of the AS2 port.

Thanks!

-Jens

-- http://www.websector.de/