运行任务

为运行自定义工作区任务而设计的 Sublime Text 包

详细信息

版本 1.0.0
主页 packagecontrol．io
问题 github．com
修改时间 5 年前
最后出现时间 2 小时前
首次出现时间 5 年前

安装

总数 728
Win 445
Mac 114
Linux 169

	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	0	0	0	0	0	0	0	0	0	0	0	0	1	0	0	0	0	0	0	0	0	0	0	0	0	1	0	0	0	1	1	0	1	0	0	0	0	0	0	0	0	0	0	0
Mac	1	1	0	0	0	0	0	0	1	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0
Linux	0	0	0	1	0	0	0	0	0	0	0	0	0	1	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	1	0

README

源码: raw．githubusercontent．com

Sublime Run Task

从 Sublime Text 3 快速面板运行自动化工作区任务。使用 Run Task，您可以配置常用工作区任务的列表，比如运行单元测试和代码生成，而无需离开您最喜欢的文本编辑器就能运行它们并分析其结果。

Screenshot

安装

包控制

安装 Run Task 包的推荐方法是使用包控制。只需从命令面板使用 包控制：安装包 命令并搜索 Run Task。通过选择此安装方式，任何包更新都将自动安装。

手动

可以通过将此 Git 仓库克隆到您的 Sublime Text 包安装目录中手动安装 Run Task 包。请注意，通过选择此安装方式，任何包更新都需手动安装。

在 Sublime Text 包安装目录中打开一个终端。此目录的路径可通过 首选项 → 浏览包... 查找。

运行

git clone https://github.com/mgutski/sublime-run-task "Run Task"

用法

打开或创建 .sublime-project 文件，这是包含您的项目定义的文件。

Usage

添加顶级节 Run Task.tasks，使用 JSON 任务定义，如下面的示例所示。

{
    "folders":
    [
        {
            "path": ".",
            "folder_exclude_patterns": [".idea", ".vscode"],
            "file_exclude_patterns": [".gitignore", ".gitattributes", ".gitmodules", ".firebaserc"]
        }
    ],
    "settings":
    {
        "tab_size": 4
    },
    "Run Task.tasks": 
    [
        {
            "name": "Run Unit Tests",
            "type": "shell",
            "command": "./Tests/run_unit_tests.sh",
            "windows": {
                "command": "wsl",
                "args": "./Tests/run_unit_tests.sh"
            }
        },
        {
            "name": "Start Local Web Server",
            "type": "shell",
            "command": "osascript",
            "args": "-e 'tell app \"Terminal\" to activate' -e 'tell app \"Terminal\" to do script \"cd ${cwd} && ./Debug/run-http-server.sh\"'",
            "windows": {
                "command": "cmd",
                "args": "/C start cmd /K .\\\\Debug\\\\run-http-server.cmd"
            },
            "show_output_panel": false
        },
        {
            "name": "Generate Docs",
            "type": "shell",
            "command": "./Source/scripts/generate_docs.sh",
            "windows": {
                "command": "wsl",
                "args": "./Source/scripts/generate_docs.sh"
            }
        }
    ]
}

除了 shell 命令之外，Run Task 还支持运行 Sublime Text 窗口命令。例如，对于一个要启动终端的任务，可能会使用来自 Terminal 包的 open_terminal_project_folder 窗口命令。这可以通过以下任务定义实现

{
    "name": "Start Local Web Server",
    "type": "sublime",
    "command": "open_terminal_project_folder",
    "args": {
        "parameters": ["/C", ".\\Debug\\run-http-server.cmd"]
    }
}

这就是全部内容。您现在可以方便地从项目的任何位置访问自定义任务，无论是通过从命令面板运行运行任务命令，还是使用快捷键。

任务属性

运行任务支持以下任务属性和值

属性	是否必需	类型	值
name	是	字符串	任务在Sublime的快捷面板中显示的名称。
type	是	字符串	任务的类型。可以是`shell`或`sublime`。如果指定`shell`，则将`command`解释为要执行的shell命令。如果指定`sublime`，则将`command`解释为要执行的Sublime Text窗口命令。
command	是	字符串	要执行的命令。它必须是有效的shell命令或Sublime Text窗口命令名，具体取决于指定的`type`。为了使shell命令生效，指定的可执行文件必须在您的PATH中。
args	否	字符串、数组或对象	传递给`command`的参数。对于类型为`shell`的任务，它可以是字符串或数组。对于类型为`sublime`的任务，它必须是JSON对象。
windows	否	对象	Windows特定的`command`和`args`属性。如果指定，则当在Windows操作系统上执行任务时将使用提供的属性。
show_output_panel	否	布尔值	定义是否将`shell`任务输出打印到Sublime的输出面板。

变量替换

运行任务支持shell类型的任务变量替换。可替换变量可以用在任务定义的command和args属性中。

支持的变量

变量	替换值
cwd	工作区目录路径。

示例

{
    "name": "Variable Substitution Test",
    "type": "shell",
    "command": "./Debug/script.sh",
    "args": ["CWD:", "${cwd}"],
    "windows": {
        "command": "${cwd}\\Debug\\script.cmd",
        "args": ["CWD:", "${cwd}"]
    }
}

快捷键

此软件包包含一些预定义的键盘快捷键。您始终可以通过首选项 → 软件包设置 → 运行任务 → 快捷键来配置自己的快捷键。

命令	Linux & Windows	macOS
运行任务	`Ctrl`+`Alt`+`R`	`Ctrl`+`Option`+`R`

鸣谢

运行任务的功能在很大程度上受到Visual Studio Code Tasks的启发。

许可

该项目受MIT许可证的许可。有关详细信息，请参阅LICENSE文件。