> For the complete documentation index, see [llms.txt](https://docs.apryse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apryse.com/xamarin/samples/run-samples.md).

# Run samples

Explore Xamarin.Android, Xamarin.iOS, and Xamarin.Forms samples from Apryse's library. Download SDK for Xamarin.Android with three sample projects showcasing various features. Run projects in Visual S

There are several samples available for Xamarin.Android, Xamarin.iOS and Xamarin.Forms which will allow you to test and experience the many features included in Apryse's library.

{% tabs %}
{% tab title="Android" %}

## Xamarin.Android samples

Download the SDK

[Download](https://pdftron.s3.amazonaws.com/downloads/PDFNetXamarin.Android.zip)

Apryse for Xamarin.Android ships with three sample projects each containing examples that you could use in your project. All samples are included in the download package under `\samples` folder. You can run any of the sample projects using Visual Studio.

* Open `\projectSrc\PDFNetAndroidXamarin\PDFNetAndroidXamarin.sln` or the `.csproj` file for project of interest in latest version of Visual Studio.
* Select the project of interest as the startup project.
* Clean and build the project.
* Choose a deploy target, either a device or an emulator, then deploy to device.

### CompleteReader project

This sample shows how to use `DocumentActivity`, a document viewing and editing activity. In addition to PDF files, it also supports viewing of other file extensions such as `.docx`, `.doc`, `.pptx`, `.xlsx`, `.md`, `.cbz` and various image formats. It allows stream conversion of these non-pdf documents to PDF format so you can view the document while conversion happens. In this activity, you can read, annotate, sign, fill in PDF forms and more.

### PDFNetAndroidXamarinSample project

This sample shows how to use `PDFViewCtrl` to make a universal viewer that supports PDF files as well as other file extensions such as `.docx`, `.doc`, `.pptx`, `.xlsx`, `.md`, `.cbz` and various image formats. It supports annotating on PDF files. It also has code snippets such as showing how to add a custom view on a PDF page, how to find text, how to hide tools from QuickMenu and AnnotationToolbarComponent, how to show reflow mode, night mode etc.

### AndroidMiscellaneousSamples project

This app shows the functionalities of the Apryse SDK and includes the samples found in the [sample code](/xamarin/get-started/samples.md) page. Inspect its source code to learn how to use some of the main classes and features of the SDK, or just run the sample and check the results.

{% hint style="info" %}
**This project shares all of its source code with iOSMiscellaneousSamples project.**
{% endhint %}
{% endtab %}

{% tab title="iOS" %}

## Xamarin.iOS samples

Download the SDK

[Download](https://pdftron.s3.amazonaws.com/downloads/PDFNetXamarin.iOS.zip)

Apryse for Xamarin.iOS ships with two sample projects each containing examples that you could use in your project. All samples are included in the download package under `\samples` folder. You can run any of the sample projects via Visual Studio.

* Open `\projectSrc\PDFNetiOSXamarin\PDFNetiOSXamarin.sln` or the `.csproj` file for project of interest in latest version of Visual Studio.
* Select the project of interest as the startup project.
* Clean and build the project.
* Choose a deploy target, either a device or an simulator, then deploy to device.

### PDFNetiOSXamarinSample project

This sample shows how to use `PDFViewCtrl` to make a PDF viewer and annotator. It also has code snippets such as showing how to use AnnotationToolbar, bookmark controls etc.

### iOSMiscellaneousSamples project

This app shows the functionalities of the Apryse SDK and includes the samples found in the [sample code](/xamarin/get-started/samples.md) page. Inspect its source code to learn how to use some of the main classes and features of the SDK, or just run the sample and check the results.

{% hint style="info" %}
**This project shares all of its source code with AndroidMiscellaneousSamples project.**
{% endhint %}
{% endtab %}

{% tab title="Forms" %}

## Xamarin.Forms sample

[This sample](https://developer.xamarin.com/guides/xamarin-forms/application-fundamentals/custom-renderer/contentpage/) shows how to use Apryse for Xamarin in Xamarin.Forms project via `PageRenderer`. You can run this sample on Android, iOS and UWP. It shows a simple `PDFViewCtrl` with annotation functionality. Read more in the [detailed tutorial](/xamarin/guides/xamarin-forms.md).
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.apryse.com/xamarin/samples/run-samples.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
