Doconut 라이선스 사용하기

Doconut 라이선스를 사용하는 방법을 알아보려면, 아래 .NET 플랫폼별 지침을 따르세요.

Doconut 라이선스 설치

이 섹션에서는 .NET Framework, .NET Standard/Core, .NET 6 등 다양한 환경에서 Doconut 라이선스를 설치하고 활성화하는 방법을 배웁니다. 제공된 단계를 따라 라이선스를 프로젝트에 원활히 통합하세요.

.NET Framework

자동 라이선스 감지

Doconut은 라이선스가 프로젝트의 bin 폴더에 배치된 경우 자동으로 감지할 수 있습니다.

수동 기본 라이선스 추가

라이선스를 수동으로 추가하려면 다음 옵션을 사용할 수 있습니다:

파일 경로로 라이선스 추가

이 방법은 라이선스 파일 경로를 지정하여 라이선스를 추가하기 위해 Viewer.DoconutLicense(string licencePath) 오버로드를 사용합니다.

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

스트림으로 라이선스 추가

이 방법은 스트림을 사용하여 라이선스를 추가하기 위해 Viewer.DoconutLicense(Stream licenseStream) 오버로드를 사용합니다.

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

XML 문서로 라이선스 추가

이 방법은 XML 문서를 사용하여 라이선스를 추가하기 위해 Viewer.DoconutLicense(XMLDocument licence) 오버로드를 사용합니다.

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

파일 경로로 플러그인 라이선스 추가

이 방법은 플러그인 라이선스 파일 경로를 지정하여 플러그인 라이선스를 추가하기 위해 Viewer.SetLicensePlugin(string pathPluginLicence) 오버로드를 사용합니다.

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

스트림으로 플러그인 라이선스 추가

이 방법은 스트림을 사용하여 플러그인 라이선스를 추가하기 위해 Viewer.SetLicensePlugin(Stream pluginLicence) 오버로드를 사용합니다.

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

XML 문서로 플러그인 라이선스 추가

이 방법은 XML 문서를 사용하여 플러그인 라이선스를 추가하기 위해 Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) 오버로드를 사용합니다.

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

.NET Standard/Core 및 .NET 6 이상

자동 라이선스 감지

Doconut은 라이선스가 프로젝트의 wwwroot 폴더에 배치된 경우 자동으로 감지할 수 있습니다.

자동 라이선스 감지를 위해 docViewer를 초기화하려면 다음 코드를 사용하세요:

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

수동 기본 라이선스 추가

뷰어를 초기화할 때 단일 기본 라이선스 파일의 경로를 수동으로 지정할 수 있습니다.

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

스트림으로 라이선스 추가

이 방법은 스트림을 사용하여 라이선스를 추가하기 위해 Viewer.DoconutLicense(Stream licenseStream) 오버로드를 사용합니다.

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

XML 문서로 라이선스 추가

이 방법은 XML 문서를 사용하여 라이선스를 추가하기 위해 Viewer.DoconutLicense(XMLDocument licence) 오버로드를 사용합니다.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // 필요에 따라 xmlDoc에서 속성을 채웁니다

수동 기본 다중 플러그인 라이선스

여러 라이선스를 지정해야 하는 경우, 뷰어 초기화 시 파일 경로 목록을 제공할 수 있습니다.

// Licences는 의존성 주입을 통해 구성됩니다; 명시적인 생성자는 필요하지 않습니다.
var viewer = /* DI‑해결된 Viewer 인스턴스 */ null;

스트림으로 플러그인 라이선스 추가

이 방법은 스트림을 사용하여 플러그인 라이선스를 추가하기 위해 Viewer.SetLicensePlugin(Stream pluginLicence) 오버로드를 사용합니다.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // 라이선스 스트림은 BaseConfig에 의해 내부적으로 사용됩니다

XML 문서로 플러그인 라이선스 추가

이 방법은 XML 문서를 사용하여 플러그인 라이선스를 추가하기 위해 Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) 오버로드를 사용합니다.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Doconut.NETStandard 26.9.0에서 라이선스 로딩은 더 이상 필요하지 않습니다

라이선스 파일 보호

Doconut 라이선스 파일(.lic)을 안전하게 보호하려면 파일 보안 모범 사례를 따르는 것이 중요합니다. 라이선스 파일을 접근이 제한된 안전한 디렉터리에 저장하여 권한이 있는 사용자나 서비스만 읽을 수 있도록 하세요.