linphone desktop

Linphone Desktop

LinPhone هو softphone مفتوحة المصدر للصوت والفيديو عبر الاتصال برسالة IP والرسائل الفورية.

إنه يعتمد بالكامل على SIP ، لجميع المكالمات والحضور وميزات IM.

الوصف العام متاح من موقع LinPhone على الويب

رخصة

حقوق الطبع والنشر © Belledonne Communications

LinPhone مرخص مزدوج ، ومتاح إما:

• بموجب ترخيص GNU/GPLV3 ، مجانًا (مفتوح المصدر). يرجى التأكد من أنك تفهم وموافقة على شروط هذا الترخيص قبل استخدامه (انظر ملف الترخيص للحصول على التفاصيل).

• بموجب ترخيص الملكية ، مقابل رسوم ، لاستخدامها في طلبات المصدر المغلقة. اتصل بـ Belledonne Communications عن أي سؤال حول التكاليف والخدمات.

الوثائق

• الميزات المدعومة و RFCs

• Linphone Public Wiki

ابدء

فيما يلي التعليمات العامة لبناء LinPhone لسطح المكتب. تم وصف التعليمات المحددة لكل منصة بناء أدناه مباشرة. ستحتاج إلى الأدوات:

• cmake > = 3.22: قم بتنزيله في https://cmake.org/download/
• python : https://www.python.org/downloads/release/python-381/
• pip : إنه مضمن بالفعل داخل بيثون ، لذلك يجب أن يكون هناك ما يجب فعله حيال ذلك
• yasm : https://yasm.tortall.net/download.html
• nasm : https://www.nasm.us/pub/nasm/ReleaseBuilds/
• doxygen (مطلوب لركب CXX)
• Perl
• pystache : استخدم "Pip Install Pystache -User"
• six : استخدم "Pip تثبيت ستة -مستخدم"
• git

لسطح المكتب: ستحتاج إلى QT6 ( 6.2 أو أحدث ). C++17 الدعم مطلوب!

اضبط بيئتك

1. من الضروري تثبيت أمر pip وتنفيذ:

    pip install pystache six
   

2. يجب عليك تعيين متغير البيئة Qt6_DIR للإشارة إلى المسار الذي يحتوي على مجلدات CMAKE من QT6 ، PATH إلى bin QT6. مثال:

    Qt6_DIR="~/Qt/6.5.3/gcc_64/lib/cmake/Qt6"
    PATH="~/Qt/6.5.3/gcc_64/bin/:$PATH"
   

ملاحظة: إذا كان لديك أداة الطرف الثالث مثبتة qtchooser : eval "$ (qtchooser -print -env)" التصدير qt6_dir = $ {qtlibdir}/cmake/qt6 مسار التصدير = $ {qttooldir}: $ path 3. للحصول على متطلبات محددة ، انظر تعليمات النظام الأساسي أدناه.

ملخص لخطوات البناء

    `git clone https://gitlab.linphone.org/BC/public/linphone-desktop.git --recursive`
    `cd linphone-desktop`
    `mkdir build`
    `cd build`
    `cmake .. -DCMAKE_BUILD_PARALLEL_LEVEL=10 -DCMAKE_BUILD_TYPE=RelWithDebInfo`
    `cmake --build . --parallel 10 --config RelWithDebInfo`
    `cmake --install .`
    `./OUTPUT/bin/linphone --verbose` or `./OUTPUT/Linphone.app/Contents/MacOS/linphone --verbose`

الحصول على مصادر

    git clone https://gitlab.linphone.org/BC/public/linphone-desktop.git --recursive

المبنى: الخطوات العامة

يتم البناء عن طريق بناء SDK والتطبيق. أهدافهم هي sdk و Linphone .

1. قم بإنشاء مجلد البناء الخاص بك في جذر المشروع: mkdir build انتقل إلى هذا المجلد الجديد وابدأ عملية الإنشاء: cd build

2. قم بإعداد خياراتك: cmake .. بشكل افتراضي ، سيحاول تجميع جميع التبعيات المطلوبة. يمكنك إزالة بعض عن طريق إضافة -DENABLE_<COMPONENT>=NO إلى الأمر. يمكنك استخدام cmake-gui .. إذا كنت ترغب في الحصول على وصول أفضل إليها. يمكنك إضافة -DCMAKE_BUILD_PARALLEL_LEVEL=<count> للقيام <count> بنيات متوازية لتسريع العملية. أيضًا ، يمكنك إضافة -DENABLE_BUILD_VERBOSE=ON للحصول على مزيد من الملاحظات أثناء إنشاء المشروع.

