iAnywhere.com - Introduction

Developing UltraLite Applications for Windows CE

Introduction

This section contains instructions pertaining to building UltraLite applications for use under Microsoft Windows CE.

For a list of supported host platforms and development tools for Windows CE development, and for a list of supported target Windows CE platforms, see UltraLite development platforms, and UltraLite target platforms.

You can test your applications under an emulator on most Windows CE target platforms.

Preparing for Windows CE development

The recommended development environment for Windows CE at the time of writing is Microsoft eMbedded Visual C++ 3.0. This development environment is available from Microsoft as part of eMbedded Visual Tools.

You can download eMbedded Visual C++ from the Microsoft Developer Network at [external link] http://msdn.microsoft.com/.

A first application

A sample eMbedded Visual C++ project is provided in the Samples\UltraLite\CEStarter directory under your SQL Anywhere directory. The workspace file is Samples\UltraLite\CEStarter\ul_wceapplication.vcw.

When preparing to use eMbedded Visual C++ for UltraLite applications, you should make the following changes to the project settings. The CEStarter application has these changes made.

Compiler settings:
- Add $(ASANY9)\h to the include path.
- Define appropriate compiler directives. For example, the UNDER_CE macro should be defined for eMbedded Visual C++ projects.
Linker settings:
- Add "$(ASANY9)\ultralite\ce\processor\lib\ulrt.lib"
  
  where processor is the target processor for your application.
- Add winsock.lib.
The .sqc file (embedded SQL only):
- Add ul_database.sqc and ul_database.cpp to the project
- Add the following custom build step for the .sqc file:
```
"$(ASANY9)\win32\sqlpp" -q -c "dsn=UltraLite 9.0 Sample" $(InputPath) ul_database.cpp
```
- Set the output file to ul_database.cpp.
- Disable the use of precompiled headers for ul_database.cpp.

Choosing how to link the runtime library