The V-Play Engine Installation takes 3 steps:
To install the V-Play SDK, a V-Play account is required.
Go to https://v-play.net/pricing to create a new account. You can also upgrade your V-Play license there. If you already have a V-Play account, you can skip this step.
Open a terminal and install the following packages with
sudo apt-get install build-essential libglu1-mesa-dev libpulse-dev libglib2.0-dev
If the installed OS is lower than (but not equal to) Debian 8 or Ubuntu 17.04 also install these additional packages:
sudo apt-get install libgstreamer-plugins-base0.10-0
To install V-Play on Fedora or CentOS, see this guide for tips.
Open a terminal and install the following packages using
sudo pacman -S base-devel
If SSL is not working in your application, you may adjust the SSL library path because Arch Linux stores the needed SSL library versions in a different path. To do that, replace the
Exec=bash -c line in the
launcher shortcut to be found below with:
Exec=bash -c 'LD_LIBRARY_PATH=/usr/lib/openssl-1.0/ %%VPLAYDIR%%/Tools/QtCreator/bin/qtcreator.sh %F'
The above installation instructions may also work on derivatives of said distributions. Because there different dependencies per distribution there may be some packages missing for V-Play to work. In this case please try to
install the distributions Qt5 package to resolve missing dependencies. The package is usually called
V-Play and its contained software may not function properly if files or folders are symlinked (soft links). Thus always specify the real path to the V-Play installation folder on the filesystem and do not change its contents.
If you want to have an easy to use launcher, create the following file in your home directory, paste the contents and make it executable. Replace
%%%VPLAYDIR%%% with your V-Play installation directory:
.local/share/applications/qtcreator-vplay.desktop [Desktop Entry] Version=1.0 StartupNotify=false Type=Application NoDisplay=false Terminal=false Name=V-Play Qt Creator Icon=%%%VPLAYDIR%%%/VPlayLive/assets/vplay-logo.png Exec=bash -c '%%%VPLAYDIR%%%/Tools/QtCreator/bin/qtcreator.sh %F' Keywords=qt;c++;cpp;qml;vplay;v-play; Categories=Development;IDE;Qt; TryExec=%%%VPLAYDIR%%%/Tools/QtCreator/bin/qtcreator.sh Actions=maint;vpdocs;qtdocs; StartupWMClass=qtcreator [Desktop Action maint] Name=MaintenanceTool Exec=/mnt/store/Software/Portable/qt/vplay_linux64/MaintenanceTool [Desktop Action vpdocs] Name=-> V-Play Docs Exec=xdg-open "https://v-play.net/doc/" [Desktop Action qtdocs] Name=-> Qt Docs Exec=xdg-open "https://doc.qt.io/qt-5/index.html"
If you need any help to install V-Play on your PC or for other platforms, please contact us here.
Download the latest V-Play Installer from https://v-play.net/download/
Note: Please see Add V-Play to Existing Qt Installation if you already have a Qt installation on your system.
The Installer allows you to the select the parts of the V-Play & Qt SDK for your desired target platforms. So it helps to keep the download size small, because you can select beforehand which parts of the SDK are downloaded.
Open the V-Play Installer and follow the instructions on screen.
Note: By default, only a desktop-compiler is installed. You can add compilers for mobile platforms later on.
After opening Qt Creator, you will be asked to provide your login credentials. Enter the email address that you used for signing up and your password.
Note: To protect your account from unauthorized access, it is locked after ten failed login attempts. Please contact us if you accidentally locked your account.
After installation start Qt Creator and select
File/New Project. Choose a V-Play project for starting to develop V-Play.
Also have a look at the V-Play examples and demos: they are located in the folder of your Qt installation in the folder
We also prepared a lot of tutorials to get you started, you can find them in our documentation.
If you experience issues at installation or during development, please let us know in the V-Play Qt 5 support forum.
If you already installed Qt 5 on your system, install V-Play in parallel using our installer, to solve Qt and Qt Creator version compatibility issues. The V-Play and Qt installation will work side-by-side in two different directories.
However, you can try to add V-Play to your installation. Open the executable called Maintenance Tool and follow these steps:
Package Manager option so the
Settings button is shown in the bottom left corner.
Settings button and in the Settings window, click on the
Repositories tab. Click on the bottom section
User defined repositories and then click the
Now enter the URL for your development platform in the text box. It is either:
Next, confirm the V-Play installation repository with
OK and proceed with the
Package Manager option by pressing the
For a more detailed explanation, see the blog post How to Add V-Play to your Existing V-Play Installation.
Note: Each V-Play version is compatible with a certain Qt and Qt Creator version. For example, the V-Play version 2.12.1 uses Qt 5.9.0. If you are using an different version of Qt or Qt Creator that is used within V-Play, parts of the V-Play SDK will not work properly. Please have a look at the V-Play Update Guide to view recent changes and Qt version updates of V-Play, and to find out which Qt version is currently used by the latest V-Play version.
If you have problems adding V-Play to your installation, we recommed to install V-Play in addition to your existing Qt SDK by using the V-Play Installer. The two installations will not interfere with each other, and both work independently.
You can then proceed with the steps of Download & Install V-Play like described above.
If you have an existing Qt Mobile App, you can extend your Qt application with V-Play components to improve your mobile app experience. You can mix all of the V-Play and Qt components and have them combined in your project. For more information, please see our blog post How to Add V-Play to your Qt Mobile App.
Voted #1 for: