설치
Doconut을 .NET Standard 2.1 프로젝트에 추가
.NET Standard용 기본 Doconut 뷰어는 모든 ASP.NET Core 애플리케이션에 연결할 수 있는 하나의 NuGet 패키지로 제공됩니다. 선택적 플러그인은 별도의 패키지를 사용합니다. 이 페이지에서는 기본 패키지를 설치하고, 호스트가 이를 사용할 수 있는지 확인하며, 미들웨어를 등록합니다 — 첫 렌더링 전에 필요한 최소 단계입니다.
먼저 호스트 프레임워크 확인
이 라이브러리는 netstandard2.1을 대상으로 합니다. 이는 이전 netstandard2.0 빌드보다 더 좁은 계약이며, 확인해야 할 첫 번째 항목입니다:
| 호스트 | 지원 |
|---|---|
| .NET Core 3.0 이상, .NET 5/6/7/8 포함 | 예 |
| .NET Framework (모든 버전) | 아니오 — netstandard2.1은 .NET Framework에서 사용할 수 없습니다 |
패키지는 Windows 전용으로 실행됩니다. Linux 호스트의 경우, Doconut.NET8 또는 Doconut.NET6를 사용하십시오.
애플리케이션이 .NET Framework에서 실행되는 경우, 이는 올바른 패키지가 아닙니다. 대신 Doconut.NETFramework를 사용하십시오; 26.9.0부터는 .NET Framework 4.7.2가 필요합니다.
패키지 설치
dotnet add package Doconut.NETStandard버전이 지정되지 않은 명령은 최신 안정 버전을 설치합니다. 이 문서에서 설명하는 릴리스를 고정하려면, 버전을 별도의 옵션으로 전달하십시오:
dotnet add package Doconut.NETStandard --version 26.10.0Doconut.NETStandard는 패키지 ID입니다. 버전 접미사는 다운로드된 Doconut.NETStandard.<version>.nupkg 파일 이름에 포함되며 ID의 일부가 아닙니다.
버전 번호는 세대 구분
여기서는 패키지 이름보다 버전이 더 중요합니다. 두 세대의 .NET Standard 라이브러리가 동일한 패키지 ID로 배포되며, 버전만이 이를 구분합니다:
| 버전 | 대상 | API |
|---|---|---|
| 26.7.0 이하 | netstandard2.0 | 이전 통합 |
| 26.8.0 이상 | netstandard2.1 | 여기 문서화된 통합 |
호환성 쉼이 없으며, 병렬 패키지도 없습니다. 버전을 올리는 것이 바로 업그레이드이며, 컴파일러는 API 차이를 즉시 보고합니다.
패키지 이름만으로 문서를 선택하지 마십시오:
new Viewer(_cache, _accessor, …),UnSafeMode, 동기식OpenDocument(...),viewer.InitCache(),UseDoconutWebFarm, 및 수동으로 복사한 뷰어 스크립트는 이전 통합을 식별합니다;AddDoconut(),UseDoconutResources(), 주입된Viewer, 및OpenDocumentAsync(...)는 여기 문서화된 현재 통합을 식별합니다.
번역된 이전 설정 매뉴얼은 여전히 사용할 수 있습니다. 세대를 변경하려면 마이그레이션 가이드를 사용하십시오; 패키지 업데이트는 시작 설정, 뷰어 수명, 또는 브라우저 리소스를 자동으로 변환하지 않습니다.
Doconut 등록
AddDoconut()는 유일한 등록 진입점이며 — 단일 오버로드가 존재하고, Viewer 서비스, 라이선스 서비스, 그리고 렌더링 인프라를 DI 컨테이너에 연결합니다.
두 개의 미들웨어 호출이 설정을 완료하며, 순서가 중요합니다: UseDoconutResources()는 UseDoconut()보다 먼저 실행되어야 합니다. UseDoconut()는 최종 미들웨어이므로 먼저 호출하면 모든 /doconut-res 자산에 대한 요청이 리소스 핸들러에 도달하지 않아 404가 발생합니다. UseDoconut()는 도달하는 모든 요청에 응답하므로 app.Map와 함께 별도의 분기에서 마운트하십시오. 세션 연결도 필요합니다 — Doconut의 기본 문서 보안은 모든 페이지 요청을 ASP.NET 세션 상태와 검증합니다.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // session state에 캐시가 필요합니다 (MVC/Razor Pages는 이미 하나를 추가합니다)
builder.Services.AddSession(); // Doconut 문서 보안은 ASP.NET session state와 연동됩니다
app.UseSession(); // UseDoconut() 전에 UseSession()을 호출하세요
app.UseDoconutResources(); // UseDoconut() 전에 등록되어야 합니다
app.Map("/doconut", branch => branch.UseDoconut());네임스페이스
구성 타입이 이제 네 개의 네임스페이스에 흩어져 있지 않습니다. 이번 릴리스에서는 거의 모든 것이 루트 Doconut 네임스페이스에 존재합니다:
using Doconut; // Viewer, DoconutOptions, DocOptions, 모든 포맷 설정
using Doconut.Middleware; // AddDoconut, UseDoconut, UseDoconutResources
using Doconut.Clouds; // 클라우드 및 파일 공유 설정
using Doconut.Configs.Conversion; // ConversionTarget타입 이름 자체는 변경되지 않았습니다 — PdfConfig, WordConfig, ExcelConfig,
CssConfig, ScriptConfig 및 나머지는 모두 여전히 존재합니다. 기존 애플리케이션을 이동하는 경우, 대부분의 파일은 두 개의 삭제된 using 라인만 필요합니다; 마이그레이션 가이드를 참조하십시오.
모든 옵션
DoconutOptions은 다음과 같은 설정 가능한 속성을 받습니다. 모든 속성은 선택 사항이며 — 아래 기본값은 속성이 설정되지 않았을 때 적용됩니다.
| 속성 | 기본값 | 설명 |
|---|---|---|
ShowDoconutInfo | false | true인 경우, token가 없는 요청은 404 대신 버전 배너를 반환합니다. 스모크 체크에 유용하지만, 프로덕션에서는 비활성화하십시오. |
UnsafeMode | false | true인 경우, 페이지 요청 시 ASP.NET 세션 보안 검사를 건너뜁니다. 프로덕션에서는 비활성화하십시오. 표기법에 유의하십시오 — 이전 라이브러리는 이를 UnSafeMode라고 불렀습니다. |
MiddlewarePath | "/doconut" | 페이지-이미지 엔드포인트의 조정 값입니다. 검증은 되지만 자체적으로 분기를 마운트하지는 않으며, 실제 UseDoconut() 매핑 및 클라이언트 BasePath와 일치하도록 유지하십시오. |
ResourcesPath | "/doconut-res" | 내장된 JS/CSS/이미지 리소스가 제공되는 위치입니다. |
LicensePath | "" (빈 문자열) | 라이선스 파일 경로입니다. 비어 있으면 다음 소스로 넘어가며, 이후 자동 검색됩니다. |
LicenseContent | "" (빈 문자열) | 원시 라이선스 내용 — 환경 변수, 비밀 관리자, 또는 데이터베이스에서 가져옵니다. |
LicenseStream | null | 시작 시 한 번 읽는 스트림 형태의 라이선스입니다. |
ResetLicense | false | 예약된 호환성 플래그입니다. 라이선스는 AddDoconut() 중에 읽히며; 라이선스를 교체한 후 앱을 재시작하십시오. |
MaxConcurrentEditorSessions | 200 | 실시간 편집기 세션의 최대 수(DocOptions.EditMode로 연 문서). 이를 초과하면 가장 오래된 유휴 편집기 세션이 종료됩니다. 일반 뷰어 세션은 계산되지 않습니다. 0 또는 음수 값은 제한이 없음을 의미합니다. |
EditorSnapshotEveryOps | 50 | 편집기 지속성이 활성화된 경우(AddDoconutEditorPersistence), N개의 기록된 변경마다 실시간 문서를 스냅샷합니다. 0 또는 음수 값은 세션 중 스냅샷을 하지 않습니다. 지속성이 비활성화된 경우 효과가 없습니다. |
여러 소스가 설정된 경우 라이선스 우선순위: LicenseStream > LicenseContent > LicensePath > 자동 검색 — 라이선스 설정을 참조하십시오.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.MiddlewarePath = "/doconut"; // 앱 매핑 및 클라이언트 BasePath와 조정하세요
options.ResourcesPath = "/doconut-res"; // viewer의 JS/CSS/이미지가 제공되는 위치
options.UnsafeMode = false; // 세션 보안을 유지하세요
options.ShowDoconutInfo = false;
});다음 단계
이 페이지가 도움이 되었나요?