2 This directory contains the MacOS-specific code for building a Cocoa
3 version of xscreensaver without using X11.
5 To build it, just type "make", or use the included XCode project. The
6 executables will show up in the "build/Release/" and/or "build/Debug/"
9 To build these programs, XCode 2.4 or later is required.
10 To run them, MacOS 10.4.0 or later is required.
13 This is how you add a new screen saver to the Xcode project. It's a
14 ridiculously long list of steps!
16 1: Duplicate a target (Dangerball for GL, or Attraction for X11).
17 2: Rename it, and drag it to the right spot in the list.
18 3: Delete the dangerball.c and dangerball.xml files from the new target.
19 4: Delete the "DangerBall copy-Info.plist" file that got created.
20 5: Delete the "DangerBall copy-Info.plist" from the Build Settings too.
21 6: Change PRODUCT_NAME in Build Settings.
22 7: Manage Schemes, rename "DangerBall Copy".
23 8: Move to the right place in the list.
24 9: Scheme / Run: set SELECTED_SAVER environment variable.
25 10: Scheme / Run / Info: Executable: SaverTester.app.
26 11: File / Add Files / the new .c and .xml.
27 Add to targets: the new target, and also "XScreenSaver-iOS".
28 12: Re-order them in the file list.
29 13: In target "All Savers (OpenGL)" add the new target as a dependency.
30 14: In target "XScreenSaver-iOS", reorder new files in "Copy" and "Compile".
31 15: In target "XScreenSaver-iOS", add "-DUSE_GL" to the new file's options.
32 16: Put a 200x150 screen shot in ~/www/xscreensaver/screenshots/
33 17: ln -s ../../src/xscreensaver/OSX/build/Debug/NEW.saver \
34 ~/Library/Screen\ Savers/
35 18: Build "XScreenSaver-iOS" once. then:
36 cd ~/src/xscreensaver/OSX ; make ios-function-table.m
38 19: cvs add xscreensaver.xcodeproj/xcuserdata/*/xcschemes/*.xcscheme
39 20: Don't forget to create a man page from the XML with xml2man.pl,
40 and update Makefile.in.