Changes between Version 43 and Version 44 of BuildingTapWindows6


Ignore:
Timestamp:
04/19/19 11:04:39 (3 years ago)
Author:
Samuli Seppänen
Comment:

Add instructions on how to modify build properties in tap-windows6.vcxproj.in

Legend:

Unmodified
Added
Removed
Modified
  • BuildingTapWindows6

    v43 v44  
    3434
    3535In the documentation below it is assumed that all Windows commands are executed from within a Powershell session.
     36
     37= Modifying the Visual Studio project file =
     38
     39Many tap-windows6 build settings come from the Visual studio project file, src\tap-windows6.vcxproj. That file is generated by buildtap.py from src\tap-windows6.vcxproj.in.
     40
     41There does not seem to be any easily available reference for vcxproj files. This means that the safest and possibly the only realistic way to modify them is by using Visual Studio itself. The Visual Studio + WDK installation process is fairly well documented [https://docs.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk here], but for sake of completeness the requirements are:
     42
     43* Visual Studio 2019 Community
     44 * Install workload "Desktop Development with C++"
     45 * Install component "Windows 10 SDK"
     46* Windows Driver Kit (WDK)
     47 * Version must match that of "Windows 10 SDK"
     48* Copy of tap-windows6.vcxproj under src
     49 * This file can be generated elsewhere with buildtap.py and copied over to the Visual Studio computer
     50
     51After you've installed the above components launch Visual Studio 2019 and open tap-windows6.vcxproj file. Then you can modify the project properties as you want using the GUI. Your changes will not affect tap-windows6.vcxproj, but will create a new file called tap-windows6.vcxproj.user. Its contents look something like this:
     52
     53{{{
     54<?xml version="1.0" encoding="utf-8"?>
     55<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
     56  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
     57    <SignMode>TestSign</SignMode>
     58  </PropertyGroup>
     59  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
     60    <SignMode>Off</SignMode>
     61  </PropertyGroup>
     62</Project>
     63}}}
     64
     65Once you've figured out what the GUI does you can port those changes to tap-windows6.vcxproj.in and they will get applied to all subsequent builds.
    3666
    3767= Setting up the SMB share =