Difference between revisions of "ROMP Developer Guide"

Latest revision as of 12:46, 10 April 2013

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
2) Generic compilation
3) Changing installation path

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.

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:

• Qt libraries 4.8.4 for Windows (VS 2010, 234 MB)
• Visual Studio 2010 Express
• QJSON ([1])
• 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 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.