مقدمة
التعامل مع ملفات 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 أو أحدث.