Instalace

Tato stránka pokrývá instalaci: Aspose-email-foss 26.3 do projektu Python. Tento balíček je čistě Python knihovna bez nativních závislostí žádné Microsoft Office, žádný COM interop, žádné rozšíření platformy. pip install To je všechno. To je nutné.

Předpoklady

Požadavek	Podrobnosti
Python	3.10 or later (`python --version` Kontrolovat)
PIP (přepínání)	Zahrnuje moderní instalace Python
Operační systém	Windows, macOS nebo Linux žádné omezení platforem

Pokud používáte Python 3.9 nebo starší, před pokračováním upgradujte na 3.10+. knihovna používá strukturální vzorové shodování a match/case zavedená syntaxe v Pythonu 3.10.

Instalace přes pip

pip install aspose-email-foss

To je poslední stabilní verze PyPI.:

pip install aspose-email-foss

Pro modernizaci stávající instalace:

pip install --upgrade aspose-email-foss

Virtuální prostředí nastavení

Použití virtuálního prostředí je doporučeno pro jakýkoli projekt. Izoluje balík od systému Python a vyhýbá se konfliktu závislosti mezi projekty.

python -m venv .venv
source .venv/bin/activate   # Linux/macOS
# .venv\Scripts\activate    # Windows (Command Prompt)
# .venv\Scripts\Activate.ps1  # Windows (PowerShell)
pip install aspose-email-foss

Virtuální prostředí je třeba vytvořit pouze jednou za projekt. Aktivujte ho na začátku každé terminálové sezení před spuštěním skriptů.

Ověřte instalaci

Po instalaci potvrďte, že balíček je správně naložen spuštěním minimální kontrolní operace. Test. create() metoda třídy vytváří nový MapiMessage v paměti bez Čtení jakéhokoli souboru, což je spolehlivý test kouře bez vedlejších účinků.

from aspose.email_foss.msg import MapiMessage

msg = MapiMessage.create("Test subject", "Test body")
print(f"Subject: {msg.subject}")

Pokud vidíte, že je předmět vytisknut bez chyb, pak se balíček správně nainstaloval a dováží.

Vyřešení problémů

ModuleNotFoundError: No module named 'aspose'

Balíček je nainstalován do jiného prostředí než běžící. - Zkontroluj to. which python (Linux/macOS) nebo where python (Windows) ukazuje na stejný tlumočník, který jste použili pro pip install.Jestliže … Pokud používáte virtuální prostředí, ujistěte se, že je aktivováno.

ModuleNotFoundError: No module named 'aspose.email_foss'

Nejvyšší úroveň. aspose namespace existuje (z jiného balíčku Aspose), ale email_foss Podbalíček nebyl nalezen. Run pip install aspose-email-foss Opět v správném prostředí.

ImportError na Python 3.9

Knihovna vyžaduje Python 3.10 nebo novější. Upgrade vaše instalace Pythonu.

Proxy nebo offline prostředí

U instalací s vzduchovým mezerem stahujte kolo z PyPI a nainstalujte: přímo: pip install aspose_email_foss-26.3-py3-none-any.whl.

Další kroky

Jak začít?: Přehled a rychlý příklad pro zahájení
Příručka pro vývojáře: Provozování, vlastnosti a přípojná zařízení pro MSG