الصفحة الرئيسية>المتعلقة بالبرمجة>ج/ج++
تنزيل

libobs عبر روابط العقدة

تهدف هذه المكتبة إلى توفير روابط للمكتبة الداخلية لـ obs-studio، والتي تسمى libobs وفقًا لذلك، بغرض استخدامها من وقت تشغيل العقدة. حاليًا، يتم دعم Windows وMacOS فقط.

مبنى

المتطلبات الأساسية

سوف تحتاج إلى تثبيت ما يلي:

  • بوابة
  • Node.js
  • غزل
  • CMake

ويندوز

يتطلب البناء على Windows برامج إضافية:

  • فيجوال ستوديو 2019 أو 2022
  • Windows SDK (قد يتم تثبيته بواسطة Visual Studio 2022 Installer)

بناء المثال

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

مثال: 

 yarn install
git submodule update --init --recursive
mkdir build
cd build
cmake .. -G"Visual Studio 17 2022" -A x64 -DCMAKE_PREFIX_PATH=%CD%/libobs-src/cmake/
cmake --build . --target install --config RelWithDebInfo

سيؤدي هذا إلى تنزيل أي تبعيات مطلوبة، وإنشاء الوحدة، ثم وضعها في أرشيف متوافق مع npm أو الغزل الذي قد تحدده في package.json معين.

بناء OBS مخصص

افتراضيًا، نقوم بتنزيل إصدار مُصمم مسبقًا من libobs إذا لم يتم تحديد أي شيء. ومع ذلك، قد لا يكون هذا الإصدار المبني مسبقًا هو ما تريد استخدامه أو ربما أنت تختبر ميزة obs جديدة.

يمكنك تحديد أرشيف مخصص خاص بك. ومع ذلك، يجب إجراء بعض التغييرات على التكوين الافتراضي لـ obs-studio قبل الإنشاء:

  • يجب ضبط ENABLE_SCRIPTING على false
  • يجب ضبط ENABLE_UI على false
  • لا ينبغي تحديد QTDIR لأنه غير مستخدم.

إذا كنت لا تعرف كيفية إنشاء obs-studio من المصدر، فقد تجد التعليمات هنا.

com.cppcheck

قم بتثبيت cppcheck من http://cppcheck.sourceforge.net/ وأضف مجلد cppcheck إلى PATH لتشغيل الاختيار من سطر الأوامر: 

 cd build 
cmake --build . --target CPPCHECK

يمكن أيضًا إنشاء الهدف من Visula Studio. تم تعيين تنسيق إخراج التقرير على أنه متوافق والتنقل إلى الملف: السطر ممكن من لوحة نتائج البناء.

تم منع بعض التحذيرات في الملفات obs-studio-client/cppcheck_suppressions_list.txt و obs-studio-server/cppcheck_suppressions_list.txt .

محلل الكلانغ

يجب تثبيت Ninja و LLVM في النظام. تحذير: لقد كسرت أداة depot_tool النينجا.
لجعل البناء مفتوحًا cmd.exe . 

 mkdir build_clang
cd build_clang

"c:Program Files (x86)Microsoft Visual Studio 14.0VCbinamd64vcvars64.bat"
 
set CCC_CC=clang-cl
set CCC_CXX=clang-cl
set CC=ccc-analyzer.bat
set CXX=c++-analyzer.bat
#set CCC_ANALYZER_VERBOSE=1

#make ninja project 
cmake  -G "Ninja" -DCLANG_ANALYZE_CONFIG=1 -DCMAKE_INSTALL_PREFIX:PATH=""  -DCMAKE_LINKER=lld-link -DCMAKE_BUILD_TYPE="Debug"   -DCMAKE_SYSTEM_NAME="Generic" -DCMAKE_MAKE_PROGRAM=ninja.exe ..

#try to build and "fix" errors 
ninja.exe 

#clean build to scan 
ninja.exe clean 

scan-build --keep-empty -internal-stats -stats -v -v -v -o check ninja.exe

تعد خطوة "fixing" الأخطاء مهمة لأن قاعدة التعليمات البرمجية وخاصة تعليمات الطرف الثالث ليست جاهزة للإنشاء باستخدام clang. ولن يتم فحص الملفات التي فشل تجميعها بحثًا عن الأخطاء.

الاختبارات

تتم كتابة اختبارات عقدة obs studio في Typescript وتستخدم Mocha كإطار اختبار، مع حزمة الإلكترون-mocha لجعل Mocha يعمل في Electron، وChai كإطار عمل للتأكيد.

تحتاج إلى إنشاء عقدة obs-studio لإجراء الاختبارات. يمكنك إنشائه بالطريقة التي تريدها، فقط تأكد من استخدام CMAKE_INSTALL_PREFIX لتثبيت obs-studio-node في مجلد من اختيارك. تستخدم الاختبارات هذا المتغير لمعرفة مكان وحدة عقدة obs-studio. نظرًا لأننا نستخدم تفرعنا الخاص من Electron، فأنت بحاجة أيضًا إلى إنشاء متغير بيئة يسمى ELECTRON_PATH للإشارة إلى مكان وجود الثنائي Electron في المجلدNode_modules بعد تشغيل yarn install . فيما يلي ثلاث طرق مختلفة لإنشاء عقدة obs-studio:

الأوامر الطرفية

في المجلد الجذر لـ obs-studio-node:

  1. yarn install
  2. git submodule update --init --recursive --force
  3. mkdir build
  4. cmake -Bbuild -H. -G"Visual Studio 16 2019" -A x64 -DCMAKE_INSTALL_PREFIX="path_of_your_choosing"
  5. cmake --build build --target install

المحطة باستخدام البرامج النصية package.json

في المجلد الجذر لـ obs-studio-node:

  1. mkdir build
  2. yarn local:config
  3. yarn local:build
  4. اختياري: لتنظيف مجلد البناء، قم بتكرار الخطوات من 2 إلى 3 مرة أخرى، قم بإجراء yarn local:clean

كميك واجهة المستخدم الرسومية

  1. yarn install
  2. قم بإنشاء مجلد إنشاء في جذر عقدة obs-studio
  3. افتح واجهة المستخدم الرسومية CMake
  4. ضع مسار مشروع obs-studio-node في مربع Where is the source code:
  5. ضع المسار لإنشاء المجلد في مربع Where to build the binaries:
  6. انقر فوق Configure
  7. قم بتغيير CMAKE_INSTALL_PREFIX إلى مسار المجلد الذي تختاره
  8. انقر فوق Generate
  9. انقر فوق Open Project لفتح Visual Studio وإنشاء المشروع هناك

تشغيل الاختبارات

تتفاعل بعض الاختبارات مع Twitch ونستخدم خدمة تجمع المستخدمين للحصول على المستخدمين، ولكن في حالة عدم تمكننا من جلب مستخدم منها، فإننا نستخدم مفتاح الدفق الذي يوفره متغير البيئة. قم بإنشاء متغير بيئة يسمى SLOBS_BE_STREAMKEY باستخدام مفتاح الدفق لحساب Twitch الذي تختاره.

  • لإجراء جميع الاختبارات، قم بإجراء yarn run test
  • لتشغيل اختبار واحد فقط، قم yarn run test --grep describe_name_value حيث يكون describe_name_value هو اسم الاختبار الذي تم تمريره إلى استدعاء الوصف في كل ملف اختبار. أمثلة: yarn run test --grep nodeobs_api أو yarn run test -g "Start streaming"
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل