Skip to content

Developers guide: Setting up development environment

Amangeldi Zhusubaliev edited this page Sep 14, 2018 · 22 revisions
  1. Windows
    1.1. Install Microsoft Visual Studio
    1.2. Install Qt
    1.3. Install Git
    1.4. Required Libraries
  2. Linux (Ubuntu)
    2.1. Install Qt
    2.2. Install Git
    2.3. Install libssh
  3. MacOS
    3.1. Install Xcode
    3.2. Install Qt
    3.3. Install Git
    3.4. Install libssh
  4. Cloning Control Center repository

Windows

Install Microsoft Visual Studio

Get online installer here

When installing, in Worklads tab, check marks:

  1. Windows
    1.1. Universal Windows Platform development
    1.2. .NET Desktop development
    1.3. Desktop development with C++

In Summary field, marks should be on these items:

  1. Universal Windows Platform development
    1.1. Blend for Visual Studio
    1.2. .NET Native and .NET Standard
    1.3. NuGet package manager
    1.4. Universal Windows Platform tools
    1.5. Windows 10 SDK (10.0.17134.0)
    1.6. Graphics debugger and GPU profiler for DirectX

  2. .NET desktop development
    2.1. .NET desktop development tools
    2.2. .NET Framework 4.6.1 development tools
    2.3. C# and Visual Basic
    2.4. Blend for Visual Studio
    2.5. .NET profiling tools
    2.6. Just-In-Time debugger

  3. Desktop development with C++
    3.1. Visual C++ core desktop features
    3.2. Just-In-Time debugger
    3.3. VC++ 2017 version 15.7 v14.14 latest v141 tools
    3.4. C++ profiling tools
    3.5. Windows 10 SDK (10.0.17134.0)
    3.6. Visual C++ tools for CMake
    3.7. Visual C++ ATL for x86 and x64
    3.8. Test Adapter for Boost.Test
    3.9. Test Adapter for Google Test

install Qt

Get online installer here.

In Select Component step check these components:
In Qt:

  1. Qt 5.10.0
    1.1. MSVC 2015 32-bit
    1.2. MSVC 2015 64-bit
    1.3. MSVC 2017 64-bit
    1.4. Sources
    1.5. Qt Charts
    1.6. Qt WebEngine
    1.7. Qt Network Authorization
    1.8. Qt Remote Objects (TP)
    1.9. Qt WebGL Streaming Plugin (TP)
    1.10. Qt Script (Deprecated)
  2. Tools
    2.1. Qt Creator 4.6.1 CDB Debugger Support
    2.2. Qt Installer Framework 3.0

Install Git

Get installer here

Check if PATH variable contains git directory:

  1. Open Command Prompt
  2. run echo %PATH% command
  3. check if PATH contains ..\Git\cmd directory
    3.1. if it doesn't contain, press Win+S to open search
    3.2. type in Edit the system environment variables, press Enter
    3.3. press Environment Variables...
    3.4. in System variables panel double click on Path variable.
    3.5. Press New then, add ..\installedDirectory\Git\cmd (default directory is C:\Program Files\Git\cmd)
    3.6. Press OK and close these windows.

Required Libraries

After Cloning Control Center repository step, there is one more thing to do - CC requires these libraries. Extract these three libraries to control-center\libssh2\lib\win32 directory.

Linux (Ubuntu)

install Qt

Get online installer here.

If it is not installing (.run file), try this:

  1. open terminal in directory of 'qt-unified-linux-x64-3.0.4-online.run' (versions may vary) file.
  2. run this command: chmod +x qt-unified-linux-x64-3.0.4-online.run.
  3. run installer by double-clicking on it.

In Select Component step check these components:
In Qt:

  1. Qt 5.10.0
    1.1. Desktop gcc 64-bit
    1.2. Sources
    1.3. Qt Charts
    1.4. Qt WebEngine
    1.5. Qt Network Authorization
    1.6. Qt Remote Objects (TP)
    1.7. Qt WebGL Streaming Plugin (TP)
    1.8. Qt Script (Deprecated)
  2. Tools
    2.1. Qt Installer Framework 3.0

Also install these components:

  1. generic font configuration library - runtime
    1.1. run this command in terminal: sudo apt-get install libfontconfig1
  2. OpenGL libraries
    1.1. run this command in terminal: sudo apt-get install mesa-common-dev
    1.2. run this command in terminal: sudo apt-get install libglu1-mesa-dev -y

If you face troubles, please read this wiki.

Install Git

  1. just run these commands in terminal:
    1.1. sudo apt-get update
    1.2. sudo apt-get upgrade
    1.3. sudo apt-get install git

Install libssh

  1. just run these commands in terminal:
    1.1. sudo apt-get install libssh2-1-dev
    1.2. sudo apt-get install libssh-dev

MacOS

install Xcode

You can install it from App Store. Simply open App Store, search for Xcode and install it. If you are facing compatibility problems (old version of Mac etc.), find older version of Xcode here.

install Qt

Get online installer here.

In Select Component step check these components:
In Qt:

  1. Qt 5.9.0 or higher version
    1.1. macOS
    1.2. Sources
    1.3. Qt Charts
    1.4. Qt WebEngine
    1.5. Qt Network Authorization
    1.6. Qt Remote Objects (TP)
    1.7. Qt WebGL Streaming Plugin (TP)
    1.8. Qt Script (Deprecated)
  2. Tools
    2.1. Qt Creator 4.6.1
    2.2. Qt Installer Framework 3.0

Install Git

Get installer here

Install libssh

  1. just run this command in terminal:
    1.1. brew install libssh2

Cloning Control Center repository

  1. Go to profile settings
  2. Go to SSH and GPG keys
  3. Add New SSH key
    3.1. Adding SSH keys
  4. Download
    4.1. Go to CC github page
    4.2. Press Clone or download
    4.3. Press Use SSH
    4.4. Copy the SSH address
    4.5. Run this command in terminal/cmd: git clone 'paste SSH address from step 4.4 here, without quotes'