Ubuntu 16.04 and Debian 8 are both EOL, update minimum versions accordingly.
33 KiB
راهنمای نصب
- پیشنیازها
- لینوکس
- OS X
- ویندوز
- سویچ های زمان کامپایل
پیشنیازها
نام | نسخه | ماژولها |
---|---|---|
Qt | >= 5.7.1 | concurrent, core, gui, network, opengl, svg, widget, xml |
GCC/MinGW | >= 4.8 | C++11 enabled |
toxcore | >= 0.2.10 | core, av |
FFmpeg | >= 2.6.0 | avformat, avdevice, avcodec, avutil, swscale |
CMake | >= 3.7.2 | |
OpenAL Soft | >= 1.16.0 | |
qrencode | >= 3.0.3 | |
sqlcipher | >= 3.2.0 | |
pkg-config | >= 0.28 | |
[snorenotify] | >= 0.7.0 | optional dependency |
[toxext] | >= 0.0.3 | |
[tox_extension_messages] | >= 0.0.3 |
نیازمندیهای اختیاری
این نیازمندیها اختیاری هستند و میتوان آنها را در زمان کامپایل کردن فعال یا غیر فعال کرد. فعال کردن یا غیر فعال کردن آنها را میتوان با دادن دستورات لازم به cmake
در زمان ساخت qTox انجام داد.
اگر فایلهای این نیازمندی ها وجود نداشته باشند، qTox بدون قابلیت های مربوطه ساخته خواهد شد.
نیازمندیهای توسعه
این فایلها و برنامه ها برای انجام تست و ویرایش کد و سایر کارهای مربوط به توسعه برنامه مورد نیاز هستند. اگر این فایل ها موجود نباشند این قابلیت ها وجود نخواهند داشت.
نام | نسخه |
---|---|
Check | >= 0.9 |
لینوکس
پشتیبانی از Auto-way
نام | نسخه |
---|---|
libXScrnSaver | >= 1.2 |
libX11 | >= 1.6.0 |
اگر پیشنیازهای مطرح شده در جدول فوق موجود نباشند. این قابلیت ارایه نخواهد شد.
آیکون برنامه در KDE / آیکون کنار ساعت در GTK
نام | نسخه |
---|---|
Atk | >= 2.14 |
Cairo | |
GdkPixbuf | >= 2.31 |
GLib | >= 2.0 |
GTK+ | >= 2.0 |
Pango | >= 1.18 |
برای غیرفعال کردن:
-DENABLE_STATUSNOTIFIER=False -DENABLE_GTK_SYSTRAY=False
آیکن کنار ساعت در محیط Unity
به شکل پیش فرض غیر فعال میباشد.
نام | نسخه |
---|---|
Atk | >= 2.14 |
Cairo | |
DBus Menu | >= 0.6 |
GdkPixbuf | >= 2.31 |
GLib | >= 2.0 |
GTK+ | >= 2.0 |
libappindicator | >= 0.4.92 |
Pango | >= 1.18 |
برای فعال سازی:
-DENABLE_APPINDICATOR=True
لینوکس
نصب آسان
نصب آسان qTox برای ویرایش های مختلفی از لینوکس ارایه شده است:
آرچ لینوکس
PKGBUILD در مخزن community
موجود است، برای نصب کافی است از این دستور استفاده شود:
pacman -S qtox
فدورا
qTox در مخزن RPMFusion آماده دانلود است، برای نصب کافی است:
dnf install qtox
جنتوو
qTox در جنتوو آماده دانلود است.
برای نصب آن دستور زیر را اجرا کنید:
emerge qtox
اسلکوار
ساخت SlackBuild برنامه qTox را میتوان در آدرس زیر یافت:
http://slackbuilds.org/repository/14.2/network/qTox/
فری بی اس دی
qTox به صورت بسته های باینری آماده قابل دانلود است. برای نصب میتوان از دستور زیر استفاده کرد:
pkg install qTox
پورت qTox همچنین در net-im/qTox
قابل دسترسی است. برای ساخت و نصب qTox از روی سورس کد برنامه با استفاده از پورت میتوان از دستورات زیر استفاده کرد:
cd /usr/ports/net-im/qTox
make install clean
اگر توزیع مورد نظر شما لیست نشده است، یا میخواهید/نیاز دارید که qTox را کامپایل نمایید، در اینجا راهنمای لازم برای این کار ارایه میشود.
قسمت عمده پکیج ها و فایل های پیشنیاز در اکثر منابع مدیریت بسته سیستم های عامل موجود هستند. شما میتوانید یا راهنمای زیر را دنبال نمایید یا تنها فایل
./simple_make.sh
نصب کردن Git
برای کپی کردن کد منبع برنامه به ابزار Git نیاز است.
آرچ
sudo pacman -S --needed git
دبیان
sudo apt-get install git
فدورا
sudo dnf install git
اوپنسوزه
sudo zypper install git
اوبونتو
sudo apt-get install git
کپی کردن qTox
در مرحله بعد از نصب Git یک ترمینال باز کرده و به پوشه دلخواه خود تغیر مسیر دهید. در این پوشه اقدام به بارگیری و کپی کردن کد منبع qTox نمایید:
cd /home/$USER/qTox
git clone https://github.com/qTox/qTox.git qTox
اقدامات بعدی چنین فرض میکنند که شما کد منبع را در مسیر
/home/$USER/qTox
GCC, Qt, FFmpeg, OpenAL Soft و qrencode
آرچ
sudo pacman -S --needed base-devel qt5 openal libxss qrencode ffmpeg
دبیان
نکته: تنها دبیان نسخه های بالاتر از 9 پایدار (توزیع stretch) پشتیبانی میشوند
sudo apt-get install \
build-essential \
cmake \
ffmpeg \
libavcodec-dev \
libexif-dev \
libgdk-pixbuf2.0-dev \
libgtk2.0-dev \
libopenal-dev \
libqrencode-dev \
libqt5opengl5-dev \
libqt5svg5-dev \
libsqlcipher-dev \
libxss-dev \
pkg-config \
qrencode \
qt5-default \
qttools5-dev \
qttools5-dev-tools \
yasm
فدورا
توجه داشته باشید که sqlcipher هنوز در همه ویرایش های فدورا موجود نیست در زمان نگارش این قسمت (نوامبر 2016)، فدورا 25 با sqlcipher ارایه میشود، اما فدورا 24 و ویرایش های قدیمی تر هنوز این کتابخانه را ندارند. این بدان معنی است که اگر نمیتوان sqlcipher را از منابع فدورا دانلود کرد و نصب نمود، میبایست به شکل جداگانه این کتابخانه دانلود و نصب شود.
sudo dnf groupinstall "Development Tools" "C Development Tools and Libraries"
# (can also use sudo dnf install @"Development Tools")
sudo dnf install \
ffmpeg-devel \
gtk2-devel \
libexif-devel \
libXScrnSaver-devel \
libtool \
openal-soft-devel \
openssl-devel \
qrencode-devel \
qt-creator \
qt-devel \
qt-doc \
qt5-linguist \
qt5-qtsvg \
qt5-qtsvg-devel \
qtsingleapplication \
sqlcipher \
sqlcipher-devel
در صورت نیاز برای کامپایل به قسمت sqlcipher مراجعه شود.
اوپنسوزه
sudo zypper install \
libexif-devel \
libQt5Concurrent-devel \
libQt5Network-devel \
libQt5OpenGL-devel \
libQt5Xml-devel \
libXScrnSaver-devel \
libffmpeg-devel \
libqt5-linguist \
libqt5-qtbase-common-devel \
libqt5-qtsvg-devel \
openal-soft-devel \
patterns-openSUSE-devel_basis \
qrencode-devel \
sqlcipher-devel
اسلک وار
لیست تمام پیش نیاز های qTox و SlackBuilds مربوط به آنها را میتوان در آدرس زیر مشاهده نمود:
http://slackbuilds.org/repository/14.2/network/qTox/
اوبونتو نسخه بالاتر یا برابر 15.04
sudo apt-get install \
build-essential cmake \
libavcodec-ffmpeg-dev \
libavdevice-ffmpeg-dev \
libavfilter-ffmpeg-dev \
libavutil-ffmpeg-dev \
libexif-dev \
libgdk-pixbuf2.0-dev \
libglib2.0-dev \
libgtk2.0-dev \
libopenal-dev \
libqrencode-dev \
libqt5opengl5-dev \
libqt5svg5-dev \
libsqlcipher-dev \
libswresample-ffmpeg-dev \
libswscale-ffmpeg-dev \
libxss-dev \
qrencode \
qt5-default \
qttools5-dev-tools
اوبونتو نسخه بالاتر یا برابر با 16.04
sudo apt-get install \
build-essential \
cmake \
libavcodec-dev \
libavdevice-dev \
libavfilter-dev \
libavutil-dev \
libexif-dev \
libgdk-pixbuf2.0-dev \
libglib2.0-dev \
libgtk2.0-dev \
libopenal-dev \
libqrencode-dev \
libqt5opengl5-dev \
libqt5svg5-dev \
libsqlcipher-dev \
libswresample-dev \
libswscale-dev \
libxss-dev \
qrencode \
qt5-default \
qttools5-dev-tools \
qttools5-dev
نیازمندی های toxcore
نصب تمامی پیش نیاز های toxcore.
آرچ
sudo pacman -S --needed opus libvpx libsodium
دبیان
sudo apt-get install libtool autotools-dev automake checkinstall check \
libopus-dev libvpx-dev libsodium-dev libavdevice-dev
فدورا
sudo dnf install libtool autoconf automake check check-devel libsodium-devel \
opus-devel libvpx-devel
اوپنسوزه
sudo zypper install libsodium-devel libvpx-devel libopus-devel \
patterns-openSUSE-devel_basis
اسلک وار
لیست تمامی پیش نیازهای toxcore و SlackBuilds آنها را میتوان در آدرس زیر مشاهده نمود:
اوبونتو نسخه بالاتر یا برابر 15.04
sudo apt-get install libtool autotools-dev automake checkinstall check \
libopus-dev libvpx-dev libsodium-dev
sqlcipher
اگر از یک نسخه قدیمی فدورا استفاده نمیکنید، این قسمت را رها کرده، و مستقیما به toxcore مراجعه کنید.
git clone https://github.com/sqlcipher/sqlcipher
cd sqlcipher
./configure --enable-tempstore=yes CFLAGS="-DSQLITE_HAS_CODEC" \
LDFLAGS="-lcrypto"
make
sudo make install
cd ..
کامپایل toxcore
اگر تمامی پیش نیاز های مورد نیاز را نصب داشته باشید، میتوانید به راحتی این دستورات را اجرا کنید و toxcore را کامپایل کنید:
git clone https://github.com/toktok/c-toxcore.git toxcore
cd toxcore
git checkout v0.2.12
autoreconf -if
./configure
make -j$(nproc)
sudo make install
echo '/usr/local/lib/' | sudo tee -a /etc/ld.so.conf.d/locallib.conf
sudo ldconfig
کامپایل qTox
مطمئن شوید که تمامی پیش نیاز ها را نصب کرده اید
اگر در حین کامپایل با مشکلی مواجه شوید بدون تردید پیش نیازی را نصب ندارید. بنابراین مطمئن شوید که همه آنها را نصب کرده اید.
اگر دارید qTox را در فدورا 25 کامپایل میکنید، باید PKG_CONFIG_PATH
را به متغیر environment به شکل دستی اضفاه کنید:
export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig"
سپس این دستورات را در پوشه qTox اجرا کنید تا برنامه کامپایل شود:
cmake .
make
بعد از اتمام کامپایل میتوان qTox را با استفاده از فرمان
./qtox
ضمن عرض تبریک، شما موفق به کامپایل qTox شده اید :)
دبیان / ابونتو / مینت
اگر پروسه کامپایل به خاطر عدم وجود یک پیش نیاز متوقف میشود، مانند ... libswscale/swscale.h missing
این دستور را امتحان کنید:
apt-file search libswscale/swscale.h
سپس بسته هایی را نصب کنید که فایل های مورد نیاز را فراهم میکنند. دوباره فرمان make را اجرا کنید، در صورت نیاز دوباره این مراحل را تکرار کنید. اگر برایتان امکان پذیر است لیستی از فایلهای مورد نیاز تهیه کنید و برای ما ارسال نمایید تا بتوانیم مشخص کنیم که چه فایلهایی به شکل معمول مورد نیاز کاربران است ;)
ساخت بسته ها
در یک روش دیگر، qTox به شکل آزمایشی و شاید غیر قابل اطمینان میتواند خود را بسته بندی کند.
(منظور بسته بندی به فرمت .deb
به شکل خودکار، و بسته بندی به فرمت .rpm
با استفاده از alien است).
بعد از نصب پیش نیاز های مورد نیاز، bootstrap.sh
را اجرا کنید، و سپس اسکریپت buildPackages.sh
را اجرا نمایید، که میتوان آن را در پوشه tools پیدا نمود. اجرای این دستور به شکل خودکار بسته های مورد نیاز برای ساخت .deb
را دانلود و نصب میکند، پس برای تایپ پسورد sudo آماده باشد.
OS X
OS X ویرایشهای بالاتر از نسخه 10.8 پشتیبانی میشوند.
کامپایل qTox روی OS X برای توسعه به سه ابزار زیر نیاز دارد:
اسکریپت خودکار
حالا میتوانید به شکل خودکار سیستم OS X خود را برای کامپایل qTox با استفاده از اسکریپت
./osx/qTox-Mac-Deployer-ULTIMATE.sh
میتوان این اسکریپت را به شکل مجزای از منبع qTox اجرا نمود، و این اسکریپت همه چیزی است که برای ساخت و کامپایل روی OS X مورد نیاز است.
برای استفاده از این اسکریپت ابتدا ترمینال را از مسیر زیر اجرا کنید:
در صورتی که میخواهید بیشتر یاد بگیرید میتوانید این دستور را اجرا کنید:
توجه داشته باشید که این اسکریپت همه تغیراتی که ذخیره نشده باشند را در منبع qTox به شکل اولیه بر مگرداند و این اتفاق در مرحله update
رخ میدهد.
اجرای اولیه / نصب
اگر برای بار اول است که اسکریپت را اجرا میکنید میبایست مطمئن شوید که سیستم شما آماده است. برای این کار میتوانید به سادگی دستور
./qTox-Mac-Deployer-ULTIMATE.sh -i
بعد از نصب اولیه حالا شما میتوانید qTox را از روی کد برنامه بسازید. که این کار با اجرای :
./qTox-Mac-Deployer-ULTIMATE.sh -b
اگر خطایی رخ ندهد، آنوقت شما یک نسخه قابل اجرا از برنامه qTox در پوشه خانه خود (home) در زیرشاخه
~/qTox-Mac_Build
به روز رسانی
اگر به منظور آزمایش یا اجرای آخرین ویرایش برنامه نیاز به به روز رسانی برنامه دارید میتوانید
./qTox-Mac-Deployer-ULTIMATE.sh -u
./qTox-Mac-Deployer-ULTIMATE.sh -b
گسترش و توزیع
سیستم عامل OS X به منظور اضافه کردن قابلیت به اشتراک گذاری در فایل
qTox.app
اگر میخواهید برنامه ای را که کامپایل کرده اید با سایر دوستانتان که OS X دارند به اشتراک بگذارید قبل از این کار، دستور
./qTox-Mac-Deployer-ULTIMATE.sh -d
کامپایل دستی
کتابخانه های مورد نیاز
homebrew را نصب کنید اگر آن را ندارید:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
در مرحله اول، تمامی پیش نیاز های موجود در brew
را نصب کنید.
brew install git ffmpeg qrencode libtool automake autoconf check qt5 libvpx \
opus sqlcipher libsodium
در مرحله بعد toxcoreرا نصب کنید
سپس qTox را کپی کنید:
git clone https://github.com/qTox/qTox
از این به بعد، در مرحله آخر، همه فایلهای مورد نیاز را کپی کنید. هر بار که بسته های brew را آپدیت میکنید، میتوانید تمامی گام های بالا را انجام ندهید، و تنها دستورات زیر را اجرا کنید:
cd ./git/qTox
sudo bash bootstrap-osx.sh
کامپایل کردن
شما میتوانید qTox را با استفاده از Qt Creator بسازید. seperate download یا آن را به شکل دستی با استفاده از cmake ایجاد نمایید.
اگر بخواهید از cmake استفاده کنید، میتوانید qTox را در پوشه git کامپایل کنید:
cmake .
make
یا یک راه تمیز تر میتواند این باشد:
cd ./git/dir/qTox
mkdir ./build
cd build
cmake ..
گسترش و توزیع
اگر qTox را به شکل صحیح کامپایل کرده باشید، حالا میتوانید qTox.app
ایجاد شده را با دیگران در اشتراک بگذارید.
با استفاده از qt5 homebrew نصب شده در پوشه build:
/usr/local/Cellar/qt5/5.5.1_2/bin/macdeployqt ./qTox.app
اجرای qTox
شما دو انتخاب دارید، یا روی qTox کلیک کنید که سریعا خارج میشود، یا دستور زیر را اجرا نمایید:
qtox.app/Contents/MacOS/qtox
میتوانید از محیط CLI ای که ایجاد کرده اید لذت ببرید و احتمال زیاد دوستان و خانواده شما فکر میکنند که شما یک هکر شده اید.
ویندوز
کامپایل برای سایر سیستم عامل ها در لینوکس
مراجعه کنید به windows/cross-compile
کامپایل در ویندوز
Qt
در ابتدا فایل نصب Qt را از qt.io دانلود کنید. در طول نصب میباید toolchian مربوط به Qt را اسمبل کنید. میتوانید آخرین نسخه Qt را با استفاده از MinGW کامپایل کنید. هرچند که خود فایل نصب یک کامپایلر MinGW ارایه میکند، اما توصیه میشود که آن را به شکل جداگانه نصب کرد، چرا که Qt فاقد MSYS است که برای کامپایل و نصب OpenAL مورد نیاز است. به همین جهت میتوانید در صورت نیاز سربرگ Tools
را غیر فعال کنید. گام های بعدی این چنین فرض میکنند که Qt در C:\Qt
نصب شده است. اگر Qt را در مسیر دیگری نصب میکنید، دستورات زیر را به شکل مناسب تغیر دهید.
MinGW
فایل نصب MinGW را برای ویندوز از sourceforge.net دانلود و نصب کنید. مطمئن شوید که MSYS را انتخاب و نصب میکنید. MSYS مجموعه ای از ابزار های Unix برای ویندوز است. گام های بعدی در نظر میگیرند که MinGW در C:\MinGW
نصب شده است. اگر مسیر نصب متفاوت است دستورات زیر را به شکل مناسب تغییر دهید. در برنامه نصب MinGW (mingw-get.exe) بسته های mingw-developer-toolkit
, mingw32-base
, mingw32-gcc-g++
, msys-base
و mingw32-pthreads-w32
را انتخاب کنید. دقت داشته باشید که نسخه MinGW با ورژن و نسخه Qt سازگاری داشته باشد.
Wget
فایل نصب Wget برای ویندوز را از http://gnuwin32.sourceforge.net/packages/wget.htm دانلود و نصب کنید. این فایل ها را نصب کنید. گام های بعدی چنین فرض میکنند که Wget در مسیر
C:\Program Files (x86)\GnuWin32\
UnZip
فایل نصب UnZip برای ویندوز را از http://gnuwin32.sourceforge.net/packages/unzip.htm دانلود و آن را نصب کنید. گام هایی که در ادامه میآیند چنین فرض میکنند که UnZip در
C:\Program Files (x86)\GnuWin32\
تغییر PATH سیستم
فایل های اجرایی
Control Panel
-> System and Security
-> System
-> Advanced system settings
-> Environment Variables...
یا دستور sysdm.cpl
را اجرا کنید، سر برگ Advanced system settings
را انتخاب کنید و روی دکمه Environment Variables
کلیک کنید. در جعبه دوم (پایینی) به دنبال متغیر PATH
بگردید و روی دکمه Edit...
کلیک کنید. جعبه ورودی Variable value:
به احتمال زیاد دارای چندین پوشه از قبل میباشد. هر پوشه با استفاده از نقطه ویرگول (;) جدا شده است. این جعبه ورودی را طوری تغییر دهید که پوشه های زیر را نیز شامل شود:
;C:\MinGW\bin;C:\MinGW\msys\1.0\bin;C:\Program Files (x86)\CMake 2.8\bin;C:\Program Files (x86)\GnuWin32\bin
sh
و bash
هستند، مانند مسیر C:\Program Files\OpenSSH\bin
PATH
قرار داشته باشند، در غیر اینصورت کامپایل انجام نخواهد شد.
کپی کردن منبع
کد منبع (https://github.com/qTox/qTox.git) را با استفاده از برنامه Git مورد نظر خود کپی کنید. برنامه های SmartGit و TorteiseGit هردو برای انجام این کار برنامه های خوبی هستند (توجه داشته باشید که شاید لازم باشد git.exe
را به PATH
اضافه کنید). گام های بعدی چنین فرض میکنند که کد ها را در مسیر C:\qTox
کپی کرده اید. اگر تصمیم گرفته اید که مسیر دیگری را انتخاب کنید، دستورات را اصلاح نمایید.
دریافت پیش نیاز ها
اسکریپت bootstrap.bat
که در مسیر C:\qTox
قرار دارد را اجرا کنید. این اسکریپت به شکل خودکار پیش نیاز های لازم را دانلود خواهد کرد، آنها را کامپایل و در مسیر های لازم کپی خواهد نمود.
توجه داشته باشید که برخی از ابزار های ویروسیابی برخی از کتابخانه ها را به اشتباه ویروس شناسایی میکنند. اگر با این مشکل مواجه میشوید، به منظور کسب اطلاعات بیشتر به صفحه problematic antiviruses مراجعه کنید.
سویچ های زمان کامپایل
این سویچ ها به عنوان مولفه به دستور cmake
اضافه میشوند. به عنوان مثال یک سویچ SWITCH
که مقدار YES
به آن اختصاص داده میشود، این مقدار به cmake
منتقل میشود. و این اتفاق به شکل زیر انجام میشود:
cmake -DSWITCH=yes
سویچها:
SMILEYS
, مقادیر معنی دار:- اگر تعریف نشود یا میزان معنی داری به آن اختصاص پیدا نکند، همه شکلک ها اضافه خواهند شد
DISABLED
– هیچ بسته شکلکی را اضافه نکن، تنها بسته های کاربر اضافه میشوندMIN
– تنها یک بسته شکلک ها اضافه شود