Enable reproducible builds for ESP32 platform

Use reproducible builds for ESP32 platform so that locally build binaries will be an exact match
of release binaries for the same tag. Error message line info will start from the source path,
trimming any diectories leading up to it. SHA256 sums of binaries built from release tags should be
an exact match of release binaries.

Signed-off-by: Winford <[email protected]>

Author: UncleGrumpy

CHANGELOG.md

@@ -87,6 +87,7 @@ instead `badarg`.
 - ESP32 Elixir support is determined automatically from the offset of `boot.avm` in the partiton
 table.
 - ESP32 ports now flash a complete working image using the `idf.py flash` task.
+- ESP32 platform now uses reproducible builds.
 
 ### Fixed
 

doc/src/programmers-guide.md

@@ -163,6 +163,22 @@ Deployment of the AtomVM virtual machine and an AtomVM application currently req
 
 For more information about deploying the AtomVM image and AtomVM applications to your device, see the [Getting Started Guide](./getting-started-guide.md)
 
+```note
+The ESP32 platform uses reproducible builds, this has an effect when doing advanced debugging with
+GDB because paths are altered to strip away leading paths that are substituted with the following
+placeholders:
+
+* Path to ESP-IDF is replaced with /IDF
+* Path to the project is replaced with /IDF_PROJECT
+* Path to the build directory is replaced with /IDF_BUILD
+* Paths to components are replaced with /COMPONENT_NAME_DIR (where NAME is the name of the
+component)
+
+For information on how to configure GDB for debugging reproducible builds consult the ESP-IDF
+documentation about
+[Reproducible Builds and Debugging](https://docs.espressif.com/projects/esp-idf/en/v5.5/esp32/api-guides/reproducible-builds.html#reproducible-builds-and-debugging).
+```
+
 ## Applications
 
 An AtomVM application is a collection of BEAM files, aggregated into an AtomVM "Packbeam" (`.avm`) file, and typically deployed (flashed) to some device.  These BEAM files be be compiled from Erlang, Elixir, or any other language that targets the Erlang VM.
@@ -1582,7 +1598,7 @@ The read options take the form of a proplist, if the key `raw` is true (`{raw, t
 
 If the key `voltage` is true (or simply appears in the list as an atom), then a calibrated voltage value will be returned in millivolts in the second element of the returned tuple.  Otherwise, this element will be the atom `undefined`.
 
-You may specify the number of samples (1 - 100000) to be taken and averaged over using the tuple `{samples, Samples :: 1..100000}`, the default is `64`. 
+You may specify the number of samples (1 - 100000) to be taken and averaged over using the tuple `{samples, Samples :: 1..100000}`, the default is `64`.
 
 ```{warning}
 Using a large number of samples can significantly increase the amount of time before a response, up to several seconds.

src/platforms/esp32/sdkconfig.defaults.in

@@ -4,3 +4,5 @@ CONFIG_MBEDTLS_ECP_FIXED_POINT_OPTIM=y
 CONFIG_LWIP_IPV6=n
 CONFIG_PARTITION_TABLE_CUSTOM_FILENAME="@AVM_PARTITION_TABLE_FILENAME@"
 CONFIG_PARTITION_TABLE_FILENAME="@AVM_PARTITION_TABLE_FILENAME@"
+CONFIG_APP_REPRODUCIBLE_BUILD=y
+

src/platforms/esp32/sdkconfig.release-defaults.in

@@ -6,3 +6,4 @@ CONFIG_COMPILER_OPTIMIZATION_ASSERTIONS_SILENT=y
 CONFIG_LWIP_IPV6=n
 CONFIG_PARTITION_TABLE_CUSTOM_FILENAME="@AVM_PARTITION_TABLE_FILENAME@"
 CONFIG_PARTITION_TABLE_FILENAME="@AVM_PARTITION_TABLE_FILENAME@"
+CONFIG_APP_REPRODUCIBLE_BUILD=y