Installing Documentize via NuGet

Cách cài đặt qua NuGet Package Manager Console

1. Mở dự án của bạn:

   • Khởi động Visual Studio và mở ứng dụng .NET của bạn.

2. Truy cập Package Manager Console:

   • Điều hướng tới Tools > NuGet Package Manager > Package Manager Console.

3. Cài đặt gói:

   • Để cài đặt phiên bản đầy đủ mới nhất, nhập lệnh Install-Package Documentize.
   • Để cài đặt phiên bản mới nhất bao gồm các bản sửa lỗi, sử dụng Install-Package Documentize -prerelease.
   • Nhấn Enter để thực thi lệnh.

Cách cập nhật gói qua NuGet Package Manager Console

Nếu bạn đã cài đặt Documentize qua NuGet và muốn cập nhật lên phiên bản mới nhất:

1. Mở dự án của bạn:

   • Khởi động Visual Studio và mở ứng dụng .NET của bạn.

2. Truy cập Package Manager Console:

   • Điều hướng tới Tools > NuGet Package Manager > Package Manager Console.

3. Cập nhật gói:

   • Để cập nhật lên phiên bản đầy đủ mới nhất, nhập Update-Package Documentize.
   • Để cập nhật lên phiên bản mới nhất bao gồm các bản sửa lỗi, sử dụng Update-Package Documentize -prerelease.
   • Nhấn Enter để thực thi lệnh.

Cách cài đặt qua giao diện NuGet Package Manager (GUI)

1. Mở dự án của bạn:

   • Khởi động Visual Studio và mở ứng dụng .NET của bạn.

2. Đi đến Manage NuGet Packages:

   • Từ menu Project, chọn Manage NuGet Packages.

3. Tìm kiếm Documentize:

   • Chuyển tới tab Browse và nhập Documentize vào ô tìm kiếm.

4. Cài đặt gói:

   • Nhấn Install/Update bên cạnh phiên bản mới nhất của Documentize.
   • Xác nhận bằng cách nhấn Accept trong cửa sổ pop‑up.

Ưu điểm của việc sử dụng NuGet

• Quản lý phụ thuộc tự động:

  • NuGet tự động xử lý các phụ thuộc, đảm bảo mọi thư viện cần thiết đều được bao gồm và cập nhật đúng cách. Điều này giảm nguy cơ thiếu hoặc không tương thích các phụ thuộc.

• Cập nhật đơn giản:

  • Việc cập nhật các gói rất dễ dàng với NuGet, dù qua Package Manager Console hay giao diện GUI. Điều này giúp bạn luôn duy trì các thư viện với các tính năng và bản sửa lỗi mới nhất.

• Tích hợp sẵn trong Visual Studio:

  • NuGet được tích hợp liền mạch với Visual Studio, cung cấp giao diện thân thiện để quản lý các gói mà không cần rời khỏi môi trường phát triển.

• Quản lý phiên bản:

  • NuGet cho phép bạn chỉ định và quản lý các phiên bản khác nhau của thư viện, giúp dễ dàng quay lại các phiên bản trước hoặc thử nghiệm các bản phát hành mới mà không làm gián đoạn quá trình phát triển.

Nhược điểm của việc sử dụng NuGet

• Hạn chế với Visual Studio:

  • NuGet chủ yếu được thiết kế để sử dụng trong Visual Studio. Mặc dù có thể dùng trong các môi trường khác, nhưng mức độ tích hợp mạnh nhất vẫn là trong Visual Studio.

• Khả năng xung đột phiên bản:

  • Trong các dự án lớn với nhiều phụ thuộc, việc quản lý các phiên bản và giải quyết xung đột có thể trở nên phức tạp. NuGet cung cấp công cụ hỗ trợ, nhưng vẫn đòi hỏi sự chú ý tỉ mỉ.

• Phụ thuộc vào mạng:

  • Việc cài đặt và cập nhật các gói yêu cầu kết nối internet. Nếu bạn làm việc trong môi trường có hạn chế hoặc không có kết nối internet, có thể phải sử dụng các phương pháp ngoại tuyến hoặc tải trước các gói.

