Agar

   <-- Back to Documentation

Installing Agar on MacOS X

This guide describes how to install and use the Agar library under Mac OS X. You can develop Agar applications using either Xcode or the command-line.

Compiling the Agar library

The following section describes the preferred method for compiling Agar from source on MacOS X.

Prerequisites

Your system should have an Xcode package installed (with Xcode "Command Line Tools" included). Start up Xcode, click on "Xcode / Preferences" and bring the "Downloads" tab forward. Click on the "Install" button right of "Command Line Tools". The download may take some time.

On MacOS X the cocoa driver is the one used by default. The sdlfb and sdlgl drivers are made available if the SDL 1.2.x library or SDL framework can be found.

Compilation/Installation Procedure

First download the Agar source package and unpack it to a temporary location:

  $ tar -xzf agar-1.6.0.tar.gz
  $ cd agar-1.6.0

Then configure and compile the sources. There are a number of build options available (see ./configure --help) but the defaults should be fine unless you have specific requirements.

  • --enable-debug is recommended for developer use since it enables (expensive) run-time assertions and type safety checks.
  • If thread safety is not required, --disable-threads will improve performance.
  $ ./configure --prefix=$HOME      # install in some alternate location
  $ ./configure --enable-debug      # debugging features (expensive)
  $ ./configure --disable-threads   # if multithreading is not needed

  $ make

Finally, install the library. This will install under the /usr/local by default (you can use the configure option --prefix to install to an alternate location).

  # make install
Testing Agar (hello world)

You can test that Agar is working using a simple hello.c program like so:

  #include <agar/core.h>
  #include <agar/gui.h>
  
  int
  main(int argc, char *argv)
  {
          AG_Window *win;
          
          if (AG_InitCore(NULL, 0) == -1 ||
              AG_InitGraphics(0) == -1) {
		fprintf(stderr, "Init failed: %s\n", AG_GetError());
		return (1);
	  }
          win = AG_WindowNew(0);
          AG_LabelNew(win, 0, "Hello, world!");
          AG_WindowShow(win);
          AG_EventLoop();
          return (0);
  }

Compile this example using:

  $ cc -o hello `agar-config --cflags` hello.c `agar-config --libs`
Running agartest (interactive test suite)

The tests directory contains an interactive test suite named agartest:

  $ cd tests
  $ ./configure && make

  $ open agartest.app
Csoft.net ElectronTubeStore