Mirrors/overte
3
0
Fork 0
mirror of https://github.com/overte-org/overte.git synced 2025-07-23 13:44:32 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Cleanup.

Browse source
This commit is contained in:
NissimHadar 2019-04-25 08:53:25 -07:00
parent bf1d73b413
commit 450bc96c39
1 changed files with 146 additions and 149 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

295
tools/qt-builder/README.md
View file

@ -15,167 +15,165 @@ Add path to python executable to PATH.
NOTE: REMOVE python 3 from PATH. Our regular build uses python 3. This will still work, because HIFI_PYTHON_EXEC points to the python 3 executable. NOTE: REMOVE python 3 from PATH. Our regular build uses python 3. This will still work, because HIFI_PYTHON_EXEC points to the python 3 executable.
Verify that python runs python 2.7 (run “python --version”) Verify that python runs python 2.7 (run “python --version”)
1. git >= 1.6 1. git >= 1.6
Check if needed `git --version` Check if needed `git --version`
Download from https://git-scm.com/download/win Download from https://git-scm.com/download/win
Verify by entering `git --version` Verify by entering `git --version`
1. perl >= 5.14 1. perl >= 5.14
Install from Strawberry Perl - http://strawberryperl.com/ - 5.28.1.1 64 bit to C:\Strawberry\ Install from Strawberry Perl - http://strawberryperl.com/ - 5.28.1.1 64 bit to C:\Strawberry\
Verify by running `perl --version` Verify by running `perl --version`
1. flex and bison 1. flex and bison
Download from https://sourceforge.net/projects/winflexbison/files/latest/download Download from https://sourceforge.net/projects/winflexbison/files/latest/download
Uncompress in C:\flex_bison Uncompress in C:\flex_bison
Rename win-bison.exe to bison.exe and win-flex.exe to flex.exe Rename win-bison.exe to bison.exe and win-flex.exe to flex.exe
Add C:\flex_bison to PATH Add C:\flex_bison to PATH
Verify by running `flex --version` Verify by running `flex --version`
Verify by running `bison --version` Verify by running `bison --version`
1. gperf 1. gperf
Install from http://gnuwin32.sourceforge.net/downlinks/gperf.php Install from http://gnuwin32.sourceforge.net/downlinks/gperf.php
Add C:\Program Files (x86)\GnuWin32\bin to PATH Add C:\Program Files (x86)\GnuWin32\bin to PATH
Verify by running `gperf --version` Verify by running `gperf --version`
1. 7-zip 1. 7-zip
Download from https://www.7-zip.org/download.html Download from https://www.7-zip.org/download.html
1. Bash shell 1. Bash shell
From *Settings* select *Update & Security* From *Settings* select *Update & Security*
Select *For Developers* Select *For Developers*
Enable *Developer mode* Enable *Developer mode*
Restart PC Restart PC
Open Control Panel and select *Programs and Features* Open Control Panel and select *Programs and Features*
Select *Turn Windows features on or off* Select *Turn Windows features on or off*
Check *Windows Subsystem for Linux* Check *Windows Subsystem for Linux*
Click *Restart now* Click *Restart now*
Download from the Microsoft Store - Search for *bash* and choose the latest Ubuntu version Download from the Microsoft Store - Search for *bash* and choose the latest Ubuntu version
[First run will take a few minutes] [First run will take a few minutes]
Enter a user name - all small letters (this is not required for later use) Enter a user name - all small letters (this is used for *sudo* commands)
Choose a password Choose a password
### Linux ### Linux
Tested on Ubuntu 18.04 Tested on Ubuntu 18.04
1. qt5 requirements 1. qt5 requirements
edit /etc/apt/sources.list (edit as root) edit /etc/apt/sources.list (edit as root)
replace all *# deb-src* with *deb-src* (in vi `1,$s/# deb-src/deb-src/`) replace all *# deb-src* with *deb-src* (in vi `1,$s/# deb-src/deb-src/`)
`sudo apt-get update -y` `sudo apt-get update -y`
`sudo apt-get upgrade -y` `sudo apt-get upgrade -y`
`sudo apt-get build-dep qt5-default -y` `sudo apt-get build-dep qt5-default -y`
1. git >= 1.6 1. git >= 1.6
Check if needed `git --version` Check if needed `git --version`
`sudo apt-get install git -y` `sudo apt-get install git -y`
Verify again Verify again
1. python 1. python
Check if needed `python --version` - should return python 2.7.x Check if needed `python --version` - should return python 2.7.x
`sudo apt-get install python -y` (not python 3!) `sudo apt-get install python -y` (not python 3!)
Verify again Verify again
1. gperf 1. gperf
Check if needed `gperf --version` Check if needed `gperf --version`
`sudo apt-get install gperf -y` `sudo apt-get install gperf -y`
Verify again Verify again
1. bison and flex 1. bison and flex
Check if needed `flex --version` and `bison --version` Check if needed `flex --version` and `bison --version`
`sudo apt-get install flex bison -y` `sudo apt-get install flex bison -y`
Verify again Verify again
1. pkg-config (needed for qtwebengine) 1. pkg-config (needed for qtwebengine)
Check if needed `pkg-config --version` Check if needed `pkg-config --version`
`sudo apt-get install pkg-config -y` `sudo apt-get install pkg-config -y`
Verify again Verify again
1. OpenGL 1. OpenGL
Verify (first install mesa-utils - `sudo apt install mesa-utils -y`) by `glxinfo | grep "OpenGL version"` Verify (first install mesa-utils - `sudo apt install mesa-utils -y`) by `glxinfo | grep "OpenGL version"`
`sudo apt-get install libgl1-mesa-dev -y` `sudo apt-get install libgl1-mesa-dev -y`
`sudo ln -s /usr/lib/x86_64-linux-gnu/libGL.so.346.35 /usr/lib/x86_64-linux-gnu/libGL.so.1.2.0` `sudo ln -s /usr/lib/x86_64-linux-gnu/libGL.so.346.35 /usr/lib/x86_64-linux-gnu/libGL.so.1.2.0`
Verify again Verify again
1. make 1. make
Check if needed `make --version` Check if needed `make --version`
`sudo apt-get install make -y` `sudo apt-get install make -y`
Verify again Verify again
1. g++ 1. g++
Check if needed Check if needed
`g++ --version` `g++ --version`
`sudo apt-get install g++ -y` `sudo apt-get install g++ -y`
Verify again Verify again
1. dbus-1 (needed for qtwebengine) 1. dbus-1 (needed for qtwebengine)
`sudo apt-get install libdbus-glib-1-dev -y` `sudo apt-get install libdbus-glib-1-dev -y`
1. nss (needed for qtwebengine) 1. nss (needed for qtwebengine)
`sudo apt-get install libnss3-dev -y` `sudo apt-get install libnss3-dev -y`
### Mac ### Mac
1. git >= 1.6 1. git >= 1.6
Check if needed `git --version` Check if needed `git --version`
Install from https://git-scm.com/download/mac Install from https://git-scm.com/download/mac
Verify again Verify again
1. pkg-config 1. pkg-config
brew fontconfig dbus-glib stall pkg-config brew fontconfig dbus-glib stall pkg-config
1. dbus-1 1. dbus-1
brew install dbus-glib brew install dbus-glib
## Build Process ## Build Process
### General ### General
qt is cloned to the qt5 folder. qt is cloned to the qt5 folder.
The build is performed in the qt5-build folder. The build is performed in the qt5-build folder.
Build products are installed to the qt5-install folder. Build products are installed to the qt5-install folder.
Before running configure, make sure that the qt5-build folder is empty. Before running configure, make sure that the qt5-build folder is empty.
**Only run the patches once!!!** **Only run the patches once!!!**
### Windows ### Windows
Before building, verify that **HIFI_VCPKG_BASE_VERSION** points to a *vcpkg* folder containing *packages\openssl-windows_x64-windows*. If not, follow https://github.com/highfidelity/vcpkg to install *vcpkg* and then *openssl*. Before building, verify that **HIFI_VCPKG_BASE_VERSION** points to a *vcpkg* folder containing *packages\openssl-windows_x64-windows*.
If not, follow https://github.com/highfidelity/vcpkg to install *vcpkg* and then *openssl*.
#### Preparing source files #### Preparing source files
`git clone --recursive https://code.qt.io/qt/qt5.git -b 5.12.3 --single-branch` `git clone --recursive https://code.qt.io/qt/qt5.git -b 5.12.3 --single-branch`
* Copy the **patches** folder to qt5 * Copy the **patches** folder to qt5
* Copy the **qt5vars.bat** file to qt5 * Copy the **qt5vars.bat** file to qt5
* Apply the two patches to Qt * Apply the two patches to Qt
`cd qt5` `cd qt5`
`git apply --ignore-space-change --ignore-whitespace patches/qfloat16.patch` `git apply --ignore-space-change --ignore-whitespace patches/qfloat16.patch`
`git apply --ignore-space-change --ignore-whitespace patches/aec.patch` `git apply --ignore-space-change --ignore-whitespace patches/aec.patch`
`cd ..` `cd ..`
#### Configuring #### Configuring
`mkdir qt5-install` `mkdir qt5-install`
`mkdir qt5-build` `mkdir qt5-build`
`cd qt5-build` `cd qt5-build`
run `..\qt5\qt5vars.bat` run `..\qt5\qt5vars.bat`
`cd ..\..\qt5-build` `cd ..\..\qt5-build`
`..\qt5\configure -opensource -confirm-license -opengl desktop -platform win32-msvc -openssl-linked OPENSSL_LIBS="-lssleay32 -llibeay32" -I %HIFI_VCPKG_BASE_VERSION%\packages\openssl-windows_x64-windows\include -L %HIFI_VCPKG_BASE_VERSION%\packages\openssl-windows_x64-windows\lib -nomake examples -nomake tests -skip qttranslations -skip qtserialport -skip qt3d -skip qtlocation -skip qtwayland -skip qtsensors -skip qtgamepad -skip qtspeech -skip qtcharts -skip qtx11extras -skip qtmacextras -skip qtvirtualkeyboard -skip qtpurchasing -skip qtdatavis3d -no-warnings-are-errors -no-pch -prefix ..\qt5-install` `..\qt5\configure -opensource -confirm-license -opengl desktop -platform win32-msvc -openssl-linked OPENSSL_LIBS="-lssleay32 -llibeay32" -I %HIFI_VCPKG_BASE_VERSION%\packages\openssl-windows_x64-windows\include -L %HIFI_VCPKG_BASE_VERSION%\packages\openssl-windows_x64-windows\lib -nomake examples -nomake tests -skip qttranslations -skip qtserialport -skip qt3d -skip qtlocation -skip qtwayland -skip qtsensors -skip qtgamepad -skip qtspeech -skip qtcharts -skip qtx11extras -skip qtmacextras -skip qtvirtualkeyboard -skip qtpurchasing -skip qtdatavis3d -no-warnings-are-errors -no-pch -prefix ..\qt5-install`
#### Make #### Make
`nmake` `nmake`
`nmake install` `nmake install`
#### Fixing #### Fixing
The *.prl* files have an absolute path that needs to be removed (see http://www.linuxfromscratch.org/blfs/view/stable-systemd/x/qtwebengine.html) The *.prl* files have an absolute path that needs to be removed (see http://www.linuxfromscratch.org/blfs/view/stable-systemd/x/qtwebengine.html)
1. Open a bash terminal 1. Open a bash terminal
1. `cd` to the *qt5-install* folder (e.g. `cd /mnt/d/qt5-install/`) 1. `cd` to the *qt5-install* folder (e.g. `cd /mnt/d/qt5-install/`)
1. Run the following command 1. Run the following command
` find . -name \*.prl -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;` ` find . -name \*.prl -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;`
#### Uploading #### Uploading
Create a tar file called qt5-install.tar from the qt5-install folder (e.g. using 7-zip) Create a tar file called qt5-install.tar from the qt5-install folder (e.g. using 7-zip)
Create a gzip file called qt5-install.tar.gz from the qt5-install.tar file just created (e.g. using 7-zip) Create a gzip file called qt5-install.tar.gz from the qt5-install.tar file just created (e.g. using 7-zip)
Upload qt5-install.tar.gz to https://hifi-qa.s3.amazonaws.com/qt5/Windows/ Upload qt5-install.tar.gz to https://hifi-qa.s3.amazonaws.com/qt5/Windows/
### Linux ### Linux
#### Preparing source files #### Preparing source files
`git clone --recursive git://code.qt.io/qt/qt5.git -b 5.12.3 --single-branch` `git clone --recursive git://code.qt.io/qt/qt5.git -b 5.12.3 --single-branch`
* Copy the **patches** folder to qt5 * Copy the **patches** folder to qt5
* Apply one patch to Qt * Apply one patch to Qt
`cd qt5` `cd qt5`
`git apply --ignore-space-change --ignore-whitespace patches/aec.patch` `git apply --ignore-space-change --ignore-whitespace patches/aec.patch`
`cd ..` `cd ..`
#### Configuring #### Configuring
`mkdir qt5-install`
`mkdir qt5-build`
`cd qt5-build`
`mkdir qt5-install` `../qt5/configure -opensource -confirm-license -platform linux-g++-64 -nomake examples -nomake tests -skip qttranslations -skip qtserialport -skip qt3d -skip qtlocation -skip qtwayland -skip qtsensors -skip qtgamepad -skip qtspeech -skip qtcharts -skip qtx11extras -skip qtmacextras -skip qtvirtualkeyboard -skip qtpurchasing -skip qtdatavis3d -no-warnings-are-errors -no-pch -prefix ../qt5-install`
`mkdir qt5-build`
`cd qt5-build`
`../qt5/configure -opensource -confirm-license -platform linux-g++-64 -nomake examples -nomake tests -skip qttranslations -skip qtserialport -skip qt3d -skip qtlocation -skip qtwayland -skip qtsensors -skip qtgamepad -skip qtspeech -skip qtcharts -skip qtx11extras -skip qtmacextras -skip qtvirtualkeyboard -skip qtpurchasing -skip qtdatavis3d -no-warnings-are-errors -no-pch -prefix ../qt5-install`
#### Make #### Make
`make` `make`
`make install` `make install`
#### Fixing #### Fixing
The *.prl* files have an absolute path that needs to be removed (see http://www.linuxfromscratch.org/blfs/view/stable-systemd/x/qtwebengine.html) The *.prl* files have an absolute path that needs to be removed (see http://www.linuxfromscratch.org/blfs/view/stable-systemd/x/qtwebengine.html)
`cd ../qt5-install` `cd ../qt5-install`
` find . -name \*.prl -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;` ` find . -name \*.prl -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;`
#### Uploading #### Uploading
1. Return to the home folder 1. Return to the home folder
`cd ..` `cd ..`
1. Open a python 3 shell
1. Open a python 3 shell `python3`
`python3`
1. Run the following snippet: 1. Run the following snippet:
`import os` `import os`
`import tarfile` `import tarfile`
@ -183,28 +181,27 @@ The *.prl* files have an absolute path that needs to be removed (see http://www.
`filename.add("qt5-install", os.path.basename("qt5-install"))` `filename.add("qt5-install", os.path.basename("qt5-install"))`
`exit()` `exit()`
1. Upload qt5-install.tar.gz to https://hifi-qa.s3.amazonaws.com/qt5/Ubuntu/ 1. Upload qt5-install.tar.gz to https://hifi-qa.s3.amazonaws.com/qt5/Ubuntu/
### Mac ### Mac
#### Preparing source files #### Preparing source files
git clone --recursive git://code.qt.io/qt/qt5.git -b 5.12.3 --single-branch git clone --recursive git://code.qt.io/qt/qt5.git -b 5.12.3 --single-branch
* Copy the **patches** folder to qt5 * Copy the **patches** folder to qt5
* Apply one patch to Qt * Apply one patch to Qt
`cd qt5` `cd qt5`
`git apply --ignore-space-change --ignore-whitespace patches/aec.patch` `git apply --ignore-space-change --ignore-whitespace patches/aec.patch`
`cd ..` `cd ..`
#### Configuring #### Configuring
`mkdir qt5-install` `mkdir qt5-install`
`mkdir qt5-build` `mkdir qt5-build`
`cd ../qt5-build` `cd ../qt5-build`
`../qt5/configure -opensource -confirm-license -nomake examples -nomake tests -skip qttranslations -skip qtserialport -skip qt3d -skip qtlocation -skip qtwayland -skip qtsensors -skip qtgamepad -skip qtspeech -skip qtcharts -skip qtx11extras -skip qtmacextras -skip qtvirtualkeyboard -skip qtpurchasing -skip qtdatavis3d -no-warnings-are-errors -no-pch -prefix ../qt5-install` `../qt5/configure -opensource -confirm-license -nomake examples -nomake tests -skip qttranslations -skip qtserialport -skip qt3d -skip qtlocation -skip qtwayland -skip qtsensors -skip qtgamepad -skip qtspeech -skip qtcharts -skip qtx11extras -skip qtmacextras -skip qtvirtualkeyboard -skip qtpurchasing -skip qtdatavis3d -no-warnings-are-errors -no-pch -prefix ../qt5-install`
#### Make #### Make
`make` `make`
`make install` `make install`
#### Fixing
#### Uploading #### Uploading
`tar -zcvf qt5-install.tar.gz qt5-install` `tar -zcvf qt5-install.tar.gz qt5-install`
Upload qt5-install.tar.gz to https://hifi-qa.s3.amazonaws.com/qt5/Mac/ Upload qt5-install.tar.gz to https://hifi-qa.s3.amazonaws.com/qt5/Mac/
## Problems ## Problems
*configure* errors, if any, may be viewed in **config.log** and **config.summary** *configure* errors, if any, may be viewed in **config.log** and **config.summary**