UltraLite User's Guide
  Tutorial: Build an Application Using the C++ API

Lesson 5: Build and run your application

You can compile and link your application in the development tool of your choice. In this section, we describe how to compile and link using Visual C++; if you are using one of the other supported development tools, modify the instructions to fit your tool.

1. Start Microsoft Visual C++ from your desktop in the standard fashion.

2. Configure Visual C++ to search the appropriate directories for UltraLite header files and library files.

   Select Tools > Options and click on the Directories tab. In the Show Directories For dropdown list, choose Include Files. Include the following directory, so that the header files can be accessed.

   C:\Program Files\Sybase\SQL Anywhere 9\h

   On the same tab, select Library Files under the Show Directories For dropdown menu. Include the following directory so that the UltraLite library files can be accessed.

   C:\Program Files\Sybase\SQL Anywhere 9\ultralite\win32\386\lib

   Click OK to submit the changes.

3. Create a project named APITutorial (it should be the same name as the directory you have used to hold your files).

   • Select File > New. The New dialog is displayed.

   • On the Projects tab choose Win32 Console Application.

   • Specify a project name of APITutorial.

   • Specify the APITutorial directory as location.

   • Select New Workspace and click OK.

   • Choose to create An Empty Project and click Finish.

   • On the Workspace window, click the FileView tab. The workspace tutorial consists of just the APITutorial project. Double-click APITutorial files to display the three folders: Source Files, Header Files, Resource Files.

4. Configure the project settings.

   • Right click on APITutorial files and select Settings. The Project Settings dialog is displayed.

   • From the Settings For dropdown menu, choose All Configurations.

   • Click the Link tab. Add the following runtime library to the Object/Library Modules box.

     ulimp.lib

   • Click on the C/C++ tab. From the Category dropdown menu, choose General. Add the following to the Preprocessor definitions list:

     __NT__,UL_USE_DLL

     Here, __NT__ has two underscores either side of NT.

   • Click OK to finish.

5. Add sample.cpp and ProductPubAPI.cpp to the project.

   • Right click on the Source Files folder and select Add Files to Folder. Locate your sample.cpp file and click OK. Open the Source Files folder to verify that it contains sample.cpp.

   • Repeat to add the generated ProductPubAPI.cpp file to the project.

6. Add the file containing the base classes for the UltraLite API to the project.

   • Right click on the Source Files folder and choose Add Files to Folder. Browse to ulapi.cpp, which is in the src subdirectory of your SQL Anywhere directory, and click OK.

7. Compile and link the application.

   • Select Build > Build APITutorial.exe to compile and link the executable. Depending on your settings, the APITutorial.exe executable may be created in a Debug directory within your APITutorial directory.

8. Ensure that the application can locate the UltraLite runtime library.

   • The UltraLite runtime library is ulrt8.dll. In Visual C++, choose Tools > Options, click the Directories tab. From the Show Directories For list choose Executable files. Add the win32 subdirectory of your SQL Anywhere directory to the list. Click OK to complete.

9. Run the application.

   • Select Build > Execute APITutorial.exe.

   A command prompt window appears and displays the prices of the products in the product table.

You have now built and run a simple UltraLite application. The next step is to add synchronization to your application.