CodeGym 插件是什么,以及为什么你需要安装它?

这是一个特殊的软件组件,可以安装到 IntelliJ IDEA 开发环境中。它让你能够轻松完成 CodeGym 课程的任务:编写解决方案、进行验证、将你的代码与“正确”的比较等等。我们的插件会将你在任务中的进展同步到你的 CodeGym 账户。因此,你在 Web 平台和开发环境中的任务进展将会保持一致。

我们建议你尽早开始使用插件。它不仅能更便捷地完成复杂的任务,还能帮助你迅速熟悉流行的专业开发工具 —— IntelliJ IDEA。

安装和激活 CodeGym 插件的步骤

IntelliJ IDEA 的最低要求版本为 2023.1。该插件不支持较旧的版本。 你可以在这里下载最新版本的 IntelliJ IDEA Community Edition

你可以在你的 IDE 中直接从 JetBrains 插件市场下载 CodeGym 插件。

  1. 打开设置。Windows/Linux File - Settings, MacOS Intellij IDEA - Preferences。 然后点击弹出窗口侧边菜单中的 Plugins (插件) 部分。
  2. 打开 Marketplace (插件市场) 选项卡,然后在搜索栏中键入 codegym :
  3. 点击 Install (安装)。
  4. 重新启动 IntelliJ IDEA 以开始使用插件。
  5. 安装插件后,你会注意到界面稍微有所变化,并在顶部水平栏上看到一个 Log in (登录) 按钮。 点击后,你将看到登录窗口弹出,请在窗口中输入你的 Secret key (密钥):
  6. 你可以在 CodeGym 网站的 “设置” → “安全和登录” 部分找到密钥。

    成功登录后,CodeGym 项目和 CodeGym SDK 将自动开始下载,无需切换到其他版本。

  7. 要打开一个新任务,点击左侧垂直栏中的 Tasks (任务) 图标,然后点击左侧侧边栏中的任务卡片,在弹出窗口中点击 Open (打开):
  8. 你会看到弹出一个带有两个选项卡的窗口。其中一个显示任务条件,另一个选项卡 Solution (解决方案)是你输入代码的地方。就是这样!现在你已经准备好开始完成这个任务了。

  9. 输入你的解决方法。

    现在你可以将任务提交进行验证。点击 Validate (验证) 按钮:

插件已安装,你可以开始完成任务了。

重要提示:请你先在下方了解有关插件中新手模式的信息。

以下是关于使用插件的常见问题解答。

插件基本设置

如何在插件中切换浅色和深色主题?

点击位于顶部面板旁边的切换器,就在你的头像旁边。

如何同时完成多个任务的解决方案?

如果你想在切换任务标签时保持多个任务解决方案文件打开,请前往 Settings 菜单并取消激活 Close files when changing tasks 模式:

  • 如果该模式处于激活状态,切换任务时(通过点击另一个任务卡片),当前任务解决方案的文件将被关闭;
  • 如果你关闭该模式,当前任务解决方案的文件和新任务解决方案的文件都会在这个面板中保持打开,可以随意在它们之间切换。
如何在任务条件中更改字体大小?

打开 Settings 并在 Font size in the task condition 字段中选择所需字体大小。

如何在 IntelliJ IDEA 中关闭 CodeGym 插件?

点击你的个人资料图片,然后点击 Disable plugin。

如何在 IntelliJ IDEA 中完成课程任务?

如何使用任务过滤器?

登录你的帐户后,你会看到 CodeGym 项目中的课程任务。在左侧部分,有一个任务列表。在顶部面板上,有任务过滤器,可以帮助你对任务进行排序:

  • All ——显示所有的课程任务
  • New —— 显示可完成的新任务
  • In progress —— 显示正在进行的任务
  • Solved —— 显示已完成的任务
  • Unavailable —— 显示由于尚未达到的级别而不可用的任务。
任务为何无法打开?

确保你想打开的任务是可完成的(你必须解锁包含该任务的课程)。选择 New 或 In progress 过滤器以打开可用任务的列表。

任务列表或任务条件不见了 —— 如何找回?
  1. 点击左侧垂直栏上的 Tasks 以找回任务列表。
  2. 点击右侧垂直栏上的 Conditions 以找回任务窗口。
如何验证我的解决方案?

