Introducció

Treballar amb fitxers MSG d’Outlook en C++ ha requerit històricament una automatizació COM només per a Windows o biblioteques de tercers pesants amb llicències restrictives. Aspose.Email FOSS for C ++ modifica que: és una biblioteca pura de C +++17 sense dependències externes, sense COM i cap codi específic per plataforma. Es construeix idènticament sobre Linux, macOS i Windows.

La biblioteca es publica sota la llicència MIT i distribueix com a font via GitHub. L’integra mitjançant la clonació del repositori i afegint-lo com un subdirectori CMake no cal registrar el gestor de paquets, i no és necessari construir binaris prèviament.

Aquest post fa un recorregut pel flux de treball central: llegir un fitxer MSG existent, inspeccionar les seves propietats, crear un nou missatge programàticament i fer girs entre els formats MS G i EML.

Característiques clau

Llegir arxius MSG existents

Utilització: msg_reader per obrir una .msg arxiu i msg_document per accedir al seu contingut estructurat. Les dues classes viuen en el sector de la indústria. aspose::email::foss::msg espai de noms.

#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é un from_stream sobrecarrega per a la lectura d’un std::istream, que és útil en contextos del costat del servidor o de pipeline on els arxius no estan presents al disc.

Crear missatges programadament

mapi_message::create Produeix un nou missatge en memòria amb un tema i cos. pot llavors configurar detalls de remitent, afegir destinataris i adjuntar càrregues binàries o text abans d’utilitzar el sistema. Salvar.

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

Converteix MSG en EML

mapi_message El sistema de conversió d’MSG a EML és el que s’ha creat en la indústria. save_to_eml mètode. L’empremta EML és conforme a la RFC 5322 (MIME), fent-la compatible amb qualsevol correu estàndard. client 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 de l’EML

La direcció inversa és igualment directa: load_from_eml llegeix un fitxer EML. i produeix un mapi_message en la memòria, que després es pot guardar 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 CFB de baix nivell

Per a casos d’ús avançats com ara lectura de propietats MAPI en bruto no exposades per la API d’alt nivell cfb_reader dóna accés directe al contenidor Binari de fitxers compostos. que sosté 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 afegir com a subdirectori

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

En el teu 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 Inclou i utilitza

#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 Construir

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

Formats suportats

Format de la pàginaExtensióLlegeix.Escriure
MSG (Mèsatge de perspectiva).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (component binari de fitxers).msg, .cfb✓✓

Fonte oberta i llicències

Aspose.Email FOSS for C++ is released under the MIT license. The full source is available en GitHub a: FOSS-per-Cpp.Email-FOSP per a la CPP. L’ús comercial està permès sense drets d’autor. La biblioteca no té dependències de temps d ’execució més enllà d’un compilador C++17 i CMake 3.26 o posterior.

Com començar a treballar