Viewing PDFs in MAUI for C# .NET

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF Viewer를 사용하면 MAUI 애플리케이션에서 PDF를 직접 볼 수 있습니다. IronPDF Viewer는 탐색, 확대/축소, 검색 및 인쇄를 위한 툴바 옵션을 제공하는 완벽한 기능의 PDF 보기 구성 요소를 단 한 줄의 코드로 구현할 수 있습니다.

IronPDF .NET Maui PDF 뷰어 배너. 차트와 다이어그램이 포함된 복잡한 기술 문서가 뷰어에서 렌더링된 모습.

크로스 플랫폼 애플리케이션은 앱 내에서 PDF 문서를 직접 표시해야 하는 경우가 많습니다. IronPDF Viewer를 사용하면 MAUI 애플리케이션에 PDF 보기 기능을 내장하여 WindowsmacOS 플랫폼에서 문서를 볼 수 있습니다.

IronPDF Viewer는 IronPDF 라이브러리를 기반으로 구축된 구성 요소로, PDF 조작 및 보기를 위한 포괄적인 솔루션을 제공합니다. 이 소프트웨어는 .NET MAUI 애플리케이션과의 네이티브 통합을 제공하여 플랫폼 전반에 걸쳐 일관된 성능을 보장합니다.

이 문서에서는 IronPDF Viewer를 MAUI 애플리케이션에 통합하여 사용자가 PDF 파일을 보고, 저장하고, 인쇄할 수 있도록 하는 방법을 설명합니다. 기업용 애플리케이션, 문서 관리 시스템 또는 교육용 소프트웨어를 개발하든 관계없이 이 가이드는 PDF 보기 기능을 구현하는 데 도움이 될 것입니다.

빠른 시작: IronPDF를 사용하여 MAUI에서 PDF 보기

IronPDF를 MAUI 애플리케이션에 통합하면 즉시 PDF 파일을 볼 수 있습니다. 이 코드 조각은 IronPDF PdfViewer 인스턴스를 생성하고 PDF 파일을 불러와 보는 방법을 보여줍니다.

Nuget Icon지금 바로 NuGet을 사용하여 PDF 만들기를 시작하세요.

  1. NuGet 패키지 관리자를 사용하여 IronPDF를 설치하세요.

    PM > Install-Package IronPdf

  2. 다음 코드 조각을 복사하여 실행하세요.

    new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    지금 바로 무료 체험판을 통해 프로젝트에서 IronPDF를 사용해 보세요.
    arrow pointer


IronPDF 뷰어 라이브러리를 다운로드하고 설치하는 방법은 무엇인가요?

NuGet 패키지 관리자를 통해 어떻게 설치하나요?

Visual Studio에서 솔루션 탐색기의 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 Manage NuGet Packages...를 선택합니다. 그다음 IronPdf.Viewer.Maui 를 검색하여 최신 버전을 솔루션에 설치하십시오. 보다 자세한 설치 지침은 설치 개요를 참조하십시오. 또는 Tools > NuGet Package Manager > Package Manager Console로 이동하여 다음 명령을 입력하여 NuGet 패키지 관리자 콘솔을 엽니다.

Install-Package IronPdf.Viewer.Maui

IronPDF Viewer 패키지에는 MAUI 애플리케이션에서 PDF를 보는 데 필요한 모든 종속성이 포함되어 있습니다. 정확한 문서 표시를 위해 핵심 IronPDF 라이브러리와 동일한 렌더링 엔진을 사용합니다.

IronPDF 뷰어를 MAUI 애플리케이션에 통합하는 방법은 무엇인가요?

다음 섹션에서는 IronPDF Viewer를 기본 MAUI 애플리케이션에 통합하는 방법을 보여줍니다. 통합 과정은 간단하며 최소한의 설정만 필요합니다.

통합 전에 어떤 설정이 필요합니까?

IronPDF Viewer를 MAUI 프로젝트에 추가하기 전에 iOS 및 Android 플랫폼을 대상으로 하지 않는지 확인하십시오. 현재 IronPDF Viewer는 Windows 및 macOS 데스크톱 플랫폼을 지원합니다. 프로젝트 파일을 마우스 오른쪽 버튼으로 클릭하고 속성을 선택하여 이를 확인하십시오. 'iOS 플랫폼 대상으로 지정' 및 'Android 플랫폼 대상으로 지정' 확인란이 선택되어 있으면 선택을 해제하세요. 이 변경 사항을 적용하려면 체크를 해제한 후 프로젝트를 저장하고 Visual Studio를 다시 시작하십시오.

 .NET 7.0 프레임워크를 사용하여 iOS, Android 및 Windows 플랫폼 타겟팅이 활성화된 MAUI 프로젝트 속성을 보여줍니다.

iOS 및 Android 플랫폼에 대한 대상 지정을 해제한 후, MauiProgram.cs 파일로 이동하여 다음 코드를 추가하여 뷰어를 초기화하십시오.

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-1.cs
using IronPdf.Viewer.Maui;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            // other configuration options ...
            .ConfigureIronPdfView(); // configure the viewer on app start-up

        return builder.Build();
    }
}
$vbLabelText   $csharpLabel

기본적으로 IronPDF 뷰어는 보기의 오른쪽 하단에 배너를 표시합니다. 이 배너를 제거하고 모든 기능을 잠금 해제하려면 IronPDF(또는 Iron Suite) 라이선스 키를 ConfigureIronPdfViewer에 추가하세요.

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
$vbLabelText   $csharpLabel

라이선스 키 획득 및 적용에 대한 자세한 내용은 라이선스 키 가이드를 참조하십시오.

PDF 뷰어 페이지를 어떻게 추가하나요?

이 섹션에서는 PDF 뷰어 페이지를 만드는 방법, IronPDF 뷰어를 통합하는 방법, 그리고 MAUI 애플리케이션에 해당 탭을 만드는 방법을 다룹니다. 우리는 XAML과 C# ContentPage을 사용하여 이를 시연합니다. 자신의 개발 스타일과 프로젝트 요구 사항에 가장 적합한 접근 방식을 선택하십시오.

뷰어 페이지를 추가하는 단계는 무엇인가요?

  1. 프로젝트를 마우스 오른쪽 버튼으로 클릭한 다음 Add > New Item...로 이동하여 프로젝트에 새 페이지를 추가합니다.
    MAUI 애플리케이션 개발을 위한 새 항목, 참조 및 프로젝트 구성 요소를 보여주는 Visual Studio 추가 메뉴

  2. .NET MAUI 섹션으로 이동합니다. XAML 페이지를 만들려면 .NET MAUI ContentPage (XAML)를 선택하세요. C# 파일의 경우 .NET MAUI ContentPage (C#)를 선택하세요. 파일 이름을 _PdfViewerPage_로 지정한 다음 Add를 클릭하세요.
    Visual Studio의 새 항목 추가 대화 상자에서 .NET MAUI ContentPage(C#)가 선택되고 PdfViewerPage.cs 파일 이름이 입력되었습니다.

  3. XAML 파일에 다음 코드를 추가하고 저장하세요.

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>
XML
  1. 프로젝트를 저장한 다음 빌드하고 실행하세요. 아래 그림과 같이 왼쪽 상단에 탭이 표시될 것입니다. "PDF 뷰어" 탭을 클릭하면 IronPDF 뷰어가 열립니다. 이 뷰어는 PDF 문서와의 상호 작용을 위한 다양한 기능을 갖춘 인터페이스를 제공합니다.

어두운 테마가 적용된 IronPDF 뷰어의 기본 인터페이스. 파일 업로드 영역과 파일 찾아보기 버튼이 표시됩니다.

컴퓨터 시작 시 PDF 파일을 불러오려면 어떻게 해야 하나요?

IronPDF Viewer는 애플리케이션 시작 시 기본적으로 사용자에게 PDF 파일을 열도록 요청합니다. 하지만 시작 시 PDF 파일을 자동으로 열 수 있어 특정 문서를 즉시 표시해야 하는 애플리케이션의 사용자 경험을 향상시킵니다. 시작 시 PDF 파일을 불러오는 방법은 파일 이름, 바이트 배열, 스트림의 세 가지가 있습니다. 각 방법은 데이터 소스와 애플리케이션 아키텍처에 따라 서로 다른 장점을 제공합니다.

파일 이름으로 불러오려면 어떻게 해야 하나요?

PDF 파일을 파일 이름으로 불러오려면 XAML 파일의 IronPdfView 태그에 PDF 파일의 소스를 지정하세요. 로컬 파일을 사용할 때 가장 간단한 방법입니다.


<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
XML

마찬가지로 C#에서도 다음과 같습니다.

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cs
pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;
$vbLabelText   $csharpLabel

이것은 다음을 표시합니다:

기본 설정에서 IronPDF 뷰어 툴바의 메뉴 아이콘, 로고 및 파일 선택 버튼이 표시됩니다.

툴바 옵션에 대한 이러한 세부적인 제어를 통해 애플리케이션 요구 사항에 맞는 보기 환경을 만들 수 있습니다. 예를 들어, 보안 문서 뷰어에서 다운로드를 제한하거나 기본적인 보기 시나리오에 맞춰 인터페이스를 간소화할 수 있습니다.

결론

이 튜토리얼에서는 IronPDF Viewer를 MAUI 애플리케이션에 통합하고 필요에 맞게 툴바를 사용자 지정하는 방법을 다뤘습니다. IronPDF Viewer는 최소한의 코드로 .NET MAUI 애플리케이션에 완벽하게 통합되는 강력한 PDF 보기 환경을 제공합니다.

이 뷰어는 다양한 소스(파일, 바이트 배열 및 스트림)에서 PDF를 로드할 수 있는 유연성을 갖추고 있어 간단한 문서 뷰어부터 복잡한 문서 관리 시스템에 이르기까지 다양한 응용 분야에 적합합니다. 다양한 툴바 사용자 지정 옵션과 결합하여 사용자가 필요로 하는 정확한 보기 환경을 만들 수 있습니다.

이 뷰어는 강력한 PDF 생성 , 편집조작 기능을 포함하는 IronPDF 제품에 함께 제공됩니다. 기능 추가를 요청하시거나 IronPDF Viewer(또는 IronPDF)에 대한 일반적인 질문이 있으시면 지원팀에 문의해 주세요. 기꺼이 도와드리겠습니다.

고급 PDF 작업에 대해서는 종합적인 PDF 보기 가이드를 참조하거나 라이선스 키를 적용하여 IronPDF의 모든 기능을 애플리케이션에서 활용하는 방법을 알아보세요.

자주 묻는 질문

.NET MAUI용 IronPDF 뷰어란 무엇입니까?

IronPDF Viewer는 MAUI 애플리케이션에 PDF 보기 기능을 직접 내장할 수 있도록 해주는 완벽한 기능을 갖춘 PDF 뷰어 구성 요소입니다. 탐색, 확대/축소, 검색 및 인쇄를 위한 툴바 옵션을 제공하며, 단 한 줄의 코드로 구현할 수 있습니다. 이 뷰어는 IronPDF 라이브러리를 기반으로 구축되어 포괄적인 PDF 조작 및 보기 기능을 제공합니다.

IronPDF Viewer는 MAUI 애플리케이션에서 어떤 플랫폼을 지원합니까?

IronPDF Viewer는 .NET MAUI 애플리케이션과의 기본 통합을 제공하며 Windows 및 macOS 플랫폼 모두에서 크로스 플랫폼 PDF 보기를 지원하여 이러한 운영 체제에서 일관된 성능을 보장합니다.

MAUI 프로젝트에 IronPDF Viewer를 어떻게 설치하나요?

Visual Studio의 NuGet 패키지 관리자에서 'IronPdf.Viewer.Maui'를 검색하여 최신 버전을 설치하면 IronPDF Viewer를 설치할 수 있습니다. 또는 패키지 관리자 콘솔에서 'Install-Package IronPdf.Viewer.Maui' 명령어를 사용하여 설치할 수도 있습니다. 이 패키지에는 MAUI 애플리케이션에서 PDF를 보는 데 필요한 모든 종속성이 포함되어 있습니다.

MAUI 앱에 PDF 보기 기능을 얼마나 빨리 구현할 수 있을까요?

IronPDF Viewer를 사용하면 단 한 줄의 코드로 모든 기능을 갖춘 PDF 뷰어를 내장할 수 있습니다. `new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };` 이를 통해 MAUI 애플리케이션에 PDF 보기 기능을 매우 빠르게 추가할 수 있습니다.

PDF 뷰어 도구 모음은 어떤 기능을 제공하나요?

IronPDF Viewer 툴바는 페이지 간 이동을 위한 탐색 컨트롤, 문서 보기 크기를 조정하는 확대/축소 기능, PDF 내에서 텍스트를 찾는 검색 기능, MAUI 애플리케이션에서 문서를 직접 출력하는 인쇄 옵션 등 포괄적인 기능을 제공합니다.

IronPDF Viewer에서 서로 다른 소스의 PDF 파일을 불러올 수 있나요?

네, IronPDF Viewer는 직접 파일 경로, 바이트 배열, 스트림 등 다양한 소스에서 PDF를 불러오는 것을 지원합니다. 이러한 유연성을 통해 MAUI 애플리케이션 내에서 로컬 저장소, 메모리 또는 네트워크 소스의 PDF를 표시할 수 있습니다.

IronPDF Viewer는 기업용 애플리케이션에 적합한가요?

IronPDF Viewer는 기업용 애플리케이션, 문서 관리 시스템 및 교육용 소프트웨어 개발에 이상적입니다. 핵심 IronPDF 라이브러리와 동일한 렌더링 엔진을 사용하여 정확한 문서 표시와 비즈니스 핵심 애플리케이션에 적합한 전문가 수준의 PDF 보기 기능을 제공합니다.

조르디 바르디아
소프트웨어 엔지니어
조르디는 Iron Software에서 일하지 않을 때는 파이썬, C#, C++에 가장 능숙하며 게임 프로그래밍을 합니다. 제품 테스트, 제품 개발 및 연구를 담당하며 지속적인 제품 개선에 크게 기여하고 있습니다. 다양한 경험은 그에게 끊임없는 도전과 흥미를 제공하며, Iron Software에서 일하는 가장 큰 장점 중 하나라고 합니다. 조르디는 플로리다주 마이애미에서 자랐으며 플로리다 대학교에서 컴퓨터 과학과 통계학을 전공했습니다.
시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다