Changes between Version 59 and Version 60 of Windows build instructions

Timestamp:

Jun 9, 2017 3:21:48 PM (7 years ago)

Author:

Frank Mehnert

Comment:

--

Windows build instructions

@@ -59 +59 @@
 
  * ''Optional:'' '''NSIS 2.51''', only needed if you want to build the Guest Additions including the installer. Required plugins: `NsSCM`, `AccessContro`, `NsProcess` and `nsisunz`. Grab the sources or setup from: [[BR]]
- https://sourceforge.net/projects/nsis/files/NSIS%202/2.51/
+ https://sourceforge.net/projects/nsis/files/NSIS%202/2.51/ [[BR]]
+ ''Use '''`VBOX_PATH_NSIS`''' in `LocalConfig.kmk` to set the path to this package.
 
  * ''Optional:'' '''gSOAP 2.8.x''', only needed if you want to build the webservice API server. Grab the sources from: [[BR]]
  http://sourceforge.net/projects/gsoap2/files/gSOAP/gSOAP%202.7.12%20stable/ [[BR]]
- Add `VBOX_PATH_GSOAP=/path/to/gsoap-VERSION/gsoap` and `VBOX_GSOAP_INSTALLED=1` to your `LocalConfig.kmk` file (no autodetection from configure.vbs).
+ Add `VBOX_PATH_GSOAP=/path/to/gsoap-VERSION/gsoap` and `VBOX_GSOAP_INSTALLED=1` to your `LocalConfig.kmk` file (no autodetection from configure.vbs).[[BR]]
+ ''Add `VBOX_WITH_WEBSERVICES=` to `LocalConfig.kmk` to disable building + packing the webservice API server.''
 
  * ''Optional:'' '''Python 2.7.x''', only needed if you want to build Python API bindings, both webservice and COM. Grab the binaries from: [[BR]]
@@ -71 +73 @@
  * ''Optional:'' '''Java SE 6 JDK''', only needed if you want to build Java API bindings, both webservice and COM. Grab the binaries from: [[BR]]
  http://www.oracle.com/technetwork/java/javase/downloads/index.html
+
+ * ''Optional:'' '''AutoIt v3 3.2.10''', only needed if you want to package the Guest Additions. Grab the binaries from: [[BR]]
+ https://www.autoitscript.com/site/autoit/ [[BR]]
+ ''Use `VBOX_PATH_AUTOIT3=PATH` in `LocalConfig.kmk` to set the path to this package. `PATH` should contain the Aut2Exe directory.''
+
+ * ''Optional:'' '''Driver Install Frameworks (DIFx) 2.1''', only needed if you want to package the Guest Additions. See[[BR]]
+ https://support.microsoft.com/en-us/help/910189/information-about-updates-for-driver-install-frameworks-difx-tools [[BR]]
+ ''Use `VBOX_PATH_DIFX=PATH` in `LocalConfig.kmk` to set the path to this package.''
+
+ * ''Optional:'' '''`mkisofs.exe`''', only needed if you want to package the Guest Additions. Grab the package from[[BR]]
+ http://opensourcepack.blogspot.de/p/cdrtools.html [[BR]]
+ ''Use `VBOX_MKISOFS=PATH_TO_BINARY` in `LocalConfig.kmk` to set the path to the `mkisofs.exe` binary.''
+
+ * ''Optional:'' '''`zip.exe`''', only needed if you want to package the Validation Kit (disable with `VBOX_WITH_VALIDATIONKIT=` in `LocalConfig.kmk`). Grab the package from[[BR]]
+ http://gnuwin32.sourceforge.net/packages/zip.htm
+ ''Use `VBOX_ZIP=PATH` in `LocalConfig.kmk` to set the path to the `zip.exe` binary.''
+
+ * ''Optional:'' '''WIX toolset 3.8.1128''', only needed if you want to package !VirtualBox. Grab the binaries from [[BR]]
+ http://wixtoolset.org/releases/ [[BR]]
+ ''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]]
+ ''Use `VBOX_PATH_WISUMINFO=...WiSumInf.vbs` in `LocalConfig.kmk` to set the path to this script.''
 
 === Manual compilation of certain prerequisites ===
@@ -127 +152 @@
 Here is an incomplete list of settings which could be added to '''`LocalConfig.kmk`''':
  VBOX_WITH_ADDITIONS=::
-  Don't build the !VirtualBox Guest Additions.
+  Don't build + package the !VirtualBox Guest Additions.
  VBOX_ONLY_ADDITIONS=1::
   Build the Guest Additions exclusively.
  VBOX_WITH_VALIDATIONKIT=::
-  Don't build the !VirtualBVox validation kit.
+  Don't build + package the !VirtualBVox 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.
  VBOX_WITHOUT_HARDENING=1::
   Disable Windows hardening. Useful for testing. Do '''not''' use this setting for production builds! Without hardening the binaries are not signed and !VirtualBox.exe can be started straight away from the out\...\bin directory (`kmk packing` + installation not required).