How to Build in Xcode 3

NOTE : Apple’s Developer Tools and Git must be installed first in order to build Lunettes. The Developer Tools installer is located on your Mac OS X install DVD. On Snow Leopard 10.6.6, Git is already installed in the Version 1.7.3.4.

The latest version of the Git program can be downloaded from, there is already a version :

http://code.google.com/p/git-osx-installer/downloads/list

Step-By-Step Instructions

• Download the latest version of the BWToolkit package from here :
  
  http://brandonwalkin.com/blog/bwtfiles/BWToolkit.zip
  
  


• Unzip the BWtookit archive.
  
  


• Double-click on the BWToolkit.ibplugin file that is located inside the expanded archive. This will launch Xcode’s Interface Builder app and load the plug-in into IB. Unless you later decide to move the BWToolkit.ibplugin file to a new location on your hard drive, this step does not need to be done again.
  
  


• Once git is installed, launch the Terminal app in order to get the vlc.git and Glasses.git packages.
  
  


• Run the following command in order to download and install the vlc directory into your Home folder. Please be patient as this may take some time :
  
  git clone git://git.videolan.org/vlc/vlc-1.1.git
  
  Note : Please note that the above link is for the VLC 1.1 source code. This is the current stable version of the code, and will give you fewer problems when compiling it. If you prefer the newer 1.2 code, then use the following link instead, but please keep in mind that it may throw you a lot more warnings and errors in Xcode, and may not successfully build :
  
  git clone git://git.videolan.org/vlc.git
  
  Important : If you choose to use the 1.2 code, you have to change the Link to the VLCKit.xcodeproj in your Lunettes.xcodeproj. He is linked to the vlc-1.1 folder. Otherwise, when you build Glasses, Xcode will not be able to find the VLC source, as it will be looking for a directory called vlc-1.1 and not vlc.
  
  
• Run the following command in order to download and install the Glasses directory into your Home folder :
  
  git clone git://github.com/pdherbemont/Glasses.git
  
  Note : After the Lunettes and vlc directories have been downloaded and created in your Home folder, it is a wise idea to make backup copies in another location, just in case something goes wrong during the build process which is not recoverable. This will save you the time and the effort of having to download the packages again.
  
  
• Launch Xcode by double-clicking the VLCKit.xcodeproj project file that is located at the following location in the new vlc folder that you just created with git :
  
  vlc/projects/macosx/framework/VLCKit.xcodeproj
  
  
• Select Xcode’s Build option under the Build menu once VLCKit.xcodeproj loads into the program. It is recommended to compile VLCKit for Intel 64-bit (x86_64) or to create a Universal Binary (32 + 64bit Intel).
  
  
• Double-click the Lunettes.xcodeproj project file that is located at the following location in the new Glasses folder that you just created with git :
  
  Glasses/Lunettes.xcodeproj
  
  
• Select Xcode’s Build option under the Build menu once Lunettes.xcodeproj loads into the Xcode program. Like for VLCKit, it is recommended to compile Lunettes for Intel 64bit (x86_64) or to create a Universal Binary (32 + 64bit Intel). Please note that Lunettes requires Mac OS X 10.6 or later to compile and run. Hence, the PowerPC platform is not supported.
  
  
• That’s it. You should now having the latest working version of Lunettes on your hard drive. It will be located at the following location in the Glasses folder :
  
  Glasses/build/Debug
• 
  

Compilation Warnings And Errors :

After Lunettes has compiled, in the lower right corner of the Xcode window, you may notice that a certain number of warnings and errors occurred during the build process. According to the developers, as long as Lunettes compiles and runs properly, you should not worry about the warnings and errors. These should be misinterpretation of autotools output by Xcode.

How To Update Your Code Base :

If you wish to update the code base in your Glasses and vlc directories so that it includes the latest commits, please follow the instructions below. This will only update the files which have changed :

• For the Glasses directory, first type the following command in the Terminal in order to go to the top level of your Glasses directory, if you are not already there. This command assumes that you are at the top level of your Home folder :
  
  cd Glasses
  
  


• After typing the above command, hit your return key, and then type the following command in the Terminal in order to download and install any changed files into your Glasses folder :
  
  git pull —rebase
  
  


• Please note that in the previous command, that is two dashes before the word rebase. After typing the above command, hit your return key, and then wait while any changed files are downloaded.
  
  


• For the vlc directory, first type the following command in the Terminal in order to return to the top level of your Home folder :
  
  cd ..
  
  


• After typing the above command, hit your return key, and then type the following in order to go to the top level of your vlc directory :
  
  cd vlc
  
  


• After typing the above command, hit your return key, and then type the following command in the Terminal in order to download and install any changed files into your vlc folder :
  
  git pull —rebase
  
  


• Please note that in the previous command, that is two dashes before the word rebase. After typing the above command, hit your return key, and then wait while any changed files are downloaded.
  
  


• After you have updated both the Glasses and vlc directories, simply type exit in order to log out of the Terminal session.
  

NOTES :

Compilation is currently tested on Mac OS X 10.6 Snow Leopard with Xcode 3.2.x (or later) only. It will not work on previous releases of Mac OS X or Xcode.

If you encounter any problems during or after building Lunettes, please send CrashReporter logs and Console logs to the developers so they can analyze the problems for you. Some problems may remain unknown to them unless end users send in their reports. Also, please consider adding your comments to the Lunettes Issues page at : http://github.com/pdherbemont/Glasses/issues


INFORMATION AND CONTACTS :

The Lunettes home page is located here : http://wiki.github.com/pdherbemont/Glasses/

The latest code changes to Lunettes can be found here : http://github.com/pdherbemont/Glasses

The latest commits for Lunettes can be found here : http://github.com/pdherbemont/Glasses/commits/master

The VLC mailing list page is located here : http://mailman.videolan.org/


Developer Email Addresses :

Pierre d’Herbemont – pdherbemont at free dot fr

Felix Kühne – fkuehne at videolan dot org