Вступ

Робота з файлами 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.
Комерційне використання дозволено без роялті. Бібліотека не має залежностей під час виконання
крім компілятора C++17 та CMake 3.26 або новішого.

Початок роботи