ملاحظة: بالنسبة لـ Makefile أو ninja ، يجب عليك إضافة -DCMAKE_BUILD_TYPE=<your_config> إذا كنت ترغب في إنشاء تكوين معين (على سبيل المثال RelWithDebInfo ).

3. بناء وتثبيت المشروع بأكمله: cmake --build . --target <target> --parallel <count> (استبدل <target> الاسم الهدف و <count> بعدد البناء المتوازي).

ملاحظة: بالنسبة إلى Xcode أو Visual Studio ، يجب عليك إضافة --config <your_config> إذا كنت ترغب في إنشاء تكوين معين (على سبيل المثال RelWithDebInfo ).

عندما تنتهي كل شيء ، ستكون الملفات في مجلد الإخراج في دليل الإنشاء. عند إعادة البناء ، عليك استخدام cmake --build . --target install (أو cmake --install . ) لوضع التطبيق في التكوين الصحيح.

الثنائيات داخل مجلدات أخرى (مثل build/bin/ و linphone-sdk ) ليس من المفترض أن تعمل.

4. عند القيام ببعض التعديلات في SDK ، يمكنك إعادة بناء SDK فقط باستخدام sdk الهدف ونفس الشيء للتطبيق مع linphone-qt-only

5. من أجل الحصول على الحزم ، يمكنك استخدام cmake .. -DENABLE_APP_PACKAGING=YES . ستكون الملفات في مجلد OUTPUT/packages .

قم بتحديث مشروعك

1. قم بتحديث مشروعك بـ:

   git fetch git pull -rebase

2. تحديث الزخارف الفرعية من فرعك الحالي

   تحديث الجهاز الفرعي git -init -recursive

ثم ببساطة إعادة البناء باستخدام cmake.

استكشاف الأخطاء وإصلاحها العامة

• قد لا يعمل أحدث إصدار من Doxygen مع SDK. إذا قمت ببناء بعض المشكلات ولديك نسخة محددة من Doxygen غير في طريقك ، فيمكنك استخدام -DLINPHONESDK_DOXYGEN_PROGRAM .

على سبيل المثال على Mac: -DLINPHONESDK_DOXYGEN_PROGRAM=/Applications/Doxygen.app/Contents/Resources/doxygen

• إذا كان بناء تعطل SDK بشيء مثل "CMD.exe فشل" ولم يعد هناك معلومات ، فقد يكون ذلك بمثابة تبعية غير متوفرة. يجب عليك التحقق مما إذا كان كل شيء في طريقك. عادة ، إذا كان الأمر يتعلق بـ VPX أو DECAF ، فقد يأتي هذا من تثبيت Perl الخاص بك.

• إذا لم يبدأ التطبيق وإنشاء ملف فارغ باسم عشوائي ، فقد يأتي من تكوين سيء بين التطبيق الخاص بك والوحدات الفرعية الأخرى. تحقق من التكوينات الخاصة بك وفرضها مع -DCMAKE_BUILD_TYPE=<your_config> أو --config <your_config> .

• على MAC ، يمكن للتطبيق تعطل في البداية من QOPENGLCONTEXT. يتمثل الحل البديل في إلغاء تنشيط وضع MIPMAP على الصور عن طريق إضافة ملف التكوين الخاص بك (Linphonerc): mipmap_enabled=0 في [ui] قسم.

تعليمات محددة لمنصة Mac OS X

لتثبيت التبعيات المطلوبة على Mac OS X ، يمكنك استخدام Homebrew. قبل تثبيت الحزم باستخدام Brew ، قد تضطر إلى تغيير أذونات الدلائل (إذا لم تتمكن من تغيير الأذونات مع Sudo على MacOS> = High Sierra ، فاحصل على إلقاء نظرة على إجابة Stackoverflow هذه).

1. تثبيت Xcode من متجر Apple. قم بتشغيله مرة واحدة على الأقل للسماح لها بتثبيت أدواتها. قد تحتاج إلى الجري:

   xcode-select-التثبيت

2. قم بتثبيت homebrew باتباع الإرشادات هنا https://brew.sh/

3. تثبيت التبعيات:

   Brew تثبيت Cmake PKG-Config git doxygen nasm yasm

4. أولا تأكد من أن لديك PIP

5. ثم ، يمكنك تثبيت حزمة PIP مع الأمر التالي:

   تثبيت Python -M PIP [حزمة]

على سبيل المثال ، أدخل الأمر التالي:

 python -m pip install pystache six graphviz

6. قم بتنزيل QT ، قم بتثبيت إصدار QT6 وقم بتعيين متغيرات QT6_DIR و PATH.

