Viewing PDFs in MAUI for C# .NET

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

IronPDF 뷰어 배너

크로스 플랫폼 개발이 대세인 현대 시대에 사용자가 앱 내에서 PDF 문서를 직접 볼 수 있도록 하는 것은 단순한 편의를 넘어 필수적인 요소입니다. IronPDF Viewer를 사용하면 MAUI 애플리케이션에 PDF 보기 기능을 내장할 수 있습니다.

이 글에서는 IronPDF Viewer를 MAUI 애플리케이션에 통합하여 사용자가 PDF 파일을 보고, 저장하고, 인쇄할 수 있도록 하는 방법을 알아보겠습니다.

빠른 시작: MAUI에 IronPDF 뷰어 구현

단 몇 줄의 코드로 IronPDF 뷰어를 MAUI 애플리케이션에 통합하는 방법을 알아보세요. 이 간편 가이드는 IronPDF의 강력한 라이브러리를 사용하여 PDF 파일을 손쉽게 불러오는 방법을 보여줍니다. 앱에 원활한 PDF 보기 기능을 추가하여 앱 성능을 향상시키고자 하는 개발자에게 이상적인 이 접근 방식은 사용 편의성과 빠른 구현을 강조합니다. IronPDF 뷰어를 초기화하고 PDF 파일을 불러오기만 하면 앱에서 편리하게 PDF를 볼 수 있습니다.

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

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

    PM > Install-Package IronPdf

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

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

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

Visual Studio - NuGet 패키지 관리자

Visual Studio에서 솔루션 탐색기의 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 Manage NuGet Packages...를 선택합니다. 여기에서 IronPdf.Viewer.Maui 를 검색하고 최신 버전을 솔루션에 설치할 수 있습니다. 또는 Tools > NuGet Package Manager > Package Manager Console로 이동하여 다음 명령을 입력하면 NuGet 패키지 관리자 콘솔을 열 수 있습니다.

Install-Package IronPdf.Viewer.Maui

IronPDF 뷰어를 MAUI 애플리케이션에 통합하기

다음 섹션에서는 IronPDF Viewer를 기본 MAUI 애플리케이션에 통합하는 방법을 보여드리겠습니다.

설정

IronPDF Viewer를 MAUI 프로젝트에 추가하기 전에 iOS 및 Android 플랫폼을 대상으로 하지 않는지 확인하십시오. 프로젝트 파일을 마우스 오른쪽 버튼으로 클릭하고 속성을 선택하면 이를 확인할 수 있습니다. 'iOS 플랫폼 대상 지정' 및 'Android 플랫폼 대상 지정' 확인란이 선택 해제되어 있지 않으면 선택을 해제하십시오. 이 변경 사항을 성공적으로 적용하려면 해당 옵션을 선택 해제한 후 프로젝트를 저장하고 Visual Studio를 다시 시작해야 할 수 있습니다.

속성 화면

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 뷰어는 화면 오른쪽 하단에 배너를 표시합니다. 이 보기를 제거하려면 다음과 같이 ConfigureIronPdfViewer에 IronPDF(또는 Iron Suite) 라이선스 키를 추가하세요.

: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...로 이동하여 프로젝트에 새 페이지를 추가합니다. 새 항목 추가

  2. .NET MAUI 섹션으로 이동합니다. XAML 페이지를 만들려면 .NET MAUI ContentPage (XAML)를 선택하세요. C# 파일의 경우 .NET MAUI ContentPage (C#)를 선택하세요. 파일 이름을 _PdfViewerPage_로 지정한 다음 Add를 클릭하세요. .NET MAUI `ContentPage`

  3. XAML 파일에 다음 코드를 추가하고 저장하세요.
:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-1.xml
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>
XML

만약 C# ContentPage를 생성했다면, 다음 코드를 대신 추가하고 저장하세요.

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

public class MainPage : ContentPage
{
    private readonly IronPdfView pdfView;

    public MainPage()
    {
        InitializeComponent();

        this.pdfView = new IronPdfView { Options = IronPdfViewOptions.All };

        Content = this.pdfView;
    }
}
$vbLabelText   $csharpLabel
  1. AppShell.xaml 파일에 다음 내용을 추가하세요.
:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-2.xml
<?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 뷰어가 열립니다.

IronPDF 뷰어 기본 설정

시작 시 PDF 파일 로드

IronPDF Viewer는 애플리케이션 시작 시 기본적으로 사용자에게 PDF 파일을 열도록 요청합니다. 또한 시작 시 PDF 파일을 자동으로 열도록 설정할 수도 있습니다. 시작 시 PDF 파일을 불러오는 방법에는 파일 이름, 바이트 배열, 스트림의 세 가지가 있습니다.

파일 이름으로 불러오기

PDF 파일을 파일 이름으로 불러오려면 XAML 파일의 IronPdfView 태그에 PDF 파일의 소스를 지정하면 됩니다. 아래는 그 예입니다.

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-3.xml
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView Source="C:/path/to/my/example.pdf" />
</ContentPage>
XML

또는 C# ContentPage에서 IronPdfViewSource.FromFile 메서드를 사용하여 파일 이름으로 PDF를 로드할 수 있습니다.

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-4.cs
// We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf");
$vbLabelText   $csharpLabel

바이트 배열을 통해 로드

일부 사용 사례에서는 PDF의 바이트 배열을 로드하는 것이 바람직할 수 있습니다. XAML에서는 불가능하지만 C#에서는 가능합니다. IronPdfViewSource.FromBytes 메서드를 사용하면 간단하게 이를 달성할 수 있습니다. 이 방법을 사용하는 예시는 아래와 같습니다.

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cs
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));
$vbLabelText   $csharpLabel

스트림을 통해 로드

마찬가지로, 일부 사용 사례에서는 PDF를 스트림 방식으로 로드하는 것이 더 바람직할 수 있습니다. XAML에서는 불가능하지만 C#에서는 가능합니다. IronPdfViewSource.FromStream 메서드를 사용하면 간단하게 이를 달성할 수 있습니다. 이 방법을 사용하는 예시는 아래와 같습니다.

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cs
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));
$vbLabelText   $csharpLabel

툴바 구성하기

IronPDF Viewer를 사용하면 도구 모음에 표시할 옵션을 선택할 수 있습니다. 사용 가능한 옵션은 다음과 같습니다.

  • 썸네일 보기
  • 파일 이름 표시
  • 텍스트 검색
  • 페이지 번호 탐색
  • 너비에 맞게 조정
  • 키에 맞게 조절 가능
  • 시계 방향으로 회전
  • 시계 반대 방향으로 회전
  • 파일 열기
  • 파일 다운로드
  • 파일 인쇄
  • 주석 표시
  • 두 페이지 보기

기본적으로 IronPDF Viewer는 아래와 같은 도구 모음을 표시합니다.

기본 툴바

기본 보기에서는 파일 이름 표시, 텍스트 검색 및 시계 반대 방향 회전 옵션이 모두 비활성화되어 있습니다. 모든 내용을 표시하려면 XAML에서 IronPdfView 태그의 Option 매개변수를 All로 설정하십시오.

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-4.xml
<?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="All"/>
</ContentPage>
XML

또는 C#을 사용하여 동일한 결과를 얻을 수도 있습니다.

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
$vbLabelText   $csharpLabel

그러면 다음과 같은 내용이 표시됩니다.

모든 툴바

아무것도 표시하고 싶지 않다면 옵션을 None로 설정하세요. Options가 다음과 같이 설정되어 있으면 툴바가 나타나지 않습니다.

툴바 없음

표시할 특정 옵션을 선택할 수 있습니다. 예를 들어, 썸네일 이미지와 파일 열기 옵션만 표시하려면 XAML에서 IronPdfViewOptions 매개변수를 다음과 같이 수정하세요.

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-5.xml
<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 Viewer를 MAUI 애플리케이션에 통합하는 방법과 필요에 맞게 툴바를 사용자 지정하는 방법을 배웠습니다.

이 뷰어는 IronPDF 제품에 포함되어 있습니다. 기능 추가를 요청하시거나 IronPDF Viewer(또는 IronPDF)에 대한 일반적인 질문이 있으시면 지원팀에 문의해 주세요. 기꺼이 도와드리겠습니다.

자주 묻는 질문