点击顶部栏上的 Validate:

如何查看任务的正确解决方案?

点击顶部面板上的 Solution 按钮。 正确的解决方案会显示在右边,而你当前的解决方案会显示在左边。

如何进入任务讨论/任务帮助部分?

点击顶部栏上的 Help

你可以选择其中的一个选项:

  • Discuss the task on the forum —— 进入任务评论区进行讨论;
  • Ask for help —— 进入帮助部分,查看有关任务的所有问题的主题;
  • Reset the task progress —— 如果你在代码中不小心删除了重要内容,或者对自己的解决方案感到困惑,你可以从头开始重新完成该任务。
如何在不进行任务验证的情况下运行解决方案?

点击顶部栏的 Run。这会执行你的解决方案代码,但不会验证解决方案。

如何调试我的解决方案?

点击顶部栏上的 Debug

如何获得改善解决方案代码风格的建议?

点击顶部栏上的 Analyze

如何更换任务?

你可以通过点击左侧栏中的任务卡片来更换任务。如果你想使用过滤器,请点击顶部栏上的 Select Task。

接下来,你将切换到任务选择模式,并可以使用可用的过滤器。

我之前在 CodeGym 网站上完成过任务。我的进度会在 IntelliJ IDEA 的插件中同步/显示吗?

是的。任务列表及其状态会在用户在插件中连续 5 分钟不活动后自动更新。此外,在每次验证任务后也会进行更新。因此,如果你在 Web 插件(在 CodeGym 网站上)中完成了一个任务,它也会显示在 IntelliJ IDEA 插件的已完成任务列表中。

如果你需要立即更新任务状态,请使用 Synchronize the tasks 命令:

如果你在 CodeGym 网站上解决了一些任务或者打开了一些新任务,你可能会需要这个功能。通过点击 Synchronize the tasks,你可以将网站和 IntelliJ IDEA 中的任务状态进行同步。

如何完成“游戏”部分的任务?

为了在“游戏”部分完成任务,我是否需要进行额外的安装?

不需要。我们插件中的游戏引擎已经改用 Swing 重新编写。因此,在插件中你已经有了完成这类任务所需的一切,无需进行任何额外的安装。

如何在“游戏”部分发布我的解决方案 (已完成的游戏)?

如果你决定实现 CodeGym 上的其中一个游戏项目,并希望将其发布供所有用户享受,也有一个专门的按钮。点击顶部栏上的 Publish 按钮就可以了。

插件中新手模式和专业模式的主要区别

Novice mode (新手模式) 是专为那些对 IntelliJ IDEA 和其他开发环境没有(或有限)经验的用户设计的简化版本。该模式“隐藏”了 IntelliJ IDEA 的一些功能,包括在 CodeGym 项目(课程任务)以外的其他项目中进行操作的能力。

该模式将防止你发生各种“误点击了不该点的地方”和“不小心删除了不该删除的东西”的意外事件。因此,在新手模式下,你只能完成 CodeGym 课程的任务。

如果你在新手模式下尝试在 IntelliJ IDEA 中打开其他项目,系统将自动将你返回到 CodeGym 项目。如果你想在其他项目上编码,请切换到专业模式。

在插件中如何在新手和专业模式之间切换?

你可以在你的账户 Settings 中更改模式。点击位于顶部栏左侧的头像,然后在下拉菜单中选择 Settings

新手模式是默认设置的。若要切换到专业模式,请关闭新手模式并点击 Save

插件中的 PRO (专业) 模式是什么?

专业模式下,你可以使用所有 IntelliJ IDEA 的工具和功能,包括完成 CodeGym 课程任务之外的其他项目:

在专业模式下,你会看到顶部和底部出现了包含 IDEA 命令和工具的工具栏。

请注意,完成任务时,你经常使用的主要命令(功能)在顶部面板中得到了重复,如图中所示。

在专业模式下如何隐藏导航栏?

点击设置(⚙️),取消 Show Plugin Navigation Bar。

在专业模式下,如何返回到 CodeGym 项目(任务)?

点击设置(⚙️),选择 Open Java course Project。然后,包含 CodeGym 任务的项目会自动打开。

这将帮助你删除所有项目文件并恢复项目的结构和 SDK(软件开发工具包)。

更新:2024 年 2 月 21 日