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 CeGCC, 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]. There are two environments: CeGCC and Mingw32ce. We use Mingw32ce.

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.'''The patches for the WinCE port have not yet been added to the main tree. Right now, you should get the tree on git.videolan.org/vlc-geal.git and use the wince2 branch.'''

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="/opt/mingw32ce/bin/arm-wince-mingw32ce-gcc" \
 CXX="/opt/mingw32ce/bin/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 --enable-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 --disable-optimize-memory --enable-debug \
             --enable-wince --enable-waveout --disable-directx --disable-x264 \
             --disable-live555 --disable-pulse --disable-swscale

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 and download your fresh new VLC build.

== Running VLC ==

Upload the VLC directory on your Windows CE device, and add in its root mingwm10.dll. This the mingw runtime for Windows CE, and VLC won't work without it. You can find it in /opt/mingw32ce/arm-wince-mingw32ce/bin.

== 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

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)