Conan C++: دليل شامل مع أمثلة عملية

1. ما هو Conan ولماذا تحتاجه؟

Conan هو مدير حزم لا مركزي مفتوح المصدر، مصمم خصيصًا للغة C++. يحل Conan واحدة من أكثر المشاكل إيلامًا في نظام C++ البيئي: إدارة التبعيات (Dependencies). على عكس اللغات الأخرى (Python مع pip، JavaScript مع npm، Rust مع Cargo)، لم يكن لدى C++ لفترة طويلة أداة قياسية للتحميل التلقائي وبناء وتكامل المكتبات الخارجية. كان على المطورين تنزيل المصادر يدويًا، وإعداد مسارات التضمين (include paths)، وربط المكتبات، وحل تعارضات الإصدارات بشكل مؤلم. يقوم Conan بأتمتة هذه العملية بأكملها.

يدعم Conan جميع أنظمة التشغيل الرئيسية (Windows، Linux، macOS) والمترجمات (GCC، Clang، MSVC، MinGW). كما يعمل مع أنظمة بناء مختلفة: CMake، MSBuild، Makefiles، SCons، Bazel وغيرها. يمكن توزيع حزم Conan إما ككود مصدري (حيث سيقوم Conan ببنائها لمنصتك) أو كملفات ثنائية جاهزة. هذا يوفر ساعات من الوقت، خاصة في المشاريع الكبيرة التي تحتوي على عشرات التبعيات.

الميزة الرئيسية لـ Conan هي نموذج الملفات التعريفية (Profiles). يمكنك تحديد ملف تعريف لكل منصة/مترجم (مثل "clang-14-release-x86_64" أو "msvc-2022-debug-x86"). سيقوم Conan تلقائيًا باختيار أو بناء الحزم المتوافقة مع ملفك التعريفي. هذا يجعله أداة لا غنى عنها للتطوير عبر المنصات وخطوط أنابيب CI/CD.

2. التثبيت

Conan مكتوب بلغة Python ويتم تثبيته عبر pip. يُنصح بتثبيته في بيئة افتراضية (venv) لتجنب التعارض مع حزم Python النظامية.

# التثبيت عبر pip (يُفضل في بيئة افتراضية)
python -m pip install conan

# التحقق من التثبيت
conan --version

# التحديث إلى أحدث إصدار
python -m pip install --upgrade conan

بعد التثبيت، يُنصح بإعداد المستودع البعيد (remote) الافتراضي فورًا وهو ConanCenter. هو مضاف افتراضيًا، ولكن يمكنك التحقق من ذلك بالأمر:

conan remote list

إذا كان ConanCenter غير موجود، أضفه:

conan remote add conancenter https://center.conan.io

3. البداية السريعة — مثال عملي بسيط

لننشئ مشروعًا بسيطًا يستخدم مكتبة fmtlib (لتنسيق النصوص) ومكتبة zlib (لضغط البيانات).

الخطوة 1: هيكل المشروع

mkdir my_conan_project
cd my_conan_project
mkdir src

الخطوة 2: ملف conanfile.txt

[requires]
fmt/10.2.1
zlib/1.3.1

[generators]
CMakeDeps
CMakeToolchain

[layout]
cmake_layout

الخطوة 3: ملف CMakeLists.txt

cmake_minimum_required(VERSION 3.15)
project(MyConanProject CXX)

find_package(fmt REQUIRED)
find_package(ZLIB REQUIRED)

add_executable(my_app src/main.cpp)
target_link_libraries(my_app PRIVATE fmt::fmt ZLIB::ZLIB)

الخطوة 4: ملف src/main.cpp

#include <fmt/core.h>
#include <zlib.h>
#include <iostream>

int main() {
    // استخدام fmt
    fmt::print("مرحبًا من Conan! الإصدار: {}\n", FMT_VERSION);

    // استخدام zlib
    std::cout << "إصدار zlib: " << zlibVersion() << std::endl;

    // مثال بسيط على الضغط
    const char* data = "مرحبًا، Conan! هذه السلسلة النصية سيتم ضغطها.";
    uLong source_len = strlen(data) + 1;
    uLong dest_len = compressBound(source_len);
    char* compressed = new char[dest_len];

    int ret = compress(reinterpret_cast(compressed), &dest_len,
                       reinterpret_cast(data), source_len);
    if (ret == Z_OK) {
        fmt::print("تم الضغط بنجاح! الحجم الأصلي: {} بايت -> الحجم المضغوط: {} بايت\n", source_len, dest_len);
    }

    delete[] compressed;
    return 0;
}

الخطوة 5: البناء والتشغيل

# تثبيت التبعيات وإنشاء ملفات CMake
conan install . --build=missing

# بناء المشروع
cmake --preset conan-default
cmake --build --preset conan-release

# تشغيل التطبيق
./build/Release/my_app

الآن أصبحت بيئة Conan جاهزة للاستخدام في مشاريع C++ الخاصة بك!