Installation

Documentize SDK kann auf verschiedene Weise installiert werden, die jeweils auf unterschiedliche Entwicklungsumgebungen und Vorlieben zugeschnitten sind. Im Folgenden sind die empfohlenen Methoden zur Installation von Documentize aufgeführt:

1. NuGet (Bevorzugte Methode)

NuGet ist die einfachste und bevorzugte Methode zur Installation von Documentize, die sicherstellt, dass Sie immer die neueste Version und die neuesten Updates direkt in Ihrer Entwicklungsumgebung haben. Weitere Details zu dieser Installationsmethode finden Sie unter How to install Documentize SDKs using NuGet.

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 in mehreren Projekten verwenden möchten, ohne die DLL-Dateien manuell verwalten zu müssen. Weitere Details zu dieser Installationsmethode finden Sie unter How to install Documentize SDKs using MSI.

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 How to install Documentize SDKs using ZIP.

28.12.2024

Unterabschnitte von Installation

Systemanforderungen

Documentize SDKs sind dafür ausgelegt, sich in .NET-Anwendungen zu integrieren 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 höher

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 höher.

Entwicklungsumgebungen

  • Microsoft Visual Studio:
    • Visual Studio 2010 und höher (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 jedoch empfohlen, um PDFs anzuzeigen.
28.12.2024

Erklärung

Die Documentize.com SDKs benötigen ein Vollständiges Vertrauen-Berechtigungsset, wenn sie innerhalb von .NET-Anwendungen verwendet werden. Dieses Berechtigungsniveau ist entscheidend für die SDKs, um bestimmte systemnahe Operationen durchzuführen, wie z. B. den Zugriff auf Registrierungseinstellungen, Systemdateien und das Parsen von Schriften.

Warum vollständiges Vertrauen erforderlich ist

Die Documentize SDKs verwenden zentrale .NET-Systemklassen, die oft erhöhte Berechtigungen aus folgenden Gründen benötigen:

  • Zugriff auf die Registrierung: Einige Operationen erfordern möglicherweise das Lesen oder Schreiben in die Systemregistrierung.
  • Systemdateien: Der Zugriff auf Systemdateien über das virtuelle Verzeichnis der Anwendung hinaus kann für bestimmte Aufgaben erforderlich sein, wie z. B. das Verarbeiten von Schriften oder das Durchführen von Dateioperationen.

Einschränkungen der Umgebung für mittleres Vertrauen

In Hosting-Umgebungen, die die Sicherheitsanforderung Mittleres Vertrauen durchsetzen, sind mehrere wichtige Berechtigungen eingeschränkt oder nicht verfügbar. Dies könnte verhindern, dass die SDKs in solchen Umgebungen korrekt funktionieren. Die folgenden Einschränkungen gelten im Rahmen des Mittleren Vertrauens:

  • OleDbPermission: Kann den ADO.NET verwalteten OLE DB-Datenanbieter nicht verwenden, 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 diejenigen innerhalb des virtuellen Verzeichnisses der Anwendung beschränkt.
28.12.2024

Nicht-Windows-Umgebung

Documentize SDKs unterstützen .NET Standard 2.0, was es ermöglicht, in .NET Core-Anwendungen zu verwenden, die unter Linux oder anderen Nicht-Windows-Umgebungen ausgeführt werden. Um optimale Leistung und korrektes Text-Rendering sicherzustellen, befolgen Sie die folgenden Schritte:

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 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 Operationen mit Documentize SDKs ausführen:

Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<path to ms fonts>"));

Tipp

Durch die Sicherstellung dieser Installationen und die korrekte Konfiguration des Schriftartenpfads können Sie die Leistung der Documentize SDKs unter Linux oder anderen Nicht-Windows-Systemen maximieren.

28.12.2024

Evaluation

Sie können die Documentize SDKs leicht zu Evaluierungszwecken 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, enthält sie die folgenden Einschränkungen, bis eine Lizenz angewendet wird:

  • Ein Evaluierungs-Wasserzeichen 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 Zeilen Code zu Ihrem Projekt hinzufügen.

 Deutsch