In Japanese In English

Palm Development Tips

prc-tools-2.0 には致命的なバグがあるのでできるだけ最新版 (prc-tools-2.0.9x)にアップデートしたほうがいいでしょう。これはメンテナの John Marshall さんもメーリングリストなどでよく言われています。(2002-03-12)

このページはかなり読みにくいと思っているので構成変更を予定しています。 (2002-03-02)

SDK 4.0 に移行しましたが、手順はほとんど 3.5 のときと同じで OK でした。(2001-07-17)

現在のところ SDK 3.5 と prc-tools-2.0 のインストールについてしか書いていません．これら以外に pilrc というリソースコンパイラが必要です。(2000-11-19)

まずはデベロッパ登録する

開発環境を構築する前に、まず、デベロッパ登録をすることを勧めます。私は www.palmos.com から登録しましたが、日本法人からでも登録できるはずです。私の場合、申し込んでから、だいたい 2 週間くらいかかりました。

(契約書を直接、封書でやりとりしなければならないのでこれくらいかかります。手続きそのものは簡単で契約書をよく読み、内容に同意できたら印刷してそれに必要事項を記入し、送付して、先方の担当者の署名が入ったものが送り返されてくるのを待つだけです。)

なぜデベロッパ登録が必要かというと、それはデバッグ ROM を入手するためです。私の経験からすると、デバッグ ROM と POSE なしでの Palm ソフトウェアの開発は想像できません。

開発環境を構築する

Palm の Web ページに構築方法があるのでそれにしたがって行えばわりと簡単に構築できるはずであったが、すんなりとはいかなかった。私が普段持ち歩いているのは OpenBSD-2.6 i386 なのでそれに環境を構築してみた。

準備するもの

PalmOS SDK 3.5
prc-tools-2.0
binutils-2.9.1
gcc-2.95.2
gdb-4.18
make-3.77
pilrc-2.5b1

PalmOS SDK 3.5 をインストール

SDK の置場所は /usr/local/palmdev/sdk-3.5 としました。そのまま展開すると、Unix 的ではない path になるので展開後 path 名を変更します。

$ cd /usr/local/palmdev
$ zcat sdk35.tar.gz | tar -xvf -
[...]
$ mv 'Palm OS 3.5 Support/Incs' sdk-3.5/include
$ mv 'Palm OS 3.5 Support/GCC Libraries' sdk-3.5/lib
$ ln -s sdk-3.5 sdk

ソースファイルを展開しパッチをあてる

どこに置いても構いませんが、私は /usr/local/palmdev/src に置きました。

$ mkdir /usr/local/palmdev/src
$ cd /usr/local/palmdev/src
$ zcat prc-tools-2.0.tar.gz | tar -xvf -
$ zcat binutils-2.9.1.tar.gz | tar -xvf -
$ zcat gcc-2.95.2.tar.gz | tar -xvf -
$ zcat gdb-4.18.tar.gz | tar -xvf -
$ zcat make-3.77.tar.gz | tar -xvf -

次にパッチをあてます。

