View source for ROMP Developer Guide

This document explains how to compile and install ROSA Media Player.


== Build under Linux ==


Compiling ROSA Media Player should be easy. It depends on Qt, wild-midi and qjson. 

1) How to make a rpm package<br>
2) Generic compilation<br>
3) Changing installation path<br>


'''1. How to make a rpm package'''
----------------------------
Run rpmbuild:
 rpmbuild -tb rosa-media-player-1.6.x.tar.gz

You'll find the rpm pachage under /usr/src/packages/RPMS/i586/


'''2. Generic compilation'''
----------------------
You need at least Qt 4.2 to compile ROSA Media Player. It won't work with an older
version.

Be sure you have installed the Qt 4 development package. Its name maybe
qt4-devel, libqt4-dev or similar. 

Other dependences:
*wildmidi-devel - for midi support
*qjson-devel - for youtube support

Uncompress the source code, open a console and enter in the rosa-media-player directory.<br>

Type "make":
 make

If you dont need midi support, add argument "no-midi-support":

 make no-midi-support

If everything is ok now you can install it with "make install". That will install rosa-media-player in /usr/local.
 make install

If "make" fails, it's probably because the Qt 3 qmake has been used instead of the Qt 4 one. It seems that some distros have renamed that tool to qmake-qt4. Others may have installed in another directory. Look at the contents of the qt4-devel package (or whatever its name is) and find out where it is.

Now type something like this (just examples):
 make QMAKE=qmake-qt4
or
 make QMAKE=/usr/share/qt4/bin/qmake


'''3. Changing installation path'''
-----------------------------
By default ROSA Media Player will be installed in /usr/local. You can change it by using PREFIX and DESTDIR.

Examples:
 make PREFIX=/usr
 make PREFIX=/usr install

That would install ROSA Media Player under /usr.

DESTDIR will be useful for package maintainers.
 make PREFIX=/usr''
 make PREFIX=/usr DESTDIR=/tmp/ install''

That would compile ROSA Media Player for /usr but in fact it will be installed in /tmp/usr/


== Build under Windows ==

Following dependencies should be installed:

*[http://releases.qt-project.org/qt4/source/qt-win-opensource-4.8.4-vs2010.exe Qt libraries 4.8.4 for Windows (VS 2010, 234 MB)]
*[http://download.microsoft.com/download/C/3/1/C3171EE9-20C4-4B7F-9D47-584D0BBFB0A1/VS2010ExpressRUS.iso Visual Studio 2010 Express]
*[http://qjson.sourceforge.net/build/ QJSON] ([http://habrahabr.ru/post/147952/])
*[http://www.jrsoftware.org/isinfo.php Inno Setup Compiler].

Sources should be placed as followed:
*''rosa-media-player-plugin'' (download from https://abf.rosalinux.ru/uxteam/rosa-media-player-plugin)
**''romp'' (rosa-media-player download from https://abf.rosalinux.ru/uxteam/ROSA_Media_Player)
**''qjson'' (download from official [http://qjson.sourceforge.net/build/ site])
**''rosamp-plugin'' (source of rosamp plugin)
**''translations''
*''ROMP-binary-artifacts''
**''install-bin''
**''install-source''

Compilation:

1. Compile qjson passing ''-DCMAKE_BUILD_TYPE=Release'' to ''cmake'' (compiled binaries should be placed in ''ROMP-binary-artifacts/install-source'').

2. Compile ROSA Media Player:
*execute ''get_romp_version.bat'' (get romp versoin from spec, update translations):
 get_romp_version.bat
*execute ''qmake  -tp vc'' (to create solution file for MS VS2010):
 qmake  -tp vc
*compile MS VS2010 (in release mode).

3. Compile plugin (in release mode); run get_translations.bat (to create and move translation file to appropriate directory):
 get_translations.bat

4. Create installer in Inno Setup Compiler using installation script ''rosa-media-player.iss''. 

When compiling the player and plugin all the necessary files (executable and libraries) are copied to the folder ''ROMP-binary-artifacts/install-source''.
This folder should contain all the necessary files to build the installation program - ''mplayer'', ''ffmpeg'', ''mplayer'', ''wget'', etc.