Installation
Das Documentize SDK kann auf mehreren Wegen installiert werden, die an unterschiedliche Entwicklungsumgebungen und Vorlieben angepasst sind. Im Folgenden finden Sie die empfohlenen Methoden zur Installation von Documentize:
1. NuGet (Bevorzugte Methode)
NuGet ist die einfachste und bevorzugte Methode zur Installation von Documentize, die sicherstellt, dass Sie immer die neueste Version und Updates direkt in Ihrer Entwicklungsumgebung haben. Weitere Details zu dieser Installationsmethode finden Sie unter Wie man Documentize SDKs mit NuGet installiert.
2. MSI Installer
Der MSI-Installer ist eine praktische Option, wenn Sie die Documentize DLLs direkt auf Ihrem System installieren möchten. Diese Methode ist ideal für Entwickler, die Documentize über mehrere Projekte hinweg nutzen möchten, ohne DLL-Dateien manuell verwalten zu müssen. Weitere Details zu dieser Installationsmethode finden Sie unter Wie man Documentize SDKs mit MSI installiert.
3. ZIP-Archiv
Für Entwickler, die einen manuellen Ansatz bevorzugen, enthält das ZIP-Archiv die Documentize DLLs, die extrahiert und direkt zu Ihrem Projekt hinzugefügt werden können. Weitere Details zu dieser Installationsmethode finden Sie unter Wie man Documentize SDKs mit ZIP installiert.
Unterabschnitte von Installation
Systemanforderungen
Documentize SDKs sind darauf ausgelegt, in .NET-Anwendungen integriert zu werden und unterstützen verschiedene Betriebssysteme und Entwicklungsumgebungen. Nachfolgend sind die wichtigsten Systemanforderungen aufgeführt:
Unterstützte Betriebssysteme
Windows
- Windows 7 (x64, x86)
- Windows 8, 8.1 (x64, x86)
- Windows 10 (x64, x86)
- Windows 11 (x64, x86)
- Windows Server 2003 bis Windows Server 2022 (x64, x86)
- Cloud: Microsoft Azure
macOS
- macOS 10.12 (Sierra) und später
Linux
- Kompatibel mit mehreren Linux-Distributionen:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)
Android
- Unterstützt Android 8.0 (Oreo) und später.
Entwicklungsumgebungen
- Microsoft Visual Studio:
- Visual Studio 2010 und später (einschließlich 2019 und 2022)
- Unterstützt jede Entwicklungsumgebung, die auf .NET-Plattformen abzielt.
Unterstützte .NET Frameworks
- .NET Framework 4.0 und höher
- .NET Standard 2.0 (.NET Core 3.1+)
- .NET 6.0, .NET 7.0, .NET 8.0
Zusätzliche Hinweise
- Adobe Acrobat ist nicht erforderlich, um Documentize SDKs auszuführen, wird aber zur Ansicht von PDFs empfohlen.
Erklärung
Die Documentize.com SDKs benötigen ein Vollvertrauen-Berechtigungsset, wenn sie innerhalb von .NET-Anwendungen verwendet werden. Dieses Berechtigungsniveau ist entscheidend, damit die SDKs bestimmte systemnahe Operationen durchführen können, wie z. B. den Zugriff auf Registrierungseinstellungen, Systemdateien und das Parsen von Schriftarten.
Warum Vollvertrauen erforderlich ist
Die Documentize SDKs nutzen grundlegende .NET-Systemklassen, die häufig erweiterte Berechtigungen benötigen aus folgenden Gründen:
- Zugriff auf die Registrierung: Einige Operationen können das Lesen oder Schreiben in die Systemregistrierung erfordern.
- Systemdateien: Der Zugriff auf Systemdateien außerhalb des virtuellen Verzeichnisses der Anwendung kann für bestimmte Aufgaben erforderlich sein, wie z. B. das Verarbeiten von Schriftarten oder das Durchführen von Dateioperationen.
Einschränkungen der Medium Trust-Umgebung
In Hosting-Umgebungen, die eine Medium Trust-Sicherheit durchsetzen, sind mehrere wichtige Berechtigungen eingeschränkt oder nicht verfügbar. Dies könnte die korrekte Funktion der SDKs in solchen Umgebungen verhindern. Die folgenden Einschränkungen gelten unter Medium Trust:
- OleDbPermission: Es kann kein ADO.NET verwalteter OLE DB-Datenanbieter verwendet werden, um auf Datenbanken zuzugreifen.
- EventLogPermission: Der Zugriff auf das Windows-Ereignisprotokoll ist untersagt.
- ReflectionPermission: Verhindert die Verwendung von Reflection, was bestimmte dynamische Operationen beeinträchtigen kann.
- RegistryPermission: Der Zugriff auf die Systemregistrierung ist verweigert.
- WebPermission: Die Kommunikation ist auf vordefinierte Adressen oder Bereiche beschränkt, wie im
<trust>
-Element konfiguriert. - FileIOPermission: Der Zugriff auf Dateien ist auf die innerhalb des virtuellen Verzeichnisses der Anwendung beschränkt.
Nicht-Windows-Umgebung
Documentize SDKs unterstützen .NET Standard 2.0, was es ermöglicht, sie in .NET Core-Anwendungen zu verwenden, die auf Linux oder anderen Nicht-Windows-Umgebungen laufen. Um optimale Leistung und korrektes Text-Rendering sicherzustellen, folgen Sie bitte den nachstehenden Schritten:
Empfohlene Einrichtung für Linux
1. Installieren Sie das libgdiplus-Paket
Dieses Paket bietet die erforderliche GDI+-Funktionalität, die für das Rendern und Verarbeiten von PDFs entscheidend ist. Sie können es installieren, indem Sie den folgenden Befehl in Ihrem Terminal ausführen:
sudo apt-get install libgdiplus
2. Installieren Sie Microsoft-kompatible Schriftarten
Für ein korrektes Text-Rendering installieren Sie Microsoft TrueType-Schriftarten mit dem Befehl:
sudo apt-get install ttf-mscorefonts-installer
Diese Schriftarten sollten im Verzeichnis /usr/share/fonts/truetype/msttcorefonts
abgelegt werden. Wenn Ihr System Schriftarten in einem anderen Verzeichnis speichert, aktualisieren Sie den Pfad in Ihrem Code, bevor Sie irgendwelche Operationen mit den Documentize SDKs ausführen:
Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<Pfad zu ms Schriftarten>"));
Tipp
Indem Sie sicherstellen, dass diese Installationen abgeschlossen sind und der Schriftartenpfad korrekt konfiguriert ist, können Sie die Leistung der Documentize SDKs auf Linux oder anderen Nicht-Windows-Systemen maximieren.
Bewertung
Sie können die Documentize SDKs problemlos für Evaluierungszwecke herunterladen. Die Evaluierungsversion ist identisch mit der gekauften Version, der einzige Unterschied besteht darin, wie Sie die Lizenz anwenden.
Einschränkungen der Evaluierungsversion
Während die Evaluierungsversion vollen Zugriff auf alle Funktionen bietet, gelten die folgenden Einschränkungen, bis eine Lizenz angewendet wird:
- Ein Wasserzeichen zur Evaluierung wird in alle Ausgabedokumente eingefügt.
- Nur die ersten vier Seiten eines PDF-Dokuments können angezeigt oder bearbeitet werden.
Um diese Einschränkungen zu entfernen und die Vollversion freizuschalten, wenden Sie einfach eine Lizenz an, indem Sie ein paar Codezeilen zu Ihrem Projekt hinzufügen.