ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
1. Use the -I compiler option to add some additional include directories:
• $(ARCENGINEHOME)/include
• (Linux) /usr/X11R6/include (or the correct version for your installation)
2. Use the -L linker option to specify some additional library directories:
• $(ARCENGINEHOME)/bin
• (Linux) /usr/X11R6/lib (or the correct version for your installation)
3. Use the -l linker option link against the arcsdk library.
4. Use the -D compiler option to define the ESRI_UNIX symbol to direct the
compiler to read the UNIX support headers from within ArcSDK.h.
The template makefiles, Makefile.Solaris and
Makefile.Linux, can be found in ArcGIS Developer
Help under Development Environments > C++
> Makefiles.
The comment text used here to describe the
code of the makefile has been modified from the
actual comments within the file to reflect the
steps being taken.
Customizing the templates Makefile.Solaris and Makefile.Linux
As a convenience, template makefiles, named Makefile.Solaris for Solaris command-line
applications and Makefile.Linux for Linux command-line applications,
are included with ArcGIS Engine for your use. The following steps highlight the
specific areas of those files that must be customized for you to use them in your
development process. The modifications shown are based on an application that
is written in a single code and a single header file, my_application.cpp and
my_application.h, and produces an executable that takes in a single file at
runtime.
1. Throughout the makefile, update the program name, currently ‘basic_sample’,
to reflect your application name. In this example, the program name is
my_application.
# Set up the program name
PROGRAM = my_application
...
# Program name updates - source list
CXXSOURCES = my_application.cpp
...
# Program name updates - objects, dependencies, and compilation commands
my_application.o: my_application.cpp my_application.h
$(CXX) $(CXXFLAGS) -c -o my_application.o my_application.cpp
2. Update the dependencies list for your application. This line was also shown
above to illustrate the update of the program name. However, it may also
involve adding additional parameters and lists if the application you are
writing is broken up into more files.
...
# Program name updates - objects, dependencies, and compilation commands
my_application.o: my_application.cpp my_application.h
$(CXX) $(CXXFLAGS) -c -o my_application.o my_application.cpp
With your makefile prepared, you are ready to write your code. Don’t forget to
start by including ArcSDK.h!
218 • ArcGIS Engine Developer Guide