Cài đặt

SDK Documentize có thể được cài đặt qua nhiều phương pháp, mỗi phương pháp được điều chỉnh cho các môi trường phát triển và sở thích khác nhau. Dưới đây là các cách cài đặt Documentize được khuyến nghị:

1. NuGet (Phương pháp ưu tiên)

NuGet là phương pháp đơn giản nhất và được ưu tiên cho việc cài đặt Documentize, đảm bảo rằng bạn luôn có phiên bản và bản cập nhật mới nhất ngay trong môi trường phát triển của mình. Xem thêm chi tiết về phương pháp cài đặt này tại Cách cài đặt SDK Documentize bằng NuGet.

2. Trình cài đặt MSI

Trình cài đặt MSI là một lựa chọn tiện lợi nếu bạn thích cài đặt trực tiếp các DLL của Documentize lên hệ thống của mình. Phương pháp này lý tưởng cho các nhà phát triển có thể muốn sử dụng Documentize trong nhiều dự án mà không cần quản lý thủ công các tệp DLL. Xem thêm chi tiết về phương pháp cài đặt này tại Cách cài đặt SDK Documentize bằng MSI.

3. Tập tin ZIP

Đối với các nhà phát triển thích cách tiếp cận thủ công, tập tin ZIP chứa các DLL của Documentize, có thể được giải nén và thêm trực tiếp vào dự án của bạn. Xem thêm chi tiết về phương pháp cài đặt này tại Cách cài đặt SDK Documentize bằng ZIP.

Yêu cầu hệ thống

Các SDK của Documentize được thiết kế để tích hợp với các ứng dụng .NET và hỗ trợ nhiều hệ điều hành cùng môi trường phát triển khác nhau. Dưới đây là những yêu cầu hệ thống chính:

Các hệ điều hành được hỗ trợ

Windows

Windows 7 (x64, x86)
Windows 8, 8.1 (x64, x86)
Windows 10 (x64, x86)
Windows 11 (x64, x86)
Windows Server 2003 đến Windows Server 2022 (x64, x86)
Đám mây: Microsoft Azure

macOS

macOS 10.12 (Sierra) và các phiên bản sau

Linux

Tương thích với nhiều bản phân phối Linux:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)

Android

Hỗ trợ Android 8.0 (Oreo) và các phiên bản sau.

Môi trường phát triển

Microsoft Visual Studio:
- Visual Studio 2010 và các phiên bản sau (bao gồm 2019 và 2022)
Hỗ trợ bất kỳ môi trường phát triển nào nhắm đến các nền tảng .NET.

Các .NET Frameworks được hỗ trợ

.NET Framework 4.0 và cao hơn
.NET Standard 2.0 (.NET Core 3.1+)
.NET 6.0, .NET 7.0, .NET 8.0

Ghi chú thêm

Adobe Acrobat không bắt buộc để chạy các SDK của Documentize, nhưng được khuyến nghị để xem các tệp PDF.

Tuyên bố

SDK của Documentize.com yêu cầu một bộ quyền Full Trust khi được sử dụng trong các ứng dụng .NET. Mức độ quyền này rất cần thiết cho các SDK để thực hiện một số hoạt động cấp hệ thống, chẳng hạn như truy cập cài đặt registry, tệp hệ thống và phân tích phông chữ.

Tại sao cần Full Trust

Các SDK của Documentize sử dụng các lớp hệ thống .NET cốt lõi, thường cần quyền cao hơn vì các lý do sau:

Truy cập Registry: Một số hoạt động có thể yêu cầu đọc hoặc ghi vào registry hệ thống.
Tệp hệ thống: Truy cập vào các tệp hệ thống ngoài thư mục ảo của ứng dụng có thể cần thiết cho một số tác vụ, chẳng hạn như xử lý phông chữ hoặc thực hiện các thao tác tệp.

Hạn chế của Môi trường Medium Trust

Trong các môi trường hosting áp dụng bảo mật Medium Trust, một số quyền quan trọng bị hạn chế hoặc không khả dụng. Điều này có thể ngăn cản các SDK hoạt động đúng cách trong những môi trường như vậy. Các hạn chế sau đây được áp dụng dưới Medium Trust:

OleDbPermission: Không thể sử dụng nhà cung cấp dữ liệu OLE DB quản lý ADO.NET để truy cập cơ sở dữ liệu.
EventLogPermission: Truy cập vào Nhật ký Sự kiện Windows bị cấm.
ReflectionPermission: Ngăn việc sử dụng phản chiếu, điều này có thể ảnh hưởng đến một số hoạt động động.
RegistryPermission: Truy cập vào registry hệ thống bị từ chối.
WebPermission: Giao tiếp bị giới hạn ở các địa chỉ hoặc phạm vi đã định trước như cấu hình trong phần tử <trust>.
FileIOPermission: Truy cập vào các tệp bị giới hạn ở những tệp trong thư mục ảo của ứng dụng.

Môi Trường Không Phải Windows

SDK Documentize hỗ trợ .NET Standard 2.0, cho phép chúng được sử dụng trong các ứng dụng .NET Core chạy trên Linux hoặc các môi trường không phải Windows khác. Để đảm bảo hiệu suất tối ưu và kết xuất văn bản chính xác, hãy làm theo các bước dưới đây:

Thiết lập được khuyên cho Linux

1. Cài đặt gói libgdiplus

Gói này cung cấp các chức năng GDI+ cần thiết, điều quan trọng để kết xuất và xử lý PDFs. Bạn có thể cài đặt nó bằng cách chạy lệnh sau trong terminal của bạn:

sudo apt-get install libgdiplus

2. Cài đặt phông chữ tương thích với Microsoft

Để kết xuất văn bản chính xác, hãy cài đặt phông chữ TrueType của Microsoft bằng lệnh:

sudo apt-get install ttf-mscorefonts-installer

Các phông chữ này nên được đặt trong thư mục /usr/share/fonts/truetype/msttcorefonts. Nếu hệ thống của bạn lưu trữ phông chữ trong một thư mục khác, hãy cập nhật đường dẫn trong mã của bạn trước khi thực hiện bất kỳ thao tác nào với SDK Documentize:

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

Mẹo vặt

Bằng cách đảm bảo rằng các cài đặt này đã hoàn tất và cấu hình đường dẫn phông chữ một cách chính xác, bạn có thể tối đa hóa hiệu suất của SDK Documentize trên Linux hoặc các hệ thống không phải Windows khác.

Đánh giá

Bạn có thể dễ dàng tải xuống SDK Documentize để phục vụ cho mục đích đánh giá. Phiên bản đánh giá giống hệt với phiên bản đã mua, với sự khác biệt duy nhất là cách bạn áp dụng giấy phép.

Hạn chế của phiên bản đánh giá

Trong khi phiên bản đánh giá cung cấp quyền truy cập đầy đủ vào tất cả các tính năng, nó có các hạn chế sau cho đến khi một giấy phép được áp dụng:

Một dấu hiệu đánh giá được chèn vào tất cả các tài liệu đầu ra.
Chỉ bốn trang đầu tiên của bất kỳ tài liệu PDF nào có thể được xem hoặc chỉnh sửa.

Để xóa bỏ những hạn chế này và mở khóa phiên bản đầy đủ, chỉ cần áp dụng một giấy phép bằng cách thêm một vài dòng mã vào dự án của bạn.