View source for WinCECompile

=Introduction=

This is a guide for cross-compiling VLC for Windows CE on Linux with a step-by-step instruction to download, install, configure and build your VLC.

= Building VLC =

==Prepare your environment==
VLC uses automake, autoconf and friends for compilation. Make sure they are up to date and usable for your system.

===Get mingw32ce===
To compile VLC, we use Mingw32CE, a cross-development environment for Windows CE. Get it on [http://downloads.sourceforge.net/cegcc/mandriva-cegcc-mingw32ce-0.51.0.tar.gz?modtime=1196987404&big_mirror=0 Sourceforge].

Go the the directory where you dowloaded CeGCC, and untar it:
 % tar xzf mandriva-cegcc-mingw32ce-0.51.0.tar.gz -C /

You should now see the folder /opt/mingw32ce.

==Get the source==
Start by [[GetTheSource|getting the source]], using FTP for releases, or using [[Git]] for development.
If your are using the release, download source code and extract the archive and go into your VLC directory.
 % cd /path/to/your/vlc/folder/

If you are using the [[Git]] version, start by bootstrapping your VLC.
 % cd /path/to/your/vlc/folder/
 % ./bootstrap

==Get the contribs==
There is a package which contains some external libraries, and some hacks with header files. Get [http://eleves.ec-lille.fr/~couprieg/divers/wince.tar.gz it] and uncompress it in /usr/wince.

== Configuration ==

You need to tweak your configure line.

<tt>./configure</tt> is used to check whether your system is able to compile VLC.
Also you choose the functionalities of your build.
 % ./configure --help
will show you the various options

Create a new file named conf-vlc.sh and add in it:

 PATH=/opt/mingw32ce/bin:/opt/mingw32ce/arm-wince-mingw32ce/bin:$PATH \
 CC="arm-wince-mingw32ce-gcc" \
 CXX="arm-wince-mingw32ce-g++" \
 CFLAGS="-I/usr/wince/include -I/opt/mingw32ce/arm-wince-mingw32ce/include  -mwin32 -D __COREDLL__ -D _WIN32_WCE=0x0500" \
 CPPFLAGS="-I/usr/wince/include -I/opt/mingw32ce/arm-wince-mingw32ce/include  -mwin32 -D __COREDLL__ -D _WIN32_WCE=0x0500" \
 LDFLAGS="-L/opt/mingw32ce/arm-wince-mingw32ce/lib -L/usr/wince/lib -lws2" \
 
 ./configure --host=arm-wince-mingw32ce \
             --disable-sdl --disable-gtk \
             --disable-dvdnav --disable-dvdread --disable-avformat \
             --disable-postproc --disable-hal --disable-nls    \
             --enable-sout --enable-vlm --disable-wxwindows \
             --disable-a52 --enable-libmpeg2 --disable-freetype \
             --disable-libgcrypt --disable-fribidi --disable-mad \
             --disable-optimize-memory --disable-audioscrobbler \
             --disable-tremor --disable-faad --enable-ffmpeg --disable-avcodec \
             --enable-vlc --disable-activex --disable-testsuite --disable-skins2 \
             --disable-qt4 --disable-notify --disable-httpd --disable-dbus-control \
             --disable-growl --disable-telepathy --disable-lua --disable-vlm \
             --disable-gnutls --disable-bonjour --disable-x11 --disable-glx \
             --disable-xvideo --disable-remoteosd --disable-schroedinger \
             --disable-dshow --enable-wingdi --disable-real --disable-realrtsp \
             --disable-optimizations --enable-debug \
             --enable-wince --enable-waveout --disable-directx --disable-x264 \
             --disable-live555 --disable-pulse --disable-swscale --disable-telnet

Save it and make it executable:
 % chmod u+x conf-vlc.sh

== Compiling source code ==
Now run your configuration script and build VLC:
 % ./conf-vlc.sh
 % make

== Creating self contained packages ==

Once the compilation is done, you can build self-contained VLC packages with the following "make" commands:

 make package-win32-base

(This will create a subdirectory named vlc-x.x.x with all the binaries "stripped" without any debugging symbols).

 make package-win32-zip

(Same as above but will package the directory in a zip file).

 make package-win32-base-debug

(Creates the same subdirectory, but with debug symbols).

There is not (yet) an option to build a .cab file.

= Using and Debugging VLC =

== Interacting with your device ==

Use [http://www.synce.org SynCE] to synchronize your device with Linux. Or find an Windows machine with ActiveSync installed and download your fresh new VLC build.

== Debugging VLC ==

CeGCC provides a stub for GDB to permit remote debugging on Windows CE. To use it, go in the vlc folder:
 % cd vlc-1.0.0
 % arm-wince-mingw32ce-gdb vlc.exe

This GDB will upload vlc.exe to /gdb/ on the device. Make sure you uploaded all the VLC directory on your device.

Then, follow the [http://cegcc.sourceforge.net/docs/debugging.html demo of a debugging session] for Windows CE.

== Common errors ==

Well... I don't remember right now all the weird errors I encountered, but if you find one, I may have seen it before, so contact me, I'll help you and add it here. --[[User:Geal|Geal]] 10:37, 2 September 2008 (CEST)