From 4a83ea2ab4f8b2379ae44fb97b15aa0f6d1c2d41 Mon Sep 17 00:00:00 2001 From: OS-pedrogustavobilro Date: Wed, 5 Nov 2025 12:49:21 +0000 Subject: [PATCH 1/3] docs: Homebrew and CocoaPods as optional for Cap 8 --- .../main/getting-started/environment-setup.md | 25 +++++++++++++------ 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/docs/main/getting-started/environment-setup.md b/docs/main/getting-started/environment-setup.md index 16b78a9c9..9c3cecec4 100644 --- a/docs/main/getting-started/environment-setup.md +++ b/docs/main/getting-started/environment-setup.md @@ -25,14 +25,12 @@ With Node installed, you can get started with creating Progressive Web Applicati To build iOS apps, you will need **macOS**. While there are solutions like [Ionic Appflow](http://ionicframework.com/appflow) that can be used to perform iOS cloud builds if you don't have a Mac, it is highly recommended to have the tools available to you locally in order to properly test your Capacitor application. -In order to develop iOS applications using Capacitor, you will need four additional dependencies: +In order to develop iOS applications using Capacitor, you will need two additional dependencies: - Xcode - Xcode Command Line Tools -- Homebrew -- Cocoapods -Once you've installed the core requirements, as well as Xcode, Xcode Command Line Tools, and Cocoapods, you'll be able to create both iOS applications and PWAs. +Once you've installed the core requirements, as well as Xcode, Xcode Command Line Tools, you'll be able to create both iOS applications and PWAs. ### Xcode @@ -53,7 +51,16 @@ xcode-select -p # /Applications/Xcode.app/Contents/Developer ``` -### Homebrew +### Optional dependencies + +The following dependencies are not required if you are creating a new application iOS using Capacitor 8 or later. + +Starting with Capacitor 8, Swift Package Manager (SPM) is the default dependency manager for iOS. If you are on an older version of Capacitor, or you are working with plugins that do not support SPM yet, you'll need these two dependencies as well: + +- Homebrew +- CocoaPods + +#### Homebrew Homebrew is a package manager for macOS packages. You need to install it in order to install CocoaPods for both Intel and Apple Silicon Macs. @@ -69,9 +76,11 @@ Don't just trust us! This is how [brew.sh](https://brew.sh) recommends installin If you do not want to install Homebrew, alternative, but not recommended, instructions can be found below. -### CocoaPods +#### CocoaPods + +CocoaPods was the default iOS dependency manager in Capacitor 7 and earlier. Since Capacitor 8, the default has been replaced with SPM, but you can still use CocoaPods as an alternative if your project needs it. -Cocoapods is an iOS dependency manager that Capacitor uses to install and manage native dependencies for your iOS project. You can install [CocoaPods](https://cocoapods.org/) by running the following command in your terminal +You can install [CocoaPods](https://cocoapods.org/) by running the following command in your terminal ```bash brew install cocoapods @@ -84,7 +93,7 @@ pod --version # 1.12.1 ``` -#### Installing CocoaPods without Homebrew +##### Installing CocoaPods without Homebrew You can install CocoaPods directly with Ruby Gem. To install it, you can run the following command. ``` From 627727bc6e6dceb7a0c51ce73260c21da15bf32e Mon Sep 17 00:00:00 2001 From: OS-pedrogustavobilro Date: Thu, 6 Nov 2025 09:24:55 +0000 Subject: [PATCH 2/3] docs: drop some mentions of Capacitor versions for CocoaPods Following PR comments --- docs/main/getting-started/environment-setup.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/main/getting-started/environment-setup.md b/docs/main/getting-started/environment-setup.md index 9c3cecec4..193b8a374 100644 --- a/docs/main/getting-started/environment-setup.md +++ b/docs/main/getting-started/environment-setup.md @@ -53,13 +53,15 @@ xcode-select -p ### Optional dependencies -The following dependencies are not required if you are creating a new application iOS using Capacitor 8 or later. +The following dependencies are optional for using Capacitor on iOS. -Starting with Capacitor 8, Swift Package Manager (SPM) is the default dependency manager for iOS. If you are on an older version of Capacitor, or you are working with plugins that do not support SPM yet, you'll need these two dependencies as well: +If you need to use CocoaPods as a dependency manager for native iOS packages, then you should install these two package managers: - Homebrew - CocoaPods +We recommend using [Swift Package Manager](https://docs.swift.org/swiftpm/documentation/packagemanagerdocs) (SPM) as the dependency manager for iOS. If you don't have need for CocoaPods, then you can use SPM and do not have to install the two dependencies. + #### Homebrew Homebrew is a package manager for macOS packages. You need to install it in order to install CocoaPods for both Intel and Apple Silicon Macs. From 8a4a3545f4559b1e78f97c9720d5194789575385 Mon Sep 17 00:00:00 2001 From: OS-pedrogustavobilro Date: Thu, 6 Nov 2025 12:10:27 +0000 Subject: [PATCH 3/3] chore: Minor corrections Following PR comments. --- docs/main/getting-started/environment-setup.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/main/getting-started/environment-setup.md b/docs/main/getting-started/environment-setup.md index 193b8a374..211370906 100644 --- a/docs/main/getting-started/environment-setup.md +++ b/docs/main/getting-started/environment-setup.md @@ -60,7 +60,7 @@ If you need to use CocoaPods as a dependency manager for native iOS packages, th - Homebrew - CocoaPods -We recommend using [Swift Package Manager](https://docs.swift.org/swiftpm/documentation/packagemanagerdocs) (SPM) as the dependency manager for iOS. If you don't have need for CocoaPods, then you can use SPM and do not have to install the two dependencies. +We recommend using [Swift Package Manager](https://docs.swift.org/swiftpm/documentation/packagemanagerdocs) (SPM) as the dependency manager for iOS. If you don't need CocoaPods, then you can use SPM and skip the install of those two dependencies. #### Homebrew @@ -80,7 +80,7 @@ If you do not want to install Homebrew, alternative, but not recommended, instru #### CocoaPods -CocoaPods was the default iOS dependency manager in Capacitor 7 and earlier. Since Capacitor 8, the default has been replaced with SPM, but you can still use CocoaPods as an alternative if your project needs it. +CocoaPods was the default iOS dependency manager in Capacitor 7 and earlier. Since Capacitor 8, the default has been replaced with SPM, but you can still use CocoaPods as an alternative if your project needs it, by passing `--packagemanager CocoaPods` to `npx cap add ios` command. You can install [CocoaPods](https://cocoapods.org/) by running the following command in your terminal