client build

Wiki ▸ Development Environment ▸ Client Build

Biobank client

Here are instructions to build the Biobank client for MS Windows, Mac OSX and Linux. A computer running Linux is required to install the software packages listed below. Ubuntu is recommended.

Development Environment

Ensure your computer has been set up to build clients by following these instructions.

Client branding

The Biobank client can be built to display a customized splash image during startup. At the moment the available splash images are for:

• CBSR
• HIMC

The instructions below state how to select the splash image.

Client build instructions

Follow these instructions to build the client on a Linux machine.

1. Ensure that the java.client.version.num in file build.properties has the correct version number.

2. Use the following command at the project's root directory to build the client with the default branding (CBSR).

   ant product

   Or, if you would like to customize the client for HIMC use the following command:

   ant -Dclient.branding=stanford product

   This creates the following files in <proj_root>/product/buildDirectory/I.Product.

   BioBank-_version_-linux.gtk.x86_64.zip
   BioBank-_version_-linux.gtk.x86.zip
   BioBank-_version_-macosx.cocoa.x86_64.zip
   BioBank-_version_-macosx.cocoa.x86.zip
   BioBank-_version_-win32.win32.x86.zip

   Where _version_ matches the setting for java.client.version.num in build.properties.

3. Add the Microsoft Windows JRE to the win32 zip file using the following commands:

   cd <proj_root>/product/buildDirectory/I.Product
   mkdir BioBank
   cp -r  <ms_windows_jre> BioBank
   zip -r -g BioBank-_version_-win32.win32.x86.zip BioBank/jre
   rm -rf BioBank

   Where ms_windows_jre is the directory containing the MS Windows version of the JRE.

The ZIP files can now be placed where users can download the files.