esp-idf/tools/windows/tool_setup
Ivan Grokhotkov f7cae13d2a tools: bump windows tools installer version to v2.1
Includes the following changes:

80ad09f23 allow changing the installation path
(a fix for https://github.com/espressif/esp-idf/issues/3806)

9c5284e7b verify that IDF_PATH doesn't contain spaces

aaf3dcbda fix quoting of IDF_TOOLS_PATH
(a fix for https://github.com/espressif/esp-idf/issues/3807)

e6e179294 tools: update idf_exe to 1.0.1
76dc87e9a idf_exe: fix NULL pointer passed to WriteFile
(fixes for https://github.com/espressif/esp-idf/issues/3740)
2019-09-24 06:00:31 +02:00
..
cmdlinerunner tools: Mass fixing of empty prototypes (for -Wstrict-prototypes) 2019-08-01 16:28:56 +07:00
.gitignore tools: new installer for Windows 2019-07-01 18:08:02 +02:00
README.md tools: update Windows installer build script 2019-09-24 06:00:31 +02:00
build_installer.sh tools: update Windows installer build script 2019-09-24 06:00:31 +02:00
choice_page.iss.inc tools: new installer for Windows 2019-07-01 18:08:02 +02:00
cmdline_page.iss.inc tools: new installer for Windows 2019-07-01 18:08:02 +02:00
git_find_installed.iss.inc tools: new installer for Windows 2019-07-01 18:08:02 +02:00
git_page.iss.inc tools: new installer for Windows 2019-07-01 18:08:02 +02:00
idf_cmd_init.bat tools: installer: fix quoting of IDF_TOOLS_PATH 2019-07-22 09:29:49 +02:00
idf_download_page.iss.inc tools: installer: verify that IDF_PATH doesn't contain spaces 2019-07-22 09:29:49 +02:00
idf_page.iss.inc tools: installer: verify that IDF_PATH doesn't contain spaces 2019-07-22 09:29:49 +02:00
idf_setup.iss.inc Installer: support for WD exclusions (IDF Tools) 2019-09-23 14:42:32 +02:00
idf_tool_setup.iss tools: bump windows tools installer version to v2.1 2019-09-24 06:00:31 +02:00
license.txt windows: Add License (GPL) display to IDF Tools installer 2018-10-18 09:56:16 +11:00
main.iss.inc Installer: support for WD exclusions (IDF Tools) 2019-09-23 14:42:32 +02:00
python_find_installed.iss.inc tools: new installer for Windows 2019-07-01 18:08:02 +02:00
python_page.iss.inc tools: new installer for Windows 2019-07-01 18:08:02 +02:00
sign_installer.sh tools: update Windows installer build script 2019-09-24 06:00:31 +02:00
summary.iss.inc tools: new installer for Windows 2019-07-01 18:08:02 +02:00
tools_WD_clean.ps1 Installer: support for WD exclusions (IDF Tools) 2019-09-23 14:42:32 +02:00
tools_WD_excl.ps1 Installer: support for WD exclusions (IDF Tools) 2019-09-23 14:42:32 +02:00
tools_fallback.json tools: update idf_exe to 1.0.1 2019-07-09 14:15:09 +02:00
utils.iss.inc tools: new installer for Windows 2019-07-01 18:08:02 +02:00

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.

Building the installer

In Docker

This uses wine-innosetup Docker image and build_installer.sh script. This is how the installer is built in CI.

docker run --rm -v $IDF_PATH:/idf -w /idf/tools/windows/tool_setup -it $CI_DOCKER_REGISTRY/wine-innosetup:1 /bin/bash build_installer.sh

Manually, step by step

  • Build cmdlinerunner DLL.

    • On Linux/Mac, install mingw-w64 toolchain (i686-w64-mingw32-gcc). Then build the DLL using CMake:
      mkdir -p cmdlinerunner/build
      cd cmdlinerunner/build
      cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-i686-w64-mingw32.cmake -DCMAKE_BUILD_TYPE=Release ..
      cmake --build .
      
      This will produce 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.
  • Download 7zip.exe ("standalone console version") and put it into unzip directory (to get unzip/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 use install.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.

Signing the installer

  • Obtain the signing key (e.g key.pem) and the certificate chain (e.g. certchain.pem). Set the environment variables to point to these files:

    • export KEYFILE=key.pem
    • export CERTCHAIN=certchain.pem
  • Run sign_installer.sh script. This will ask for the key.pem password, and produce the signed installer in the Output directory. If you plan to run the script multiple times, you may also set KEYPASSWORD environment variable to the key.pem password, to avoid the prompt.