Menggunakan Lisensi Doconut Anda

Untuk mengetahui cara menggunakan lisensi Doconut, ikuti instruksi di bawah ini untuk berbagai platform .NET.

Instalasi Lisensi Doconut

Di bagian ini, Anda akan belajar cara menginstal dan mengaktifkan lisensi Doconut Anda di berbagai lingkungan, termasuk .NET Framework, .NET Standard/Core, dan .NET 6. Ikuti langkah-langkah yang diberikan untuk memastikan integrasi lisensi Anda ke dalam proyek secara mulus:

.NET Framework

Deteksi Lisensi Otomatis

Doconut dapat secara otomatis mendeteksi lisensi jika diletakkan di dalam folder bin proyek.

Tambahkan Lisensi Default Manual

Jika Anda lebih suka menambahkan lisensi secara manual, opsi berikut tersedia:

Tambahkan Lisensi melalui Jalur File

Metode ini menggunakan overload Viewer.DoconutLicense(string licencePath) untuk menambahkan lisensi dengan menentukan jalur ke file lisensi.

var licensePath = "path/to/your/license.lic";
Viewer.DoconutLicense(licensePath);

Tambahkan Lisensi melalui Stream

Metode ini menggunakan overload Viewer.DoconutLicense(Stream licenseStream) untuk menambahkan lisensi menggunakan stream.

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    Viewer.DoconutLicense(licenseStream);
}

Tambahkan Lisensi melalui Dokumen XML

Metode ini menggunakan overload Viewer.DoconutLicense(XMLDocument licence) untuk menambahkan lisensi menggunakan dokumen XML.

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
Viewer.DoconutLicense(xmlDoc);

Tambahkan Lisensi Plugin melalui Jalur File

Metode ini menggunakan overload Viewer.SetLicensePlugin(string pathPluginLicence) untuk menambahkan lisensi plugin dengan menentukan jalur ke file lisensi plugin.

var pluginLicensePath = "path/to/your/plugin-license.lic";
new Viewer().DoconutLicense(pluginLicensePath);

Tambahkan Lisensi Plugin melalui Stream

Metode ini menggunakan overload Viewer.SetLicensePlugin(Stream pluginLicence) untuk menambahkan lisensi plugin menggunakan stream.

using var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var viewer = new Doconut.Viewer();
viewer.DoconutLicense(pluginLicenseStream);

Tambahkan Lisensi Plugin melalui Dokumen XML

Metode ini menggunakan overload Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) untuk menambahkan lisensi plugin menggunakan dokumen XML.

var viewer = new Viewer();
viewer.DoconutLicense("path/to/your/plugin-license.xml");

.NET Standard/Core dan .NET 6 ke atas

Deteksi Lisensi Otomatis

Doconut dapat secara otomatis mendeteksi lisensi jika diletakkan di dalam folder wwwroot proyek.

Untuk menginisialisasi docViewer dengan deteksi lisensi otomatis, gunakan baris berikut:

using Microsoft.Extensions.DependencyInjection;
var docViewer = app.Services.GetRequiredService<Doconut.Viewer>();

Tambahkan Lisensi Default Manual

Anda dapat secara manual menentukan jalur ke satu file lisensi default saat menginisialisasi viewer.

using System.IO;
var licenseFilePath = Path.Combine(path, "path/to/your/license");
var token = await viewer.OpenDocumentAsync(licenseFilePath, new BaseConfig(), new DocOptions(), ct);

Tambahkan Lisensi melalui Stream

Metode ini menggunakan overload Viewer.DoconutLicense(Stream licenseStream) untuk menambahkan lisensi menggunakan stream.

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    var license = new DoconutLicense
    {
        DocBytes = new BinaryReader(licenseStream).ReadBytes((int)licenseStream.Length)
    };
}

Tambahkan Lisensi melalui Dokumen XML

Metode ini menggunakan overload Viewer.DoconutLicense(XMLDocument licence) untuk menambahkan lisensi menggunakan dokumen XML.

using System.Xml;
using Doconut.Infrastructure.Licensing;

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // isi properti dari xmlDoc sesuai kebutuhan

Lisensi Plugin Default Manual Ganda

Jika Anda perlu menentukan beberapa lisensi, Anda dapat menyediakan daftar jalur file ke inisialisasi viewer.

// Lisensi dikonfigurasi melalui dependency injection; tidak diperlukan konstruktor eksplisit.
var viewer = /* instance Viewer yang di‑resolve DI */ null;

Tambahkan Lisensi Plugin melalui Stream

Metode ini menggunakan overload Viewer.SetLicensePlugin(Stream pluginLicence) untuk menambahkan lisensi plugin menggunakan stream.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // stream lisensi dikonsumsi secara internal oleh BaseConfig

Tambahkan Lisensi Plugin melalui Dokumen XML

Metode ini menggunakan overload Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) untuk menambahkan lisensi plugin menggunakan dokumen XML.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Pemuat lisensi tidak lagi diperlukan di Doconut.NETStandard 26.9.0

Melindungi File Lisensi Anda

Untuk melindungi file lisensi Doconut Anda (.lic), penting untuk mengikuti praktik terbaik keamanan file. Simpan file lisensi di direktori yang aman dengan akses terbatas, memastikan hanya pengguna atau layanan yang berwenang yang dapat membacanya.