在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

IntelliJ IDEA是Java语言开发的集成环境,IntelliJ在业界被公认为优秀的Java开发工具之一,尤其在智能代码助手、代码自动提示、重构、J2EE支持、Ant、JUnit、CVS整合、代码审查、 创新的GUI设计等方面的功能可以说是超常的。

点击下载IntelliJ IDEA最新试用版

像C/C++和其他本地语言一样,Rust包括对条件编译的支持。指示编译器在编译过程中是包含还是忽略一段代码的最常见方法是添加一个带有所需条件的cfg属性。例如,您可以使用这种机制来检查目标架构,并根据操作系统在编译时切换代码块。

IntelliJ Rust会检测您项目中的条件禁用块,并将其从代码库中排除。这意味着名称解析和分析会忽略这些块,所以你不会在它们里面得到错误和警告,而且在自动完成中不会有该代码的项目出现在其他地方。另外,该插件在编辑器中把禁用的块灰化了。

这个级别的cfg支持在插件中已经有很长一段时间了,但是缺少了一些东西。条件选项可以包含Cargo功能。以前,IntelliJ Rust只支持项目依赖中声明的特性,但现在你的工作空间特性也被支持了。

我们已经实现了一个智能UI,使您的工作与特性更加透明:您可以直接在Cargo.toml文件中启用或禁用工作空间的任何特定特性。名称解析和代码洞察力会考虑到这一点。

让我们详细研究一下IntelliJ Rust如何处理Cargo特性,当它们在不同级别的依赖关系中使用时。

Library

最简单的情况是,您需要从库中排除功能,或者仅在构建中包括其中的一些功能。

首先,让我们添加tokio板条箱并使用以下full选项启用其所有功能:

 

tokio = { version = "0.3.0", features = ["full"] }

 

如果我们打开tokio的Cargo.toml并导航到该[features]部分,我们将在列出的所有功能旁边看到选中的复选框full:

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

现在我们可以来代替指定一个特定的功能full例如,signal。在tokio“ Cargo.toml”中,复选框的状态将相应更改。只有signal和它取决于功能现在已启用:

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

请注意,在外部依赖关系的情况下,此UI旨在帮助您掌握功能的状态,但不能控制它们,因此该库的Cargo.toml中的复选框不可单击。如果需要更改功能列表,请继续使用项目的.toml配置。

独立包装功能

另一种情况是,您在包内创建自己的功能部件并在cfg块中使用它们。与外部库不同,您可以在此处通过清除并选中相应的复选框来控制功能列表。

通常,Cargo功能是可加的,并且全部启用时不会冲突,这就是IntelliJ Rust默认启用工作区功能的原因。但是,您可能需要打开和关闭它们,并且插件的UI将帮助您做到这一点!

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

当您将工作区功能用作切换器而不是添加实例时,切换工作区功能特别方便(例如,Amethyst库具有控制当前可调用的渲染引擎功能)。以前,您必须从Cargo.toml中手动删除不需要的功能才能将其关闭。

由于用户界面现在允许您轻松地在功能之间进行切换,因此请注意不要同时启用任何互斥的功能。该插件不会阻止您这样做,也不会显示警告,因为在.toml文件级别,该插件没有足够的信息来检测源中的潜在问题。

在下面,您可以看到同时启用非添加功能时源中报告的多重解决情况:

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

相互依赖的程序包功能

一个稍微棘手的情况是您的功能相互依赖时:

 

[features]
wrapper = ["calc"]
calc = ["core"]
core = []

 

如果您打开或关闭其中之一,则IntelliJ Rust将识别依赖关系并相应地切换相关功能。

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

具有跨箱依赖关系的功能

您的包裹功能也可以依赖于其他包装箱中的功能。让我们core从前面的示例中依赖于的macros功能tokio:

 

core = ["tokio/macros"]

 

切换到tokio的Cargo.toml,我们会注意到macros默认情况下禁用的方式如何在打开时启用core,而在关闭时再次core禁用:

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

工作区的功能

一个更复杂的场景是在由多个程序包组成的工作区中使用要素时。

举个简单的例子,让我们创建一个有两个包的工作空间--bar和foo。在foo的Cargo.toml中,我们可以声明对bar的依赖,并指定它使用bar中的一个名为bar_feature的特性。

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

在使用工作空间时,你可能想在里面开发一个单独的箱子,就像一个独立的实例一样。在这种情况下,你需要对箱子的功能进行控制,并能够在某一时刻禁用那些你不需要的功能。

那么,如果你关注bar,并故意禁用bar_feature,会发生什么?结果,foo中所有使用它的代码都不会被解析,而且你在foo中出现的错误可能会很棘手,找不到原因。

为了帮助你避免这些问题,IntelliJ Rust会检查你的工作空间依赖中的所需特性,并为它们提出快速修复建议。

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

最后,你的工作空间箱可以有相互依赖的特征。例如,foo中的foo_features依赖于bar_feature from bar。

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

在这里,当我们禁用时bar_feature,插件会foo_feature自动禁用。但是,当我们bar_feature重新打开时,foo_feature将不会启用,因此您需要手动撤回相关功能。

在不同级别的依赖关系中,IntelliJ Rust如何处理Cargo特性

如果您以前从未使用过此功能,建议您尝试一下。如果您希望我们进一步研究其他功能,请在评论中给我们留言。

好了这就是今天的内容了,如果今天的文章未解决你的需求,可点击获取更多免费教程。不要忘了在评论与我们分享您的想法和建议。