Skip to content

Latest commit

 

History

History
30 lines (22 loc) · 1.57 KB

Development.md

File metadata and controls

30 lines (22 loc) · 1.57 KB

Development Tips

Steps to Produce Release Mode Installers

  1. Install Visual Studio 2022 (C++ desktop development must be enabled).
  2. Clone this repo and switch to a release tag.
  3. Run restore.cmd to initialize.
  4. Run build.all.bat to build everything out.

The MSI files are artifacts\installers\Release\*.msi.

Steps to Set Up Local Development Environment

The steps to set up local debugging environment are (assume you are on Windows x64 with VS2022/IIS/HttpPlatformHandler v2 already installed),

  1. Clone this repo.
  2. Switch to a release tag (like httpplatformhandler_v9.0.2-rc.1).
  3. Ensure VS2022 latest version is installed and execute restore.cmd.
  4. Modify build.debug.bat to use the VS2022 edition you are using (Community or another), and execute it to build the debug bits.
  5. Stop IIS via iisreset /stop.
  6. Copy the files from artifacts\bin\AspNetCoreModuleShim\x64\Debug to %ProgramFiles%\IIS\HttpPlatformHandler Module\V2 and overwrite the release bits.
  7. Copy the files from artifacts\bin\OutOfProcessRequestHandler\x64\Debug to %ProgramFiles%\IIS\HttpPlatformHandler Module\V2\xx.0.xxxxx to replace the release bits.
  8. Start IIS via iisreset /start.
  9. Launch VS2022 and open src\Servers\IIS\IISIntegration.slnf.
  10. Launch your web app in IIS and attach VS2022 debugger to the proper w3wp.exe process.
  11. Set breakpoints in the code base to debug around.

Typical Locations to Debug

  • Breakpoints in src/Servers/IIS/AspNetCoreModuleV2/OutOfProcessRequestHandler/forwardinghandler.cpp can be used to debug the actual token being passed.