C#을 사용하여 MAUI 애플리케이션에서 PDF 파일을 보려면 어떻게 해야 하나요?

C#을 사용하는 MAUI 애플리케이션에서 PDF를 보려면 IronPDF Viewer 라이브러리를 통합할 수 있습니다. 이를 위해서는 Visual Studio의 NuGet을 통해 라이브러리를 설치하고 프로젝트 내에서 PDF 보기 기능을 활성화하도록 구성해야 합니다.

MAUI 앱에 PDF 뷰어를 통합하는 과정은 무엇인가요?

MAUI 앱에 PDF 뷰어를 통합하려면 NuGet 패키지 관리자를 사용하여 IronPDF Viewer 라이브러리를 설치하고 `MauiProgram.cs` 및 XAML 또는 C# ContentPage를 사용하여 PDF를 표시하도록 프로젝트에 뷰어를 설정해야 합니다.

IronPDF 뷰어를 MAUI 프로젝트에서 iOS 및 Android 플랫폼에서 사용할 수 있습니까?

현재 IronPDF 뷰어는 iOS 및 Android 플랫폼을 대상으로 하지 않는 MAUI 프로젝트용으로 설계되었습니다. 데스크톱 환경을 대상으로 하는 프로젝트에서 사용하는 것이 가장 좋습니다.

MAUI 프로젝트에서 애플리케이션 시작 시 PDF 파일을 불러오려면 어떻게 해야 하나요?

MAUI 애플리케이션 내에서 IronPDF Viewer의 메서드(예: `IronPdfViewSource.FromFile` , `FromBytes` 또는 `FromStream` 를 사용하면 시작 시 PDF 파일을 로드할 수 있습니다.

IronPDF Viewer의 툴바 구성 옵션은 무엇인가요?

IronPDF 뷰어 도구 모음은 썸네일 보기, 텍스트 검색, 페이지 탐색, 확대/축소, 회전 및 파일 작업과 같은 옵션을 포함하도록 사용자 지정할 수 있습니다. 필요에 따라 모든 옵션, 아무것도 표시하지 않거나 특정 도구만 표시하도록 설정할 수 있습니다.

PDF 뷰어 도구 모음에 특정 도구만 표시되도록 사용자 지정하려면 어떻게 해야 하나요?

툴바에 특정 도구만 표시하도록 사용자 지정하려면 XAML 또는 C# 코드에서 'Options' 매개변수를 조정하여 'ThumbnailView,OpenFile'과 같이 원하는 옵션만 포함시키세요.

IronPDF 뷰어에서 툴바를 숨길 수 있나요?

네, '옵션' 매개변수를 '없음'으로 설정하면 도구 모음을 숨길 수 있으며, 이렇게 하면 뷰어 인터페이스에서 도구 모음이 제거됩니다.

MAUI 애플리케이션에서 PDF 렌더링 문제를 어떻게 해결할 수 있을까요?

MAUI 애플리케이션에서 PDF 렌더링에 문제가 발생하는 경우 IronPDF 라이브러리가 올바르게 설치 및 구성되었는지 확인하십시오. 또한 플랫폼별 제한 사항이 있는지 확인하거나 IronPDF 기술 지원팀에 문의하십시오.

MAUI 애플리케이션에 IronPDF Viewer를 통합하는 데 필요한 지원은 어디에서 찾을 수 있나요?

MAUI 애플리케이션에 IronPDF 뷰어를 통합하는 것과 관련된 지원이나 기능 요청 사항이 있는 경우 IronPDF 공식 웹사이트를 통해 IronPDF 지원팀에 문의할 수 있습니다.

IronPDF Viewer는 .NET 10 프로젝트와 완벽하게 호환됩니까?

예. IronPDF는 MAUI 앱용 뷰어 구성 요소를 포함하여 모든 주요 제품 라인에서 .NET 10을 지원합니다. IronPDF 뷰어 패키지는 net10.0-windows 및 net10.0-maccatalyst와 같은 대상 프레임워크와 호환되므로 개발자는 별도의 해결 방법 없이 .NET 10 데스크톱 기반 프로젝트에 PDF 보기 기능을 포함할 수 있습니다.

커티스 차우
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다