หน้าแรก>ซอร์สโค้ด 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-tests
    4. ตรวจสอบ
    5. ความครอบคลุม
    6. เอกสาร
    7. Wandbox
  4. ตัวอย่าง
  5. การใช้งาน
    1. ผ่านการติดตั้ง
    2. เป็น submodule
  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-tests 

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

เป็น submodule

โครงการยังสามารถเชื่อมต่อกับโครงการอื่นเป็น submodule โดยใช้คำสั่ง 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 ในแต่ละครั้ง

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด