Giriş

C++‘ta Outlook MSG dosyalarıyla çalışmak tarihsel olarak yalnızca Windows COM otomasyonu
veya kısıtlayıcı lisanslara sahip ağır üçüncü taraf kütüphaneler. Aspose.Email FOSS for C++
bunu değiştirir: harici bağımlılıkları, COM’u ve
platforma özgü kodu olmayan bir saf C++17 kütüphanesidir. Linux, macOS ve Windows’ta aynı şekilde derlenir.

Kütüphane MIT lisansı altında yayınlanmış ve GitHub üzerinden kaynak olarak dağıtılmaktadır. Siz depolamayı klonlayarak ve onu bir CMake alt dizini olarak ekleyerek entegre edersiniz — paket yöneticisi kaydı gerekli değildir ve önceden derlenmiş ikili dosyalara ihtiyaç yoktur.

Bu gönderi temel iş akışını adım adım inceler: mevcut bir MSG dosyasını okuma, özelliklerini inceleme, programlı olarak yeni bir mesaj oluşturma ve MSG ile EML formatları arasında çift yönlü dönüşüm yapma.

Temel Özellikler

Mevcut MSG Dosyalarını Oku

msg_reader kullanarak bir .msg dosyasını açın ve msg_document ile yapılandırılmış içeriğine erişin.
Her iki sınıf da aspose::email::foss::msg ad alanında bulunur.

#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 ayrıca bir from_stream aşırı yüklemesi sunar, bir std::istream‘den okuma için, bu da dosyaların disk üzerinde bulunmadığı sunucu tarafı veya boru hattı bağlamlarında faydalıdır.

Mesajları Programlı Olarak Oluşturma

mapi_message::create yeni bir bellek içi mesaj oluşturur; konu ve gövde içerir. Ardından gönderici ayrıntılarını ayarlayabilir, alıcılar ekleyebilir ve kaydetmeden önce ikili veya metin yüklerini ekleyebilirsiniz.

#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’yi EML’ye Dönüştür

mapi_message doğrudan MSG’den EML’ye dönüşümü save_to_eml yöntemiyle destekler. EML çıktısı RFC 5322 (MIME) standardına uygundur ve böylece herhangi bir standart mail istemcisi veya işleme hattı ile uyumludur.

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’den yükle

Ters yön de aynı derecede basittir: load_from_eml bir EML dosyasını okur ve bellekte bir mapi_message üretir, ardından bu MSG’ye geri kaydedilebilir.

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

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

Düşük Seviyeli CFB Erişimi

Gelişmiş kullanım durumları için — yüksek seviyeli API tarafından ortaya çıkarılmayan ham MAPI özelliklerini okuma gibi — cfb_reader, Compound File Binary konteynerine doğrudan erişim sağlar bu konteyner MSG formatının temelini oluşturur.

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

Hızlı Başlangıç

Adım 1 — Kopyala ve Alt Dizin Olarak Ekle

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

Projenizde 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)

Adım 2 — Dahil Et ve Kullan

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

Adım 3 — Oluştur

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

Desteklenen Formatlar

BiçimUzantıOkumaYazma
MSG (Outlook Message).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Açık Kaynak ve Lisanslama

Aspose.Email FOSS for C++ MIT lisansı altında yayınlanmıştır. Tam kaynak kodu GitHub’ta aspose-email-foss/Aspose.Email-FOSS-for-Cpp adresinde mevcuttur.
Ticari kullanım telif ücreti olmadan izin verilir. Kütüphane, bir C++17 derleyicisi ve CMake 3.26 veya daha yeni bir sürümünden başka çalışma zamanı bağımlılığı içermez.

Başlarken