7. إذا كنت تبني على نظام ARM64 وتريد إصدار Intel ، فيجب عليك تحديد معالج X86_64 في مرحلة توليد CMake:

   -dcmake_apple_silicon_processor = x86_64

8. بناء كالمعتاد (الخطوات العامة).

9. إذا تلقيت خطأً حول الوحدات النمطية التي لم يتم العثور عليها في Python ، فقد يكون ذلك لأن Cmake يحاول استخدام إصدار آخر من مسارك. قد يكون الأمر كذلك إذا قمت بتثبيت Python من Brew. تثبيت وحدات Python باستخدام المسار المطلق. على سبيل المثال:

   /OPT/Homebrew/Python3 -M Pip تثبيت Pystache ستة GraphViz

تعليمات محددة لنظام التشغيل Windows

لا يتم دعم الإصدار 32 بت لأن QT6 لا يوفر حزم 32 بت لـ MSVC. يتم دعم Visual Studio 2022 فقط.

1. تثبيت الأدوات الرئيسية:

• MinGW/MSYS2 : تنزيل
  • اتبع التعليمات على صفحة "البدء".
  • قم بتثبيت أدوات أدوات وإعداد Python:
    • pacman -Sy --needed base-devel mingw-w64-mingw64-toolchain
    • pacman -S python3-pip في وحدة التحكم MSYS2 MSYS
    • python3 -m pip install pystache six في cmd
    • في هذا الترتيب ، أضف C:msys64mingw64bin ، C:msys64 و C:msys64usrbin في متغير بيئة المسار من إعدادات Windows Advanced. لا تدعم الثنائيات من مجلد MSYS (وليس من Mingw64) مسار Windows بالكامل ، وبالتالي ، يجب تجنبها.

