update CN translation based on reviewers' comments

This commit is contained in:
daiziyan 2021-03-03 19:30:02 +08:00 committed by Angus Gratton
parent fdfef114ae
commit 5b6e62d2c4
3 changed files with 5 additions and 9 deletions

View File

@ -459,8 +459,6 @@ In this example, graphics_lib.o and logo.h will be generated in the current dire
Cosmetic Improvements
^^^^^^^^^^^^^^^^^^^^^
Because logo.h is a generated file, it needs to be cleaned when make clean is called which why it is added to the COMPONENT_EXTRA_CLEAN variable.
Adding logo.h to the ``graphics_lib.o`` dependencies causes it to be generated before ``graphics_lib.c`` is compiled.
If a a source file in another component included ``logo.h``, then this component's name would have to be added to the other component's ``COMPONENT_DEPENDS`` list to ensure that the components were built in-order.

View File

@ -220,7 +220,7 @@ ESP-IDF 搜索组件时,会按照 ``COMPONENT_DIRS`` 指定的顺序依次进
- ``CFLAGS`` 传递给 C 编译器的标志。根据项目设置已经定义一组默认的 ``CFLAGS``,可以通过 ``CFLAGS +=`` 来为组件添加特定的标志,也可以完全重写该变量(尽管不推荐这么做)。
- ``CPPFLAGS`` 传递给 C 预处理器的标志(用于 ``.c````.cpp````.S`` 文件)。根据项目设置已经定义一组默认的 ``CPPFLAGS`` ,可以通过 ``CPPFLAGS +=`` 来为组件添加特定的标志,也可以完全重写该变量(尽管不推荐这么做)。
- ``CXXFLAGS`` 传递给 C++ 编译器的标志。根据项目设置已经定义一组默认的 ``CXXFLAGS`` ,可以通过 ``CXXFLAGS +=`` 来为组件添加特定的标志,也可以完全重写该变量(尽管不推荐这么做)。
- ``COMPONENT_ADD_LDFRAGMENTS``: 链接器脚本生成功能的链接器片段文件的路径,请查看 :doc:`链接器脚本生成 <linker-script-generation>`.
- ``COMPONENT_ADD_LDFRAGMENTS``:链接器脚本生成功能的链接器片段文件的路径,请查看 :doc:`链接器脚本生成 <linker-script-generation>`.
如果要将编译标志应用于单个源文件,您可以将该源文件的目标规则覆盖,例如::
@ -280,7 +280,7 @@ ESP-IDF 构建系统会在命令行中添加以下 C 预处理定义:
以非交互的方式运行 Make
~~~~~~~~~~~~~~~~~~~~~~~
如果在运行 ``make`` 的时候不希望出现交互式提示例如在IDE或自动构建系统中可以将 ``BATCH_BUILD=1`` 添加到make的参数中或者将其设置为环境变量
如果在运行 ``make`` 的时候不希望出现交互式提示(例如:在 IDE 或自动构建系统中),可以将 ``BATCH_BUILD=1`` 添加到 make 的参数中(或者将其设置为环境变量)。
设置 ``BATCH_BUILD`` 意味着:
@ -436,7 +436,7 @@ Makefile.componentbuild
#We need font if either console or plot is enabled
$(call compile_only_if,$(or $(CONFIG_ENABLE_LCD_CONSOLE),$(CONFIG_ENABLE_LCD_PLOT)), font.o)
请注意使用 Make 或者函数来包含字体文件。其他的替换函数,比如 ``and````if`` 也适用于此处。也可以使用不在 menuconfig 中定义的变量ESP-IDF 使用默认的 Make 策略,将一个空的或者只包含空格的变量视为 false ,而其中任何非空格的比那辆都为 true 。
请注意使用 Make 或者函数来包含字体文件。其他的替换函数,比如 ``and````if`` 也适用于此处。也可以使用不在 menuconfig 中定义的变量ESP-IDF 使用默认的 Make 策略,判断一个空的或只包含空格的变量视为 false而其中任何非空格的变量都为 true 。
(注意:本文档的历史版本建议将目标文件添加到 ``COMPONENT_OBJS`` 中,虽然这仍然可行,但是只有当组件中的所有目标文件都明确命名时才会起作用,并且在 ``make clean`` 后并不会清除 make 中取消选择的目标文件)。
@ -459,8 +459,6 @@ Makefile.componentbuild
润色与改进
^^^^^^^^^^
Because logo.h is a generated file, it needs to be cleaned when make clean is called which why it is added to the COMPONENT_EXTRA_CLEAN variable.
将 logo.h 添加作为 ``graphics_lib.o`` 的依赖项会导致在编译 ``graphics_lib.c`` 之前先生成它。
如果另一个组件中的源文件需要使用 logo.h则必须将此组件的名称添加到另一个组件的 ``COMPONENT_DEPENDS`` 列表中,以确保组件按顺序编译。
@ -519,7 +517,7 @@ ESP-IDF 还支持自动生成链接脚本,它允许组件通过链接片段文
保存 flash 参数
~~~~~~~~~~~~~~~
在某些情况下,我们希望在没有 IDF 的情况下烧写目标板对于这种情况我们希望保存构建的二进制文件、esptool.py 和 esptool write_flash 命令的参数。可以简单编写一段脚本来保存二进制文件和 esptool.py并且使用命令 ``make print_flash_cmd`` 来查看烧写 flash 时的参数::
在某些情况下,我们希望在没有 IDF 的情况下烧写目标板对于这种情况我们希望保存构建的二进制文件、esptool.py 和 esptool write_flash 命令的参数。可以简单编写一段脚本来保存二进制文件和 esptool.py并且使用命令 ``make print_flash_cmd`` 来查看烧写 flash 时的参数::
--flash_mode dio --flash_freq 40m --flash_size detect 0x1000 bootloader/bootloader.bin 0x10000 example_app.bin 0x8000 partition_table_unit_test_app.bin

View File

@ -418,7 +418,7 @@ ESP-IDF 构建系统会在命令行中添加以下 C 预处理器定义:
- ``COMPONENT_REQUIRES````COMPONENT_PRIV_REQUIRES`` 的值不能依赖于任何配置选项(``CONFIG_xxx``),这是因为在配置加载之前,依赖关系就已经被展开。其它组件变量(比如 ``COMPONENT_SRCS````COMPONENT_ADD_INCLUDEDIRS``)可以依赖配置选择。
- 如果当前组件除了 ``COMPONENT_REQUIRES_COMMON`` 中设置的通用组件(比如 RTOS、libc 等)外,并不依赖其它组件,那么上述两个 ``REQUIRES`` 变量可以为空。
如果组件仅支持某些硬件目标(即依赖于特定的 ``IDF_TARGET``),则可以调用 ``require_idf_targets(NAMES...)`` CMake 函数来声明这个需求。在这种情况下,如果构建系统导入了不支持当前硬件目标的组件时就会报错
通用组件包括freertos、newlib、heap、log、soc、esp_rom、esp_common、xtensa/riscv、cxx
创建项目
--------