Въведение

Работата с Outlook MSG файлове в C++ традиционно е изисквала Windows‑само COM автоматизация
или тежки библиотеки от трети страни с рестриктивни лицензи. 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 свойства, които не са изложени от високото ниво на API — cfb_reader предоставя директен достъп до контейнера Compound File Binary, който е основата на формата 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.
Търговската употреба е разрешена без royalties. Библиотеката няма runtime зависимости
освен C++17 компилатор и CMake 3.26 или по‑нов.

Започване