الصفحة الرئيسية>كود المصدر JSP>فئات أخرى
تنزيل

؟ النسخة الإنجليزية

قالب المشروع على أساس نظام تجميع CMake للغة C ++

ضربة وتغيير "mylib" إلى اسمك.

أو قم بإنشاء مشروعك باستخدام البرنامج النصي: https://github.com/izvolov/mylib-gen

محتوى

  1. حَشد
    1. جيل
    2. حَشد
  2. خيارات
    1. mylib_coverage
    2. mylib_testing
    3. doxygen_output_language
  3. أهداف التجميع
    1. بشكل افتراضي
    2. mylib_library
    3. اختبارات Mylib-Unit
    4. يفحص
    5. التغطية
    6. مستند
    7. Wandbox
  4. أمثلة
  5. الاستخدام
    1. من خلال التثبيت
    2. كوحدة فرعية
  6. أدوات
  7. علاوة

حَشد

يتكون تجميع هذا المشروع ، مثل أي مشروع آخر على نظام تجميع CMAKE ، من مرحلتين:

جيل 

cmake -S путь/к/исходникам -B путь/к/сборочной/директории [опции ...]

اقرأ المزيد عن الخيارات.

تجميع المشروع 

cmake --build путь/к/сборочной/директории [--target target]

اقرأ المزيد عن أهداف التجميع.

خيارات

mylib_coverage 

cmake -S ... -B ... -DMYLIB_COVERAGE=ON [прочие опции ...]

يتضمن الغرض من coverage ، والتي يمكنك البدء في قياس الكود الذي يغطي الاختبارات.

mylib_testing 

cmake -S ... -B ... -DMYLIB_TESTING=OFF [прочие опции ...]

يوفر الفرصة لإيقاف تجميع الاختبارات المعيارية وهدف check . نتيجة لذلك ، يتم إيقاف الكود بواسطة الطلاء الأساسي مع الاختبارات (انظر الطلاء).

يتم فصل الاختبار تلقائيًا أيضًا إذا كان المشروع متصلاً بمشروع آخر باعتباره مشروعًا فرعيًا باستخدام أمر add_subdirectory .

doxygen_output_language 

cmake -S ... -B ... -DDOXYGEN_OUTPUT_LANGUAGE=English [прочие опции ...]

إنه يغير لغة الوثائق ، والتي يتم إنشاؤها بواسطة هدف doc إلى واحد معين. للحصول على قائمة باللغات التي يمكن الوصول إليها ، راجع موقع نظام Doxygen.

بشكل افتراضي ، يتم تضمين الروسي.

أهداف التجميع

بشكل افتراضي 

cmake --build путь/к/сборочной/директории
cmake --build путь/к/сборочной/директории --target all

إذا لم يتم الإشارة إلى الهدف (وهو ما يعادل الهدف all ) ، فإنه يجمع كل ما هو ممكن ، ويسبب أيضًا هدف check .

mylib_library 

cmake --build путь/к/сборочной/директории --target mylib_library

تم تجميعها بواسطة مكتبة mylib_library . شملت بشكل افتراضي.

اختبارات Mylib-Unit 

cmake --build путь/к/сборочной/директории --target mylib-unit-tests

يجمع الاختبارات المعيارية. شملت بشكل افتراضي.

يفحص 

cmake --build путь/к/сборочной/директории --target check

يطل على الاختبارات المعيارية التي تم جمعها (يجمع ، إن لم يكن بعد). شملت بشكل افتراضي.

انظر أيضا mylib-unit-tests .

التغطية 

cmake --build путь/к/сборочной/директории --target coverage

تحليلات الاختبارات المعيارية المتقدمة (إن لم يكن بعد) لتغطية الكود مع اختبارات باستخدام برنامج GCOVR.

الهدف متاح فقط مع خيار MYLIB_COVERAGE المضمون.

انظر أيضا check .

مستند 

cmake --build путь/к/сборочной/директории --target doc

يطل على توليد الوثائق للرمز باستخدام نظام doxygen.

Wandbox 

cmake --build путь/к/сборочной/директории --target wandbox

لهذا ، يتم استخدام خدمة Wandbox. لا تسيء إلى هذا الشيء ، الخادم ليس مطاطًا.

أمثلة

تجميع المشروع في وضع الديون مع قياس الطلاء 

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Debug -DMYLIB_COVERAGE=ON
cmake --build путь/к/сборочной/директории --target coverage --parallel 16

تركيب المشروع دون تجميع أولي واختبار 

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DMYLIB_TESTING=OFF -DCMAKE_INSTALL_PREFIX=путь/к/установойной/директории
cmake --build путь/к/сборочной/директории --target install

التجميع في وضع التخرج مع مترجم معين 

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER=g++-8 -DCMAKE_PREFIX_PATH=путь/к/директории/куда/установлены/зависимости
cmake --build путь/к/сборочной/директории --parallel 4

توليد الوثائق باللغة الإنجليزية 

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Release -DDOXYGEN_OUTPUT_LANGUAGE=English
cmake --build путь/к/сборочной/директории --target doc

الاستخدام

من خلال التثبيت

أحد الخيارات لاستخدام الوحدة هو تثبيته في النظام. 

cmake --build путь/к/сборочной/директории --target install

بعد ذلك ، يحصل أي مشروع آخر ، الاتصال بأمر find_package ، على فرصة لاستخدام جميع المكتبات من Mylib:: 

 find_package (Mylib 1.0 REQUIRED)

add_executable (some_executable some.cpp sources .cpp)
target_link_libraries (some_executable PRIVATE Mylib::library)

يجب أن تكون Mylib::library متصلاً عندما تحتاج إلى الالتزام بمكتبة libmylib_library . إذا كان هناك عناوين كافية ، فمن المفيد استخدام Mylib::headers .

كوحدة فرعية

يمكن أيضًا توصيل المشروع بمشروع آخر كوحدة فرعية باستخدام أمر add_subdirectory .

في هذه الحالة ، ستكون Mylib::library و Mylib::headers متاحة بطريقة مماثلة.

أدوات

  1. Cmake 3.14

    مطلوب Cmake 3.14 لأنه في الإصدارات السابقة ، يعمل install(TARGETS ... EXPORT ...) بشكل غير صحيح في الإصدارات السابقة ، وهي المسارات الافتراضية غير محددة.

  2. مكتبة اختبار الدكتوراه

    يمكن إيقاف الاختبار (انظر الاختبار).

  3. Doxygen

    لتبديل اللغة التي سيتم إنشاء الوثائق بها ، يتم توفير خيار DOXYGEN_OUTPUT_LANGUAGE .

  4. المترجم المترجم Jap Python 3

    لتوليد تلقائي من ساندويتش على الإنترنت.

علاوة

بمساعدة Cmake وزوج من الأدوات الجيدة ، يمكنك توفير تحليل ثابت مع الحد الأدنى من حركات الجسم.

cppcheck

قامت Cmake ببناء -بدعم من التحليل الثابت لـ CPPCheck.

للقيام بذلك ، استخدم خيار CMAKE_CXX_CPPCHECK : 

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CXX_CPPCHECK= " cppcheck;--enable=all;-Iпуть/к/исходникам/include "

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

كلانج

بمساعدة أداة رائعة scan-build ، يمكنك أيضًا بدء تحليل ثابت في مجموعتين: 

scan-build cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Debug
scan-build cmake --build путь/к/сборочной/директории

هنا ، على عكس الحالة مع CPPCheck ، من الضروري تشغيل التجميع من خلال scan-build في كل مرة.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل