前言


  1. ESP32 存在一个非常好的功能,就是组件库。我们只需要在 idf_component.yml 文件中加入相关组件名称即可立即使用。
  2. 而该组件写法多样,很容易让人弄的晕头转向,因此我这里做一个简单介绍。
  3.  The ESP Component Registry

正文

固定版本

  1. 如果写法如下,表示当前组件固定为 1.3.0 版本。
  2. 我个人建议使用该写法,因为如果组件在更新过程中引入的新的 bug 或者是部分函数名进行了调整,那么会导致工程在编写的当时可以正常运行,但过了一段时间后,你再次编译,会发现代码出现了莫名其妙的 bug,很可能并不是你代码有问题,而是最行的组件造成的版本不兼容。
espressif/esp_rainmaker: "1.3.0"
  • 1.

固定子版本

  1. 这种写法是会匹配到 1.3.x 版本的任何更新,但不包括 1.4.0 及更高的版本。例如,它可以匹配 1.3.1、1.3.2,但不会匹配 1.4.0。
  2. 如下两种写法效果是一样的,根据个人喜好来。
espressif/esp_rainmaker: "~1.3.0"
espressif/esp_rainmaker: "1.3.*"
  • 1.
  • 2.

固定最小子版本

  1. 这种写法是会匹配 1.x.x 中任何高于 1.3.0 的版本,但不会匹配 2.0.0 或更高的版本。比如,它可以安装 1.3.1、1.4.0 等等。
espressif/esp_rainmaker: "^1.3.0"
  • 1.

固定主版本

  1. 这种写法是会匹配所有 1.x.x 版本,不包括 2.0.0 及其之后版本。
  2. 它允许任何小版本或补丁版本的更新。
espressif/esp_rainmaker: "1.x'"
  • 1.

拉取最新版本

  1. 如下写法为拉取最新的版本。他将拥有最新的内容和补丁,但同时可能引入未知的不稳定因素。
  2. 如下两种写法效果一样。
espressif/esp_rainmaker: "*'"
espressif/esp_rainmaker: "latest"
  • 1.
  • 2.

设置版本范围

  1. 匹配大于 1.3.0 的任何版本。
espressif/esp_rainmaker: ">1.3.0"
  • 1.
  1. 匹配 1.3.0 及以上的任何版本。
espressif/esp_rainmaker: ">=1.3.0"
  • 1.
  1. 匹配小于 1.3.0 的任何版本。
espressif/esp_rainmaker: "<1.3.0"
  • 1.
  1. 匹配 1.3.0 及以下的任何版本。
espressif/esp_rainmaker: "<=1.3.0"
  • 1.
  1. 匹配从 1.3.0 到 3.0.0 之间的任何版本,包括边界。如下两种写法效果一样。
espressif/esp_rainmaker: "1.3.0 - 3.0.0"
espressif/esp_rainmaker: ">=1.3.0 <3.0.0"
  • 1.
  • 2.