mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
60 lines
2.4 KiB
ReStructuredText
60 lines
2.4 KiB
ReStructuredText
******************
|
|
ESP-IDF clang-tidy
|
|
******************
|
|
|
|
:link_to_translation:`en:[English]`
|
|
|
|
ESP-IDF clang-tidy 是使用 `clang-tidy <https://clang.llvm.org/extra/clang-tidy/>`__ 对当前应用程序进行静态分析的工具。
|
|
|
|
.. warning::
|
|
|
|
ESP-IDF clang-tidy 的功能及其依赖的工具链尚在开发中，最终版本发布前可能有重大变更。
|
|
|
|
.. only:: CONFIG_IDF_TARGET_ARCH_RISCV
|
|
|
|
.. warning::
|
|
|
|
当前工具尚不支持基于 RISC-V 的芯片。目前，乐鑫尚未针对 RISC-V 提供基于 clang 的工具链。
|
|
|
|
准备工作
|
|
=============
|
|
|
|
初次运行此工具时，请按照以下步骤准备该工具：
|
|
|
|
#. 运行导出脚本（如 ``export.sh``、``export.bat`` 等），设置环境变量。
|
|
#. 运行 ``pip install --upgrade pyclang`` 安装插件，其他命令将在 ``idf.py`` 中自动激活。
|
|
#. 运行 ``idf_tools.py install esp-clang`` 安装 clang-tidy 所需的二进制文件。
|
|
|
|
.. note::
|
|
|
|
该工具链尚在开发中，最终版本发布后，将无需手动安装工具链。
|
|
|
|
#. 从 `llvm 仓库 <https://github.com/llvm/llvm-project/blob/main/clang-tools-extra/clang-tidy/tool/run-clang-tidy.py>`__ 获取文件，并将该脚本所在的文件夹添加到 ``$PATH`` 中，或在调用 ``idf.py clang-check`` 时传递可选参数 ``--run-clang-tidy-py``。请将脚本设置为可执行。
|
|
|
|
.. note::
|
|
|
|
在未来工具链版本中，该文件将一并捆绑。目前为临时解决方案。
|
|
|
|
#. 再次运行导出脚本（如 ``export.sh``、``export.bat`` 等），刷新环境变量。
|
|
|
|
其他命令
|
|
==============
|
|
|
|
``clang-check``
|
|
---------------
|
|
|
|
运行 ``idf.py clang-check`` 可以重新生成编译数据库，并在当前项目文件夹下运行 ``clang-tidy``，所得输出写入 ``<project_dir>/warnings.txt``。
|
|
|
|
运行 ``idf.py clang-check --help`` 查看完整文档。
|
|
|
|
``clang-html-report``
|
|
---------------------
|
|
|
|
#. 运行 ``pip install codereport`` 安装附加依赖关系。
|
|
#. 运行 ``idf.py clang-html-report`` 会根据 ``warnings.txt`` 在 ``<project_dir>/html_report`` 文件夹内生成 HTML 报告。请在浏览器中打开 ``<project_dir>/html_report/index.html`` 查看报告。
|
|
|
|
错误报告
|
|
==========
|
|
|
|
此工具托管在 `espressif/clang-tidy-runner <https://github.com/espressif/clang-tidy-runner>`__。如遇到任何错误，或有任何功能请求，请通过 `Github issues <https://github.com/espressif/clang-tidy-runner/issues>`__ 提交报告。
|