• Độ phức tạp cho dự án lớn:

  • Đối với các dự án rất lớn với cây phụ thuộc rộng, việc quản lý các gói qua NuGet có thể trở nên cồng kềnh. Trong những trường hợp này, có thể cần đến các công cụ hoặc chiến lược bổ sung để quản lý phụ thuộc một cách hiệu quả.

Cài đặt Documentize bằng ZIP

Cách cài đặt bằng tệp ZIP

1. Tải xuống tệp ZIP:

   • Nhấn vào v26.11 ZIP để tải phiên bản mới nhất của Documentize dưới dạng tệp lưu trữ.

2. Giải nén nội dung:

   • Sau khi tải xuống, giải nén tệp ZIP vào thư mục bạn muốn. Bạn có thể giữ các tệp này trong một thư mục chia sẻ hoặc trong cấu trúc dự án của mình.

3. Thêm tham chiếu vào dự án:

   • Mở dự án của bạn trong IDE (ví dụ: Visual Studio).
   • Đi tới Project > Add Reference > Browse và duyệt đến thư mục nơi bạn đã giải nén các DLL.
   • Chọn các tệp DLL liên quan và thêm chúng làm tham chiếu cho dự án.

4. Cập nhật thủ công:

   • Khi có phiên bản mới của Documentize được phát hành, bạn sẽ cần tải xuống tệp ZIP cập nhật và thay thế các tệp DLL cũ trong dự án bằng các tệp mới.

Ưu điểm khi sử dụng tệp ZIP

• Kiểm soát hoàn toàn:

  • Bạn có toàn quyền quyết định nơi lưu trữ và cách tham chiếu các DLL trong dự án. Điều này hữu ích nếu bạn muốn cấu hình tùy chỉnh hoặc phải quản lý các phụ thuộc một cách thủ công.

• Không phụ thuộc vào trình quản lý gói:

  • Khác với NuGet, bạn không cần dựa vào trình quản lý gói để xử lý việc cài đặt. Điều này có lợi trong môi trường mà các trình quản lý gói không có hoặc không được ưa chuộng.

• Tính di động:

  • Tệp ZIP có thể dễ dàng chia sẻ và di chuyển giữa các hệ thống khác nhau, rất phù hợp cho các dự án cần tính di động hoặc phân phối mà không dựa vào công cụ bên ngoài.

Nhược điểm khi sử dụng tệp ZIP

• Quản lý thủ công:

  • Khác với NuGet, nơi các cập nhật và quản lý phụ thuộc được tự động hoá, với tệp ZIP bạn phải tự mình quản lý các cập nhật và đảm bảo rằng tất cả các DLL cần thiết đã được tham chiếu đúng cách.

• Rủi ro xung đột phiên bản:

  • Nếu bạn đang quản lý nhiều dự án hoặc làm việc trong một đội, có khả năng xảy ra xung đột phiên bản khi các dự án khác nhau sử dụng các phiên bản DLL khác nhau. Điều này đòi hỏi việc theo dõi cẩn thận các phiên bản giữa các dự án.

• Không có cập nhật tự động:

  • Bạn sẽ không nhận được các cập nhật hoặc thông báo tự động khi có phiên bản mới. Điều này có thể dẫn đến việc sử dụng các thư viện lỗi thời nếu bạn không kiểm tra cập nhật thường xuyên.

Installing Documentize via MSI

Cách cài đặt qua Trình cài đặt MSI

1. Tải Trình cài đặt MSI:

   • Nhấn vào v26.11 MSI để tải trình cài đặt MSI cho phiên bản mới nhất của Documentize.

2. Chạy Trình cài đặt:

   • Nhấp đúp vào tệp MSI đã tải về để khởi chạy trình hướng dẫn cài đặt.

3. Làm theo Trình hướng dẫn Cài đặt:

   • Thực hiện các hướng dẫn trên màn hình do trình cài đặt cung cấp. Bạn có thể cần đồng ý với thỏa thuận giấy phép và chọn các tùy chọn cài đặt.

