diff options
author | Antenore Gatta <antenore@simbiosi.org> | 2020-02-28 18:53:37 +0300 |
---|---|---|
committer | Antenore Gatta <antenore@simbiosi.org> | 2020-02-28 18:53:37 +0300 |
commit | d0e08a6c90251152a663bdef62a5b9a03afc6ee0 (patch) | |
tree | 937bfeb371bb4a190fdfc71c0e0960c907783762 /Compilation | |
parent | e757130dd8b62a6f56f94bcbeac3898f688931a1 (diff) |
Fixing layout and style
Diffstat (limited to 'Compilation')
-rw-r--r-- | Compilation/Compilation.md | 3 | ||||
-rw-r--r-- | Compilation/Compile-on-Ubuntu-20.04.md | 132 |
2 files changed, 134 insertions, 1 deletions
diff --git a/Compilation/Compilation.md b/Compilation/Compilation.md index 8b65ea9..29ada59 100644 --- a/Compilation/Compilation.md +++ b/Compilation/Compilation.md @@ -8,4 +8,5 @@ We have tested the compilation of Remmina on several operating systems. Unfortun - [Compile on FreeBSD](/Compilation/Compile-on-FreeBSD) - [Compile on Ubuntu 14.04](/Compilation/Compile-on-Ubuntu-14.04) - [Compile on Ubuntu 16.04](/Compilation/Compile-on-Ubuntu-16.04) -- [Compile on Ubuntu 18.04](/Compilation/Compile-on-Ubuntu-18.04)
\ No newline at end of file +- [Compile on Ubuntu 18.04](/Compilation/Compile-on-Ubuntu-18.04) +- [Compile on Ubuntu 18.04](/Compilation/Compile-on-Ubuntu-20.04.md) diff --git a/Compilation/Compile-on-Ubuntu-20.04.md b/Compilation/Compile-on-Ubuntu-20.04.md new file mode 100644 index 0000000..cf6857d --- /dev/null +++ b/Compilation/Compile-on-Ubuntu-20.04.md @@ -0,0 +1,132 @@ +# Quick and dirty guide for compiling remmina on ubuntu 18.04 + +These are instructions for people or software developers who want to contribute to the latest version of Remmina on Ubuntu 20.04. + +If you are an end user and you want to install the latest version of remmina, please use the "Remmina Team Ubuntu PPA - next branch", as explained on the [homepage of the wiki](https://gitlab.com/Remmina/Remmina/wikis/home). + +By following these instructions, you will get Remmina and FreeRDP compiled under the /opt/remmina_devel/ subdir, so they will not mess up your system too much. This is ideal for testing remmina. + +You will also find the uninstall instructions at the bottom of this page. + +**1.** Install all packages required to build freerdp and remmina: + +```shell +sudo apt install build-essential git-core cmake libssl-dev libx11-dev libxext-dev libxinerama-dev \ + libxcursor-dev libxdamage-dev libxv-dev libxkbfile-dev libasound2-dev libcups2-dev libxml2 libxml2-dev \ + libxrandr-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ + libxi-dev libavutil-dev \ + libavcodec-dev libxtst-dev libgtk-3-dev libgcrypt20-dev libssh-dev libpulse-dev \ + libvte-2.91-dev libxkbfile-dev libtelepathy-glib-dev libjpeg-dev \ + libgnutls28-dev libavahi-ui-gtk3-dev libvncserver-dev \ + libappindicator3-dev intltool libsecret-1-dev libwebkit2gtk-4.0-dev libsystemd-dev \ + libsoup2.4-dev libjson-glib-dev libavresample-dev libsodium-dev \ + libusb-1.0-0-dev +``` + +**2.** Remove freerdp-x11 package and all packages containing the string remmina in the package name. + +```shell +sudo apt purge "?name(^remmina.*)" "?name(^libfreerdp.*)" "?name(^freerdp.*)" "?name(^libwinpr.*)" +``` + +**3.** Create a new directory for development in your home directory, and cd into it + +```shell +mkdir ~/remmina_devel +cd ~/remmina_devel +``` + +**4.** Download the latest source code of FreeRDP from its master branch + +```shell +git clone https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` + +**5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON) + +```shell +cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_SSE2=ON -DWITH_CUPS=on -DWITH_PULSE=on -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/freerdp . +``` + +Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp + +**6.** Compile FreeRDP and install + +```shell +make && sudo make install +``` + +**7.** Make your system dynamic loader aware of the new libraries you installed. For Ubuntu x64: + +```shell +echo /opt/remmina_devel/freerdp/lib | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null +sudo ldconfig +``` + +**8.** Create a symbolik link to the executable in /usr/local/bin + +```shell +sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` + +**9.** Test the new freerdp by connecting to a RDP host + +```shell +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` + +**10.** Now clone remmina repository to your devel dir: + +```shell +cd ~/remmina_devel +git clone https://gitlab.com/Remmina/Remmina.git +``` + +**11.** Configure Remmina for compilation + +```shell +cd Remmina +cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` + +**12.** Compile remmina and install it + +```shell +make && sudo make install +``` + +**13.** Create a symbolik link to the the executable + +```shell +sudo ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/ +``` + +**14.** Run remmina + +```shell +remmina +``` + +Please note that icons and launcher files are not installed, so don't search for remmina using Unity Dash. + +## Uninstall everything + +**1.** Remove the devel directory + +```shell +rm -rf ~/remmina_devel/ +``` + +**2.** Remove the binary directory + +```shell +sudo rm -rf /opt/remmina_devel/ +``` + +**3.** Cleanup symlinks and dynamic loader + +```shell +sudo rm /etc/ld.so.conf.d/freerdp_devel.conf /usr/local/bin/remmina /usr/local/bin/xfreerdp +sudo ldconfig +``` |