Kick Assembler (C64)
Sublime 文本插件用于 C64 开发，配合 Kick Assembler。
详细信息
安装次数
- 总数 5K
- Win 3K
- Mac 1K
- Linux 738
| 8 月 6 日 | 8 月 5 日 | 8 月 4 日 | 8 月 3 日 | 8 月 2 日 | 8 月 1 日 | 7 月 31 日 | 7 月 30 日 | 7 月 29 日 | 7 月 28 日 | 7 月 27 日 | 7 月 26 日 | 7 月 25 日 | 7 月 24 日 | 7 月 23 日 | 7 月 22 日 | 7 月 21 日 | 7 月 20 日 | 7 月 19 日 | 7 月 18 日 | 7 月 17 日 | 7 月 16 日 | 7 月 15 日 | 7 月 14 日 | 7 月 13 日 | 7 月 12 日 | 7 月 11 日 | 7 月 10 日 | 7 月 9 日 | 7 月 8 日 | 7 月 7 日 | 7 月 6 日 | 7 月 5 日 | 7 月 4 日 | 7 月 3 日 | 7 月 2 日 | 7 月 1 日 | 6 月 30 日 | 6 月 29 日 | 6 月 28 日 | 6 月 27 日 | 6 月 26 日 | 6 月 25 日 | 6 月 24 日 | 6 月 23 日 | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Windows | 0 | 1 | 7 | 3 | 2 | 2 | 1 | 1 | 1 | 2 | 0 | 0 | 3 | 1 | 1 | 1 | 0 | 1 | 0 | 2 | 0 | 1 | 2 | 4 | 0 | 0 | 2 | 1 | 1 | 3 | 1 | 1 | 1 | 2 | 2 | 2 | 2 | 1 | 0 | 0 | 2 | 0 | 0 | 1 | 0 |
| Mac | 0 | 1 | 0 | 0 | 0 | 1 | 1 | 0 | 2 | 0 | 0 | 0 | 1 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 |
| Linux | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
阅读me
Sublime KickAssembler (C64)
用于 C64 开发的 Sublime 插件，包含语言配置/语法高亮，构建系统和一些代码片段。支持 macOS、Windows 和 Linux。需要 Sublime Text，支持版本 3。支持 Vice C64 模拟器和 C64Debugger C64 模拟器/调试器。
以下是一个快速入门指南，完整文档在这里： http://goatpower.wordpress.com/projects-releases/sublime-package-kick-assembler-c64/
安装，macOS
- 确保安装了较新版本的 Java（从 http://www.oracle.com/technetwork/java/javase/downloads/index.htm 下载）
- 从 http://theweb.dk/KickAssembler/ 下载 KickAssembler，解压到 Applications 文件夹中的
KickAssembler文件夹（*）
文件夹/Applications/KickAssembler/应包含 KickAss.jar 和一些其他文件/文件夹。 - 从 http://www.viceteam.org/#download 下载 Vice C64 模拟器，解压到 Applications 文件夹中的
Vice文件夹（**）
文件夹/Applications/Vice/应包含 x64 和一些其他文件/文件夹。 - 为 Sublime 安装 Package Control 并安装包 Kick Assembler (C64)，或者将此 GitHub 存储库克隆/下载到
~/Library/Application Support/Sublime Text 3/Packages/的子文件夹中
* 如果要为 Kick Assembler 设置自定义路径，请将 KickAss.jar 的完整路径添加到 CLASSPATH 环境变量
** 如果要为 Vice 设置自定义路径，请将包含 x64 的 Vice 文件夹路径添加到 PATH 环境变量
安装，Windows
- 确保安装了较新版本的 Java（从 http://www.oracle.com/technetwork/java/javase/downloads/index.htm 下载）
- 从http://theweb.dk/KickAssembler/下载KickAssembler，解压到文件夹
c:\C64\Tools\KickAssembler\(*)
文件夹c:\C64\Tools\KickAssembler\应该包含 KickAss.jar 和一些其他文件/文件夹。 - 从http://www.viceteam.org/#download下载Vice C64模拟器，解压到文件夹
c:\C64\Tools\Vice\(**)
文件夹c:\C64\Tools\Vice\应该包含 x64.exe 和一些其他文件/文件夹。 - 为Sublime安装Package Control，并安装包Kick Assembler (C64) ), 或者将此GitHub仓库克隆/下载到
%USERPROFILE%\AppData\Roaming\Sublime Text 3\Packages\的子文件夹中
* 如果要为 Kick Assembler 设置自定义路径，请将 KickAss.jar 的完整路径添加到 CLASSPATH 环境变量
** 如果您想为Vice指定自定义路径，可以将包含x64.exe的Vice文件夹的路径添加到PATH环境变量中
安装，Linux
在Linux方面，我是个菜鸟，这可能使此指南也变得糟糕。无论如何，它已经在Ubuntu 14上成功测试过。
- 请确保您的系统已安装Java运行时环境，如果没有，请查阅这里，或者通过ppa安装，请参阅此指南
- 从http://theweb.dk/KickAssembler/下载Kick Assembler，解压缩到任何地方，并确保KickAss.jar的全路径存在于您的CLASSPATH环境变量中
- 下载/编译/安装Vice C64模拟器，我遵循了此指南。确保Vice文件夹的路径（包含x64）存在于您的PATH环境变量中
- 为Sublime安装Package Control，并安装包Kick Assembler (C64) ), 或者将此GitHub仓库克隆/下载到
~/.config/sublime-text-3/Packages/的子文件夹中
开发、构建和运行
- 在Sublime text中打开Kick Assembler代码文件。示例代码文件在此链接
- 按
F7键开始构建和运行（下面有更多构建选项） - 希望看到您可爱的代码执行！（(*)
* 如果出现错误信息称Java未被识别为内部或外部命令，请确保已安装Java，并将Java二进制文件文件夹的路径添加到PATH环境变量中
详细信息，构建系统
| 操作 | 快捷键 macOS | 快捷键 Windows | 描述 |
|---|---|---|---|
| 其他构建变体（如下所示） | Super+Shift+P |
Ctrl+Shift+P |
开始编写构建，并显示以下变体的列表 |
| 构建 | Command+B |
Control+B |
编译当前文件。 |
| 构建和运行 | F7 |
F7 |
编译当前文件并使用Vice模拟器运行。 |
| 构建和调试 | Shift+F7 |
Shift+F7 |
编译当前文件并使用Vice模拟器运行。此选项允许创建包含断点的文件，并将其发送到Vice模拟器进行调试。 |
| 构建启动 | Command+Shift+B |
Ctrl+Shift+B |
编译同文件夹中名为Startup.asm的文件。如果您有几个在主可运行文件中包含的代码文件，这将很有用。文件名可以通过kickass_startup_file_path设置进行配置。 |
| 构建和运行启动 | F5 |
F5 |
编译同文件夹中名为Startup.asm的文件，并使用Vice模拟器运行。如果您有几个在主可运行文件中包含的代码文件，这将很有用。文件名可以通过kickass_startup_file_path设置进行配置。 |
| 构建和调试启动 | Shift+F5 |
Shift+F5 |
编译当前文件夹中名为.Startup.asm的文件，并使用Vice模拟器运行它。如果您有一个被包含在主运行文件中的多个代码文件，这将非常有用。此选项允许创建包含断点的文件，并将其发送到Vice模拟器进行调试。文件名可以通过kickass_startup_file_path设置进行配置。 |
| 构建 | F8 |
F8 |
调用名为make.bat的Windows脚本，make.sh的macOS脚本（可通过default_make_path设置进行配置）。 |
以下环境变量将在构建脚本中可用
| 变量 | 信息 |
|---|---|
kickass_file |
命令触发时活动的文件名 |
kickass_file_path |
命令触发时活动的文件的完整路径 |
kickass_prg_file |
当命令触发时，建议的prg文件名的完整路径 |
kickass_bin_folder |
当前输出文件夹的路径（默认为bin，或由kickass_output_path设置指定） |
预/后构建
有一种方法可以在构建前后执行自定义脚本。
| 变量 | 信息 |
|---|---|
default_prebuild_path |
在构建之前将执行的.bat或.sh脚本文件的完整路径。 |
default_postbuild_path |
在构建之后将执行的.bat或.sh脚本文件的完整路径。用于文件压缩等操作。 |
KickassTooltips
此插件通过显示各种有用的工具提示信息使使用Kick Assembler变得更容易。工具提示数据库可以扩展以提供更多C64相关信息。迄今为止，已准备了一些基本的帮助文件，包括Kick Assembler指令、非法指令、VIC寄存器和SID寄存器。此插件由Roman Dobosz（Gryf/Elysium）和Krzysztof Dabrowski（Brush/Elysium）添加。
配置
导航到首选项/包设置/KickassTooltips并选择要编辑的配置文件。目前您可以配置
"css_file": "KickassTooltips/css/default.css"
这是一个包含用于样式化工具提示的css文件。
"help_directories": ["KickassTooltips/helpdb"],
这定义了json格式帮助文件的目录。您可以自由添加自己的文件。
"scopes": ["source.assembly.kickassembler"],
这定义了插件应该在哪些范围内工作。迄今为止，它只会在Kick Assembler范围内运行。
"log_level": "warning"
为了调试的目的，您可以增加日志级别到info或debug，打开Python控制台（使用ctrl-），观察正在进行什么操作以及插件遇到了什么问题。如果您报告了一个错误，请使用“debug”级别并确保复制并粘贴了整个输出。
贡献
进行更改
复制仓库，进行更改并提交拉取请求。
本地开发
只需将仓库克隆到Sublime包文件夹中，您就可以在开发过程中实时测试包。
运行所有测试
- 通过UnitTesting包控制Package Control安装包。
- 在Sublime Text中，在SublimeKickAssemblerC64文件夹打开的情况下运行命令
UnitTesting: Test Current pakcage。