4. Hoàn tất Cài đặt:

   • Khi quá trình cài đặt kết thúc, các DLL của Documentize sẽ được cài đặt vào Global Assembly Cache (GAC) của hệ thống hoặc vị trí đã chỉ định khác.

5. Xác minh Cài đặt:

   • Kiểm tra xem các DLL đã được cài đặt đúng bằng cách xác nhận sự hiện diện của chúng trong thư mục cài đặt đã chỉ định hoặc trong GAC.

Ưu điểm của Trình cài đặt MSI

• Dễ sử dụng:

  • Trình cài đặt MSI cung cấp một quy trình cài đặt đơn giản và có hướng dẫn. Nó tự động thực hiện mọi cấu hình cần thiết và đặt các DLL vào một vị trí trung tâm, giúp việc sử dụng Documentize trên nhiều dự án trở nên dễ dàng.

• Cài đặt Toàn hệ thống:

  • Phương pháp MSI cài đặt Documentize vào Global Assembly Cache (GAC) của hệ thống hoặc một vị trí trung tâm khác. Điều này cho phép bất kỳ ứng dụng nào trên hệ thống đều có thể truy cập các DLL mà không cần tham chiếu riêng trong từng dự án.

• Cập nhật Tự động:

  • Nếu Documentize cung cấp một trình cài đặt mới, bạn có thể dễ dàng cập nhật bằng cách chạy tệp MSI mới, thường sẽ tự động xử lý quá trình cập nhật một cách suôn sẻ.

• Tính Nhất quán:

  • Sử dụng trình cài đặt MSI đảm bảo tất cả các tệp cần thiết được cài đặt đúng và đồng nhất trên các môi trường khác nhau, giảm nguy cơ thiếu hoặc đặt sai vị trí DLL.

Nhược điểm của Trình cài đặt MSI

• Độ linh hoạt hạn chế:

  • Trình cài đặt MSI cài Documentize vào vị trí toàn hệ thống, có thể không phù hợp với mọi môi trường phát triển. Nó có thể thiếu khả năng tùy chỉnh cho các cấu hình hoặc phiên bản đặc thù của dự án.

• Tiềm năng gây overhead:

  • Cài đặt DLL vào GAC có thể tạo ra overhead và độ phức tạp, đặc biệt khi cần sử dụng đồng thời nhiều phiên bản của Documentize.

• Gỡ bỏ thủ công:

  • Khi cần gỡ cài Documentize, bạn phải sử dụng công cụ gỡ cài của MSI, có thể để lại các tệp hoặc cấu hình dư thừa nếu không được quản lý đúng cách.

• Xung đột Phiên bản:

  • Cài đặt toàn hệ thống có thể dẫn đến xung đột phiên bản nếu các dự án khác nhau yêu cầu các phiên bản Documentize khác nhau. Quản lý các xung đột này có thể đòi hỏi cấu hình hoặc dọn dẹp thêm.

Môi Trường Không Windows

Làm việc với các DLL .NET Core trong môi trường không Windows

Vì Documentize for .NET cung cấp hỗ trợ .NET Standard 2.0 (.NET Core 2.0), nó có thể được sử dụng trong các ứng dụng Core chạy trên hệ điều hành kiểu Linux. Chúng tôi luôn nỗ lực cải thiện hỗ trợ .NET Core trong API của mình. Tuy nhiên, có một số thao tác chúng tôi khuyến nghị khách hàng thực hiện để đạt được kết quả tốt hơn khi sử dụng các tính năng của Documentize for .NET. Vui lòng cài đặt:

• gói libgdiplus
• Gói chứa các phông chữ tương thích Microsoft: ttf‑mscorefonts‑installer (ví dụ, 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 vì Documentize for .NET sẽ quét thư mục này trên các hệ điều hành kiểu Linux. Trong trường hợp hệ điều hành có thư mục mặc định khác cho phông chữ, bạn nên sử dụng đoạn mã sau trước khi thực hiện bất kỳ thao tác nào với Documentize:

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