Wprowadzenie

Praca z plikami Outlook MSG w C++ historycznie wymagała wyłącznie automatyzacji COM dostępnej tylko w systemie Windows
lub ciężkich bibliotek firm trzecich z restrykcyjnymi licencjami. Aspose.Email FOSS for C++
zmienia to: jest to czysta biblioteka C++17 bez zewnętrznych zależności, bez COM i bez
kodu specyficznego dla platformy. Buduje się identycznie na Linuxie, macOS i Windows.

Biblioteka jest udostępniona na licencji MIT i dystrybuowana jako kod źródłowy przez GitHub. Ty integrujesz ją, klonując repozytorium i dodając je jako podkatalog CMake — rejestracja w menedżerze pakietów nie jest wymagana, a binaria nie muszą być wstępnie kompilowane.

Ten wpis przechodzi przez podstawowy przepływ pracy: odczyt istniejącego pliku MSG, sprawdzanie jego właściwości, programowe tworzenie nowej wiadomości oraz konwersję w obie strony między formatami MSG i EML.

Kluczowe funkcje

Odczytaj istniejące pliki MSG

Użyj msg_reader, aby otworzyć plik .msg i msg_document, aby uzyskać dostęp do jego strukturalnej zawartości. Obie klasy znajdują się w przestrzeni nazw 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 ma również przeciążenie from_stream do odczytu z std::istream, co jest przydatne w kontekstach po stronie serwera lub w potokach, gdzie pliki nie znajdują się na dysku.

Utwórz wiadomości programowo

mapi_message::create tworzy nową wiadomość w pamięci z tematem i treścią.
Następnie możesz ustawić dane nadawcy, dodać odbiorców i dołączyć binarne lub tekstowe ładunki przed
zapisaniem.

#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"));

Konwertuj MSG na EML

mapi_message obsługuje bezpośrednią konwersję MSG‑do‑EML przy użyciu metody save_to_eml.
Wyjście EML jest zgodne z RFC 5322 (MIME), co czyni je kompatybilnym z dowolnym standardowym klientem poczty
lub potokiem przetwarzania.

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();

Załaduj z EML

Kierunek odwrotny jest równie prosty: load_from_eml odczytuje plik EML i tworzy mapi_message w pamięci, który następnie można zapisać z powrotem jako MSG.

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

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

Niskopoziomowy dostęp CFB

W zaawansowanych przypadkach użycia — takich jak odczytywanie surowych właściwości MAPI, które nie są udostępniane przez interfejs wysokiego poziomu — cfb_reader zapewnia bezpośredni dostęp do kontenera Compound File Binary, który stanowi podstawę formatu 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();

Szybki start

Krok 1 — Sklonuj i dodaj jako podkatalog

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

W Twoim projekcie 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)

Krok 2 — Dołącz i użyj

#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";
}

Krok 3 — Budowanie

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

Obsługiwane formaty

FormatRozszerzenieOdczytZapis
MSG (Outlook Message).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Open Source i licencjonowanie

Aspose.Email FOSS for C++ jest udostępniony na licencji MIT. Pełne źródło jest dostępne
na GitHub pod adresem aspose-email-foss/Aspose.Email-FOSS-for-Cpp.
Użycie komercyjne jest dozwolone bez opłat licencyjnych. Biblioteka nie ma zależności w czasie
działania poza kompilatorem C++17 i CMake 3.26 lub nowszym.

Rozpoczęcie