Merge branch 'main' of github.com:ionic-team/capacitor-docs

# Conflicts:
#	docs/main/getting-started/environment-setup.md
#	docs/main/getting-started/faqs.md

Author: rdlabo

docs/apis/geolocation.md

@@ -24,6 +24,14 @@ Apple requires privacy descriptions to be specified in `Info.plist` for location
 - `NSLocationAlwaysAndWhenInUseUsageDescription` (`Privacy - Location Always and When In Use Usage Description`)
 - `NSLocationWhenInUseUsageDescription` (`Privacy - Location When In Use Usage Description`)
 
+> [!NOTE]
+> This Capacitor plugin does not support background geolocation directly. However, it relies on
+> [`ion-ios-geolocation`](https://github.com/ionic-team/ion-ios-geolocation), which can report
+> location in the background. As a result, Apple requires you to include a
+> `NSLocationAlwaysAndWhenInUseUsageDescription` entry in your `Info.plist`. Since this permission
+> prompt won’t appear to users, you can safely use the same description string as for
+> `NSLocationWhenInUseUsageDescription`.
+
 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

docs/apis/inappbrowser.md

@@ -216,9 +216,10 @@ Removes all listeners for the browser events.
 
 Defines the options for opening a URL in the web view.
 
-| Prop          | Type                                                      | Description                                                          |
-| ------------- | --------------------------------------------------------- | -------------------------------------------------------------------- |
-| **`options`** | <code><a href="#webviewoptions">WebViewOptions</a></code> | A structure containing some configurations to apply to the Web View. |
+| Prop                | Type                                                      | Description                                                          |
+| ------------------- | --------------------------------------------------------- | -------------------------------------------------------------------- |
+| **`options`**       | <code><a href="#webviewoptions">WebViewOptions</a></code> | A structure containing some configurations to apply to the Web View. |
+| **`customHeaders`** | <code>{ [key: string]: string; }</code>                   | A map of custom headers to be sent with the request.                 |
 
 
 #### WebViewOptions

docs/main/android/setting-target-sdk.md

@@ -8,7 +8,7 @@ slug: /android/setting-target-sdk
 All Android applications must specify a target SDK version, or the version of Android that the application is designed to run on. Each year, Google releases updates to the Android operating system and subsequently bumps the version number that applications are required to target. Typically, [this date is August 31st](https://support.google.com/googleplay/android-developer/answer/11926878?hl=en) of each year. Because of this, it is important to keep your application up to date with the latest version of Android. In a Capacitor application, this is done by specifying your target SDK in the `/android/variables.gradle` file.
 
 ```groovy
-targetSdkVersion = 34
+targetSdkVersion = 35
 ```
 
 ## Capacitor Android Requirements
@@ -21,6 +21,7 @@ The following table shows the target SDK versions that are supported by Capacito
 
 | Capacitor Android | Target SDK Version |
 | ----------------- | ------------------ |
+| 7.x               | 35                 |
 | 6.x               | 34                 |
 | 5.x               | 33                 |
 | 4.x               | 32                 |
@@ -30,4 +31,4 @@ The following table shows the target SDK versions that are supported by Capacito
 
 ## Custom Target SDK Versions
 
-Capacitor Android does not support custom target SDK versions. Each version of Capacitor Android requires a specific target SDK version and support is only provided for that matching version.
+Capacitor Android does not support custom target SDK versions. Each version of Capacitor Android requires a specific target SDK version and support is only provided for that matching version.

docs/main/getting-started/environment-setup.md

@@ -8,10 +8,6 @@ slug: /getting-started/environment-setup
 
 Capacitorは3つのアプリケーションターゲットを公式にサポートしています。Android、iOS、そしてWebです。3つのプラットフォームすべてに対応したアプリケーションを作成するためには、以下の依存関係をすべてインストールする必要があります。ネイティブモバイルターゲットのいずれかをターゲットにしていない場合は、関連するセクションをスキップすることができます。
 
-:::info
-デスクトップのサポートが必要ですか？Capacitorを使用して[Windows](https://ionic.io/docs/windows/usage)または[Electron](https://github.com/capacitor-community/electron)アプリをビルドすることも可能です!
-:::
-
 ## 要件
 
 Capacitorでアプリケーションを開発するには、NodeJS 20以上がインストールされている必要があります。Nodeをインストールするには、[Nodeのウェブサイト](https://nodejs.org)のインストーラを使用するか、JavaScriptツールマネージャの [Volta](https://volta.sh/) を使用するか、[homebrew](https://brew.sh/)や[Chocolatey](https://chocolatey.org/)のようなパッケージマネージャを使用します。
@@ -95,18 +91,7 @@ CocoaPodsはRuby Gemで直接インストールすることができます。イ
 sudo gem install cocoapods
 ```
 
-しかし、この方法でCocoaPodsをインストールすると、Apple Silicon Macでは**うまくいきません**。Rosettaを有効にしてCocoaPodsを実行する必要があります。これを行うには、以下のコマンドを実行します。
-
-```bash
-sudo arch -x86_64 gem install ffi
-```
-
-それから、新しいバージョンのWebコードを使用するためにアプリケーションを更新したいときはいつでも、次のコマンドを実行する必要があります。
-
-```bash
-npx cap copy
-arch -x86_64 pod install
-```
+For running without sudo see [CocoaPods sudo-less installation docs](https://guides.cocoapods.org/using/getting-started.html#sudo-less-installation)
 
 ## Androidの要件
 

docs/main/getting-started/faqs.md

@@ -16,8 +16,8 @@ Capacitorは公式プラットフォームとコミュニティプラットフ
 ### 公式プラットフォーム
 
 Capacitorは以下のプラットフォームを公式にサポートしています。
-- iOS 13+
-- Android 5.1+
+- iOS 14+
+- Android 6+
   - Requires Chrome WebView 60+
 - Modern Web Browsers
   - Chrome
@@ -30,9 +30,6 @@ Capacitorは以下のプラットフォームを公式にサポートしてい
 Capacitorは、クロスプラットフォームのデスクトップフレームワークをターゲットにしたコミュニティプラットフォームも用意しています。現在、コミュニティで対象としているのは以下の通りです。
 - Electron
   - https://github.com/capacitor-community/electron
-- Tauri (alpha)
-  - https://github.com/capacitor-community/tauri
-
 
 ## CapacitorでIonic Frameworkを使う必要があるのでしょうか？
 
@@ -66,25 +63,5 @@ CapacitorがCordovaプラグインをサポートしていることをご存知
 
 ## Androidエミュレータで実行すると、なぜ空白の画面が表示されるのですか？
 
-CapacitorはAndroid 5.1およびWebViewのバージョン60以上を必要とします。例えばAndroid 6や7のエミュレータを作成した場合、最新バージョンのWebViewがインストールされないため、真っ白な画面が表示されます。これを回避するには、アプリケーションのテスト用に、より新しいAndroidエミュレータをインストールすることができます。
-
-## なぜApple Silicon DeviceでCocoaPodsのエラーが発生するのでしょうか？
-
-If you installed CocoaPods with `sudo gem install cocoapods` and you're using an Apple Silicon-powered Mac, you might encounter something like this when running `npx cap update`:
-
-```
-[error] Analyzing dependencies
-        /Library/Ruby/Gems/2.6.0/gems/ffi-1.15.3/lib/ffi/library.rb:275: [BUG] Bus Error at 0x0000000000000000
-        ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.arm64e-darwin20]
-```
-
-This is a CocoaPods bug related to `ffi` not installing on Apple Silicon computers.
-We recommend using [Homebrew to install CocoaPods](/main/getting-started/environment-setup.md#homebrew).
-Alternatively, if you have Rosetta installed, you can install `ffi` on a `x86_64` architecture and run `pod install` using the simulated Intel architecture for the first time.
-
-```
-$ sudo arch -x86_64 gem install ffi
-$ arch -x86_64 pod install
-```
+Capacitor requires Android 6 as well as a WebView version of 60 or higher. If you create an Android 6 or 7 emulator for example, the newest version of the WebView won't be installed, and you'll get a blank white screen. To get around this, you can install a newer Android emulator for testing your application.
 
-After that, running Capacitor should work as expected.

docs/main/ios/spm.md

@@ -124,27 +124,29 @@ At this point you're done and can build and work as normal.
 
 If your plugin only contains Swift aside from the required `[Name]Plugin.m` and `[Name]Plugin.h` you can use the [capacitor-plugin-converter](https://github.com/ionic-team/capacitor-plugin-converter).
 
-This tool will add the following required things to your main swift plugin file, `[Name]Plugin.swift`:
-
-- Add Conformance to the `CAPBridgedPlugin` protocol to your class
-- Add 3 variables to your class. `identifier`, `jsName`, and `pluginMethods`
-  - `identifer` will correspond to the first argument to the `CAP_PLUGIN` macro
-  - `jsName` will correspond to the second argument to the `CAP_PLUGIN` macro
-  - `pluginMethods` will be an array of the methods passed to the `CAP_PLUGIN` macro
+This tool will do the following changes:
+
+- Add the following required things to your main swift plugin file, `[Name]Plugin.swift`:
+  - Add Conformance to the `CAPBridgedPlugin` protocol to your class.
+  - Add 3 variables to your class. `identifier`, `jsName`, and `pluginMethods`:
+    - `identifer` will correspond to the first argument to the `CAP_PLUGIN` macro.
+    - `jsName` will correspond to the second argument to the `CAP_PLUGIN` macro.
+    - `pluginMethods` will be an array of the methods passed to the `CAP_PLUGIN` macro.
+- A `Package.swift` file will be created at the root of your plugin folder.
 - The following files will be removed as they are no longer needed:
   - `Plugin.xcodeproj`
   - `Plugin.xcworkspace`
   - `Plugin/Info.plist`
   - `PluginTests/Info.plist`
   - `Podfile`
-- To fit SPM best practices, the Project files will be moved to `Sources` and `Tests` directories
-- The plugins `package.json` will get the following fixes:
+- To fit SPM best practices, the Project files will be moved to `Sources` and `Tests` directories.
+- The plugins `package.json` will get the following changes:
   - The files array will add these files or directories:
     - `ios/Sources`
     - `ios/Tests`
     - `Package.swift`
   - `verify:ios` will be changed to `xcodebuild -scheme YourPluginName -destination generic/platform=iOS` to allow it to continue to work as you expect.
-- Your plugin podspec will be changed so that `s.source_files` now points to the `Sources` directory rather than the `Plugin` directory
+- Your plugin podspec will be changed so that `s.source_files` now points to the `Sources` directory rather than the `Plugin` directory.
 
 
 See the documentation in the repository at [capacitor-plugin-converter](https://github.com/ionic-team/capacitor-plugin-converter) for more.

docs/main/ios/troubleshooting.md

@@ -67,27 +67,6 @@ Xcode は時々、永遠にインデックス作成に行き詰まることが
 
 唯一の解決策は、アクティビティモニタを使って Xcode を強制終了し、再度起動させることです。
 
-## Apple Silicon: `ffi` Bus Error
-
-If you installed CocoaPods with `sudo gem install cocoapods` and you're using an Apple Silicon-powered Mac, you might encounter something like this when running `npx cap update`:
-
-```
-[error] Analyzing dependencies
-        /Library/Ruby/Gems/2.6.0/gems/ffi-1.15.3/lib/ffi/library.rb:275: [BUG] Bus Error at 0x0000000000000000
-        ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.arm64e-darwin20]
-```
-
-This is a CocoaPods bug related to `ffi` not installing on Apple Silicon computers.
-We recommend using [Homebrew to install CocoaPods](/main/getting-started/environment-setup.md#homebrew).
-Alternatively, if you have Rosetta installed, you can install `ffi` on a `x86_64` architecture and run `pod install` using the simulated Intel architecture for the first time.
-
-```
-$ sudo arch -x86_64 gem install ffi
-$ arch -x86_64 pod install
-```
-
-After that, running Capacitor should work as expected.
-
 ## CocoaPods: Failed to connect to GitHub
 
 このエラーは、古いバージョンの openssl と ruby がインストールされた Mac で発生する可能性があります。

versioned_docs/version-v4/main/getting-started/environment-setup.md

@@ -8,10 +8,6 @@ slug: /getting-started/environment-setup
 
 Capacitor has three officially supported application targets: Android, iOS, and Web. In order to create applications for all three platforms, you'll need to install all of the following dependencies. If you are not targeting one of the native mobile targets, you can skip the associated section.
 
-:::info
-Do you need to support Desktops? You can use Capacitor to build [Windows](https://ionic.io/docs/windows/usage) or [Electron](https://github.com/capacitor-community/electron) apps as well!
-:::
-
 ## Core Requirements
 
 In order to develop any application with Capacitor, you will need NodeJS 12 or higher installed. You can install Node by using the installer on [the Node website](https://nodejs.org), using [Volta](https://volta.sh/): a JavaScript tools manager, or installing it with a package manager like [homebrew](https://brew.sh/), or [Chocolatey](https://chocolatey.org/).

versioned_docs/version-v4/main/getting-started/faqs.md

@@ -30,9 +30,6 @@ Capacitor officially supports the following platforms:
 Capacitor also has community platforms to target cross platform desktop frameworks. The current community targets are the following.
 - Electron
   - https://github.com/capacitor-community/electron
-- Tauri (alpha)
-  - https://github.com/capacitor-community/tauri
-
 
 ## Do I need to use Ionic Framework with Capacitor?
 

versioned_docs/version-v5/main/getting-started/environment-setup.md

@@ -8,10 +8,6 @@ slug: /getting-started/environment-setup
 
 Capacitor has three officially supported application targets: Android, iOS, and Web. In order to create applications for all three platforms, you'll need to install all of the following dependencies. If you are not targeting one of the native mobile targets, you can skip the associated section.
 
-:::info
-Do you need to support Desktops? You can use Capacitor to build [Windows](https://ionic.io/docs/windows/usage) or [Electron](https://github.com/capacitor-community/electron) apps as well!
-:::
-
 ## Core Requirements
 
 In order to develop any application with Capacitor, you will need NodeJS 16 or higher installed. You can install Node by using the installer on [the Node website](https://nodejs.org), using [Volta](https://volta.sh/): a JavaScript tools manager, or installing it with a package manager like [homebrew](https://brew.sh/), or [Chocolatey](https://chocolatey.org/).