| |
|
Installing Cygwin on Windows |
| |
| Cygwin provides user tools and a Make facility
for building Palm OS applications. |
| |
 |
|
| 1. |
If you have an existing version of Cygwin, you
will need to update your Path environment variable to remove
the directory of the existing Cygwin installation: |
| |
a. |
Click Start->Settings->Control Panel
to open the Control Panel window |
| |
b. |
Double-click the System icon to open the
System Properties window. On Windows 2000,
select the advancedtab and click Environment
Variables. For other Windows systems, select the
Environment tab. |
| |
c. |
In the System Variables list box, select the
Path variable. If the Cygwin directory is listed
in the value for the Path variable, remove the Cygwin
directory. |
| |
|
|
| 2. |
Download
the Cygwin tools package as setup.exe and run it to start the
installer. |
| |
a. |
The installer will ask you for a temporary directory which
it will use as a location for extracting the package. |
| |
b. |
Next, the installer will ask you for a directory where
Cygwin will be installed. (The default is
C:\cygnus\cygwin-b20, where C: is the default system drive.)
|
| |
c. |
Finally, the installer will ask you for the name of the
Program Files folder shortcut to add. (The
default is a Cygwin B20 menu in a folder called
Cygnus Solutions.) |
| |
d. |
Then the installer will install the tools and exit. |
| |
|
|
| 3. |
Next, you can select Start->Cygnus
Solutions->Cygwin B20 to start Cygwin. A bash shell
will open with special environment variables set up for
you. |
| 4. |
If you are running on Windows 95 or Windows 98 and yousee
an “Out of environment space” error message, you will need to
increase the amount of environment space available to Cygwin.
Generally, this can be done with the following
procedure: |
| |
a. |
Edit the system config.sys file (usually C:\config.sys,
where C: is the default system drive). |
| |
b. |
Add the following line to the config.sys file:
shell=C:\command.com /e:4096 /p where C: is the default system
drive. |
| |
c. |
Reboot your system. |
| |
|
|
| Installing PRC-Tools on
Windows |
| |
|
| The PRC-Tools package contains all of the GCC
tools specific to Palm OS. |
| |
|
|
| 1. |
Download
the PRC-Tools package for Windows. Run the executable to start
the installer. |
| |
a. |
The installer will ask you to select the components you
want to install:
- program files
- documentation
-
sample programs |
| |
b. |
Next, the installer will ask you to choose an installation
directory for the program files. The default is C:\Program
Files\PRC_Tools, where C: is the default system
drive. |
| |
c. |
Next, the installer will ask you to choose an installation
directory for the documentation and sample programs. The
default is C:\PalmDev, where C: is the default system
drive. |
| |
d. |
Then the installer will install the tools and exit. |
| 2. |
Add the PRC-Tools directory (the one specified in step 1b
above) to your Path environment variable. You can do this
either by using the System Properties window’s
Environment page, or by adding the following to
your system’s AUTOEXEC.BAT file:
set PATH=”C:\Program
Files\PRC-Tools\H-i586-cygwin32\bin;%PATH%
This AUTOEXEC.BAT text is based on the default directory.
If you specified a different directory in step 1b, then you
need to use the directory you specified. |
| |
|
| The PRC-Tools package is intended to be
installed once. If you re-install PRC-Tools, you will create
multiple entries in your system’s Windows registry. To remove
an existing installation of PRC-Tools, you must do the
following: |
| |
| 1. |
Remove all references to PRC-Tools from the Windows
registry. Generally, the PRC-Tools entries are in
HKEY_LOCAL_MACHINE -> SOFTWARE -> Palm Computing
-> PRC-Tools |
| 2. |
Unmount PRC-Tools by opening your Cygwin bash
shell and typing this command:
umount
/PRC-Tools |
| |
|
| Installing PilRC on
Windows |
| |
| PilRC is the resource compiler for developing
Palm OS user interfaces. |
| |
| 1. |
Download
the PilRC package for Windows. (Download the win_32 version of
the packaged ZIP file.) |
| 2. |
Unzip the package and place it in the directory
where you want it installed. Once the package is unzipped, it
is ready to be used. |
| 3. |
You may want to add PilRC to your cygwin.bat file to make
compiling easier. For example, if you placed the unzipped
PilRC package in the directory c:\pilrc-2.5, you
would add the following line to your cygwin.bat
file:
PATH=”c:\plirc-2.5;%PATH%” |
| |
|
| Installing Palm OS SDK on
Windows |
| |
|
| The Palm OS SDK package 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. |
Unzip the package to obtain the SDK installer
executable; run it to start the installation. |
| |
a. |
The installer will ask you to choose an installation
directory for the SDK. (The default is
C:\PalmDev, where C: is the default
system drive.) |
| |
b. |
The installer will install the SDK and exit. |
| 3. |
To specify the default version of the SDK that
should be used on your system, you need to change the “SDK”
symbolic link by using the Cygwin bash shell. |
| |
a. |
Open the Cygwin bash shell |
| |
b. |
Then type the following commands to change the symbolic
link:
C:\PalmDev
rm sdk
ln -s sdk-3.5 sdk
This example assumes the default directory C:\PalmDev was
used. In addition, this example specifies that the Palm OS 3.5
SDK is the new default. |
| |
| Installing Palm OS
Emulator |
| |
| 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 Windows |
| 4. |
Unzip the package run the .EXE file to install
the Palm OS Emulator. |
| |
|
Cygwin b20.1