Skip to content

Latest commit

 

History

History
55 lines (35 loc) · 3.15 KB

BUILDING.md

File metadata and controls

55 lines (35 loc) · 3.15 KB
Raw

To build Portable-VirtualBox from source do the following:

Prerequisites

Obtain and install the following free tools

Obtaining the source code

Check out the source code from GitHub. For example by using GitHub on Windows or use git from the command line like this:

git clone https://github.com/vboxme/Portable-VirtualBox.git

This will create a new folder named Portable-VirtualBox.

Making a new version with the build script

Run the build.bat script. The new version should appear in the build\release directory.

Making a new version manually

Compiling manually

  1. Go to the Start menu and select All programs -> AutoIt v3 -> Compile Script to .exe (x86)
  2. Use the browse functionality to set:
  • Source: Portable-VirtualBox\source\Portable-VirtualBox.au3
  • Destination: Portable-VirtualBox\Portable-VirtualBox.exe
  • Custom Icon: Portable-VirtualBox\source\VirtualBox.ico
  1. Click Convert

A new .exe file is created as Portable-VirtualBox.exe. This is Portable-VirtualBox and can be run from the Portable-VirtualBox folder.

Releasing manually

To make a release you also need to do the following:

  1. If you have run it in the Portable-VirtualBox folder delete the Portable-VirtualBox folder and do a new git clone and compile so its no junk in the data and app folders from previous runs
  2. Go back to the Portable-VirtualBox folder
  3. Right click on it and select 7zip -> Add to archive
  4. In the 7zip dialog select Self extracting archive (SFX) and click OK
  5. This will make a new .exe file named Portable-VirtualBox.exe
  6. Open the newly created Portable-VirtualBox.exe with Resource Hacker find the Icon Group->1->1033
  7. Use the Replace resource function to replace it with the icon at Portable-VirtualBox\source\VirtualBox.ico
  8. Save & exit

AutoIt version when distributing software

Portable-VirtualBox uses a great and powerful scripting language known as AutoIt. Unfortunately some virus creators also use AutoIt with malicious intent. Each time a new version of AutoIt is released some virus is quickly written in it, and some anti-virus vendor then manages to marks sets of instructions found in all AutoIt made software as malicious. This causes many legitimate programs to be accidently flagged as viruses (this is what is known as a false positive).

Eventually software makers complain and the anti-virus maker realize there mistakes. AutoIt gets cleared again. However this vicious cycle means that if you do not want to get any falsely virus warnings when distributing software that you have built it is best to use an older version of AutoIt. We recommend version 3.3.8.1 that was released in November 2012.

However if you for some reason want to use the newest version you can download it from http://www.autoitscript.com/site/autoit/downloads/ ( you need "AutoIt Full Installation" ).