올바른 Doconut SDK 선택하기: .NET Standard 2.1, .NET 6, 또는 .NET 8
애플리케이션 호스트부터 시작하기
Doconut 패키지를 선택하는 것은 이를 실행할 프로젝트에서 시작됩니다. 새로운 .NET 8 웹 애플리케이션, 기존 .NET 6 서비스, 그리고 라이브러리와 호환되는 ASP.NET Core 호스트 모두 임베디드 문서 뷰어가 필요할 수 있지만, 프레임워크 제약과 업그레이드 계획은 서로 다릅니다.
Doconut은 .NET 8, .NET 6 및 새로운 .NET Standard 2.1 패키지를 사용하는 호환 호스트용 최신 SDK 경로를 제공합니다. 올바른 선택은 일반적으로 호스트와 직접 일치하고 애플리케이션을 유지 관리하는 팀에게 프레임워크 모호성을 최소화하는 패키지입니다.
Doconut Viewer SDK 개요는 제품 기능을 확인할 수 있는 시작점입니다. 프레임워크별 문서를 사용하여 패키지를 결정하십시오.
세 라벨이 의미하는 바 이해하기
.NET 8과 .NET 6은 애플리케이션 대상입니다. 웹 애플리케이션은 이 런타임 중 하나를 대상으로 하여 일치하는 Doconut 패키지를 선택할 수 있습니다.
.NET Standard 2.1은 다릅니다: 호환 가능한 .NET 호스트가 사용할 수 있는 라이브러리 API 계약을 정의합니다. Doconut 26.8.0은 .NET Core 3.0 이상, .NET 5부터 .NET 8까지를 대상으로 하는 애플리케이션을 위한 현재 Doconut.NETStandard 세대를 도입합니다. .NET Framework에서는 사용할 수 없습니다.
이 구분은 결정을 명확히 합니다. .NET Standard 2.1이 더 일반적으로 들린다고 선택하지 마세요; 호스트와 솔루션 구조에 계약이 적합할 때 선택하십시오.
실용적인 선택 표
| 애플리케이션 상황 | 평가할 Doconut 경로 | 이유 |
|---|---|---|
| 새로운 .NET 8을 대상으로 하는 애플리케이션 | Doconut.NET8 | 현재 .NET 개발과 전체 .NET 8 문서 경로에 직접 일치합니다. |
| .NET 6을 유지해야 하는 기존 애플리케이션 | Doconut.NET6 | 호스트 대상은 유지하면서 현재 의존성 주입, 미들웨어, 비동기 세션 및 선택적 분산 모델을 제공합니다. |
| .NET Standard 계약이 필요한 호환 ASP.NET Core 호스트 | Doconut.NETStandard 26.8.0+ | .NET Standard 2.1을 대상으로 하며 지원되는 호스트에 현재 Doconut 통합을 제공합니다. |
| 기존 Doconut.NETStandard 26.7.0 또는 이전 통합 | 26.8.0+을 선택하기 전에 마이그레이션을 계획하십시오 | 패키지 ID는 동일하지만 대상 및 API 세대가 변경됩니다. |
| .NET Framework를 대상으로 하는 애플리케이션 | Doconut.NETFramework | .NET Framework는 .NET Standard 2.1을 사용할 수 없습니다. |
이 표는 첫 번째 결정을 좁혀줍니다. 라이선스, 선택적 플러그인, 문서 형식, 배포 설계 및 업그레이드 노력은 여전히 별도의 검증이 필요합니다.
새로운 .NET 8 애플리케이션에 Doconut.NET8 선택하기
새로운 .NET 8 애플리케이션의 경우, 전용 패키지가 가장 명확한 평가 대상입니다. .NET 8 뷰어 페이지는 의존성 주입, 미들웨어 제공 리소스, 비동기 문서 세션 및 선택적 분산 워크플로를 기반으로 한 현재 모델을 설명합니다.
직접적인 런타임 일치는 문서를 따라가기 쉽게 만듭니다. 설치, 구성, 문제 해결, 플러그인 및 샘플 모두 하나의 프레임워크별 경로에서 평가할 수 있습니다.
채택하기 전에 제품이 실제로 필요로 하는 문서 형식과 선택적 기능을 테스트하십시오. 패키지 일치가 인증, 인가, 저장, 보존, 모니터링 및 리소스 제한과 같은 애플리케이션 수준의 결정을 대체하지는 않습니다.
.NET 6을 유지해야 하는 호스트일 때 Doconut.NET6 선택
기존 애플리케이션은 .NET 6에 머물러야 하는 종속성이나 지원 약속이 있을 수 있습니다. 업데이트된 .NET 6 Viewer 를 사용하면 애플리케이션이 해당 타깃을 유지하면서 Doconut의 최신 통합 아키텍처로 이동할 수 있습니다.
런타임 업그레이드와 문서 뷰어 마이그레이션을 같은 릴리스에서 동시에 진행하지 않아야 할 때 유용합니다. 팀은 호스트 프레임워크를 안정적으로 유지하면서 뷰어 등록, 리소스 전달, 비동기 열기 및 문서 세션을 현대화할 수 있습니다.
기존 프로젝트가 클래식 통합인지 업데이트된 Doconut .NET 6 통합인지 확인하십시오. 패키지 이름만으로는 세대를 알 수 없을 수 있습니다. 공식 마이그레이션 문서에서는 이를 구분하는 API 서명 및 호스팅 패턴을 식별합니다.
솔루션에 계약이 맞을 때 Doconut.NETStandard 선택
새로운 .NET Standard 2.1 설치 가이드 는 호환성 경계를 정의합니다. 이는 .NET Core 3.0 이상 호스트를 지원하며, .NET 5, 6, 7, 8을 포함하고 .NET Framework는 제외합니다.
솔루션이 .NET Standard 라이브러리 계약을 명시적으로 요구할 때 이 경로가 의미가 있습니다. 버전 선택이 중요합니다: Doconut.NETStandard 26.7.0 이하 버전은 .NET Standard 2.0을 대상으로 이전 통합을 사용하고, 26.8.0 이상은 현재 API와 함께 .NET Standard 2.1을 대상으로 합니다.
애플리케이션이 이미 이전 패키지 세대를 사용 중이라면 업데이트하기 전에 .NET Standard 마이그레이션 가이드 를 참고하십시오. 이 변경은 컴파일을 넘어 시작, 뷰어 수명, 리소스 라우팅, 문서 열기, 라이선스, 플러그인 및 분산 배포까지 영향을 미칠 수 있어 주의가 필요합니다.
전체 애플리케이션 영향 비교
작은 개념 증명은 “패키지가 설치되는가?” 이상의 질문에 답해야 합니다. 평가 항목:
- 호스트 호환성: 애플리케이션 타깃과 뷰어 패키지를 참조하는 모든 프로젝트를 확인합니다.
- 통합 세대: 현재 또는 클래식 등록, 뷰어 생성, 문서 열기 패턴을 식별합니다.
- 문서 범위: 제품에 필요한 대표적인 PDF, Office, CAD, 이미지, 이메일 또는 의료 파일을 테스트합니다.
- 플러그인 필요성: 워크플로에 포함될 경우 Search, Annotation, Converter, DICOM 기능을 개별적으로 검증합니다.
- 운영 모델: 세션 수명, 캐싱, 리소스 전달, 정리 및 단일 노드 또는 분산 설계를 테스트합니다.
- 업그레이드 노력: 프레임워크 변경과 Doconut 변경을 구분하여 오류 진단을 용이하게 합니다.
- 애플리케이션 제어: 주변 시스템에서 접근, 저장, 보존 및 전달 동작을 확인합니다.
각 결과와 함께 패키지 버전 및 프레임워크 타깃을 기록하십시오. 이는 하나의 SDK 경로에 대한 성공적인 테스트가 다른 경로에 대한 증거로 오해되는 것을 방지합니다.
프레임워크 선택을 명시적으로 만들기
좋은 아키텍처 노트는 간단히 작성할 수 있습니다: 애플리케이션 타깃, 선택한 Doconut 패키지 및 버전, 필요한 플러그인, 배포 모델, 구현 중 사용한 문서 경로를 명시합니다. 이러한 결정 기록은 이후 업그레이드가 패키지명 추정이 아닌 사실에 기반하도록 돕습니다.
새로운 .NET 8 개발의 경우 전용 .NET 8 SDK로 시작하십시오. .NET 6에 머무는 애플리케이션은 업데이트된 .NET 6 패키지를 평가합니다. 호환 가능한 호스트에 .NET Standard 2.1 계약이 적합할 경우 Doconut.NETStandard 26.8.0+ 를 사용하고, .NET Framework 애플리케이션은 전용 패키지 경로를 유지하십시오.
선택한 경로를 자체 애플리케이션 및 문서와 함께 테스트하려면 Doconut 문서 허브 와 체험판 다운로드 를 검토하십시오.