.. _platformio:

PlatformIO
##########

:link_to_translation:`en:[English]`

.. image:: ../../_static/platformio-logo.png
  :target: https://platformio.org/?utm_source=docs.espressif.com

.. contents::
    :local:

什么是 PlatformIO？
~~~~~~~~~~~~~~~~~~~

`PlatformIO <https://platformio.org/?utm_source=docs.espressif.com>`__
是一个跨平台的嵌入式开发环境，能直接支持 ESP-IDF。

由于 PlatformIO 对 ESP-IDF 的支持并非由 Espressif 团队维护，
如果遇到 PlatformIO 相关的问题，请通过 `官方 PlatformIO 库 <https://github.com/platformio>`_ 联系其开发人员。

要了解关于 PlatformIO 生态系统及其理念的详细概述，请参考
`官方 PlatformIO 文档 <https://docs.platformio.org/en/latest/what-is-platformio.html?utm_source=docs.espressif.com>`_。

安装
~~~~~~~~~~~~

* `PlatformIO IDE <https://platformio.org/platformio-ide?utm_source=docs.espressif.com>`_ 是一个可在 Windows，macOS 和 Linux 平台上使用的嵌入式 C/C++ 开发工具集。
* `PlatformIO Core (CLI) <https://docs.platformio.org/en/latest/core/index.html?utm_source=docs.espressif.com>`_ 是一个命令行工具，包含多平台编译系统，平台和库管理器以及其他集成组件。它可以与各种代码开发环境一起使用，还可以集成云平台和网络服务。

配置
~~~~~~~~~~~~~

请参阅 `PlatformIO 官方的 ESP-IDF 配置指南 <https://docs.platformio.org/en/latest/frameworks/espidf.html?utm_source=docs.espressif.com#configuration>`_。

教程
~~~~~~~~~

- `ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis <https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html?utm_source=docs.espressif.com>`__

项目示例
~~~~~~~~~~~~~~~~

请参阅 `PlatformIO 官方文档 <https://docs.platformio.org/en/latest/frameworks/espidf.html?utm_source=docs.espressif.com#examples>`__ 中 ESP-IDF 相关内容。

更多内容
~~~~~~~~~~

访问以下链接探索 PlatformIO 生态系统：

- 了解更多 `与其他 IDE 或文本编辑器集成 <https://docs.platformio.org/en/latest/integration/ide/index.html?utm_source=docs.espressif.com>`_ 的信息。
- 从 `PlatformIO 社区 <https://community.platformio.org/?utm_source=docs.espressif.com>`__ 获取帮助。