حدد -DENABLE_WINDOWS_TOOLS_CHECK=ON عند إنشاء SDK لتثبيت الأدوات المفقودة تلقائيًا من msys2: toolchain ، python ، doxygen ، perl ، yasm ، gawk ، bzip2 ، nasm ، sed ، patch ، pkg-config ، gettext ، glib2 ، intltool و graphviz (

• git : استخدم MSYS2: pacman -S git أو تنزيل

• يجب أيضًا تكوين Visual Studio بشكل صحيح مع الإضافات. ضمن "أدوات"-> "الحصول على الأدوات والميزات" ، تأكد من تثبيت المكونات التالية:

  • حدد تطوير منصة Windows Universal وتطوير سطح المكتب C ++

2. تأكد من تنزيل إصدار QT الصحيح على MSVC.

3. أو افتح سطر أوامر مع Developer Command Prompt for VS 2022 واتصل qtenv2.bat الموجود في ثنائيات QT الخاصة بك على C:Qt<version>msvc2019binqtenv2.bat المثال

4. بناء كالمعتاد مع إضافة -A x64 إلى cmake .. (الخطوات العامة):

• cmake .. -DCMAKE_BUILD_PARALLEL_LEVEL=10 -DCMAKE_BUILD_TYPE=RelWithDebInfo -A x64 البناء الافتراضي طويل جدًا. من المسلم به استخدام مولد النينجا -G "Ninja"
• cmake --build . --target ALL_BUILD --parallel 10 --config RelWithDebInfo

5. سيكون مجلد المشروع في دليل الإنشاء ويجب أن يكون الثنائيات في مجلد الإخراج.

تعليمات محددة للينكس

sudo apt تثبيت QT6-base-dev

في حالة عدم تثبيت "الوحدة النمطية" Qtquick.*"، يمكنك تثبيت هذه الحزم:

• QML-QT6
• QML6-Module-Qtquick
• QML6-module-qtquick-layouts
• QML6-module-qtqml-workerscript
• QML6-Module-Qtquick-Controls
• QML6-module-qtquick-templates

تثبيت التبعيات

هناك تكوينات ملفات Docker حيث يمكن استرداد التبعيات.

أيضًا ، تتوفر المزيد من التكوينات في مجلد ملفات Docker من عرض Linphone-SDK.

خيارات

خيارات	وصف	القيمة الافتراضية
enable_app_license	تمكين الترخيص في الحزم.	نعم
enable_app_packaging	تمكين التغليف. سيتم نشر الحزمة في OUTPUT/packages	لا
enable_app_pdf_viewer	تمكين عارض PDF. بحاجة إلى وحدة QT PDF.	نعم
enable_app_webview	تمكين WebView للحسابات. يجب نشر محرك WebView ، ويستغرق الحجم الكبير.	لا
enable_app_package_rootca	قم بتضمين ملف Rootca (تسلسل جميع شهادات الجذر التي نشرتها Mozilla) في الحزمة	نعم
enable_build_app_plugins	تمكين بناء المكونات الإضافية	نعم
enable_build_examples	تمكين بناء الأمثلة	لا
enable_build_verbose	تمكين توليد البناء ليكون أكثر مطولاً	لا
enable_daemon	تمكين واجهة Linphone Daemon.	لا
enable_pqcrypto	تمكين ما بعد الكم ZRTP.	لا
enable_strict	بناء مع أعلام المركب الصارمة على سبيل المثال -سحر	لا
enable_tests	بناء مع ثنائيات اختبار SDK	لا
enable_tests_components	بناء libbctoolbox-tester	لا
enable_tools	تمكين أدوات SDK	لا
enable_unit_tests	تمكين اختبار وحدة SDK.	لا
enable_update_check	تمكين التحقق من التحديث.	نعم
linphone_sdk_make_release_file_url	قم بعمل ملف إصدار يعمل على طول check_version واستخدم عنوان URL هذا	"" "

المساهمة

شفرة

من أجل إرسال رقعة لإدراجها في رمز مصدر Linphone:

1. تأكد أولاً من أن التصحيح الخاص بك ينطبق على أحدث مصادر GIT قبل تقديمه: لا يمكن دمج التصحيحات التي تم إجراؤها على الإصدارات القديمة.

2. املأ وأرسل اتفاقية المساهمين لتضمين التصحيح الخاص بك في شجرة Git عن طريق الروابط التالية هناك. الهدف من هذه الاتفاقية هو منحنا الممارسة السلمية لحقوقنا في قانون مصدر LinPhone ، دون أن تفقد حقوقك على مساهمتك.

3. ثم انتقل إلى مستودع GitHub وقدم طلبات سحب بناءً على الرمز الخاص بك.

يرجى ملاحظة أننا لا نقدم دعمًا مجانيًا وسيتم معالجة هذه المساهمات في وقت فراغنا.

Files Tree

• Linphone: رمز التطبيق.

  • النموذج: إدارة SDK التي يتم تشغيلها على موضوع SDK.

  • عرض: أشياء واجهة المستخدم الرسومية التي يتم تشغيلها على موضوع واجهة المستخدم.

    • العنصر: العناصر الأساسية البسيطة التي تزيد من وجود كائن بسيط للوجود.
    • الصفحة: استخدام العناصر لميزات أكثر تعقيدًا.
    • الأداة: أدوات ورموز JS.
    • التطبيق: تدفق التطبيق الذي يدير الصفحات.

  • CORE: الرمز الرئيسي الذي يربط نموذج وعرض في نمط MVVM.

  • البيانات: جميع البيانات غير الرمز

    • CONF: ملفات التكوين
    • الخط: الخطوط المضمنة
    • أيقونة: أيقونات تم إنشاؤها
    • الصورة: جميع صور التطبيق. يجب أن يكون التنسيق في SVG و Monocolor للسماح بالتحديثات في الوقت الفعلي.
    • لانج: ملفات TS المستخدمة مع WebLate.

  • الأداة: المكتبة الداخلية للأدوات العامة.

• Cmake: إنشاء وتثبيت البرامج النصية.

• الخارج: المشاريع الخارجية.

  • Linphone-SDK

اللغات

يحصل Linphone على دعم تدويل كامل.

لم نعد نستخدم Transifex لعملية الترجمة ، وبدلاً من ذلك ، قمنا بنشر مثيلنا الخاص بـ [WebLate] (https://weblate.linphone.org).


إذا كنت ترغب في المساهمة ، فيمكنك القيام بذلك على: https://weblate.linphone.org/projects/linphone-desktop/

ردود الفعل أو الإبلاغ عن الأخطاء

قم بتشغيل التطبيق باستخدام المعلمة --verbose للحصول على سجلات كاملة وإرسالها بطلبك. يمكنك استخدام زر "إرسال سجلات" في الإعدادات لتحميل ملفات السجل ومشاركتها عبر البريد الإلكتروني أو مع منشور في مشروع GitHub المقابل:

• تطبيق سطح المكتب
• Linphone SDK

في بعض نظام التشغيل (مثل Fedora 22 وما بعد ذلك) ، يقومون بتعطيل ناتج تصحيح QT بشكل افتراضي. للحصول على إخراج كامل ، تحتاج إلى إنشاء ~/.config/QtProject/qtlogging.ini وإضافة:

    [Rules]
    *.debug=true
    qt.*.debug=false