Building Xuggle Xuggler (GPL and LGPL Licensed Versions)

[Linux 32-bit, Linux 64-bit, Windows 32-bit, Windows 64-bit]

To build the Xuggle Xuggler library, you will need two Linux virtual machines running Ubuntu 11.10 (32-bit and 64-bit operating systems). A 32-bit version of the OS is required to build Linux 32-bit, cross compiling Windows 32-bit, and cross compiling Windows 64-bit binaries. A 64-bit version of the OS is required to build Linux 64-bit binaries.

Using VirtualBox, I created the two virtual machines discussed above with the ubuntu-11.10-server-i386.iso and ubuntu-11.10-server-amd64.iso disk images. These are headless server versions of Ubuntu. After installation of the OS, follow these steps to build Xuggler (you are welcome to try different dependency versions and not use the root user, but this is what I did to build successfully):

1. Change to root user:

• sudo su

2. Just use root’s home directory:

• cd /root

3. Update apt-get to use specific repository:

• apt-get install python-software-properties
• add-apt-repository ppa:ferramroberto/java
• apt-get update

4. Install Java:

• apt-get install sun-java6-jdk sun-java6-plugin

5. Verify the HotSpot Java 6 JVM is the default java:

• java -version

6. If the incorrect version of Java appears, configure the default by running:

• update-alternatives --config java

7. Install gcc, g++, make and all the other build essentials:

• apt-get install build-essential

8. Install YASM:

• apt-get install yasm

9. Install Open SSL:

• apt-get install openssl

10. Install Package Config:

• apt-get install pkg-config

11. Install Git:

• apt-get install git

12. Install Ant:

• apt-get install ant-optional

13. Install JUnit:

• apt-get install junit

14. Install MingGW to be able to build for Windows (mingw-w64 can do 32 and 64-bit Windows):

• apt-get install mingw-w64

15. Download the LGPL configured Xuggle source code (Ed’s fork of the code from Jeff Wallace’s fork from the original GPL xuggle code) or the original GPL version:

• LGPL: git clone https://github.com/e-d/xuggle-xuggler.git
• GPL: git clone https://github.com/xuggle/xuggle-xuggler.git 

16. Compile and build the JAR files (with binaries inside). Be sure to run the 64-bit Linux build on the 64-bit version of Ubuntu. Also note that between builds you will need to run “ant clobber” to remove all of the compiled files from the previous architecture. To build run:

• (32/64-bit Linux): ant stage
• (64-bit Windows): ant -Dbuild.configure.os=x86_64-w64-mingw32 stage
• (32-bit Windows): ant -Dbuild.configure.os=i686-w64-mingw32 stage

17. The deployable JAR files will be in the /dist/lib directory.
18. If you need the Linux binaries to additionally work on CentOS, you’ll now need to change the version of GCC and G++ to use 3.4 instead of 3.6.

• Install GCC 4.4:

1. apt-get install gcc-4.4

• Update symbolic links to use 4.4 (the arch-specific link will be different on 32-bit VM):

1. rm /usr/bin/gcc
2. ln -s /usr/bin/gcc-4.4 /usr/bin/gcc
3. rm /usr/bin/x86_64-linux-gnu-gcc
4. ln -s /usr/bin/x86_64-linux-gnu-gcc-4.4 /usr/bin/x86_64-linux-gnu-gcc

• Install C++ (G++) 4.4:

1. apt-get install c++-4.4

• Update symbolic links to use 4.4 (the arch-specific link will be different on 32-bit VM):

1. rm /usr/bin/cpp
2. ln -s /usr/bin/cpp-4.4 /usr/bin/cpp
3. rm /usr/bin/x86_64-linux-gnu-cpp
4. ln -s /usr/bin/x86_64-linux-gnu-cpp-4.4 /usr/bin/x86_64-linux-gnu-cpp
5. rm /usr/bin/g++
6. ln -s /usr/bin/g++-4.4 /usr/bin/g++
7. rm /usr/bin/x86_64-linux-gnu-g++
8. ln -s /usr/bin/x86_64-linux-gnu-g++-4.4 /usr/bin/x86_64-linux-gnu-g++

• Verify default versions:

1. gcc --version
2. c++ --version
3. cpp --version
4. gcc --version

• You can now run the builds the same way as before (you only need to re-build Linux binaries). The binaries will now be compatible with slightly older versions of many Linux distros (including CentOS compatibility). These 4.4 compiled binaries should still work everywhere the 4.6 compiled versions would run too.