文档首页/ CodeArts IDE/ 用户指南/ Java/ 启动配置/ 简介
更新时间：2024-04-12 GMT+08:00
查看PDF
分享

简介

启动配置允许您配置和保存各种场景的运行或调试设置详细信息。CodeArts IDE将配置信息保存在项目根文件夹下的.arts文件夹中的launch.json文件中。

在Java环境中，可以使用以下配置模板：

要创建launch.json文件，请在CodeArts IDE主工具栏上的列表中选择“打开launch.json”。

CodeArts IDE尝试自动检测您的调试环境，但如果失败，您将需要手动选择。在Java环境中，选择Java Debug。

CodeArts IDE创建一个launch.json文件，并根据检测到的环境填充默认内容。请检查所有自动生成的值，确保它们适用于您的项目和调试环境。

在launch.json中定义的所有启动配置都可以从CodeArts IDE主工具栏上的列表中选择。

向现有的launch.json添加新的配置

  1. 执行以下任一操作：

    • 在launch.json编辑器中，单击编辑器右下角的 Add Configuration按钮，或将光标放置在configurations数组内，并使用代码完成（“Ctrl+I” / “Ctrl+Space” / “Ctrl+Shift+Space”（IDEA键盘映射））。
    • 在CodeArts IDE主工具栏上的配置列表中选择Add Configuration。

  2. 在弹出的建议列表中，选择要使用的启动配置模板。

    在launch.json中，使用代码完成（“Ctrl+I” / “Ctrl+Space” / “Ctrl+Shift+Space”（IDEA键盘映射））查看可用属性及其值的列表。

变量替换

CodeArts IDE将常用路径和其他值作为变量提供，并支持在launch.json中的字符串中进行变量替换，因此您不必在启动配置中使用绝对路径。

支持以下预定义变量：

  • ${cwd} - CodeArts IDE启动时任务运行器的当前工作目录。
  • ${defaultBuildTask} - 默认构建任务的名称。
  • ${extensionInstallFolder} - 指定扩展安装的路径。
  • ${fileBasenameNoExtension} - 当前打开文件的无扩展名的基本名称。
  • ${fileBasename} - 当前打开文件的基本名称。
  • ${fileDirname} - 当前打开文件的目录名。
  • ${fileExtname} - 当前打开文件的扩展名。
  • ${file} - 当前打开的文件。
  • ${lineNumber} - 活动文件中当前选定的行号。
  • ${pathSeparator} - 操作系统用于分隔文件路径组件的字符。
  • ${relativeFileDirname} - 相对于workspaceFolder的当前打开文件的目录名。
  • ${relativeFile} - 相对于workspaceFolder的当前打开文件。
  • ${selectedText} - 活动文件中当前选定的文本。
  • ${workspaceFolderBasename} - 在CodeArts IDE中打开的文件夹的名称，不包含任何斜杠（/）。
  • ${workspaceFolder} - 在CodeArts IDE中打开的文件夹的路径。

临时和永久启动配置

当您从编辑器边栏手动运行类或方法时，CodeArts IDE会自动创建相应的启动配置，并在配置列表中显示。这些配置默认为临时配置：CodeArts IDE根据指定的限制（默认为10）保留它们的数量，并在超过此限制时自动删除最少使用的配置。

将临时启动配置保存为永久配置

您可以将临时启动配置保存为永久配置，以防止其被删除。

  1. 在CodeArts IDE主工具栏上的配置列表中，选择Edit Configuration。

  2. 在打开的Debug Configuration中，在左侧的配置列表中，选择要保存为永久配置的配置。然后，在配置参数中，将Temporary切换为False。

或者，您可以在launch.json中找到相应的启动配置记录，并为其提供"temporary": false顶级属性，例如：

{
   "type": "javadbg",
   "name": "Java Class",
   "request": "launch",
   "mainClass": {
      "name": "com.example.Main",
      "console": "integrated"
   },
   "temporary": false
}

调整临时启动配置的限制

默认情况下，CodeArts IDE根据指定的限制（默认为10）保留临时启动配置的数量，并在超过限制时自动删除最少使用的配置。如果需要，您可以通过java.executedConfigurationsLimit设置来调整此限制。如果设置为零，CodeArts IDE不会创建任何临时启动配置，并删除任何现有的临时启动配置。

父主题： 启动配置

相关文档