Breaking Changes - prb28/vscode-amiga-assembly GitHub Wiki

1.9

Syntax coloring scopes are renamed

The TextMate grammar has been rewritten. If you customize the colors with editor.tokenColorCustomizations in your settings, replace the old scopes with the new ones:

Before 1.9 1.9
keyword.other.opcode.mem.m68k keyword.control.directive.data.m68k
keyword.other.opcode.pc.m68k keyword.control.directive.data.pc.m68k
keyword.operator.assignment.stack.*.m68k keyword.control.directive.storage.m68k
meta.label.global.m68k entity.name.label.m68k
variable.other.macro.m68k entity.name.function.macro.m68k

New scopes can also be colored, for example the size suffixes (move.l, dc.w) with support.type.size.m68k:

"editor.tokenColorCustomizations": {
    "textMateRules": [
        {
            "scope": "entity.name.label.m68k",
            "settings": { "foreground": "#DCDCAA" }
        },
        {
            "scope": "support.type.size.m68k",
            "settings": { "foreground": "#808080" }
        }
    ]
}

1.7

The launch configuration has been unified between the new FS-UAE and WinUAE builds.

Binaries are embedded

There is no more need for binaries to be downloaded.

You may have to reset the amiga-assembly.binDir setting to get rid of error messages.

Bin dir setting

How to migrate your workspace to version 1.7/1.8

Steps to migrate your workspace:

  • Open your vscode/launch.json file.
  • Change the launch settings
  • For WinUAE

Example of a < 1.6 WinUAE launch configuration :

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "winuae",
            "request": "launch",
            "name": "WinUAE Debug",
            "buildWorkspace": true,
            "stopOnEntry": true,
            "serverName": "localhost",
            "serverPort": 2345,
            "startEmulator": true,
            "trace": false,
            "exceptionMask": 8188,
            "emulatorStartDelay": 1500,
            "emulator": "${config:amiga-assembly.binDir}/winuae.exe",
            "emulatorWorkingDir": "${config:amiga-assembly.binDir}",
            "program": "${workspaceFolder}/uae/dh0/gencop",
            "options": [
                "-s",
                "quickstart=a500,1",
                "-s",
                "filesystem=rw,dh0:${workspaceFolder}\\uae\\dh0",
                "-s",
                "debugging_trigger=SYS:gencop",
                "-s",
                "debugging_features=gdbserver"
            ],
            "preLaunchTask": "amigaassembly: build"
        }
	]
}

After migration :

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "amiga-assembly",
            "request": "launch",
            "name": "WinUAE Debug",
            "stopOnEntry": true,
            "program": "${workspaceFolder}/uae/dh0/mygame",
            "remoteProgram": "SYS:mygame",
            "emulatorType": "winuae",
            "emulatorArgs": [
                "-s",
                "filesystem=rw,dh0:${workspaceFolder}/uae/dh0",
                "-s",
                "quickstart=a500,1",
            ],
            "preLaunchTask": "amigaassembly: build"
        }
	]
}

Example of a < 1.6 FS-UAE launch configuration :

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "fs-uae",
            "request": "launch",
            "name": "FS-UAE Debug",
            "stopOnEntry": true,
            "serverName": "localhost",
            "serverPort": 6860,
            "trace": false,
            "startEmulator": true,
            "buildWorkspace": true,
            "windows": {
                "emulator": "${config:amiga-assembly.binDir}/fs-uae.exe",
            },
            "osx": {
                "emulator": "${config:amiga-assembly.binDir}/fs-uae",
            },
            "linux": {
                "emulator": "${config:amiga-assembly.binDir}/fs-uae",
            },
            "emulatorWorkingDir": "${config:amiga-assembly.binDir}",
            "program": "${workspaceFolder}/uae/dh0/gencop",
            "options": [
                "--chip_memory=1024",
                "--hard_drive_0=${workspaceFolder}/uae/dh0",
                "--joystick_port_1=none",
                "--amiga_model=A1200",
                "--slow_memory=1792",
                "--remote_debugger=200",
                "--use_remote_debugger=true",
                "--automatic_input_grab=0"
            ],
            "preLaunchTask": "amigaassembly: build"
        }
	]
}

After migration :

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "amiga-assembly",
            "request": "launch",
            "name": "FS-UAE Debug",
            "stopOnEntry": true,
            "trace": true,
            "program": "${workspaceFolder}/uae/dh0/gencop",
            "remoteProgram": "SYS:gencop",
            "emulatorType": "fs-uae",
            "emulatorArgs": [
                "--hard_drive_0=${workspaceFolder}/uae/dh0",
                "--chip_memory=1024",
                "--joystick_port_1=none",
                "--amiga_model=A1200",
                "--slow_memory=1792",
                "--remote_debugger=200",
                "--automatic_input_grab=0"
            ],
            "preLaunchTask": "amigaassembly: build"
        }
	]
}

If you do not a specific configuration you can create a new one:

  • rename the .vscode/launch.json file as .vscode/oldlaunch.json
  • create a new launch configuration
  • Rename the executable replacing string from "myprogram" to your executable name.
  • Change the configuration according to the saved .vscode/oldlaunch.json file.

If you do not want to upgrade you can select an old version of the extension in VSCode.

Install other version