Merge branch 'main' into fix_typos

Author: riderx

docs/apis/action-sheet.md

@@ -21,7 +21,7 @@ npx cap sync
 
 This plugin will use the following project variables (defined in your app's `variables.gradle` file):
 
-- `androidxMaterialVersion`: version of `com.google.android.material:material` (default: `1.12.0`)
+- `androidxMaterialVersion`: version of `com.google.android.material:material` (default: `1.13.0`)
 
 ## PWA Notes
 

docs/apis/background-runner.md

@@ -31,6 +31,18 @@ If you will be making use of Geolocation or Push Notifications, enable `Location
 
 ![Configure Background Modes in Xcode](https://github.com/ionic-team/capacitor-background-runner/raw/main/docs/configure_background_modes.png)
 
+You will also need to add the following entry into your `Info.plist` file:
+```
+<key>BGTaskSchedulerPermittedIdentifiers</key>
+<array>
+  <string>com.example.background.task</string>
+</array>
+```
+
+Read about [Configuring `Info.plist`](https://capacitorjs.com/docs/ios/configuration#configuring-infoplist) in the [iOS Guide](https://capacitorjs.com/docs/ios) for more information on setting iOS permissions in Xcode.
+
+Make sure you use the same id that you use for `BGTaskSchedulerPermittedIdentifiers` (for example "com.example.background.task") in the `label` field in the plugin configuration.
+
 After enabling the Background Modes capability, add the following to your app's `AppDelegate.swift`:
 
 At the top of the file, under `import Capacitor` add:
@@ -73,8 +85,6 @@ Apple requires privacy descriptions to be specified in `Info.plist` for location
 - `NSLocationAlwaysUsageDescription` (`Privacy - Location Always Usage Description`)
 - `NSLocationWhenInUseUsageDescription` (`Privacy - Location When In Use Usage Description`)
 
-Read about [Configuring `Info.plist`](https://capacitorjs.com/docs/ios/configuration#configuring-infoplist) in the [iOS Guide](https://capacitorjs.com/docs/ios) for more information on setting iOS permissions in Xcode
-
 ## Android
 
 Insert the following line to `android/app/build.gradle`:

docs/apis/barcode-scanner.md

@@ -53,6 +53,12 @@ Note: iOS supports all formats except `MAXICODE` and `UPC_EAN_EXTENSION` - using
 Interface defining the contract for a plugin capable of scanning barcodes.
 Requires implementation of the scanBarcode method, which initiates a barcode scan with given options.
 
+Starting in Android targetSdk 36, the scanOrientation parameter has no effect for large screens (e.g. tablets) on Android 16 and higher.
+You may opt-out of this behavior in your app by adding `<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />` to your `AndroidManifest.xml` inside `<application>` or `<activity>`.
+Keep in mind though that this opt-out is temporary and will no longer work for Android 17. Android discourages setting specific orientations for large screens.
+Regular Android phones are unaffected by this change.
+For more information check the Android docs at https://developer.android.com/about/versions/16/behavior-changes-16#adaptive-layouts
+
 ### scanBarcode(...)
 
 ```typescript
@@ -149,7 +155,7 @@ Defines the options for configuring a barcode scan.
 
 | Members     | Value                |
 | ----------- | -------------------- |
-| **`ZXING`** | <code>'zxing'</code> |
-| **`MLKIT`** | <code>'mlkit'</code> |
+| **`ZXING`** | <code>"zxing"</code> |
+| **`MLKIT`** | <code>"mlkit"</code> |
 
 </docgen-api>

docs/apis/browser.md

@@ -25,7 +25,7 @@ npx cap sync
 
 This plugin will use the following project variables (defined in your app's `variables.gradle` file):
 
-- `androidxBrowserVersion`: version of `androidx.browser:browser` (default: `1.8.0`)
+- `androidxBrowserVersion`: version of `androidx.browser:browser` (default: `1.9.0`)
 
 ## Example
 

docs/apis/camera.md

@@ -76,8 +76,8 @@ Additionally, because the Camera API launches a separate Activity to handle taki
 
 This plugin will use the following project variables (defined in your app's `variables.gradle` file):
 
-- `androidxExifInterfaceVersion`: version of `androidx.exifinterface:exifinterface` (default: `1.3.7`)
-- `androidxMaterialVersion`: version of `com.google.android.material:material` (default: `1.12.0`)
+- `androidxExifInterfaceVersion`: version of `androidx.exifinterface:exifinterface` (default: `1.4.1`)
+- `androidxMaterialVersion`: version of `com.google.android.material:material` (default: `1.13.0`)
 
 ## PWA Notes
 
@@ -151,7 +151,7 @@ with the camera.
 pickImages(options: GalleryImageOptions) => Promise<GalleryPhotos>
 ```
 
-Allows the user to pick multiplef pictures from the photo gallery.
+Allows the user to pick multiple pictures from the photo gallery.
 
 | Param         | Type                                                                |
 | ------------- | ------------------------------------------------------------------- |

docs/apis/file-transfer.md

@@ -1,8 +1,8 @@
 ---
 title: File Transfer Capacitor Plugin API
 description: The FileTransfer API provides mechanisms for downloading and uploading files.
-custom_edit_url: https://github.com/ionic-team/capacitor-file-transfer/blob/next/packages/capacitor-plugin/README.md
-editApiUrl: https://github.com/ionic-team/capacitor-file-transfer/blob/next/packages/capacitor-plugin/src/definitions.ts
+custom_edit_url: https://github.com/ionic-team/capacitor-file-transfer/blob/main/packages/capacitor-plugin/README.md
+editApiUrl: https://github.com/ionic-team/capacitor-file-transfer/blob/main/packages/capacitor-plugin/src/definitions.ts
 sidebar_label: File Transfer
 ---
 
@@ -62,7 +62,7 @@ const fileInfo = await Filesystem.getUri({
 
 try {
     // Then use the FileTransfer plugin to upload
-    const result = await FileTransfer.downloadFile({
+    const result = await FileTransfer.uploadFile({
         url: 'https://example.com/upload_api',
         path: fileInfo.uri,
         chunkedMode: true,

docs/apis/file-viewer.md

@@ -1,8 +1,8 @@
 ---
 title: File Viewer Capacitor Plugin API
 description: The FileViewer API provides mechanisms for opening files and previewing media. Not available on web.
-custom_edit_url: https://github.com/ionic-team/capacitor-file-viewer/blob/next/packages/capacitor-plugin/README.md
-editApiUrl: https://github.com/ionic-team/capacitor-file-viewer/blob/next/packages/capacitor-plugin/src/definitions.ts
+custom_edit_url: https://github.com/ionic-team/capacitor-file-viewer/blob/main/packages/capacitor-plugin/README.md
+editApiUrl: https://github.com/ionic-team/capacitor-file-viewer/blob/main/packages/capacitor-plugin/src/definitions.ts
 sidebar_label: File Viewer
 ---
 

docs/apis/filesystem.md

@@ -1,8 +1,8 @@
 ---
 title: Filesystem Capacitor Plugin API
 description: The Filesystem API provides a NodeJS-like API for working with files on the device.
-custom_edit_url: https://github.com/ionic-team/capacitor-filesystem/blob/next/packages/capacitor-plugin/README.md
-editApiUrl: https://github.com/ionic-team/capacitor-filesystem/blob/next/packages/capacitor-plugin/src/definitions.ts
+custom_edit_url: https://github.com/ionic-team/capacitor-filesystem/blob/main/packages/capacitor-plugin/README.md
+editApiUrl: https://github.com/ionic-team/capacitor-filesystem/blob/main/packages/capacitor-plugin/src/definitions.ts
 sidebar_label: Filesystem
 ---
 
@@ -549,11 +549,13 @@ We recommend using the @capacitor/file-transfer plugin instead, in conjunction w
 
 #### ReadFileOptions
 
-| Prop            | Type                                            | Description                                                                                                                                                                 | Since |
-| --------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
-| **`path`**      | <code>string</code>                             | The path of the file to read                                                                                                                                                | 1.0.0 |
-| **`directory`** | <code><a href="#directory">Directory</a></code> | The <a href="#directory">`Directory`</a> to read the file from                                                                                                              | 1.0.0 |
-| **`encoding`**  | <code><a href="#encoding">Encoding</a></code>   | The encoding to read the file in, if not provided, data is read as binary and returned as base64 encoded. Pass <a href="#encoding">Encoding.UTF8</a> to read data as string | 1.0.0 |
+| Prop            | Type                                            | Description                                                                                                                                                                                            | Default         | Since |
+| --------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------- | ----- |
+| **`path`**      | <code>string</code>                             | The path of the file to read                                                                                                                                                                           |                 | 1.0.0 |
+| **`directory`** | <code><a href="#directory">Directory</a></code> | The <a href="#directory">`Directory`</a> to read the file from                                                                                                                                         |                 | 1.0.0 |
+| **`encoding`**  | <code><a href="#encoding">Encoding</a></code>   | The encoding to read the file in, if not provided, data is read as binary and returned as base64 encoded. Pass <a href="#encoding">Encoding.UTF8</a> to read data as string                            |                 | 1.0.0 |
+| **`offset`**    | <code>number</code>                             | The offset to start reading the file from, in bytes. Native only (not available in web). Can be used in conjunction with length to partially read files.                                               | <code>0</code>  | 8.1.0 |
+| **`length`**    | <code>number</code>                             | The length of data to read, in bytes. Any non-positive value means to read to the end of the file. Native only (not available in web). Can be used in conjunction with offset to partially read files. | <code>-1</code> | 8.1.0 |
 
 
 #### ReadFileInChunksOptions