CocoaPods a annoncé qu'il deviendrait en lecture seule en décembre 2026, après quoi il ne sera plus possible de publier de nouvelles versions de pods. Les sections suivantes fournissent plus d'informations sur ce changement et expliquent comment migrer vos applications vers d'autres gestionnaires d'installation.
Présentation
- Qu'est-ce qui change ? CocoaPods passe en lecture seule, et Firebase cessera de publier de nouvelles versions sur CocoaPods en octobre 2026.
- Mon application va-t-elle cesser de fonctionner ? Non. Les versions existantes des bibliothèques Firebase resteront disponibles indéfiniment dans le registre CocoaPods, et vos applications qui utilisent ces versions de CocoaPod continueront de fonctionner.
- Pourquoi migrer ? Pour continuer à bénéficier des dernières fonctionnalités, des améliorations des performances et des correctifs critiques, vous devez migrer vers Swift Package Manager ou l'installation manuelle.
Pour tenir compte de l'annonce de CocoaPods, Firebase cessera de publier de nouvelles versions sur CocoaPods en octobre 2026. Ces modifications concernent tous les pods suivants et leurs sous-dépendances :
| Pods Firebase concernés | ||
|---|---|---|
Firebase |
FirebaseAuth |
FirebaseInstallations |
FirebaseABTesting |
FirebaseCore |
FirebaseMessaging |
FirebaseAI |
FirebaseCrashlytics |
FirebaseMLModelDownloader |
FirebaseAILogic |
FirebaseDatabase |
FirebasePerformance |
FirebaseAnalytics |
FirebaseFirestore |
FirebaseRemoteConfig |
FirebaseAppCheck |
FirebaseFunctions |
FirebaseStorage |
FirebaseAppDistribution |
FirebaseInAppMessaging |
Ces modifications auront également un impact sur toutes les distributions Firebase qui encapsulent le SDK Firebase Apple natif, y compris le SDK Firebase Unity, SDK Firebase C++ et FlutterFire.
Migrer vos applications Apple
Si vous migrez d'autres dépendances (non Firebase) depuis CocoaPods, sachez qu'il est recommandé d'utiliser une seule méthode d'installation pour l'ensemble de votre projet. Combiner CocoaPods et Swift Package Manager (SPM) dans la même cible peut entraîner des cycles de dépendances complexes et des erreurs de compilation. Si vos dépendances non Firebase ne sont pas encore compatibles avec SPM, l'utilisation de l' installation manuelle pour les bibliothèques Firebase est le moyen le plus stable de consolider votre workflow lors de votre migration.
Swift Package Manager (SPM)
Qu'est-ce que Swift Package Manager ?
Swift Package Manager (SPM) est l'outil natif d'Apple pour gérer la distribution de code. Il est intégré directement à Xcode, ce qui élimine le besoin d'outils CLI externes tels que CocoaPods et simplifie la structure de votre projet en supprimant la nécessité d'un fichier .xcworkspace pour la plupart des configurations standards.
Migrer vers Swift Package Manager
Pour la plupart des projets, la migration vers Swift Package Manager ne nécessite pas de modifier le code de votre application, sauf si votre projet comporte des configurations Xcode personnalisées ou des dépendances qui utilisent intensivement les scripts d'installation CocoaPods.
Voici comment migrer de CocoaPods vers Swift Package Manager :
- Vérifiez que chacune des dépendances de votre application est compatible avec Swift Package Manager. Toutes les bibliothèques Firebase sont compatibles avec SPM, mais vous devrez vérifier la compatibilité avec SPM de vos dépendances non Firebase dans leurs dépôts GitHub ou sur leurs pages produit. Si certaines de vos dépendances non Firebase ne sont pas compatibles avec SPM, l'utilisation de l'installation manuelle au lieu de SPM est le chemin de migration le plus stable depuis CocoaPods.
- Xcode étant fermé, supprimez CocoaPods de votre projet :
- Désinstallez vos dépendances CocoaPods en exécutant la commande suivante dans le répertoire de votre projet :
pod deintegrate
- Supprimez le fichier
.xcworkspacegénéré par CocoaPods.
- Désinstallez vos dépendances CocoaPods en exécutant la commande suivante dans le répertoire de votre projet :
- Dans Xcode, mettez à jour votre projet avec les dépendances Swift Package Manager :
- Ouvrez le fichier
.xcodeprojde votre projet via Xcode. - Ajoutez à nouveau les dépendances de votre application à l'aide de File > Add Package Dependencies (Fichier > Ajouter des dépendances de package).
- Ouvrez le fichier
- Une fois le package Firebase ajouté, vous pouvez mettre à jour les bibliothèques Firebase dont vous dépendez en accédant aux paramètres du projet dans Xcode, en sélectionnant la cible de votre application et en mettant à jour les bibliothèques sous Frameworks, Libraries, and Embedded Content (Frameworks, bibliothèques et contenu intégré). Pour en savoir plus sur l'utilisation de SPM dans Xcode dans la documentation Apple.
Installation manuelle
Qu'est-ce que l'installation manuelle ?
L'installation manuelle consiste à télécharger l'archive Firebase.zip, qui contient des XCFrameworks précompilés pour tous les produits Firebase. Cela vous permet de glisser-déposer des SDK spécifiques directement dans votre projet Xcode sans utiliser de gestionnaire de dépendances.
Migrer vers l'installation manuelle
- Xcode étant fermé, supprimez CocoaPods de votre projet :
- Désinstallez vos dépendances CocoaPods en exécutant la commande suivante dans le répertoire de votre projet :
pod deintegrate
- Supprimez le fichier
.xcworkspacegénéré par CocoaPods.
- Désinstallez vos dépendances CocoaPods en exécutant la commande suivante dans le répertoire de votre projet :
- Suivez les étapes de notre guide d'installation pour ajouter Firebase à votre projet manuellement.
Migrer vos applications Unity, C++ et Flutter
SDK Firebase Unity et FlutterFire
Aucune action n'est requise pour la plupart des développeurs Unity et Flutter. La mise à jour vers la dernière version de Firebase sur Unity ou Flutter migre automatiquement votre gestionnaire de dépendances sous-jacent sur les plates-formes Apple vers Swift Package Manager.
Notez que si vous gérez des dépendances non Firebase via CocoaPods, vous devrez peut-être les migrer manuellement.
SDK Firebase C++
Si vous incluez les dépendances iOS sous-jacentes via CocoaPods, vous pouvez suivre les instructions de migration ci-dessus pour mettre à jour vos dépendances Firebase CocoaPod afin d'utiliser Swift Package Manager à la place.
Questions fréquentes
Je dois continuer à utiliser CocoaPods après octobre 2026. Comment faire en sorte que mon application continue de fonctionner ?
Vous pouvez utiliser les anciennes versions des pods Firebase ou copier les spécifications de pod Firebase depuis GitHub et les héberger dans votre propre dépôt de spécifications.
Dans les deux cas, nous vous recommandons de migrer depuis CocoaPods dès que possible. Nous ne fournirons pas d'assistance officielle pour l'installation de Firebase directement à partir de la spécification de pod après l'arrêt de la prise en charge de CocoaPods en octobre 2026. Si vous choisissez d'héberger vos propres spécifications de pod, vous devrez les tenir à jour.
Pourquoi la prise en charge de CocoaPods est-elle interrompue en octobre 2026 alors que CocoaPods peut être publié jusqu'en décembre 2026 ?
Nous avons choisi octobre pour nous assurer que les versions finales publiées sur CocoaPods sont stables avant le verrouillage du registre en décembre. Ce calendrier offre une marge de manœuvre nécessaire pour coordonner en toute sécurité ces mises à jour finales et garantit que les SDK multiplates-formes, qui dépendent du SDK natif, mais dont les cycles de publication sont retardés, disposent de suffisamment de temps pour préparer leurs propres versions.
Mon application cessera-t-elle de fonctionner si je ne la mets pas à jour ?
Non, cette obsolescence n'affecte que les futures versions des bibliothèques Firebase. Les versions existantes dans CocoaPods resteront installables, et les applications déployées à l'aide de ces versions de pod ne seront pas affectées.
Cela a-t-il une incidence sur la facturation du projet ?
Non.
Je reçois une erreur "FirebaseLibrary not found" (Bibliothèque Firebase introuvable) lors de la compilation de mon projet après la migration vers Swift Package Manager. Comment puis-je résoudre le problème ?
Assurez-vous d'avoir ajouté le package Firebase à votre projet Xcode.
Lorsque vous ajoutez le package Firebase, Xcode vous invite à ajouter des frameworks Firebase aux cibles de compilation de votre application. Si vous oubliez d'ajouter un framework lors de cette étape, vous pouvez toujours l'ajouter ultérieurement dans les paramètres de votre cible sous Build Phases > Link Binary with Libraries (Phases de build > Associer le binaire avec des bibliothèques). Si votre projet contient plusieurs cibles, assurez-vous que Firebase est ajouté aux cibles appropriées.
Cette transition va-t-elle interrompre mes pipelines CI/CD ?
Non, les pipelines exécutant pod install ou pod update continueront de fonctionner pour les versions existantes. Toutefois, ils n'extrairont aucune nouvelle mise à jour de la bibliothèque Firebase publiée après octobre 2026.