Get started integrating Apryse UWP SDK

Welcome to Apryse. This guide will help you integrate a free trial of the Apryse UWP SDK into your Visual Studio projects for UWP applications. You can either integrate Apryse packages automatically using NuGet Package Manager, or install them manually by downloading the SDK. Pick whichever option you prefer, but integrating with NuGet is the recommended approach. Your free trial includes unlimited trial usage and support from solution engineers.

Integrate with NuGet

Integrate UWP PDF library with NuGet

Prerequisites

• Visual Studio 2017 or higher.Make sure the Universal Windows Platform development workload is part of your installation.

No trial license key required.

The trial of Apryse Mobile SDK does not require a trial key. A commercial license key is required for use in a production environment. Please contact sales to purchase a commercial key or if you need any other license key assistance.

Keep your license keys confidential.

License keys are uniquely generated. Please make sure that it is not publicly available (e.g. in your public GitHub).

Setup

1. Open a new instance of Visual Studio and create a new Project (File -> New -> Project...). In the new project dialog, select the language of your choice for UWP development. Call the application myapp-uwp.

Integrate Apryse into your UWP Application

1. Find your project in the Solution Explorer. Right Click on the project and click on Manage NuGet Packages.... In the package manager, select the Browse tab and search for PDFTron.UWP. Install this package.You can also find the package on nuget.org.

1. Open MainPage.xaml. Replace the contents of the <Grid></Grid> tag with:

<Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <Grid.RowDefinitions>
        <RowDefinition Height="*"/>
        <RowDefinition Height="Auto"/>
    </Grid.RowDefinitions>

    <Border x:Name="PDFViewBorder" Grid.Row="0"/>

    <StackPanel Grid.Row="1" Orientation="Horizontal" HorizontalAlignment="Right" Margin="5">
        <Button x:Name="OpenButton">Open</Button>
    </StackPanel>
</Grid>

Next step

View a document

Troubleshooting

Why can't I use "Any CPU" configuration for UWP? Projects that contain native code cannot use the "Any CPU" configuration

Integrate Manually

Manually integrating UWP PDF library

Prerequisites

• Visual Studio.Make sure the Universal Windows Platform development workload is part of your installation.
• Apryse's PDF library for UWP:

Download the SDK

Download%24s3%5Ej/PDFNetUWPApps_10.6.0.zip)

No trial license key required.

The trial of Apryse Mobile SDK does not require a trial key. A commercial license key is required for use in a production environment. Please contact sales to purchase a commercial key or if you need any other license key assistance.

Keep your license keys confidential.

License keys are uniquely generated. Please make sure that it is not publicly available (e.g. in your public GitHub).

Setup

1. Extract the folder from the .zip file. This article uses PDFNET_BASE as the path into the PDFNetUWPApps folder that you extracted.

PDFNET_BASE = path/to/extraction/folder/PDFNetUWPApps/

1. Navigate to PDFNET_BASE/Lib/ and execute the PDFNetUWPApps.vsix file by double clicking it. When the dialog prompts, click on Install. The Global Location installation is required.Wait for the installation to finish and close the dialog.

1. Open a new instance of Visual Studio and create a new Project (File -> New -> Project...). In the new project dialog, select the language of your choice for UWP development. Call the application myapp-uwp.

Integrate Apryse into your UWP Application

1. Find your project in the Solution Explorer. Right Click on the project and in the menu click on Properties. In the Configuration manager, select the Build tab. Make sure that the Build target is not Any CPU.
2. Find the References item in the solution explorer. Right click on it and select Add Reference.... In the left pane of the dialog, select Universal Windows. Then select Extensions and in the list that appears, check the box next to PDFNet SDK for UWP.This will allow you to use Apryse related namespaces. If you cannot find this option, see FAQ

1. Open MainPage.xaml. Replace the contents of the <Grid></Grid> tag with:

<Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <Grid.RowDefinitions>
        <RowDefinition Height="*"/>
        <RowDefinition Height="Auto"/>
    </Grid.RowDefinitions>

    <Border x:Name="PDFViewBorder" Grid.Row="0"/>

    <StackPanel Grid.Row="1" Orientation="Horizontal" HorizontalAlignment="Right" Margin="5">
        <Button x:Name="OpenButton">Open</Button>
    </StackPanel>
</Grid>

Next step

View a document

Troubleshooting

Why can't I use "Any CPU" configuration for UWP? Projects that contain native code cannot use the "Any CPU" configuration

Why can't I see the SDK in the Reference Manager? You may have to re-install SDK if it cannot be found