Cài đặt

Cài đặt SDK Documentize

Documentize có thể được cài đặt thông qua nhiều phương pháp khác nhau, mỗi phương pháp được thiết kế phù hợp với 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 khuyến nghị để cài đặt Documentize:

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 để cài đặt Documentize, đảm bảo rằng bạn luôn có phiên bản mới nhất và các bản cập nhật ngay trong môi trường phát triển của bạn. Kiểm tra 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 thuận tiện nếu bạn muốn có các DLL của Documentize được cài đặt trực tiếp trê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 trên nhiều dự án mà không cần quản lý thủ công các tệp DLL. Kiểm tra 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 ưa thích phương pháp 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. Kiểm tra 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.

28 thg 12, 2024

Tiểu mục của Cài đặt

Cài đặt Documentize thông qua NuGet

Mẹo vặt

NuGet là một trình quản lý gói miễn phí, mã nguồn mở cho .NET, đơn giản hóa việc thêm, gỡ bỏ và cập nhật thư viện trong các dự án Visual Studio. Nó tự động quản lý các tệp thư viện, tham chiếu và thay đổi cấu hình.

Cách Cài Đặt Thông Qua Console Trình Quản Lý Gói NuGet

  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 Console Trình Quản Lý Gói:

    • Điều hướng đến Công cụ > Trình Quản Lý Gói NuGet > Console Trình Quản Lý Gói.

  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 nóng, sử dụng Install-Package Documentize -prerelease.
    • Nhấn Enter để thực thi lệnh.

Cách Cập Nhật Gói Thông Qua Console Trình Quản Lý Gói NuGet

Nếu bạn đã cài đặt Documentize thông 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 Console Trình Quản Lý Gói:

    • Điều hướng đến Công cụ > Trình Quản Lý Gói NuGet > Console Trình Quản Lý Gói.

  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 nóng, sử dụng Update-Package Documentize -prerelease.
    • Nhấn Enter để thực thi lệnh.

Cách Cài Đặt Thông Qua Giao Diện Người Dùng Trình Quản Lý Gói NuGet

  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ều Hướng Đến Quản Lý Các Gói NuGet:

    • Từ menu Dự án, chọn Quản lý các gói NuGet.

  3. Tìm Kiếm Documentize:

    • Đi đến tab Duyệt và nhập Documentize vào ô tìm kiếm.

  4. Cài Đặt Gói:

    • Nhấn Cài đặt/Cập nhật 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 Chấp nhận 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 rằng tất cả các thư viện cần thiết được bao gồm và cập nhật chính xác. Đ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 đơn giản với NuGet, qua Console Trình Quản Lý Gói hoặc giao diện người dùng. Điều này giúp dễ dàng giữ cho các thư viện của bạn cập nhật với các tính năng và sửa lỗi mới nhất.

  • Tích Hợp Với Visual Studio:

    • NuGet được tích hợp liền mạch với Visual Studio, cung cấp một giao diện thân thiện cho việc 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 bạn dễ dàng quay lại các phiên bản trước hoặc thử nghiệm các phiên bản mới mà không gây gián đoạn cho việc phát triển.

Nhược Điểm Của Việc Sử Dụng NuGet

  • Giới Hạn Trong Visual Studio:

    • NuGet chủ yếu được thiết kế để sử dụng trong Visual Studio. Mặc dù có thể sử dụng trong các môi trường khác, nhưng sự tích hợp là mạnh mẽ nhất 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, quản lý 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ác công cụ để quản lý điều này, nhưng cần phải chú ý cẩn thận.

  • 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 đang làm việc trong một môi trường có hạn chế hoặc không có kết nối internet, bạn có thể cần 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 Đối Với Các Dự Án Lớn:

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

Cài đặt Documentize qua ZIP

Mẹo vặt

Tệp lưu trữ ZIP rất lý tưởng cho các nhà phát triển ưa thích phương pháp thủ công trong việc quản lý thư viện. Phương pháp này cho phép bạn tải xuống và giải nén các tệp DLL cần thiết trực tiếp mà không cần dựa vào trình quản lý gói hoặc trình cài đặt.

Cách cài đặt qua tệp lưu trữ ZIP

  1. Tải xuống tệp lưu trữ ZIP:

    • Nhấp vào v24.12 ZIP để tải xuống 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 nội dung của tệp ZIP vào một thư mục tùy chọn của bạn. Bạn có thể chọn 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 bạn.

  3. Thêm tham chiếu vào dự án của bạn:

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

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

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

