A repo for setting up and building PalmOS applications.
You must have XQuartz and Vagrant installed prior to continuing.
Note: You have to log out and back in to ensure the X11 forwarding will work on your mac.
- From within the root of the repository, run
vagrant up. This will setup most of the build environment for you! - Once the box is up, SSH into it using
vagrant ssh. - Once inside of the VM, run
sudo apt-get install xbase-clients pilrcui - After installation is complete, you may exit the SSH session.
- Run
vagrant ssh -c poseand wait for the emulator to show up on your screen!
Note: Step 2 seems like a bug since those things are actually included in the vagrant setup information, but for whatever reason don't work unless the user installs them directly. Also, all of the Vagrant commands seem to execute with a locale in Polish; I don't know why and I haven't fixed it.
So the Palm emulator is a bit strange in that it doesn't come with any OS pre-installed into it, so we have to provide a base ROM for it.
- Run
vagrant ssh -c poseto boot up the emulator. - Right click in the emulator window and select the "new" Options
- In the New Session window, select the empty ROM file drop down and select "Other..."
- This will give you a crappy file viewer that can browse the local file system of the VM. You want to navigate to
/vagrant/ROMS(/vagrantis actually where our repo gets mounted to the remote file system.) - Select
Palm OS 3.5-en-color.romand click OK - The other settings don't really matter, just hit OK on the new session screen, and watch your beautiful Palm device boot up.
Since your machine doesn't have the required compilers and associated tools, we need to execute all build commands on the virtual machine, thankfully, Vagrant makes that pretty easy.
- Run
vagrant ssh -c "cd /vagrant/app && make clean && make"
- Run
vagrant ssh -c "pose -psf [saved session file here] -load_apps /vagrant/app/palmr.prc"
