forked from nrkno/sofie-casparcg-server
-
Notifications
You must be signed in to change notification settings - Fork 0
/
BUILDING
141 lines (87 loc) · 4.23 KB
/
BUILDING
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
============================
Building the CasparCG Server
============================
The CasparCG Server source code uses the CMake build system in order to easily
generate build systems for multiple platforms. CMake is basically a build
system for generating build systems.
On Windows we can use CMake to generate a .sln file and .vcproj files. On
Linux CMake can generate make files or ninja files. Qt Creator has support for
loading CMakeLists.txt files directly.
Windows
=======
This section is based on a Windows 7 Professional installation. Other versions
of Windows might also work.
Prerequisites:
1. Install Visual Studio 2015.
2. Install CMake (http://www.cmake.org/download/).
3. Install 7Zip (www.7-zip.org/download.html).
Building a distribution
-----------------------
1. Go to the build-scripts folder.
2. If you have installed Visual Studio and 7Zip in the default locations, just
run set-variables-and-build-windows.bat, otherwise either edit it to suit
your needs or set the envirnoment variables and the run build-windows.bat
3. The distribution .zip file can be found under build/
Development using Visual Studio
-------------------------------
1. Unpack dependencies64/large_files_win32.7z
2. Create an empty directory called build in the source code root.
3. From the build directory type:
cmake -G "Visual Studio 14 2015" -A x64 ..
4. CasparCG Server.sln has now been generated and can be opened in Visual
Studio 2015 and built as usual from inside the IDE. Debug and
ReleaseWithDebInfo are the most useful configurations. Set "casparcg" as
startup project.
Linux
=====
All instructions are based on a clean install of the x86_64 version of Ubuntu
Desktop 14.04.3 LTS. Other distributions might work as well.
Prerequisites:
1. Install GCC, make and cmake etc:
sudo apt-get install build-essential cmake
2. Install development packages for libraries which are not bundled:
sudo apt-get install libxrandr-dev libjpeg-dev libsndfile1-dev libudev-dev libglu1-mesa-dev
Building a distribution
-----------------------
1. Enter the build-scripts folder.
2. Run ./set-variables-and-build-linux.sh (or edit it before running to change
default settings). You can also set the environment variables manually and
run ./build-linux.sh instead.
3. The distribution .tar.gz file can be found under build/
Building manually from command line
-----------------------------------
1. Start with unpacking dependencies64/large_files_linux.tar.xz:
cd dependencies64
tar xvJf large_files_linux.tar.xz
2. Create an empty directory called build in the source code root.
3. From the build directory type:
cmake -G "Unix Makefiles" -A x64 -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
...for a release build or:
cmake -G "Unix Makefiles" -A x64 -DCMAKE_BUILD_TYPE=Debug ..
...for a debug build.
4. A Makefile will have been generated allowing us to build using make:
make -j12
12 is the maximum number of parallel processes to compile via, and can be
changed to a more suitable number for the machine doing the compilation
(generally the number of hardware threads).
Development using Qt Creator
----------------------------
1. Start with unpacking dependencies64/large_files_linux.tar.xz:
cd dependencies64
tar xvJf large_files_linux.tar.xz
2. Install Qt Creator:
sudo apt-get install qt-creator
3. Start Qt Creator and open CMake project CMakeLists.txt from the source code
root.
4. Select where you want the shadow build to be performed. build/ directly
under the source code root is recommended.
5. Under the build settings enter the following as "CMake arguments" for the
"Release" build configuration:
-DCMAKE_BUILD_TYPE=RelWithDebInfo
...and for the "Debug" build configuration set it to:
-DCMAKE_BUILD_TYPE=Debug
6. For both "Release" and "Debug" build configurations expand the
Build Steps - Details section and add -j12 to the "Additional arguments"
(or any other number than 12 depending on the number of hardware threads
in the computer). This will enable parallel building.
7. Under "Run Settings" check the "Run in Terminal" checkbox.