TN004 - How to use the Zaurus-X-gcc cross compiler

1. make sure to have Xcode and Apple X11 including the X11 SDK installed on your development MacOS X 10.3 machine
2. install the compiler package and the mySTEP SDK
3. open the Xcode project you want to port
4. select the intended target in the Targets group
5. select from the menu Build/New Build Phase/New Shell Script Build Phase
6. select the "Shell Script Files" phase in the target
7. open the information (i) or (Apple-I)
8. copy the following code into the "Script" area

   export SOURCES=*.m                  # all source codes
   export LIBS=                        # add any additional -lAddressBook etc.
   export STRIP MacOS=false            # set to true if you want a Linux-ARM only bundle
   export INSTALL=true                 # true will try to install on the Zaurus (using ssh)
   export INSTALL PATH=/Applications   # override INSTALL PATH for MacOS X for the Zaurus
   export RUN=true                     # true will try to run with mySTEP/myPDA on the Zaurus and X11
                                       # on MacOS (using ssh through USB with address 192.168.129.201)
   /usr/bin/make -f $SYSTEM DEVELOPER DIR/Zaurus-X-gcc/SDKs/mySTEP.sdk/usr/mySTEP/etc/cross-makefile $ACTION
   

9. change the SRC= line to include all required source files (e.g. "main.m other/*.m")
10. change the LIBS= line to add any non-standard libraries (e.g. "-lAddressBook -lPreferencePane -lWebKit")
11. Build the project (either in deployment or development mode - that affects only the MacOS version)
12. If it does not compile, your project might be using classes or methods that are not (yet) available on mySTEP. Note, that there is no Carbon or Core Foundation support!