6
Installation
Scott Duensing edited this page 2021-05-02 20:38:14 +00:00
To install JoeyLib, you will need the following:
- For all targets:
- A Ubuntu-flavored 64 bit Linux Machine (stock Debian does not have all the needed packages)
- For building JoeyLib for the Apple IIgs:
- ISO of Opus II: The Software
- MSI from and GIT access to Golden Gate
- For building JoeyLib for macOS:
- XIP file of XCode 9.4.1 (Requires free Apple ID)
- A ridiculous amount of disk space (30+ gig free - seriously)
From a shell prompt on your Linux system, as a user that has sudo privileges (not root!), enter:
mkdir joey
cd joey
wget https://skunkworks.kangaroopunch.com/skunkworks/joeylib/raw/master/scripts/installer.sh
chmod +x installer.sh
./installer.sh
The installer will prepare your system and then present a menu of platforms on which you can build JoeyLib. The following items will be created in the same folder as installer.sh:
- installWork/ - Temporary folder containing intermediate files
- dist/ - Final JoeyLib binaries, header files, and helper scripts
- sdks/ - Various tools needed to work with some of the supported platforms
- joeylib/ - The source code to JoeyLib itself
- joeyDev.sh - A script to run to set up your system environment to use JoeyLib
If you are low on space, you can delete installWork/ once you have built all the desired JoeyLib platforms. However, re-running the installer to update or modify your JoeyLib binaries will re-download and re-create much of what is stored there.