alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2025-08-07 20:00:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'feature/embed_generated_files' into 'master'

Browse Source 
cmake: allow embedding files to be dependent on a target

See merge request espressif/esp-idf!8535
This commit is contained in:
Angus Gratton
2020-08-04 14:39:49 +08:00
parent 59347d6a63 aed204ce6f
commit a9dd9e3017
2 changed files with 20 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/en/api-guides/build-system.rst
View File

@@ -832,6 +832,24 @@ Place this line after the ``project()`` line in your project CMakeLists.txt file
For an example of using this technique, see :example:`protocols/https_request` - the certificate file contents are loaded from the text .pem file at compile time.
.. highlight:: cmake
It is also possible embed a generated file::
add_custom_command(OUTPUT my_processed_file.bin
COMMAND my_process_file_cmd my_unprocessed_file.bin)
target_add_binary_data(my_target "my_processed_file.bin" BINARY)
In the example above, ``my_processed_file.bin`` is generated from ``my_unprocessed_file.bin`` through some command ``my_process_file_cmd``, then embedded into the target.
To specify a dependence on a target, use the ``DEPENDS`` argument::
add_custom_target(my_process COMMAND ...)
target_add_binary_data(my_target "my_embed_file.bin" BINARY DEPENDS my_process)
The ``DEPENDS`` argument to ``target_add_binary_data`` ensures that the target executes first.
Code and Data Placements
------------------------