RepoMirrors
/
tdesktop
mirror of https://github.com/telegramdesktop/tdesktop
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
tdesktop/docs/building-xcode.md

242 lines
7.9 KiB
Markdown
Raw Normal View History

Update instructions for Xcode 10.1.
2019-01-05 12:34:34 +00:00
## Build instructions for Xcode 10.1
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Fix headers in building docs. Closes #3182
2017-04-04 09:17:54 +00:00
### Prepare folder
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
Choose a folder for the future build, for example **/Users/user/TBuild**. It will be named ***BuildPath*** in the rest of this document. All commands will be launched from Terminal.
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
Don't provide 'api_id' and 'api_hash' by default. We ask the developer to obtain his own api credentials, because the bundled 'api_id' / 'api_hash' are strictly limited by the server. The old credentials still could be used for test purposes, but the developer will need to explicitly opt-in to use them.
2018-11-04 10:29:30 +00:00
### Obtain your API credentials
You will require **api_id** and **api_hash** to access the Telegram API servers. To learn how to obtain them [click here][api_credentials].
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
### Download libraries
Fix some format, add warning on file hierarchy, fix typo and create list for readability.Signed-off-by: Fabrice Edon <fabrice.edon@gmail.com> (github: Bl4ck4t)
2015-12-05 19:07:40 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
Download [**xz-5.0.5**](http://tukaani.org/xz/xz-5.0.5.tar.gz) and unpack to ***BuildPath*/Libraries/xz-5.0.5**
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
Download [**libiconv-1.15**](http://www.gnu.org/software/libiconv/#downloading) and unpack to ***BuildPath*/Libraries/libiconv-1.15**
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
### Clone source code and prepare libraries
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
Go to ***BuildPath*** and run
fixed openal for os x 10.7 and 10.8
2015-01-10 13:07:26 +00:00
Updated building-xcode.md. Moved number of threads into variable.
2019-04-21 08:46:57 +00:00
MAKE_THREADS_CNT=-j4
Using custom build of libc++ for old OS X version. This will allow us to use C++14 library on all platforms. Patches for macold versions got bigger and are now different for crashpad and mini_chromium, so they were moved to a separate folder.
2017-02-17 09:48:31 +00:00
MACOSX_DEPLOYMENT_TARGET=10.8
fixed openal for os x 10.7 and 10.8
2015-01-10 13:07:26 +00:00
Fix xcode build instructions (#4345)
2018-01-26 00:55:31 +00:00
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Add brew install cmake ninja
2019-03-03 16:46:21 +00:00
brew install automake cmake fdk-aac git lame libass libtool libvorbis libvpx ninja opus sdl shtool texi2html theora wget x264 xvid yasm pkg-config
Fix xcode build instructions (#4345)
2018-01-26 00:55:31 +00:00
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
git clone --recursive https://github.com/telegramdesktop/tdesktop.git
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd Libraries
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Use range-v3 0.5.0 in instructions. Fixes #6097.
2019-06-06 11:48:18 +00:00
git clone --branch 0.5.0 https://github.com/ericniebler/range-v3
Add range-v3 library.
2017-11-19 14:37:07 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd xz-5.0.5
Update some details in Xcode build instructions.
2018-03-25 15:29:38 +00:00
CFLAGS="-mmacosx-version-min=10.8" LDFLAGS="-mmacosx-version-min=10.8" ./configure
build instructions done for os x version
2014-06-25 20:15:34 +00:00
make
sudo make install
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd ..
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
git clone https://github.com/telegramdesktop/zlib.git
cd zlib
CFLAGS="-mmacosx-version-min=10.8" LDFLAGS="-mmacosx-version-min=10.8" ./configure
Updated building-xcode.md. Moved number of threads into variable.
2019-04-21 08:46:57 +00:00
make $MAKE_THREADS_CNT
openal audio and voice messages prepared for os x
2014-09-04 12:23:28 +00:00
sudo make install
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd ..
openal audio and voice messages prepared for os x
2014-09-04 12:23:28 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
git clone https://github.com/openssl/openssl
cd openssl
git checkout OpenSSL_1_0_1-stable
./Configure darwin64-x86_64-cc -static -mmacosx-version-min=10.8
Updated building-xcode.md. Moved number of threads into variable.
2019-04-21 08:46:57 +00:00
make build_libs $MAKE_THREADS_CNT
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd ..
openal audio and voice messages prepared for os x
2014-09-04 12:23:28 +00:00
Update libtgvoip, opus to 1.2.1 and ffmpeg to 3.4.
2017-11-23 15:00:11 +00:00
git clone https://github.com/xiph/opus
cd opus
Update libopus to 1.3.
2018-11-29 12:33:01 +00:00
git checkout v1.3
Update libtgvoip, opus to 1.2.1 and ffmpeg to 3.4.
2017-11-23 15:00:11 +00:00
./autogen.sh
CFLAGS="-mmacosx-version-min=10.8" CPPFLAGS="-mmacosx-version-min=10.8" LDFLAGS="-mmacosx-version-min=10.8" ./configure
Updated building-xcode.md. Moved number of threads into variable.
2019-04-21 08:46:57 +00:00
make $MAKE_THREADS_CNT
Update libtgvoip, opus to 1.2.1 and ffmpeg to 3.4.
2017-11-23 15:00:11 +00:00
sudo make install
cd ..
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd libiconv-1.15
Langs updated for 9040123 closed beta.
2016-04-09 11:18:43 +00:00
CFLAGS="-mmacosx-version-min=10.8" CPPFLAGS="-mmacosx-version-min=10.8" LDFLAGS="-mmacosx-version-min=10.8" ./configure --enable-static
Updated building-xcode.md. Moved number of threads into variable.
2019-04-21 08:46:57 +00:00
make $MAKE_THREADS_CNT
openal audio and voice messages prepared for os x
2014-09-04 12:23:28 +00:00
sudo make install
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd ..
openal audio and voice messages prepared for os x
2014-09-04 12:23:28 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
git clone https://github.com/FFmpeg/FFmpeg.git ffmpeg
cd ffmpeg
Update libtgvoip, opus to 1.2.1 and ffmpeg to 3.4.
2017-11-23 15:00:11 +00:00
git checkout release/3.4
instructions for building ffmpeg added
2015-06-01 12:44:10 +00:00
CFLAGS=`freetype-config --cflags`
LDFLAGS=`freetype-config --libs`
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig:/usr/lib/pkgconfig:/usr/X11/lib/pkgconfig
Update ffmpeg.
2019-03-06 10:00:35 +00:00
./configure --prefix=/usr/local \
--extra-cflags="-mmacosx-version-min=10.8" \
--extra-cxxflags="-mmacosx-version-min=10.8" \
--extra-ldflags="-mmacosx-version-min=10.8" \
--enable-protocol=file --enable-libopus \
--disable-programs \
--disable-doc \
--disable-network \
--disable-everything \
--enable-hwaccel=h264_videotoolbox \
--enable-hwaccel=hevc_videotoolbox \
--enable-hwaccel=mpeg1_videotoolbox \
--enable-hwaccel=mpeg2_videotoolbox \
--enable-hwaccel=mpeg4_videotoolbox \
--enable-decoder=aac \
--enable-decoder=aac_at \
--enable-decoder=aac_fixed \
--enable-decoder=aac_latm \
--enable-decoder=aasc \
--enable-decoder=alac \
--enable-decoder=alac_at \
--enable-decoder=flac \
--enable-decoder=gif \
--enable-decoder=h264 \
--enable-decoder=hevc \
--enable-decoder=mp1 \
--enable-decoder=mp1float \
--enable-decoder=mp2 \
--enable-decoder=mp2float \
--enable-decoder=mp3 \
--enable-decoder=mp3adu \
--enable-decoder=mp3adufloat \
--enable-decoder=mp3float \
--enable-decoder=mp3on4 \
--enable-decoder=mp3on4float \
--enable-decoder=mpeg4 \
--enable-decoder=msmpeg4v2 \
--enable-decoder=msmpeg4v3 \
--enable-decoder=opus \
--enable-decoder=pcm_alaw \
--enable-decoder=pcm_alaw_at \
--enable-decoder=pcm_f32be \
--enable-decoder=pcm_f32le \
--enable-decoder=pcm_f64be \
--enable-decoder=pcm_f64le \
--enable-decoder=pcm_lxf \
--enable-decoder=pcm_mulaw \
--enable-decoder=pcm_mulaw_at \
--enable-decoder=pcm_s16be \
--enable-decoder=pcm_s16be_planar \
--enable-decoder=pcm_s16le \
--enable-decoder=pcm_s16le_planar \
--enable-decoder=pcm_s24be \
--enable-decoder=pcm_s24daud \
--enable-decoder=pcm_s24le \
--enable-decoder=pcm_s24le_planar \
--enable-decoder=pcm_s32be \
--enable-decoder=pcm_s32le \
--enable-decoder=pcm_s32le_planar \
--enable-decoder=pcm_s64be \
--enable-decoder=pcm_s64le \
--enable-decoder=pcm_s8 \
--enable-decoder=pcm_s8_planar \
--enable-decoder=pcm_u16be \
--enable-decoder=pcm_u16le \
--enable-decoder=pcm_u24be \
--enable-decoder=pcm_u24le \
--enable-decoder=pcm_u32be \
--enable-decoder=pcm_u32le \
--enable-decoder=pcm_u8 \
--enable-decoder=pcm_zork \
--enable-decoder=vorbis \
--enable-decoder=wavpack \
--enable-decoder=wmalossless \
--enable-decoder=wmapro \
--enable-decoder=wmav1 \
--enable-decoder=wmav2 \
--enable-decoder=wmavoice \
--enable-encoder=libopus \
--enable-parser=aac \
--enable-parser=aac_latm \
--enable-parser=flac \
--enable-parser=h264 \
--enable-parser=hevc \
--enable-parser=mpeg4video \
--enable-parser=mpegaudio \
--enable-parser=opus \
--enable-parser=vorbis \
--enable-demuxer=aac \
--enable-demuxer=flac \
--enable-demuxer=gif \
--enable-demuxer=h264 \
--enable-demuxer=hevc \
--enable-demuxer=m4v \
--enable-demuxer=mov \
--enable-demuxer=mp3 \
--enable-demuxer=ogg \
--enable-demuxer=wav \
--enable-muxer=ogg \
--enable-muxer=opus
openal audio and voice messages prepared for os x
2014-09-04 12:23:28 +00:00
Updated building-xcode.md. Moved number of threads into variable.
2019-04-21 08:46:57 +00:00
make $MAKE_THREADS_CNT
openal audio and voice messages prepared for os x
2014-09-04 12:23:28 +00:00
sudo make install
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd ..
openal audio and voice messages prepared for os x
2014-09-04 12:23:28 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
git clone git://repo.or.cz/openal-soft.git
Update OpenAL-Soft Update to version 1.19.1
2018-11-07 20:01:58 +00:00
cd openal-soft
Fix extensive CPU usage on macOS when audio is played. Regression was introduced in 91c85ec86b The openal-soft version 1.19.1 tried to use semaphores created by sem_init, which are not supported on macOS, so they just didn't work at all. This was leading to an event loop thread spin-waiting instead of a normal sem_wait. In the v1.19 upstream branch GCD semaphores are used on macOS.
2019-02-20 07:36:55 +00:00
git checkout v1.19
Update OpenAL-Soft Update to version 1.19.1
2018-11-07 20:01:58 +00:00
cd build
Fix building openal-soft on Xcode.
2018-12-12 13:59:26 +00:00
LDFLAGS='-stdlib=libc++' cmake -D ALSOFT_EXAMPLES=OFF -D LIBTYPE:STRING=STATIC -D CMAKE_OSX_DEPLOYMENT_TARGET:STRING=10.8 ..
Updated building-xcode.md. Moved number of threads into variable.
2019-04-21 08:46:57 +00:00
make $MAKE_THREADS_CNT
Moving to Qt 5.6.0, instructions can be broken.
2016-04-23 11:40:42 +00:00
sudo make install
Fix xcode build instructions (#4345)
2018-01-26 00:55:31 +00:00
cd ../..
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
git clone https://chromium.googlesource.com/external/gyp
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
Remove duplicated packages in brew install (#5222)
2018-10-07 23:39:59 +00:00
export PATH="$PWD/depot_tools:$PATH"
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
cd gyp
Fix travis build. Regression was introduced in 5faca8d4f6. GYP patch for GCC precompiled header support was accidentally removed.
2017-09-04 10:19:06 +00:00
git checkout 702ac58e47
git apply ../../tdesktop/Telegram/Patches/gyp.diff
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
./setup.py build
Fix path in doc/building-xcode.md Closes #1794 Signed-off-by: Christoph Auer <auer.chrisi@gmx.net>
2016-03-17 19:46:09 +00:00
sudo ./setup.py install
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
cd ..
Build crashpad from git. Crashpad path has changed.
2017-04-06 08:06:29 +00:00
git clone https://chromium.googlesource.com/crashpad/crashpad.git
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
cd crashpad
Build crashpad from git. Crashpad path has changed.
2017-04-06 08:06:29 +00:00
git checkout feb3aa3923
Update some details in Xcode build instructions.
2018-03-25 15:29:38 +00:00
git apply ../../tdesktop/Telegram/Patches/crashpad.diff
Build crashpad from git. Crashpad path has changed.
2017-04-06 08:06:29 +00:00
cd third_party/mini_chromium
git clone https://chromium.googlesource.com/chromium/mini_chromium
cd mini_chromium
git checkout 7c5b0c1ab4
git apply ../../../../../tdesktop/Telegram/Patches/mini_chromium.diff
cd ../../gtest
git clone https://chromium.googlesource.com/external/github.com/google/googletest gtest
cd gtest
git checkout d62d6c6556
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd ../../..
Build crashpad from git. Crashpad path has changed.
2017-04-06 08:06:29 +00:00
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
build/gyp_crashpad.py -Dmac_deployment_target=10.8
Build crashpad from git. Crashpad path has changed.
2017-04-06 08:06:29 +00:00
ninja -C out/Debug
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
ninja -C out/Release
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
cd ..
added google breakpad/crashpad to build instructions
2016-02-08 12:32:17 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
git clone git://code.qt.io/qt/qt5.git qt5_6_2
cd qt5_6_2
perl init-repository --module-subset=qtbase,qtimageformats
git checkout v5.6.2
cd qtimageformats && git checkout v5.6.2 && cd ..
cd qtbase && git checkout v5.6.2 && git apply ../../../tdesktop/Telegram/Patches/qtbase_5_6_2.diff && cd ..
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
./configure -prefix "/usr/local/tdesktop/Qt-5.6.2" -debug-and-release -force-debug-info -opensource -confirm-license -static -opengl desktop -no-openssl -securetransport -nomake examples -nomake tests -platform macx-clang
Updated building-xcode.md. Moved number of threads into variable.
2019-04-21 08:46:57 +00:00
make $MAKE_THREADS_CNT
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
sudo make install
cd ..
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
### Building the project
build instructions done for os x version
2014-06-25 20:15:34 +00:00
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
Go to ***BuildPath*/tdesktop/Telegram** and run
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
gyp/refresh.sh
Improve paths for Xcode build.
2017-10-13 19:23:19 +00:00
Then launch Xcode, open ***BuildPath*/tdesktop/Telegram/Telegram.xcodeproj** and build for Debug / Release.
Don't provide 'api_id' and 'api_hash' by default. We ask the developer to obtain his own api credentials, because the bundled 'api_id' / 'api_hash' are strictly limited by the server. The old credentials still could be used for test purposes, but the developer will need to explicitly opt-in to use them.
2018-11-04 10:29:30 +00:00
[api_credentials]: api_credentials.md