ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
The template makefiles, Makefile.SolarisGTK
and Makefile.LinuxGTK, can be found in ArcGIS
Developer Help under Development
Environments > C++ > Makefiles.
Customizing the templates Makefile.SolarisGTK and
Makefile.LinuxGTK
As a convenience, template makefiles, named Makefile.SolarisGTK for Solaris
GTK applications and Makefile.LinuxGTK for Linux GTK 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 ‘gtk_sample’, to
reflect your application name. In this example, the program name is
my_application.
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.
# 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!
Compiling your application
Once Makefile.SolarisGTK or Makefile.LinuxGTK is ready to compile your
application, you can compile from the command line by typing “make -f
Makefile.SolarisGTK” or “make -f Makefile.LinuxGTK”, as appropriate.
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 your ArcGIS Engine application,
type “make -f Makefile.SolarisGTK run” or “make -f Makefile.LinuxGTK
run”, as appropriate.
Chapter 4 • Developer environments • 223