Building / Release ghostdocs for Android under Windows

Setup

install doxygen: [ used to generate html documentation for external api ]
grab it from http://ftp.stack.nl/pub/users/dimitri/doxygen-1.8.6-setup.exe

install graphviz: [ for the ‘dot’ binary, used to generate graphics for the documentation ]
port install graphviz

install Xcode version 4.6.3, and use xcode-select to ensure that is the active version for command line builds - and also make sure it’s called /Applications/Xcode.App as that path is hardcoded in some places

ensure cvs uses ssh; add this to your .bashrc or equivalent:
export CVS_RSH=ssh

Build Procedure

Get the release tracking sheet:

cvs -d :ext:ghostscript.com:/home/robin/PicselCVS checkout docs/releases/Release_Tracking_Sheet.xls

Add your entry to the end

Commit spreadsheet to cvs

Checkout epage:
git clone ghostscript.com:/home/git-private/sot.git

checkout correct tag etc

get release command from spreadsheet

add setvers onto end of build command, eg:

--setvers '{customer:Vaultize i8089@issue:8089@version:2.1.28.1@sdate:15/03/2014}'

[Note how the issue number is put after the customer name, and that the date is in UK format.]

Broken down:

1. customer: customer name; possibly may be displayed on splashscreen; at least for iOS builds we add the issue number too to ensure it's displayed on the splashscreen (I think)
2. issue: should match the issue number in the spreadsheet
3. version: should match spreadsheet
4. sdate: Start date for the build. UK format. Use today's date normally. It is not checked unless edate is set.
5. Optional: edate: If this is set, the end date - the build will refuse to start if started after this date, or before the sdate. Set only for evaluation builds.

run release command… wait…

find the generated zip file; it’s probably on the first line of output from:
./scripts/showbuild.py

Testflight builds

Setup as per above.

Install the artifex iOS distribution private key (~joseph on casper); ask Joseph for password.

Fetch the latest provisioning profile from the artifex iOS develop account (ie. add the account under xcode preferences if necessary, and then hit 'refresh').

Run:

./scripts/release.py appstore-ios-so

Run ./scripts/showbuild.py to find the the ipa file, and drag it onto the testflight app.

-- Joseph Heenan - 2014-03-27

Comments