- 1 Introduction
- 2 Building VLC
- 3 Using and Debugging VLC
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.
Prepare your environment
VLC uses automake, autoconf and friends for compilation. Make sure they are up to date and usable for your system.
To compile VLC, we use CeGCC, a cross-development environment for Windows CE. Get it on 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 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 it and uncompress it in /usr/wince.
You need to tweak your configure line.
./configure 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:
(This will create a subdirectory named vlc-x.x.x with all the binaries "stripped" without any debugging symbols).
(Same as above but will package the directory in a zip file).
(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 SynCE to synchronize your device with Linux. Or find an Windows machine and download your fresh new VLC build.
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.
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 demo of a debugging session for Windows CE.
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. --Geal 10:37, 2 September 2008 (CEST)