ultimatepp/uppbox/Scripts

U++ POSIX/X11 installation

Standard POSIX/X11 distribution of U++ comes as a source tarball. If you want to run U++ graphical environnement (theide) or run U++ command line tool (umk), you will first need to compile and install U++.

Build Requires

Before compiling U++ source code, you must install a few developpement packages. Many POSIX/X11 distributions provides developpement packages with the same names. Sometimes, developpement package names don't match. You will have to find the corresponding names for your distribution.

Build requires per distribution

Debian/apt-get based distributions

Build requires: g++ make libgtk2.0-dev libnotify-dev libbz2-dev sox

How to install them:

if sudo is available and enabled on your distribution, copy/paste this in a terminal:

sudo apt-get install  g++  make  libgtk2.0-dev  libnotify-dev  libbz2-dev  sox

if sudo is not available:

su -c 'apt-get install  g++  make  libgtk2.0-dev  libnotify-dev  libbz2-dev  sox'

The 'buildrequires.debian' file in U++ tarball contains apt-get commands to do the same thing. You can use this file by running 'sh buildrequires.debian' as root (e.g. 'sudo sh buildrequires.debian' if sudo is available or 'su -c "sh buildrequires.debian"' if not).

Fedora based distributions

Build requires: gtk2-devel pango-devel atk-devel cairo-devel libnotify-devel bzip2-devel xorg-x11-server-devel freetype-devel expat-devel

How to install them:

if sudo is available and enabled on your distribution, copy/paste this in a terminal:

sudo yum install  gtk2-devel  pango-devel  atk-devel  cairo-devel  libnotify-devel  bzip2-devel xorg-x11-server-devel  freetype-devel  expat-devel

if sudo is not available:

su -c 'yum install  gtk2-devel  pango-devel  atk-devel  cairo-devel  libnotify-devel  bzip2-devel xorg-x11-server-devel  freetype-devel  expat-devel'

The 'buildrequires.fedora' file in U++ tarball contains yum commands to do the same thing. You can use this file by running 'sh buildrequires.fedora' as root (e.g. 'sudo sh buildrequires.fedora' if sudo is available or 'su -c "sh buildrequires.fedora"' if not).

Other rpm based distributions

Redhat 7 build requires: gtk2-devel pango-devel atk-devel cairo-devel libnotify-devel freetype-devel expat-devel bzip2-devel OpenSuse build requires: gtk2-devel pango-devel atk-devel cairo-devel libnotify-devel xorg-x11-devel freetype2-devel libexpat-devel libbz2-devel

BSD based distributions

Build requires: bash gmake gtk2 freetype2 libnotify clang-devel (e.g. clang++)

How to install them:

if sudo is available and enabled on your distribution, copy/paste this in a terminal:

sudo pkg install bash gmake gtk2 freetype2 libnotify clang-devel

if sudo is not available:

su -m root -c 'pkg install bash gmake gtk2 freetype2 libnotify clang-devel'

Compile U++ source code

Standard U++ compilation

First, uncompress U++ source tarball and change dir to the new created directory.

Example: for upp-x11-src-10641.tar.gz

version=10641
tar zxvf upp-x11-src-$version.tar.gz
cd upp-x11-src-$version

Use 'make' to compile U++ and generate theide (U++ integrated development environment) and umk (commandline tool for building U++ projects) then run 'make install' to prepare standard U++ environment:

make
make install

Now you can start playing with U++ by invoking ~/theide. You might want to put theide and umk elsewhere later, e.g. inside ~/bin/ for example

Note:. 'make install' copy theide and umk in your home directory but it also:

• create ~/upp directory to store U++ library sources and copy the U++ sources inside
• create ~/upp/MyApps to store your application sources
• create ~/upp.out as output for intermediate files
• set up a few variables in the '~/.upp' directory. Those variables are required by umk and theide

Troubleshooting

If your POSIX/X11 distribution use an old gcc version (< 4.9), U++ compilation will fail because of missing gcc c++11 standard implementation. To solve this, you need to install and use clang++ compiler instead of g++. In order to use clang++ as compiler, run make with those extra parameters:

make -e CXX="clang++" -e CXXFLAGS="-O3 -ffunction-sections -fdata-sections -Wno-logical-op-parentheses -std=c++11"
make install

On BSD distributions, if you use make instead of gmake, U++ compilation will fail because BSD 'make' needs four dollar characters ('$') to escape one. To solve this, you can install gmake or, if you want to play in a dangerous territory, you can manually (or with sed or awk) modify 'uppsrc/Makefile.in' and 'uppsrc/uMakefile.in'. You will have to change all file names containing '$$' with '$$$$'. Those file names are already escaped for gmake. This is why they already use two dollars ('$$').

U++ spec file for rpm based distribution

There is an alternative way to build U++ on rpm based distributions. Indead, U++ POSIX/X11 tarball contains a spec file for you to build a standard rpm binary and source file. To do that, first install U++ build requires and rpm-build than build U++:

Fedora based distributions

if sudo is available and enabled on your distribution, copy/paste this in a terminal:

sudo yum install  gtk2-devel  pango-devel  atk-devel  cairo-devel  libnotify-devel  bzip2-devel xorg-x11-server-devel  freetype-devel  expat-devel
sudo yum install  rpm-build
version=10641
rpmbuild -ta upp-x11-src-$version.tar.gz

if sudo is not available:

su -c 'yum install  gtk2-devel  pango-devel  atk-devel  cairo-devel  libnotify-devel  bzip2-devel xorg-x11-server-devel  freetype-devel  expat-devel'
su -c 'yum install  rpm-build'
version=10641
rpmbuild -ta upp-x11-src-$version.tar.gz

Note : the rpm binary doesn't install U++ source in your home directory nor does it create needed configuration for U++ command line tool (umk) after installation. Theide will take care of all this on first start.