$ cat prc-tools-2.0/*.palmos.diff | patch -p0
$ find . -name '*.rej'

prc-tools ディレクトリの下に各ソースファイルへのリンクを張ります。

$ cd prc-tools-2.0
$ ln -s ../binutils-2.9.1 binutils
$ ln -s ../gcc-2.95.2 gcc
$ ln -s ../gdb-4.18 gdb
$ ln -s ../make-3.77 make

configure

configure を実行します。私は以下のようなシェルスクリプトを作りました。configure の中で /usr/local 配下にディレクトリを作ろうとするので su してから実行します。 (ちょっとべたべたな解決です...)

OpenBSD-2.6 の gcc-2.95.1 では -O2 とすると ld がうまく動きませんでした。

#!/bin/sh
export CFLAGS="-g -O"
export CXXFLAGS="-g -O"
../prc-tools-2.0/configure \
	--target=m68k-palmos \
	--enable-languages=c,c++ \
	--with-headers=`pwd`/empty \
	--sharedstatedir=/usr/local/palmdev \
	--with-build-sdk=3.5

$ cd /usr/local/palmdev/src
$ mkdir build
$ cd build
$ vi zzz [上記のスクリプトを作成]
$ mkdir empty
$ su
# sh -x zzz 2>&1 | tee zzz.out
# chown -R js3guj:js3guj .
# exit
$

コンパイル

いよいよコンパイルです。

（2000-11-25 追記）以下ですがやり方の通りなのですが，一般ユーザで実行する部分で /usr/local 配下にディレクトリを作ろうとしますので，/usr/local を一般ユーザで書き込みできないようにしている場合は全部 root で実行したほうが一回で済むので楽ちんだと思います．

$ cd /usr/local/palmdev/src/build
$ gmake all-host
$ su
Password:
# gmake install-host
# exit
$ gmake all-gcc
$ su
Password:
# gmake install-gcc
# gmake install-palmdev
# exit
$ gmake all-target
$ su
Password:
# gmake install-target

ldscript のコピー

OpenBSD の sh (pdksh) ではうまく生成されないようなので linux などで生成したものをコピーします．ディレクトリは以下の通り． genscript.sh というのでエラーになるのですが深く追求していません:-)

/usr/local/m68k-palmos/lib/ldscripts

実機を使ってソースレベルデバッグ 2001-03-18

まだ POSE を NetBSD-1.4.3 で動作させることはできていませんが実機を使って gdb でデバッグする方法がわかりました．

gdbpanel をデバイスにインストールします．
デバッグ対象のプログラムを -g オプション付きでコンパイル，リンクし，デバイスにインストールします．
gdbpanel を起動して，Enable stub をチェックします．
gdb (m68k-palmos-gdb [progname]) を起動し target pilot /dev/tty01 などと入力します．
デバッグ対象のアプリケーションを起動します．

たぶん POSE 使うときと違うところは target で指定するデバイスのところだけなのかなと想像しています．

(2001-04-16) 久しぶりにデバッガを起動してみたところ，なぜかつながらなくなっています．前回やったときは

(gdb) target pilot /dev/tty01
Remote debugging under PalmOS using /dev/tty01
Waiting... (Press Ctrl-C to connect to halted machine)

と表示されていたところが，Remote 以下のメッセージが表示されないのです．

ktrace で追ってみると target コマンドを入れたあと，open(2) でブロックしていることがわかりました．

試しに別のウィンドウで stty -f /dev/tty01 clocal といれてやってからもう一度 target コマンドを入れてやると Remote... も表示され接続できるようになりました．

なにがどうなっているのかいまいちよくわかっていません．

(2001-10-19) POSE を NetBSD もしくは OpenBSD で動作させることができていないので WindowsNT で POSE を動かし、OpenBSD で gdb を起動してデバッグしています。

以下は私がぶちあたった問題とその解決方法です。これらの問題はほとんど、POSE + debug ROM + Gremlin で発見できるものです。私はすべてのデベロッパの皆さんに必ず POSE + debugROM + Gremlin でテストすることを強く勧めます。また 1 million gremlin (100万イベント分の gremlin を実行する)をエラーなしで達成するようにすることも強く勧めます。私の考えでは gremlin が出す警告は場合によっては無視してよいものもあると思います。(将来の PalmOS との互換性などを考えると警告もすべて直したほうがよいです。) エラーは無視してはいけません。

フォームの構造体などを直接参照すると debug ROM で文句を言われる。以下のような警告がログに記録されます。
```
13.971 (335):=== WARNING: Zulu (1.0) just read from memory location 0x00004AEC, which is in the "bounds" field of the frmTableObj starting at 0x00004AE4, which belongs to the form starting at 0x00004A08.

The data at this memory location is owned by the Form Manager. Applications should not access the data directly. Instead, they should make the appropriate Form Manager calls.
      
```
回避方法は警告の後段の説明にあるように、API 経由でアクセスするように修正することです。ですが、SDK4.0 の時点では API が存在せず、直接参照するほかないものもあります。これは SDK4.0 Update1 などに含まれる PalmOS Glue function を使うことで回避できるはずです。(SDK4.0 Update1 にすべての関数が用意されているのかどうかは知らないですが、最終的にはすべて用意されるものと思われます。でないと PalmOS5 + PACE の環境でちゃんと動かないですからね。)
Multi segment のプログラムがインストール直後にクラッシュする
プログラムはインストールの HotSync 直後にも、 sysAppLaunchCmdSyncNotify という launch code で呼び出されます。この launch code で呼び出される部分は必ず、デフォルトのセグメント (code 1)にないとだめです。現在の prc-tools では、multi segment の実装にグローバル変数を使っているため、このような制約があります。 sysAppLaunchCmdSyncNotify で呼び出されたときはグローバル変数が利用できないのでデフォルトのセグメントにないコードを呼び出す時点でほとんどの場合、クラッシュします。(もしくはおかしな動きをする。) sysAppLaunchCmdSyncNotify で呼び出されるコードはデフォルトのセグメントに置きましょう。
Multi segment のプログラムが Find 実行時にクラッシュする
これの原因は前項と同じです。sysAppLaunchCmdFind で呼び出されるコードはデフォルトのセグメントに置きましょう。
prc-tolols-2.0 でビルドした Multi segment のプログラムが flash ROM や flash module Springboard から起動後、終了時にクラッシュする。
これは、prc-tools-2.0 のバグです。crt0.o に含まれる、アプリケーション終了時に呼び出される関数でのメモリ解放が不十分なためなようです。最新版の prc-tools の _GccReleaseCode() をリンクしてやる(つまり、 crt0.o にあるのを新しいものと置き換える。)ことで回避できます。もしくは prc-tools を最新版にアップデートします。 prc-tools の最新版に含まれている _GccReleaseCode() はパブリックドメインです。 diddlebug-2.15 へのパッチにも含まれています。
PalmOS3.1 英語版やその他のヨーロッパ言語版で ellipsis (...) が白抜の四角に化ける。
原因はそれらのデバイスの ROM に含まれる、テキストマネージャの関数の一部がバグっているからです。文字化けが起こっている個所の関数を PalmOS Glue library の中の関数に置き換えることで回避できます。 (ただし、SDK 4.0 より前の PalmOS Glue library にも同様のバグがあるので SDK 4.0 以上の PalmOS Glue library を使用しなければなりません。)
FrmDoDialog() を使ったモーダルフォームを開いたあとにメニューを選択しようとすると POSE + DebugROM で文句を言われる。
FrmDoDialog() を使ったモーダルフォームは以下のような構造でないとだめです。
```
static void
BatmonShowAbout (void)
{
  FormPtr previousForm = FrmGetActiveForm ();
  FormPtr frm = FrmInitForm (ShowAboutAlert);

  FrmSetActiveForm (frm);

  FrmDoDialog (frm);

  FrmEraseForm (frm);
  FrmDeleteForm (frm);

  if (previousForm)
	FrmSetActiveForm (previousForm);
}
      
```
FrmDoDialg() 以降の関数はかならずこの順番で呼び出さなければなりません。
FntWordWrap() を呼んだあとそのまま PalmOS 内で無限ループに入ってしまう。
ややこしい問題なのでただいま説明の文章を作成中です。回避方法は、リソースで定義しているフィールドのサイズを、入力可能な最大文字幅以上にすることです。
メニューなどの ellipsis (...) が日本語版のデバイスで文字化けする。
*.rcp の中で `...' などと記述している部分が、ellipsis に割りあてられている古い文字コードに変換されるためです。日本語版の OS ではこの古い文字コードには ellipsis が割りあてられていないので文字化けするというわけです。私は以下のように直接 \030 などと記述することで回避しています。 pilrc に手を入れるというのも「あり」だと思います。 (ただしpilrc の最新版では変更されている可能性がありますので、この問題は起こらないかもしれません。)
```
MENU ID CommandsMenu
BEGIN
	PULLDOWN "Commands"
	BEGIN
		MENUITEM "Update Status" ID UpdateStatusMenuCmd "U"
		MENUITEM "Change Battery Profile\030" ID ChangeBattProfileMenuCmd "C"
		MENUITEM SEPARATOR
		MENUITEM "About Batmon" ID AboutMenuCmd
	END
END
      
```
POSE 3.4 からはメモリリークを検知してくれるようになりましたが、ログを見ても、関数名が Unknown とかになっていてどこで割り当てたメモリを解放し忘れたのかすぐにはわかりません。
gcc のオプションに `-mdebug-labels' を追加してやると関数名もログにとられるようになります。