مقدمة

التعامل مع ملفات Outlook MSG في C++ كان تاريخيًا يتطلب أتمتة COM خاصة بنظام Windows
أو مكتبات طرف ثالث ثقيلة ذات تراخيص مقيدة. Aspose.Email FOSS لـ C++
يغيّر ذلك: فهي مكتبة C++17 نقية بدون تبعيات خارجية، ولا COM، ولا
رمز خاص بمنصة معينة. تُبنى بنفس الطريقة على Linux، macOS، و Windows.

المكتبة مُصدرة تحت رخصة MIT وموزعة كمصدر عبر GitHub. تقوم بدمجها عن طريق استنساخ المستودع وإضافتها كدليل فرعي في CMake — لا يلزم تسجيلها في مدير الحزم، ولا تحتاج الثنائيات إلى بناء مسبق.

تستعرض هذه المشاركة سير العمل الأساسي: قراءة ملف MSG موجود، فحص خصائصه، إنشاء رسالة جديدة برمجياً، وإجراء تحويل ذهابًا وإيابًا بين صيغتي MSG وEML.


الميزات الرئيسية

قراءة ملفات MSG الموجودة

استخدم msg_reader لفتح ملف .msg و msg_document للوصول إلى محتواه المُنظم.
كلا الفئتين موجودتين في مساحة الاسم aspose::email::foss::msg.

#include "aspose/email/foss/msg/msg_reader.hpp"
#include "aspose/email/foss/msg/msg_document.hpp"
#include <filesystem>

namespace aef = aspose::email::foss;

auto reader   = aef::msg::msg_reader::from_file(std::filesystem::path("message.msg"));
auto document = aef::msg::msg_document::from_reader(reader);

msg_reader يحتوي أيضًا على تحميل زائد from_stream للقراءة من std::istream، وهو مفيد في سياقات الخادم أو خطوط الأنابيب حيث لا تكون الملفات موجودة على القرص.

إنشاء رسائل برمجياً

mapi_message::create ينتج رسالة جديدة في الذاكرة مع موضوع ومحتوى.
يمكنك بعد ذلك تعيين تفاصيل المرسل، إضافة المستلمين، وإرفاق حمولة ثنائية أو نصية قبل الحفظ.

#include "aspose/email/foss/msg/mapi_message.hpp"

namespace aef = aspose::email::foss;

auto msg = aef::msg::mapi_message::create(
    "Quarterly status update",
    "Hello team,\n\nPlease find the rollout summary attached.\n\nRegards");

msg.set_sender_name("Build Agent");
msg.set_sender_email_address("build.agent@example.com");
msg.add_recipient("alice@example.com", "Alice Example");
msg.save(std::filesystem::path("output.msg"));

تحويل MSG إلى EML

mapi_message يدعم التحويل المباشر من MSG إلى EML عبر طريقة save_to_eml.
إخراج EML يتوافق مع RFC 5322 (MIME)، مما يجعله متوافقًا مع أي عميل بريد
أو خط أنابيب معالجة.

auto loaded = aef::msg::mapi_message::from_file(
    std::filesystem::path("message.msg"), /*strict=*/false);

// Save as EML to a file
loaded.save_to_eml(std::filesystem::path("message.eml"));

// Or capture as bytes
std::vector<std::uint8_t> eml_bytes = loaded.save_to_eml();

تحميل من EML

الاتجاه العكسي سهل بنفس القدر: load_from_eml يقرأ ملف EML وينتج mapi_message في الذاكرة، والذي يمكن بعد ذلك حفظه مرة أخرى إلى MSG.

auto from_eml = aef::msg::mapi_message::load_from_eml(
    std::filesystem::path("message.eml"));

from_eml.save(std::filesystem::path("restored.msg"));

الوصول منخفض المستوى إلى CFB

لحالات الاستخدام المتقدمة — مثل قراءة خصائص MAPI الخام التي لا تُعرض عبر واجهة برمجة التطبيقات عالية المستوى — cfb_reader يوفّر وصولًا مباشرًا إلى حاوية ملف المركب الثنائي التي تدعم تنسيق MSG.

#include "aspose/email/foss/cfb/cfb_reader.hpp"

namespace aef = aspose::email::foss;

auto cfb = aef::cfb::cfb_reader::from_file(std::filesystem::path("message.msg"));
auto storage_ids = cfb.storage_ids();
auto stream_ids  = cfb.stream_ids();

البدء السريع

الخطوة 1 — استنساخ وإضافتها كدليل فرعي

git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.git

في مشروعك CMakeLists.txt:

cmake_minimum_required(VERSION 3.26)
project(my_project)

add_subdirectory(Aspose.Email-FOSS-for-Cpp)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE AsposeEmailFoss::AsposeEmailFoss)

الخطوة 2 — الإدراج والاستخدام

#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"

namespace aef = aspose::email::foss;

int main()
{
    // Create a message
    auto msg = aef::msg::mapi_message::create("Hello from C++", "Body text here");
    msg.save(std::filesystem::path("hello.msg"));

    // Round-trip to EML
    auto loaded = aef::msg::mapi_message::from_file(
        std::filesystem::path("hello.msg"), false);
    loaded.save_to_eml(std::filesystem::path("hello.eml"));

    std::cout << "Done\n";
}

الخطوة 3 — البناء

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

الصيغ المدعومة

الصيغةالامتدادقراءةكتابة
MSG (Outlook Message).msg
EML (RFC 5322 / MIME).eml
CFB (Compound File Binary).msg, .cfb

المصدر المفتوح والترخيص

تم إصدار Aspose.Email FOSS لـ C++ تحت رخصة MIT. المصدر الكامل متاح على GitHub في aspose-email-foss/Aspose.Email-FOSS-for-Cpp. يُسمح بالاستخدام التجاري دون حقوق ملكية. لا تحتوي المكتبة على أي تبعيات وقت تشغيل بخلاف مترجم C++17 و CMake 3.26 أو أحدث.


البدء