launch.json fields for SWF debugging

The ActionScript & MXML extension for Visual Studio Code provides a debugger for SWF files, which allows you to debug an application running in either Adobe AIR or Flash Player. In the case of mobile Adobe AIR apps, you can either debug in the simulator running on your computer or you can connect the debugger to an AIR app running on a mobile device.

Several custom configuration options are available when debugging SWFs, and these options may be specified in Visual Studio Code's standard launch.json file.

Table of Contents

• Examples
• Launch Request Properties
• Attach Request Properties

Examples

The following launch configurations are provided by default:

{
	"version": "0.2.0",
	"configurations": [
		{
			"type": "swf",
			"request": "launch",
			"name": "Launch SWF"
		},
		{
			"type": "swf",
			"request": "attach",
			"name": "Attach SWF"
		}
	]
}

The "launch" request will launch your application in Adobe AIR or Flash Player, depending on your type of project. You don't need to specify the location of the SWF because the debugger will find it automatically in your asconfig.json project file.

The "attach" request allows you to launch an application manually before connecting the debugger, or it may be used to debug an application running on a mobile device. For mobile debugging, see the platform field below for details.

Launch Request Properties

The following optional properties may be specified on a "launch" request.

"args"

Custom command line arguments to pass to a desktop Adobe AIR application.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"args": "-custom-arg=hello -another"
}

See AIR application invocation and termination: Capturing command line arguments and flash.events.InvokeEvent for more details.

"extdir"

The directory where your application's unpackaged native extensions are located.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"profile": "path/to/unpackaged_anes"
}

Unpackaged native extensions are ANE files that have been unzipped for development. Each unpackaged native extension should appear in its own separate subdirectory of the location that you pass to the extdir field in launch.json.

For more details about unpackaged native extensions, find the documentation for -extdir in Building Adobe AIR Applications: AIR Debug Launcher (ADL).

Note: This field is used for debugging only. When packaging your Adobe AIR application to deploy to devices, use the extdir field in asconfig.json instead.

"profile"

The Adobe AIR application profile to simulate.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"profile": "mobileDevice"
}

The following profile values are supported:

• "desktop"
• "extendedDesktop"
• "mobileDevice"

"program"

(Advanced) Custom path to the SWF or HTML file to launch. In many cases, this field can be omitted because it will be populated with the appropriate value automatically.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"program": "bin-debug/MyProject.swf"
}

"runtimeExecutable"

(Advanced) Path to runtime executable, such as the standalone version of Adobe Flash Player, a web browser, or AIR Debug Launcher. In many cases, this field can be omitted because it will be populated with the appropriate value automatically.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"program": "bin-debug/MyProject.swf"
}

"runtimeArgs"

(Advanced) Optional arguments to pass to the runtime executable, such as the standalone version of Adobe Flash Player, a web browser, or AIR Debug Launcher.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"runtimeArgs": "-custom-arg=hello -another"
}

To pass arguments to an Adobe AIR application that you're launching, use args instead.

"screenDPI"

The screen density (sometimes called DPI or PPI) of the mobile device to simulate. Customizes the value returned by flash.system.Capabilities.screenDPI. Typically used in combination with screensize.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"screenDPI": 326
}

"screensize"

The normal and full-screen dimensions of the simulated mobile device. Typically used in combination with screenDPI.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"screensize": "480x762:480x800"
}

A number of special screensize values with predefined resolutions are available, including "iPhone", "iPhoneRetina", and "iPad". See Building Adobe AIR Applications: AIR Debug Launcher (ADL) for a complete list.

"versionPlatform"

The platform string to simulate in the AIR Debug Launcher. Customizes the value returned by flash.system.Capabilities.version.

{
	"type": "swf",
	"request": "launch",
	"name": "Launch SWF",
	"versionPlatform": "IOS"
}

The following versionPlatform values are supported:

• "IOS"
• "AND"
• "WIN"
• "MAC"

Attach Request Properties

The following optional properties may be specified on an "attach" request.

"connect"

By default, the debugger will listen for connections over wifi. If the "connect" property is true, the debugger will try to connect to the runtime over USB instead.

{
	"type": "swf",
	"request": "attach",
	"name": "Attach SWF",
	"connect": true
}

"port"

If the "connect" property is true, the debugger will connect on the specified port.

{
	"type": "swf",
	"request": "attach",
	"name": "Attach SWF",
	"connect": true,
	"port": 12345
}

"platform"

Before connecting the debugger, the application will be installed over USB on a mobile device with the specified platform.

{
	"type": "swf",
	"request": "attach",
	"name": "Attach SWF",
	"platform": "ios"
}

The following platform values are supported:

• "ios"
• "android"

Further Reading

• Configuration settings for simulating common mobile devices in Adobe AIR
• Building Adobe AIR Applications: AIR Debug Launcher (ADL) (adobe.com)
• Debugging in Visual Studio Code (visualstudio.com)