ADMB Project

ADMB-11.2pre
Released December 9, 2014

Describe ADMB build and installation procedures for Windows and MinGW.

For Windows computers with Visual C++ compiler already installed, read and follow the instuctions in QuickStart for Visual C++.

For builds within Cygwin and MinGW-Msys shells, read and follow the instructions in the QuickStart for Unix.

Quick Start

Open Command Prompt window
Note — 32 or 64 bit Command Prompt is required.
Download ADMB

A installed Subversion Client is needed to download from ADMB source version control.

Note — SlikSVN is a command line Subversion Client.

To get the most current code, use the command below.
```
C:\> svn checkout http://www.admb-project.org/svn/trunk admb
```
This will copy admb trunk folder to C:\admb\ .

If unable to checkout code, download the full source distribution.

Double click downloaded zip file and extract to C:\admb\ .
Change to admb directory
```
C:\> cd admb
```
Install C++ compiler

If a C++ compiler has been installed such as MinGW, MinGW-w64, Cygwin or Rtools and is in the System Enviroment PATH, skip this step and go to the next step.

If C++ compiler has not been installed, use the command below to download and install the MinGW C++ Compiler to the C:\admb\utilities\mingw folder.
```
C:\admb\> utilities\get-mingw.bat
```
Downloads from MinGW website, then installs to the local computer. This will also update existing MinGW installation.
Build ADMB

If MinGW was installed with get-mingw.bat, use the command below.
```
C:\admb\> utilities\make
```
If debug symbols are needed, use the command below.
```
C:\admb\> utilities\make debug
```
If Rtools was installed and is included in System Enviroment PATH, use the command below.
```
C:\admb\> utilities\make
```
Note — Do not use the make utility from Rtools because it is a older version which is incompatible with the current ADMB build files.

To build 64 bit with Rtools, use the command below
```
C:\admb\> utilities\make CXXFLAGS=-m64 LDFLAGS=-m64
```
If MinGW-Msys was installed and is included in System Enviroment PATH, use the command below.
```
C:\admb\> make
```
Note — When completed, C:\admb\build\dist is the binary distribution directory.

Use ADMB

The following commands build and run the simple example.

C:\admb\> cd examples\admb\simple
C:\admb\examples\admb\simple\> C:\admb\admb simple.tpl
C:\admb\examples\admb\simple\> simple.exe

Optional — Installation

Add the admb directory to the system PATH to avoid typing the directory when calling the admb script.
1. In the System Properties window, click on the Enviroment Variables button.
2. In the Enviroment Variables window, click on the New button, then in the Variable name input type PATH and in the Variable value input type C:\admb\;%PATH%.
3. Click the OK button when done and open a new command prompt.
```
C:\admb\> cd examples\admb\simple
C:\admb\examples\admb\simple\> admb simple.tpl
C:\admb\examples\admb\simple\> simple.exe
```

For help and support, contact users@admb-project.org.

$Id: QuickStartWindowsSource.txt 2775 2014-12-09 20:00:45Z johnoel $