DVA 5 Build Instructions

Mac OS | Windows

The project is known to build on the following environments listed here: Microsoft-hosted agents

• windows-latest (Windows Server 2022)
• macos-latest (macOS 12 Monterey)
• ubuntu-latest (Ubuntu 22.04)

Mac OS

1. Download source archive:

   curl -OL https://github.com/jaboles/DVA5/archive/refs/heads/master.zip && unzip master.zip
   cd DVA5-master

2. The easiest way to install pre-requisite software tools is by using Homebrew, a package manager for Mac OSX. You may be prompted to install Apple developer tools. Click 'Install' at this point.

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Java Development Kit:

   brew install --cask temurin11

4. Apache Ant:

   brew install --ignore-dependencies ant

5. Fetch dependencies for build which includes:

   ant FetchDeps.Mac

   • JDK 17
   • Ant-Contrib
   • Protocol Buffers compiler to generate Java code from the TfNSW GTFS realtime specification
6. Build DVA:

   ant BuildMacDmg

7. Build outputs will be placed in build/Output:

   File	Description
   DVA.jar	DVA application (cross-platform)
   DVA.app	DVA application (Mac)
   DVA5.dmg.bz2	Mac disk image

Windows

1. Enable Powershell:

   Set-ExecutionPolicy unrestricted -s cu

2. Download source archive:

   (new-object net.webclient).downloadfile("https://github.com/jaboles/DVA5/archive/refs/heads/master.zip", "$env:USERPROFILE\DVAmaster.zip");
   Add-Type -as System.IO.Compression.FileSystem
   [System.IO.Compression.ZipFile]::ExtractToDirectory("$env:USERPROFILE\DVAmaster.zip", "$env:USERPROFILE")
   cd "$env:USERPROFILE\DVA5-master"

3. Scoop, a command-line installer for Windows:

   iex (new-object net.webclient).downloadstring('https://get.scoop.sh')

4. Java Development Kit:

   scoop install git
   scoop bucket add java
   scoop install temurin11-jdk

5. Apache Ant:

   scoop install ant

6. The following additional tools which you can install using:

   ant FetchDeps.Windows

   • JDK 17
   • Ant-Contrib
   • Resource Hacker
   • WinRun4J
   • Protocol Buffers compiler to generate Java code from the TfNSW GTFS realtime specification
   • Inno Setup
7. Build DVA:

   ant BuildWinSetup

8. Build outputs will be placed in build/Output:

   File	Description
   DVA.jar	DVA application (cross-platform)
   DVA.app	DVA application (Mac)
   win\i386\DVA.exe, DVA.scr	DVA application and screensaver (Windows, 32-bit)
   win\amd64\DVA.exe, DVA.scr	DVA application and screensaver (Windows, 64-bit)
   DVA5Setup.exe	Windows installer