Thiết lập tệp giấy phép cho Sheetize

Mục tiêu: Tải một tệp giấy phép hợp lệ để thư viện Sheetize NuGet/DLL mở khóa tất cả các tính năng cao cấp.
Các bước dưới đây áp dụng cho bất kỳ ngôn ngữ .NET nào (C#, VB.NET, C++, F#, …) và cho các dự án tham chiếu Sheetize thông qua NuGet hoặc bằng cách thêm trực tiếp .dll đã biên dịch.

1 - Nhận tệp giấy phép của bạn

Nguồn	Cách nhận
Trang mua hàng	Tải `Sheetize.*.lic` sau khi thanh toán.

Quan trọng: Giữ tệp ở vị trí chỉ đọc và bao gồm trong quá trình triển khai, hoặc trong thư mục an toàn cạnh file thực thi. Không commit tệp giấy phép lên kho mã nguồn công cộng để tránh bị khai thác.

2 - Thêm tệp giấy phép vào dự án (tùy chọn)

Môi trường IDE / Hệ thống xây dựng	Các bước
Visual Studio (bất kỳ dự án .NET nào)	1. Nhấp chuột phải vào dự án → Add → Existing Item → chọn `Sheetize.(*).lic`.
2. Đặt Build Action thành Content.
3. Đặt Copy to Output Directory thành Copy if newer (hoặc Copy always).

Mẹo: Nếu bạn có nhiều môi trường (dev, test, prod) có thể giữ các tệp giấy phép riêng biệt trong các thư mục (licenses/dev/, licenses/prod/) và sao chép tệp phù hợp ở thời điểm build bằng thuộc tính Condition.

3 - Khởi tạo Sheetize với tệp giấy phép

Thư viện Sheetize yêu cầu bạn gọi LicenseManager.Load(string path) một lần trước khi sử dụng bất kỳ API nào khác của Sheetize. Dưới đây là các đoạn mã cho từng ngôn ngữ.

C# (phổ biến nhất)

using Sheetize; // Namespace của thư viện
using System;
using System.IO;

public static class Program
{
    private static void Main()
    {
        // Đường dẫn tương đối với thư mục chứa EXE đang chạy (nơi tệp đã được sao chép)
        string licensePath = "/path/to/Sheetize.PdfConverter_for_.NET.lic";
        License license = new Sheetize.License();
        license.SetLicense(licensePath);

        // Bây giờ bạn có thể dùng các tính năng cao cấp
        var loadOptions = new LoadOptions
        {
            InputFile = "/path/to/sample.xlsx"
        };
        var saveOptions = new SpreadsheetSaveOptions
        {
            OutputFile = "/path/to/sample.pdf"
        };
        SpreadsheetConverter.Process(loadOptions, saveOptions);
        // .
    }
}

4 - Xác minh giấy phép khi chạy

Một mẫu thông thường là kiểm tra xem tệp đầu ra có hiển thị watermark hay không. Nếu tệp giấy phép được đọc đúng, watermark sẽ không xuất hiện.

Bạn đã sẵn sàng!

Thêm tệp Sheetize.*.lic vào dự án và đánh dấu để sao chép vào thư mục output.
Gọi SetLicense(...) trước khi sử dụng bất kỳ API nào của Sheetize.
Triển khai tệp giấy phép cùng với các bản nhị phân (hoặc qua một mount an toàn).

Khi các bước này được thực hiện, tất cả khả năng trả phí của Sheetize — biểu đồ nâng cao, streaming hiệu năng cao, mã hoá đa sheet, v.v. — sẽ được mở khóa hoàn toàn cho người dùng của bạn, bất kể họ đang lập trình bằng C#, VB.NET, C++/CLI hay bất kỳ ngôn ngữ nào hỗ trợ .NET.

Chúc coding vui vẻ!