安装

Documentize SDK 的安装

Documentize 可以通过多种方法进行安装，每种方法都针对不同的开发环境和偏好。以下是推荐的 Documentize 安装方式：

1. NuGet（首选方法）

NuGet 是安装 Documentize 最直接且首选的方法，确保您始终在开发环境中获得最新版本和更新。有关此安装方法的更多详情，请参阅 如何使用 NuGet 安装 Documentize SDK。

2. MSI 安装程序

如果您希望将 Documentize DLL 直接安装到系统中，MSI 安装程序是一个方便的选项。此方法适用于希望在多个项目中使用 Documentize 而不需要手动管理 DLL 文件的开发者。有关此安装方法的更多详情，请参阅 如何使用 MSI 安装 Documentize SDK。

3. ZIP 压缩包

对于偏好手动方式的开发者，ZIP 压缩包中包含 Documentize DLL，您可以将其解压后直接添加到项目中。有关此安装方法的更多详情，请参阅 如何使用 ZIP 安装 Documentize SDK。

2026年11月3日

安装 的子部分

Installing Documentize via MSI

提示

MSI 安装程序是一个方便且用户友好的选项，用于安装 Documentize，尤其是当你希望将 DLL 安装到系统范围时。此方法通过自动化许多步骤简化了安装过程。

通过 MSI 安装程序进行安装的步骤

  1. 下载 MSI 安装程序：

    • 点击 v26.11 MSI 下载最新版本的 Documentize 的 MSI 安装程序。

  2. 运行安装程序：

    • 双击下载的 MSI 文件以启动安装向导。

  3. 按照安装向导操作：

    • 按照安装程序提供的屏幕指示进行操作。你可能需要同意许可协议并选择安装选项。

  4. 完成安装：

    • 安装完成后，Documentize 的 DLL 将被安装到系统的全局程序集缓存（GAC）或其他指定位置。

  5. 验证安装：

    • 通过检查指定的安装目录或 GAC 中是否存在这些 DLL，确认它们已正确安装。

使用 MSI 安装程序的优势

  • 易于使用：

    • MSI 安装程序提供简单且有指导的安装过程。它会处理所有必要的配置，并将 DLL 放置在中心位置，便于在多个项目中使用 Documentize。

  • 系统范围安装：

    • MSI 方法将 Documentize 安装到系统的全局程序集缓存（GAC）或其他中心位置。这样系统上的任何应用程序都可以访问这些 DLL，无需在每个项目中单独引用。

  • 自动化更新：

    • 如果 Documentize 提供了更新的安装程序，只需运行新的 MSI 文件即可轻松更新，通常能顺利完成更新过程。

  • 一致性：

    • 使用 MSI 安装程序可确保所有必需文件在不同环境中正确且一致地安装，降低缺失或放错 DLL 的风险。

使用 MSI 安装程序的劣势

  • 灵活性有限：

    • MSI 安装程序将 Documentize 安装到系统范围的位置，这可能不适合所有开发环境，可能缺乏针对项目特定配置或版本的灵活性。

  • 潜在开销：

    • 将 DLL 安装到 GAC 可能会引入额外的开销和复杂性，尤其在需要同时使用多个 Documentize 版本的场景下。

  • 手动卸载：

    • 若需要卸载 Documentize，必须使用 MSI 提供的卸载程序，如果管理不当，可能会留下残余文件或配置。

  • 版本冲突：

    • 系统范围的安装可能导致版本冲突，当不同项目需要不同版本的 Documentize 时，需要额外的配置或清理工作来解决冲突。

Installing Documentize via ZIP

提示

ZIP 存档非常适合喜欢手动管理库的开发者。这种方式允许你直接下载并解压所需的 DLL 文件，而无需依赖包管理器或安装程序。

如何通过 ZIP 存档进行安装

  1. 下载 ZIP 存档：

    • 点击 v26.11 ZIP 下载最新版本的 Documentize 压缩包。

  2. 解压内容：

    • 下载后，将 ZIP 文件解压到你选择的目录中。你可以将这些文件保存在共享目录或项目结构内部。

  3. 将引用添加到项目中：

    • 在你的 IDE（例如 Visual Studio）中打开项目。
    • 依次选择 Project > Add Reference > Browse，定位到解压后 DLL 所在的目录。
    • 选中相关的 DLL 文件并将其添加为项目引用。

  4. 手动更新：

    • 如果发布了新版本的 Documentize，需要手动下载更新的 ZIP 存档，并用新 DLL 替换项目中旧的 DLL 文件。

使用 ZIP 存档的优势

  • 完全控制：

    • 你可以完全自行决定 DLL 的存放位置和在项目中的引用方式。如果需要自定义设置或手动管理依赖，这非常有用。

  • 无需依赖包管理器：

    • 与 NuGet 不同，你不需要依赖包管理器来进行安装。这在没有或不希望使用包管理器的环境中尤为便利。

  • 可移植性强：

    • ZIP 存档可以轻松在不同系统之间共享和迁移，适合需要在多台机器上运行或分发而不依赖外部工具的项目。

使用 ZIP 存档的劣势

  • 手动管理：

    • 与 NuGet 自动更新和依赖管理不同，使用 ZIP 需要手动处理更新并确保所有必需的 DLL 正确引用。

  • 版本冲突风险：

    • 在管理多个项目或团队协作时，不同项目可能使用不同版本的 DLL，容易导致版本冲突，需要对版本进行仔细跟踪。

  • 没有自动更新：

    • 当有新版本发布时，你不会收到自动更新或通知，除非主动检查更新，否则可能使用过时的库。

非 Windows 环境

在非 Windows 环境下使用 .NET Core DLL

由于 Documentize for .NET 提供了 .NET Standard 2.0（.NET Core 2.0）支持，它可以在类似 Linux 的操作系统上运行的 Core 应用程序中使用。我们正在不断改进 API 对 .NET Core 的支持。然而，为了在使用 Documentize for .NET 功能时获得更好的效果，我们建议客户执行以下操作。请安装：

  • libgdiplus 包

  • Microsoft 兼容字体包： ttf‑mscorefonts‑installer（例如 sudo apt-get install ttf-mscorefonts-installer）。这些字体应放置在 /usr/share/fonts/truetype/msttcorefonts 目录下，因为 Documentize for .NET 会在类 Linux 操作系统上扫描此文件夹。如果操作系统使用了其他默认的字体文件夹/目录，请在使用 Documentize 进行任何操作之前，先加入以下代码行：

    Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<user's path to ms fonts>"));
 中文