npm package: @pct-cclausen/file-opener
Description: Capacitor File Opener. The plugin is able to open a file given the mimeType and the file uri.
Author: Alex Ryltsov
Latest version: 1.0.8

<p align="center"><br><img src="https://user-images.githubusercontent.com/236501/85893648-1c92e880-b7a8-11ea-926d-95355b8175c7.png" width="128" height="128" /></p>
<h3 align="center">File Opener</h3>
<p align="center"><strong><code>@capacitor-community/file-opener</code></strong></p>
<p align="center">
  Capacitor File Opener. The plugin is able to open a file given the mimeType and the file uri.
</p>

<p align="center">
  <img src="https://img.shields.io/maintenance/yes/2022?style=flat-square" />
  <a href="https://www.npmjs.com/package/@capacitor-community/file-opener"><img src="https://img.shields.io/npm/l/@capacitor-community/file-opener?style=flat-square" /></a>
<br>
  <a href="https://www.npmjs.com/package/@capacitor-community/file-opener"><img src="https://img.shields.io/npm/dw/@capacitor-community/file-opener?style=flat-square" /></a>
  <a href="https://www.npmjs.com/package/@capacitor-community/file-opener"><img src="https://img.shields.io/npm/v/@capacitor-community/file-opener?style=flat-square" /></a>
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
<a href="#contributors-"><img src="https://img.shields.io/badge/all%20contributors-1-orange?style=flat-square" /></a>
<!-- ALL-CONTRIBUTORS-BADGE:END -->
</p>

## Table of Contents

- [Maintainers](#maintainers)
- [About](#about)
- [Installation](#installation)
- [API](#api)
- [Troubleshooting](#troubleshooting)

## Maintainers

| Maintainer | GitHub                                | Active |
| ---------- | ------------------------------------- | ------ |
| ryaa       | [ryaa](https://github.com/ryaa)       | yes    |


## About

This plugin is similar to cordova-plugin-file-opener2 but without installation support.
<br>
**NOTE**: The plugin version 1.0.5 is compatible with Capacitor 5 which requires gradle version 8.0
<br>
If you are using Capacitor 4, use [version 1.0.4](https://github.com/capacitor-community/file-opener/releases/tag/v1.0.4)
<br>

## Installation

```bash
npm install @capacitor-community/file-opener
npx cap sync
```

## API

<docgen-index>

* [`open(...)`](#open)
* [Interfaces](#interfaces)

</docgen-index>

<docgen-api>
<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->

### open(...)

```typescript
open(options: FileOpenerOptions) => Promise<void>
```

Method to open a file.

| Param         | Type                                                            |
| ------------- | --------------------------------------------------------------- |
| **`options`** | <code><a href="#fileopeneroptions">FileOpenerOptions</a></code> |

**Since:** 1.0.0

--------------------


### Interfaces


#### FileOpenerOptions

file open method options

| Prop                  | Type                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Since |
| --------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
| **`filePath`**        | <code>string</code>                    | file path                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1.0.0 |
| **`contentType`**     | <code>string</code>                    | MIME type (optional)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1.0.0 |
| **`openWithDefault`** | <code>boolean</code>                   | Use the default platform chooser, if true, otherwise: On Android: it will show "Open File in.." title of the chooser dialog, the system will always present the chooser dialog even if the user has chosen a default one and if no activity is found to handle the file, the system will still present a dialog with the specified title and an error message No application can perform this action On iOS: it will presents a menu restricted to a list of apps capable of opening the current document. This determination is made based on the document type and on the document types supported by the installed apps. To support one or more document types, an app must register those types in its Info.plist file using the CFBundleDocumentTypes key. (optional) default value is true | 1.0.0 |
| **`chooserPosition`** | <code>{ x: number; y: number; }</code> | (iOS only; iPad only) Position to anchor the chooser (ShareSheet) menu in the view (optional) Please note that this is applicable only when the application runs on iPad and when openWithDefault is false, otherwise this is ignored                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1.0.3 |

</docgen-api>

### List of Error Codes and Meanings
When an error is thrown, one of the following codes (as a string value) will be used.

| Code | Description                      |
|-----:|:---------------------------------|
|   '1' | `INTERNAL_ERROR`                |
|   '2' | `INVALID_ARGUMENT`              |
'   '8' | `FILE_NOT_SUPPORTED`            |
|   '9' | `FILE_NOT_FOUND`                |
|  '10' | `UNKNOWN`                       |

### Android

If you app needs to open files in the external directories, then within your `AndroidManifest.xml` file, change the following:

```diff
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example">

+  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

</manifest>
```
### iOS
You'll need to set ios/App/Podfile to version 13 or higher (for more details please [see](https://capacitorjs.com/docs/ios#ios-support))
```
platform :ios '13.0'
```
then `npx cap sync ios`