Changes between Version 62 and Version 63 of Windows build instructions

Timestamp:

Jun 9, 2017 3:54:30 PM (7 years ago)

Author:

Frank Mehnert

Comment:

--

Windows build instructions

@@ -95 +95 @@
  ''Use `VBOX_WIX_PATH=PATH` in `LocalConfig.kmk` to set the path to this package.''
 
- * ''Optional:'' '''WiSumInf.vbs SDK script''', only needed if you want to package !VirtualBox. The required script is `sdk-v7.1\Samples\sysmgmt\msi\scripts\WiSumInf.vbs` (see SDK prerequisite above) [[BR]]
+ * ''Optional:'' '''WiSumInf.vbs SDK script''', only needed if you want to package !VirtualBox. The required script is[[BR]]
+ `sdk-v7.1\Samples\sysmgmt\msi\scripts\WiSumInf.vbs` (see SDK 7.1 prerequisite above) [[BR]]
  ''Use `VBOX_PATH_WISUMINFO=...WiSumInf.vbs` in `LocalConfig.kmk` to set the path to this script.''
 
@@ -133 +134 @@
 
  5. To create an `.msi` package, type `kmk packing'.[[BR]]
- This step will fail for a 64-bit (`amd64`) target if the Guest Additions are part of the build process (which is the default). It will complain about a dependency to `VBoxOGL*` libraries in `out\win.x86\release\bin\additions`. In that case, create the 32-bit Guest Additions by executing
+ This step will fail for a 64-bit (`amd64`) target if the Guest Additions are part of the build process (which is the default, disable by adding `VBOX_WITH_ADDITIONS=` and `VBOX_WITH_ADDITIONS_PACKING=` to `LocalConfig.kmk`, see [#LocalConfig below]). It will complain about a dependency to `VBoxOGL*` libraries in `out\win.x86\release\bin\additions`. In that case, create the 32-bit Guest Additions by executing
 {{{
 kmk VBOX_ONLY_ADDITIONS=1 KBUILD_TARGET_ARCH=x86
@@ -151 +152 @@
 === Excluding certain features from building === #LocalConfig
 
-Here is an incomplete list of settings which could be added to '''`LocalConfig.kmk`''':
+Here is an incomplete list of settings which could be added to '''`LocalConfig.kmk`''' to prevent certain features from building / packing:
  VBOX_WITH_ADDITIONS=::
-  Don't build + package the !VirtualBox Guest Additions.
+ VBOX_WITH_ADDITIONS_PACKING=::
+  Don't build + package the !VirtualBox Guest Additions. If only `VBOX_WITH_ADDITIONS=` is specified then the Guest Additions are not built but the `VBoxGuestAdditions.iso` file is expected to be present in the '`out\win.ARCH\release\bin\additions`' directory.
  VBOX_ONLY_ADDITIONS=1::
   Build the Guest Additions exclusively.
  VBOX_WITH_VALIDATIONKIT=::
-  Don't build + package the !VirtualBVox validation kit. The validation kit is not part of the final `.msi` package anyway.
+  Don't build + package the !VirtualBox validation kit. The validation kit is not part of the final `.msi` package anyway.
  VBOX_WITH_WEBSERVICES=::
   Don't build + package the webservices API server.