![]() Installation path can now be changed in a subsequent install, without uninstalling and logging out. The default value of the installation path is set to IDF_TOOLS_PATH environment variable, if it was already set by the previous installation, or by the user. Closes https://github.com/espressif/esp-idf/issues/3806 |
||
---|---|---|
.. | ||
cmdlinerunner | ||
.gitignore | ||
README.md | ||
build_installer.sh | ||
choice_page.iss.inc | ||
cmdline_page.iss.inc | ||
git_find_installed.iss.inc | ||
git_page.iss.inc | ||
idf_cmd_init.bat | ||
idf_download_page.iss.inc | ||
idf_page.iss.inc | ||
idf_setup.iss.inc | ||
idf_tool_setup.iss | ||
license.txt | ||
main.iss.inc | ||
python_find_installed.iss.inc | ||
python_page.iss.inc | ||
summary.iss.inc | ||
tools_fallback.json | ||
utils.iss.inc |
README.md
ESP-IDF Tools Installer for Windows
This directory contains source files required to build the tools installer for Windows.
The installer is built using Inno Setup. At the time of writing, the installer can be built with Inno Setup version 6.0.2.
The main source file of the installer is idf_tools_setup.iss
. PascalScript code is split into multiple *.iss.inc
files.
Some functionality of the installer depends on additional programs:
-
Inno Download Plugin — used to download additional files during the installation.
-
7-zip — used to extract downloaded IDF archives.
-
cmdlinerunner — a helper DLL used to run external command line programs from the installer, capture live console output, and get the exit code.
Steps required to build the installer
-
Build cmdlinerunner DLL.
- On Linux/Mac, install mingw-w64 toolchain (
i686-w64-mingw32-gcc
). Then build the DLL using CMake:
This will producemkdir -p cmdlinerunner/build cd cmdlinerunner/build cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-i686-w64-mingw32.cmake -DCMAKE_BUILD_TYPE=Release .. cmake --build .
cmdlinerunner.dll
in the build directory. - On Windows, it is possible to build using Visual Studio, with CMake support installed. By default, VS produces build artifacts in some hard to find directory. You can adjust this in CmakeSettings.json file generated by VS.
- On Linux/Mac, install mingw-w64 toolchain (
-
Download 7zip.exe ("standalone console version") and put it into
unzip
directory (to getunzip/7za.exe
). -
Download idf_versions.txt and place it into the current directory. The installer will use it as a fallback, if it can not download idf_versions.txt at run time.
-
Create the
dist
directory and populate it with the tools which should be bundled with the installer. At the moment the easiest way to obtain it is to useinstall.sh
/install.bat
in IDF, and then copy the contents of$HOME/.espressif/dist
directory. If the directory is empty, the installer should still work, and the tools will be downloaded during the installation. -
Build the installer using Inno Setup Compiler:
ISCC.exe idf_tools_setup.iss
. -
Obtain the signing keys, then sign
Output/esp-idf-tools-setup-unsigned.exe
.