从 ESP-IDF 中移出或弃用的组件
================================
移至 IDF Component Registry 的组件
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
以下组件已经从 ESP-IDF 中迁出至 `IDF Component Registry `_：
* `libsodium `_
* `cbor `_
* `jsmn `_
* `esp_modem `_
* `nghttp `_
* `mdns `_
* `esp_websocket_client `_
* `asio `_
* `freemodbus `_
* `sh2lib `_
* `expat `_
* `coap `_
.. note::
请注意，http 解析功能以前属于 ``nghttp`` 组件一部分，但现在属于 :component:`http_parser ` 组件。
可使用 ``idf.py add-dependency`` 命令安装以上组件。
例如，要安装 X.Y 版本的 libsodium 组件，请运行：``idf.py add-dependency libsodium==X.Y``。
根据 `semver `_ 规则安装与 X.Y 兼容的最新版本 libsodium 组件，请运行 ``idf.py add-dependency libsodium~X.Y``。
可前往 https://components.espressif.com 查询每个组件有哪些版本，按名称搜索该组件，组件页面上会列出所有版本。
弃用的组件
^^^^^^^^^^^^^^^^^^^^^
IDF v4.x 版本中已不再使用以下组件，这些组件已弃用：
* ``tcpip_adapter``。可使用 :doc:`ESP-NETIF ` 组件代替，具体可参考 :ref:`tcpip-adapter`。
.. note::
不再支持 OpenSSL-API 组件。IDF Component Registry 中也没有该组件。请直接使用 :doc:`ESP-TLS ` 或 :component:`mbedtls` API。
版本更新后无需目标组件，因此以下目标组件也已经从 ESP-IDF 中删除：
* ``esp32``
* ``esp32s2``
* ``esp32s3``
* ``esp32c2``
* ``esp32c3``
* ``esp32h2``