Michael Martin
7dd753bd55
Also includes packaging notes for Linux and macOS, with a placeholder for Windows.
45 lines
1.9 KiB
Plaintext
45 lines
1.9 KiB
Plaintext
BUILDING THE UR-QUAN MASTERS ON MAC OS X
|
|
----------------------------------------
|
|
|
|
Starting with 0.7.1, it is possible to build and run The Ur-Quan
|
|
Masters with the brew system (https://brew.sh). This is much easier
|
|
than building a redistributable package, and personal builds should
|
|
probably rely on this. See the main INSTALL file for instructions
|
|
there.
|
|
|
|
To create a .app file that will work on most Macs, you will need to
|
|
create an app bundle with custom copies of its libraries. To do
|
|
*that*, you will to build most of them yourself:
|
|
|
|
SDL2: https://www.libsdl.org
|
|
The development libraries for macOS available here already work
|
|
fine and do not need any extra work.
|
|
|
|
Ogg Vorbis: http://www.xiph.org
|
|
You will need to build frameworks out of libogg and libvorbis,
|
|
which will be named Ogg.framework and Vorbis.framework.
|
|
|
|
libpng: http://www.libpng.org/pub/png/libpng.html
|
|
You will ultimately need to create libpng.framework.
|
|
|
|
These frameworks should be built as "archives" in Xcode with a macOS
|
|
deployment target of 10.6. Copy the framework directories out of the
|
|
archives into /Library/Frameworks.
|
|
|
|
With these in place, copy the content packages that you intend to
|
|
undle with the app (at minimum content, but potentially also voice and
|
|
3DO music or even remixes) into a subdirectory under this one named
|
|
"dist-packages".
|
|
|
|
You are now ready to actually build and package the application:
|
|
|
|
DEPS_PATH=/Library/Frameworks ./build.sh uqm
|
|
build/unix_installer/copy_mac_frameworks.pl
|
|
|
|
This should produce a working app bundle named "The Ur-Quan
|
|
Masters.app". For proper redistribution this app should be put in a
|
|
disk image with the Disk Utility. If you are running on a version of
|
|
macOS later than 10.12, don't forget to make sure you use HFS+ instead
|
|
of APFS, or your disk image won't be mountable on any version of macOS
|
|
10.12 or earlier!
|