설치

.NET Standard용 기본 Doconut 뷰어는 ASP.NET Core 애플리케이션에 연결할 수 있는 단일 NuGet 패키지로 제공됩니다. 선택적 플러그인은 별도 패키지를 사용합니다. 이 페이지에서는 기본 패키지를 설치하고, 호스트가 이를 사용할 수 있는지 확인한 뒤, 미들웨어를 등록합니다 — 첫 번째 렌더링을 수행하기 전에 필요한 최소 단계입니다.

먼저 호스트 프레임워크 확인

The library targets netstandard2.1. That is a narrower contract than the previous netstandard2.0 build, and it is the first thing to verify:

If the application runs on .NET Framework, this is not the right package. Use Doconut.NETFramework instead; from 26.9.0 it requires .NET Framework 4.7.2. The reference applications shipped with this release target net8.0.

패키지 설치

dotnet add package Doconut.NETStandard

The unversioned command installs the latest stable release. To reproduce the current 26.8.0 release exactly, pass the version as a separate option:

dotnet add package Doconut.NETStandard --version 26.8.0

Doconut.NETStandard is the package ID. The .26.8.0 suffix belongs to the downloaded Doconut.NETStandard.26.8.0.nupkg filename and is not part of the ID.

버전 번호는 세대를 나타냅니다

This matters more here than the package name. Both generations of the .NET Standard library publish under the same package ID, and only the version tells them apart:

There is no compatibility shim and no side-by-side package. Bumping the version is the upgrade, and the compiler will report the API differences immediately.

Do not select documentation from the package name alone:

• new Viewer(_cache, _accessor, …), UnSafeMode, 동기 OpenDocument(...), viewer.InitCache(), UseDoconutWebFarm, 및 수동으로 복사된 뷰어 스크립트는 이전 통합을 식별합니다;
• AddDoconut(), UseDoconutResources(), 주입된 Viewer, 및 OpenDocumentAsync(...)는 여기 문서화된 현재 통합을 식별합니다.

The translated 이전 설정 매뉴얼 remains available. Use the 마이그레이션 가이드 to change generations; a package update does not convert startup, viewer lifetime, or browser resources automatically.

Doconut 등록

AddDoconut() is the only registration entry point — there is a single overload, and it wires the Viewer service, the license service, and the rendering infrastructure into the DI container.

Two middleware calls complete the setup, and their order matters: UseDoconutResources() must run before UseDoconut(). UseDoconut() is terminal middleware, so calling it first means every request to a /doconut-res asset never reaches the resources handler and 404s. The session wiring is required too — Doconut's default document security validates every page request against ASP.NET session state.

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // 세션 상태에 캐시가 필요합니다 (MVC/Razor Pages가 이미 하나를 추가합니다)
builder.Services.AddSession(); // Doconut 문서 보안은 ASP.NET 세션 상태에 의존합니다

app.UseSession();          // UseSession()을 UseDoconut()보다 먼저 호출합니다
app.UseDoconutResources(); // UseDoconut()보다 먼저 등록되어야 합니다
app.UseDoconut();

네임스페이스

The configuration types are no longer spread across four namespaces. In this release almost everything lives in the root Doconut namespace:

using Doconut;                       // Viewer, DoconutOptions, DocOptions, 모든 포맷 설정
using Doconut.Middleware;            // AddDoconut, UseDoconut, UseDoconutResources
using Doconut.Clouds;                // 클라우드 및 파일 공유 설정
using Doconut.Configs.Conversion;    // ConversionTarget

The type names themselves did not change — PdfConfig, WordConfig, ExcelConfig, CssConfig, ScriptConfig 등은 그대로 존재합니다. 기존 애플리케이션을 옮기는 경우 대부분의 파일에서 using 라인 두 개만 삭제하면 됩니다; 자세한 내용은 마이그레이션 가이드를 참고하십시오.

모든 옵션

DoconutOptions accepts the following settable properties. Every one is optional — the defaults below apply when a property is left unset.

License precedence when more than one source is set: LicenseStream beats LicenseContent beats LicensePath beats auto-search — see 라이선스 설정.

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // 앱 매핑 및 클라이언트 BasePath와 조정
    options.ResourcesPath   = "/doconut-res"; // 뷰어의 JS/CSS/이미지가 제공되는 위치
    options.UnsafeMode      = false;          // 세션 보안을 유지
    options.ShowDoconutInfo = false;
});

다음 단계

• 빠른 시작 — 첫 번째 문서를 열어 브라우저에 렌더링합니다.
• 라이선스 설정 — Doconut이 라이선스 파일을 찾는 위치입니다.