Main Page | Modules | Namespace List | Class Hierarchy | Class List | Directories | File List | Namespace Members | Class Members | File Members | Related Pages

Installation

Overview

The following section describes the steps necessary to install the CPLAT_MacOS framework.

The CPLAT_MacOS II release has been divided into 2 archives. The first one is the source code for the framework and demos. The second one is for the projects. This division means that you only need to download a small archive containing only the projects you will be using.

Once you download the projects archive, you simply copy the contents into the empty Projects folder that is part of the source release.

Install_CPLAT_Mac_1.jpg

In this screen shot, you see the unarchived CPLAT_MacOS II release.

Install_CPLAT_Mac_2.jpg

Next, we see the projects folder with projects for both Codewarrior Pro9 and Apples XCode.

IDE / build environment setup

This next section describes the steps necesary to setup each build environment for building CPLAT_MacOS applications.

Metrowerks Codewarrior Pro 8.x and 9.x

The only step needed to be done before building the CPLAT_MacOS demos, tools and libraries is to setup some global source trees, since the paths are relative to these source trees.

The 3 source trees are (only the CPLAT_MacOS entry is mandatory): CPLAT_MacOS - this should point to the outter most folder. In the case of the above setup, the source tree should point to the CPLAT_MacOS_II_Release folder. OpenGL - if you are going to build the CFM versions of the OpenGL demo, then you need to point to the Apple OpenGL SDK (which you need to download from Apples developer site). Windows and Mach use the headers and libraries provided by the OS, so you don't need this entry, unless building for CFM. QT_SDK - you need this one if you are going to build the QuickTime classes under Windows.

Apples XCode

Like Codewarrior, the XCode projects are built with all entries relative to a CPLAT_MacOS source tree, which you setup, using the preferences of XCode.

After installing you will need to build the CPLAT_MacOS libraries unless you are using XCode 2.x, in this order. Files in the third party folder, main framework lib in the Lib folder. Then you can build any of the demos.

Beginning with XCode2.x, the demos include subprojects to build the framework, which will also build the third party libs.

UserPrefixFlags.h

The UserPrefFile is included in all precompiled / prefix files, and is designed for the user to be able to customize how they want CPLAT_MacOS to be built, such as overriding any of the default defines in CPLAT_MacOS.

MacOS APIs

Beginning with CPLAT_II 2.0 you can set the flag CP_UseDepreciated_10_4_APIs to 0 to prevent APIs that are being disabled by Apple for 10.4 and above from being used. CPLAT attempts to provide more current and / or recommended approaches to the APIs being depreciated. This includes using HIShapes for Regions, Quartz for QuickDraw, etc.

Universal Binaries

Beginning with CPLAT_II 2.0 support for building Universal Binaries is supported. The CPLAT framework will produce a Universal Binary using the supplied XCode 2.1 projects. However, CPLAT has not yet been fully tested under OSX for Intel using the Developer Transition kit.
Generated on Tue Sep 20 20:22:25 2005 for CPLAT_MacOS by  doxygen 1.4.0