| |
| The following is a list of the tools that are
necessary to set up a GCC development environment for your
Unix or Linux computer. Where version numbers are indicated,
these are the only tested versions at this time and we can’t
guarantee that other versions will work. |
| |
|
|
| |
 |
GCC 2.95 or
higher – The actual compiler |
| |
|
PRC-Tools
2.0 for RPMs - The supported GCC release for Unix
installations |
| |
|
PilRC
2.4 or higher* - Generates binary resources from
textual definitions |
| |
|
Palm
OS SDK – Read the SDK
notes, or download SDK
3.5 now |
| |
|
Palm
OS Emulator - Test and debug your application. |
| |
| |
|
* PilRC version 2.5 is required for color
resource support |
| |
| All of this software will be installed
on the command line. All individual components have their own
readme files, but here is an overview of what you need to know
for each component: |
| |
|
Installing GCC on Unix |
| |
| 1. |
Ensure you have GCC Version 2.0 or later (more information
or the FTP
releases) installed to develop Palm OS applications. |
| |
|
|
| Installing
PRC-Tools on Unix |
| |
|
|
|
The PRC-Tools package contains all of the Palm OS
components for GCC development. |
| |
| 1. |
Download
and install the PRC-Tools package for Unix. |
| 2. |
Become the root and install PRC-Tools by typing the
following command:
$rpm -i
[name_of_prc-tools.rpm]
For example: if you have downloaded the PRC-Tools package
named prc-tools-2.0-1.Linux-i386.rpm, then you would type this
command:
$rpm -i
prc-tools-2_0-1_Linux-i386.rpm
The PRC-Tools will be installed in the
/usr/local/palmdev directory. |
| |
|
|
| Installing PilRC on
Linux/Unix |
| |
| PilRC is the resource compiler for developing
Palm OS user interfaces. |
| |
| 1. |
Download
PilRC package for Unix. Get the tar.gz sources version of
the package. |
| 2. |
Unpackage the file by typing the following
command:
$tar -xvpfz
pilrc_src.tgz |
| 3. |
Change to the PilRC directory (for example,
pilrc-2.5c) and type the following
comands:
$./configure
$make |
| 4. |
Become the root and then type the following
command:
$make install |
| |
|
| Installing Palm OS SDK on
Unix |
| |
| The Palm OS SDK contains C header files and
tools required for developing Palm OS applications. |
| |
| 1. |
Download
the latest Palm OS SDK or read about choosing
an SDK for PRC-Tools. |
| 2. |
Unpackage the SDK package to obtain the
contents. |
| 3. |
You need to add the header files and libraries
to your “palmdev” directory. The default is
/usr/local/palmdev |
| 4. |
In your “palmdev” directory, create a directory
"/sdk-*.*" and create two subdirectories of
it: |
| |
|
a. /include directory
b. /lib
directory |
| 5. |
Copy the contents of “Palm OS *.*Support/Incs”
to the new /include directory. |
| 6. |
Copy the contens of “Palm OS *.*Support/GCC
Libraries” to the new /lib directory. |
| 7. |
You can now compile your programs using Palm OS
*.* headers and libraries by adding a
“-palmos3.5” option to your compile and link
commands. For example:
$ m68k-palmos-gcc -O2
-o hello hello.c -palmos*.* |
| 8. |
To use the Palm OS *.*headers and libraries by default, you
can change the “sdk” symbolic link in the “palmdev” directory
to point to the new SDK by typing the following
commands:
$ cd /usr/local/palmdev
$ rm
sdk
$ln -s sdk-*.*sdk
The resulting directory structure should match this
structure: |
| |
|
/usr/local/palmdev/sdk-*.*
/usr/local/palmdev/sdk-*.*/include
/usr/local/palmdev/sdk-*.*/include/Core
/usr/local/palmdev/sdk-*.*/include/Core/System
/usr/local/palmdev/sdk-*.*/include/Dynamic
/usr/local/palmdev/sdk-*.*/lib
/usr/local/palmdev/sdk-*.*/lib/m68k-palmos-coff |
| |
|
|
| Installing Palm OS Emulator
on Unix |
| |
| Palm OS Emulator is a tool that allows you to
test Palm OS applications by emulating the hardware that runs
the Palm OS operating system. |
| |
| 1. |
Go to the Palm OS
Emulator page |
| 2. |
Read the introduction, including section on
obtaining ROM Images |
| 3. |
Download the latest Palm OS Emulator application
for Unix/Linux. |
| 4. |
Unpack the Palm OS Emulator source files. |
| 5. |
Make sure that you have the required tools to
build Palm OS Emulator: |
| |
a. |
Fast Light Tool Kit (FLTK) C++ graphical toolkit for
X. |
| |
b. |
GCC 2.95 or higher. |
| |
|
| |
If you don’t have these tools, update your C++
compiler first and then download FLTK.
Not all FLTK toolkits install in the same way. Some install
their include files in an /Fl directory and some
install their include files in an /FL directory. Palm OS
Emulator expects the files in an /FL directory.
If your installation doesn’t have an /FL
directory, you need to create a symbolic link to
/FL with the name /Fl. In addition,
the Palm OS Emulator build script expects the file
libfltk.a to be installed in the
/user/lib or /user/
local/lib directory. If you have installed it
in a different directory, you need to specify the
––with–fltk=DIR configure flag. The directory you
specify will be used as the prefix for the additional
/include and /lib directories to be
searched.
|
| 4. |
Once you have all of the prerequisite tools for compiling
the Emulator source files, change directory to the
BuildUnix subdirectory and use the following
commands to compile the
source:
./configure
make |
| 5. |
You will now have a Palm OS Emulator application that you
can run. |
