Palm Programming - GCC development environment setup on Win32

0. Palm Programming

歡迎進入 Palm Programming 的領域，在開始這篇文章之前別忘了 Palm Programming 的官方網站，也是最重要的開發工具、資料網站 Palm OS Developers。

更新紀錄：

最新版本：本文件已更新過，使用 SDK 4.0。

舊版文件（使用 SDK 3.5）。

相關文件：

Palm OS Emulator Installation。

1. cygwin

取得 cygwin，檔名為 cygwin-b20.1-full.exe。

執行 cygwin-b20.1-full.exe，依預設值安裝在 C:\cygnus 下即可。

2. PRC-Tools

取得 Prc-tools，最新版本是 2.0，檔名為 prc-tools-2.0.exe。

執行 prc-tools-2.0.exe，預設會將程式安裝在 C:\Program Files\PRC-Tools，說明手冊和範例程式安裝在 C:\PalmDev。

3. Palm OS SDK 4.0

取得 Palm OS SDK for PRC-Tools，檔名為 sdk40.zip。

解開 sdk40.zip 後可得 Palm OS SDK 4.0.exe，執行並依預設值安裝在 C:\PalmDev 目錄下。

4. PilRC

取得 PilRC，最新版本 2.8，檔名為 pilrc_w32.zip。

將 pilrc_w32.zip 直接解開到 C:\PalmDev 目錄下。

5. 設定

以下設定是我個人建議的方法，如果你熟悉 unix，也可以依據你的需要做變化。

編輯 C:\cygnus\cygwin-b20\cygnus.bat 檔案，原檔案內容如下：

@ECHO OFF
SET MAKE_MODE=UNIX
SET PATH=c:\cygnus\CYGWIN~1\H-I586~1\bin;%PATH%
bash

在最後一行之前加入 SET HOME=C:\PalmDev，成為

@ECHO OFF
SET MAKE_MODE=UNIX
SET PATH=c:\cygnus\CYGWIN~1\H-I586~1\bin;%PATH%
SET HOME=C:\PalmDev
bash

儲存。

執行 [程式集]\[Cygnus Solutions]\[Cygwin B20]。
- 如果你使用 98/95，執行時出現 Out of environment space 訊息，請修改 C:\CONFIG.SYS，加上底下這行，
  
  SHELL=C:\COMMAND.COM /E:30000 /P
  然後重新開機，再繼續以下步驟。

在 cygwin 視窗中執行
touch /PalmDev/.bashrc
建出 .bashrc 檔，再編輯 C:\PalmDev\.bashrc 檔案，新增內容如下（若你會使用 vi，亦可直接 vi /PalmDev/.bashrc）：
export PATH=/prc-tools/H-i586-cygwin32/bin:/PalmDev/pilrc-2.8:$PATH cd
儲存。

安裝設定到此完成，若有問題請看底下的 Tricks and Troubleshooting 一節。

6. 編譯設定與說明

在以 m68k-palmos-gcc 編譯程式時需加上 -palmosX.Y 選項，指定使用的 SDK 版本，如 -palmos3.5 指定使用 SDK 3.5。然而 prc-tools 2.0 尚未支援 -palmos4.0 的選項，因此我們必須做點設定。（可使用 prc-tools 2.1，但 prc-tools 2.1 還沒 release，不建議使用。）
- 在 cygwin 視窗下執行
  cd /PalmDev ln -s sdk-4 sdk

在撰寫好資源檔（.rcp）以及程式碼（.c、.h）後：
- 用 pilrc 編譯資源檔產生 .bin 檔。
- 用 m68k-palmos-gcc 編譯程式碼。
- 再用 m68k-palmos-obj-res 產生 .grc 檔。
- 最後用 build-prc 將 .bin .grc 結合產生 .prc 檔，也就是最終的程式檔。
- 接著將 .prc 裝到 POSE 或實機上進行測試、使用。

7. 接下來...

程式寫好了要怎麼測試或 debug 呢？你需要安裝 POSE，請看 Palm OS Emulator Installation。

小試身手，試試這個 Hello Palm 範例程式吧！

8. Tricks and Troubleshooting

（98/95 使用者）修改 [程式集]\[Cygnus Solutions]\[Cygwin B20] 捷徑內容，將 [程式] 頁的 [結束時關閉] 打勾，這樣在你離開 bash 時視窗就會跟著關閉。

在 cygwin 視窗中執行 mount，可看到以下輸出：

      Device                                   Directory  Type   Flags
      C:\temp                                  /tmp       native text!=binary
      C:\Program Files\PRC-Tools               /prc-tools native text!=binary
      c:\cygnus\cygwin-b20\H-i586-cygwin32\bin /bin       native text!=binary
      C:\PalmDev                               /PalmDev   native text!=binary
      C:                                       /          native text!=binary

如果你的設定不正常，例如少了 /prc-tools 那一行，那就無法正常使用，解決方法為：

在 cygwin 視窗中執行
mount -f "C:\Program Files\PRC-Tools" /prc-tools

對 unix 熟悉的使用者，建議你可以試試搭配最新的 cygwin，僅需手動將 /prc-tools、/PalmDev mount 上即可使用。

Back Home - Palm
Last Modified: June 15, 2001