Introducció

Treballar amb fitxers Outlook MSG en C++ ha requerit històricament automatització COM només per a Windows
o biblioteques de tercers pesades amb llicències restrictives. Aspose.Email FOSS per a C++
canvia això: és una biblioteca pura C++17 sense dependències externes, sense COM i sense
codi específic de plataforma. Es compila de manera idèntica a Linux, macOS i Windows.

La biblioteca es publica sota la llicència MIT i es distribueix com a codi font a través de GitHub. La integreu clonant el repositori i afegint-lo com a subdirectori de CMake — no cal registrar cap gestor de paquets, i no cal que els binaris estiguin precompilats.

Aquesta publicació recorre el flux de treball principal: llegir un fitxer MSG existent, inspeccionar-ne les propietats, crear un missatge nou de manera programàtica i fer un viatge d’anada i torn entre els formats MSG i EML.

Característiques clau

Llegir fitxers MSG existents

Utilitzeu msg_reader per obrir un fitxer .msg i msg_document per accedir al seu contingut estructurat.
Ambdues classes es troben a l’espai de noms 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 també té una sobrecàrrega from_stream per llegir des d’un std::istream, que és útil en contextos del costat del servidor o de la canalització on els fitxers no es troben al disc.

Crear missatges programàticament

mapi_message::create genera un nou missatge en memòria amb un assumpte i un cos. A continuació, podeu establir els detalls del remitent, afegir destinataris i adjuntar càrregues útils binàries o de text abans de desar.

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

Convertir MSG a EML

mapi_message admet la conversió directa de MSG a EML mitjançant el mètode save_to_eml.
La sortida EML compleix amb RFC 5322 (MIME), fent-la compatible amb qualsevol client de correu
estàndard o pipeline de processament.

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

Carrega des de EML

La direcció inversa és igualment senzilla: load_from_eml llegeix un fitxer EML i produeix un mapi_message en memòria, que després es pot desar de nou a MSG.

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

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

Accés de baix nivell CFB

Per a casos d’ús avançats — com ara la lectura de propietats MAPI en brut que no exposa l’API de nivell alt — cfb_reader ofereix accés directe al contenidor Compound File Binary que sustenta el format 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();

Inici ràpid

Pas 1 — Clona i afegeix com a subdirectori

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

Al vostre projecte 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)

Pas 2 — Incloure i utilitzar

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

Pas 3 — Construcció

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

Formats compatibles

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

Codi obert i llicències

Aspose.Email FOSS per a C++ es publica sota la llicència MIT. El codi font complet està disponible a GitHub a aspose-email-foss/Aspose.Email-FOSS-for-Cpp. L’ús comercial està permès sense royalties. La biblioteca no té dependències d’execució més enllà d’un compilador C++17 i CMake 3.26 o posterior.

Començar