Ưu điểm của việc sử dụng tệp lưu trữ ZIP

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

    • Bạn có quyền kiểm soát hoàn toàn về nơi và cách các tệp DLL được lưu trữ và tham chiếu trong dự án của bạn. Điều này có thể hữu ích nếu bạn ưa thích một thiết lập tùy chỉnh hoặc cần 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 phụ thuộc vào một trình quản lý gói để xử lý việc cài đặt. Điều này có thể thuận lợi trong các môi trường mà trình quản lý gói không có sẵn hoặc không được ưa chuộng.

  • Tính di động:

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

Nhược điểm của việc sử dụng tệp lưu trữ ZIP

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

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

  • Nguy cơ xung đột phiên bản:

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

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

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

Cài đặt Documentize thông qua MSI

Mẹo vặt

Trình cài đặt MSI là một lựa chọn tiện lợi và thân thiện với người dùng để cài đặt Documentize, đặc biệt nếu bạn muốn các DLL được cài đặt cho toàn hệ thống. Phương pháp này đơn giản hóa quy trình cài đặt bằng cách tự động hóa nhiều bước liên quan.

Cách cài đặt thông qua trình cài đặt MSI

  1. Tải xuống trình cài đặt MSI:

    • Nhấp vào v24.12 MSI để tải xuống 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 xuống để khởi động trình hướng dẫn cài đặt.

  3. Theo dõi trình hướng dẫn cài đặt:

    • Theo dõi 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 cấp phép và chọn các tùy chọn cài đặt.

  4. Hoàn thành cài đặt:

    • Khi cài đặt hoàn tất, các DLL của Documentize sẽ được cài đặt vào Bộ nhớ toàn cầu của hệ thống (GAC) hoặc một vị trí xác định khác.

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

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

Ưu điểm của việc sử dụng trình cài đặt MSI

  • Dễ sử dụng:

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

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

    • Phương pháp MSI cài đặt Documentize vào Bộ nhớ toàn cầu của hệ thống (GAC) 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 truy cập các DLL mà không cần tham chiếu riêng lẻ trong mỗi dự án.

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

    • Nếu Documentize cung cấp trình cài đặt cập nhật, bạn có thể dễ dàng cập nhật cài đặt của mình bằng cách chạy tệp MSI mới, thường thì quy trình cập nhật sẽ diễn ra suôn sẻ.

  • Tính nhất quán:

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

Nhược điểm của việc sử dụng trình cài đặt MSI

  • Tính linh hoạt hạn chế:

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

  • Chi phí bổ sung tiềm ẩn:

    • Cài đặt các DLL vào GAC có thể gây ra chi phí bổ sung và phức tạp, đặc biệt trong các tình huống mà nhiều phiên bản của Documentize có thể cần cùng lúc.

  • Gỡ cài đặt thủ công:

    • Nếu bạn cần gỡ cài đặt Documentize, bạn phải sử dụng trình gỡ cài đặt do MSI cung cấp, điều này 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 khác nhau của Documentize. Quản lý những xung đột này có thể yêu cầu cấu hình hoặc dọn dẹp bổ sung.

Môi trường không phải Windows

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

Vì Documentize cho .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 các hệ điều hành giống như Linux. Chúng tôi đang không ngừng cải thiện hỗ trợ .NET Core trong API của chúng tôi. Tuy nhiên, có một số thao tác mà chúng tôi khuyến nghị khách hàng thực hiện để có kết quả tốt hơn khi sử dụng các tính năng của Documentize cho .NET. Vui lòng cài đặt:

  • gói libgdiplus
  • Gói với font tương thích với Microsoft: ttf-mscorefonts-installer (ví dụ: sudo apt-get install ttf-mscorefonts-installer). Những font này nên được đặt trong thư mục /usr/share/fonts/truetype/msttcorefonts vì Documentize cho .NET quét thư mục này trên các hệ điều hành giống như Linux. Trong trường hợp hệ điều hành có thư mục/thư mục mặc định khác cho font, bạn nên sử dụng dòng mã sau trước khi thực hiện bất kỳ thao tác nào sử dụng Documentize:
    Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<đường dẫn của người dùng đến các font ms>"));
 Tiếng Việt