ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
Compiling your application
Once Makefile.Windows is ready to compile your application, you can compile
from the command line by typing “nmake /f Makefile.Windows”.
Running your application
You can either invoke your application directly or through the makefile. If you
choose to invoke it directly, you will need to provide command-line parameters
from the command line. To use the makefile to run an ArcGIS Engine commandline
application, you must set up the command-line parameters in the makefile.
Update your makefile to include variables for each input parameter and a run
target.
An example of these modifications is shown below:
# Setting up the program argument
INPUT = C:\Data\inputfile
…
# Setting up a run target
run:
$(PROGRAM) $(INPUT)
Once Makefile.Windows is ready for use with your application, you will be able
to run it from the command line by typing “nmake /f Makefile.Windows run”.
If your GCC compiler on Linux has not been
installed in a standard location, some of your
compiled applications may not be able to find
libstdc++.so at runtime. In this case, you will
need to add this library’s directory (usually /lib)
to your LD_LIBRARY_PATH
environment variable.
ARCGIS DEVELOPMENT WITH MAKE AND THE SOLARIS/LINUX
COMMAND PROMPT
Setting up a compiler for use from the command prompt
Sun WorkShop (Forte) 6 update 2 (CC) for Solaris; GCC version 3.2 (g++) for
Linux
Initializing ArcGIS Engine
With your machine ready for C++ development, there is only a single step to
prepare for ArcGIS Engine development, and that is to source the arcgis/
init_engine.sh (or .csh, depending on your shell of choice). If you prefer, that can
be done in your shell’s RC file (.cshrc or .bashrc, for example). Otherwise, you
must source that file once per shell.
If desired, you can utilize the template
Makefile.Solaris or Makefile.Linux provided with
ArcGIS Engine in ArcGIS Developer Help. Refer
to the next section for details on these sample
files.
Setting up your application
Open your favorite text editor and begin writing your code. Use a makefile to set
the following include directories, library options, and compiler options.
If desired, you can utilize the template makefiles provided with ArcGIS Engine.
Makefile.Solaris provides a starting point for Solaris command-line applications,
and Makefile.Linux will get you started with Linux command-line applications.
Refer to the next section for details on these templates.
Below, $(ARCENGINEHOME) is used to refer to the root directory of your
ArcGIS Engine install and should be defined once you have sourced arcgis/
init_engine.sh (or .csh). For examples of each of these steps, see the template
makefiles: Makefile.Solaris and Makefile.Linux.
Chapter 4 • Developer environments • 217