Risoluzione dei problemi e Domande frequenti sulle piattaforme Apple e Firebase
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina offre suggerimenti e risoluzione dei problemi specifici della piattaforma Apple
che potresti riscontrare durante l'utilizzo di Firebase.
Hai altre sfide o non vedi il tuo problema descritto di seguito? Assicurati di consultare le domande frequenti principali di Firebase per altre domande frequenti su Firebase o specifiche per prodotto.
Puoi anche consultare il
repository GitHub dell'SDK Firebase per le piattaforme Apple
per un elenco aggiornato dei problemi segnalati e della risoluzione dei problemi. Ti invitiamo a segnalare anche lì i problemi relativi all'SDK Firebase per le piattaforme Apple.
Quali versioni di Xcode supporta Firebase?
Firebase supporta fino a due versioni principali di Xcode, escluse le versioni
di Xcode non più supportate da Apple. Ad esempio, a partire da marzo 2019,
Apple ha richiesto almeno iOS 12 su tutte le app, il che significa che il supporto di Xcode 9 è stato
interrotto e Xcode 10 è stata l'unica versione principale supportata.
La mia app chiede all'utente la password per accedere agli elementi del Portachiavi su macOS. Come faccio a risolvere il problema?
Esegui l'upgrade della dipendenza Firebase alla versione 9.6.0 o successive e aggiungi la
[funzionalità di condivisione del portachiavi](/docs/ios/troubleshooting-faq#macos-keychain-sharing)
al tuo target.
Perché Firebase richiede la funzionalità di condivisione del portachiavi su macOS?
Gli SDK Firebase utilizzano il portachiavi per archiviare informazioni come l'ID installazione Firebase utilizzato per FCM. Senza l'accesso al portachiavi, gli SDK Firebase potrebbero non
funzionare correttamente. Il portachiavi macOS si comporta in modo diverso rispetto al portachiavi
in stile iOS utilizzato su altre piattaforme (iOS, tvOS, macCatalyst
e watchOS).
Su macOS, le app utilizzano un portachiavi condiviso che può essere modificato da altre app e
processi. A differenza di iOS, non esiste un portachiavi in sandbox a cui l'app ha
accesso implicito. Pertanto, quando un'app per Mac interagisce con il portachiavi, il sistema
chiede all'utente l'accesso, poiché l'app per Mac potrebbe modificare un elemento del portachiavi
che non ha creato. Per risolvere questa discrepanza, Firebase esegue query sul
portachiavi con la chiave kSecUseDataProtectionKeychain, che indica
all'app di eseguire query su un elemento del portachiavi che fa parte di un gruppo di accesso al portachiavi
(questo è il comportamento predefinito su altre piattaforme). La funzionalità di condivisione del portachiavi
è necessaria perché l'app la utilizza per sintetizzare un gruppo di accesso che può essere
condiviso tra i suoi target, concedendo così l'autorizzazione all'app di accedere liberamente
agli elementi del portachiavi nel gruppo di accesso.
Nelle versioni di Xcode 13 e successive, perché le mie app UIKit non riescono ad aprire alcuni
URL che ho registrato nel mio file Info.plist?
Apple ha introdotto un limite di 50 voci LSApplicationQueriesSchemes
nei file Info.plist. Nel 2015, Apple ha introdotto
LSApplicationQueriesSchemes per limitare il numero di query URL
che ogni app poteva effettuare. Con il rilascio di Xcode 13, questi limiti vengono applicati,
mentre in Xcode 12 e versioni precedenti non esisteva un limite effettivo al numero di
schemi.
Alcuni prodotti Firebase, come Firebase Authentication e Firebase Dynamic Links,
richiedono l'utilizzo di schemi URL personalizzati per il reindirizzamento alla tua applicazione. Questi
URL rispettano uno schema di URL conciso e coerente che non dovrebbe influire
in modo significativo sul limite di 50 schemi di link.
Tieni presente che per le app che continuano a registrare più di 50
LSApplicationQueriesSchemes, alcuni schemi verranno
ignorati automaticamente. L'app potrebbe non essere in grado di eseguire determinati link diretti,
a seconda dell'ordine in cui vengono aggiunti.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 UTC."],[],[],null,["\u003cbr /\u003e\n\nThis page offers tips and troubleshooting for Apple platform-specific issues\nthat you might encounter when using Firebase.\n\nHave other challenges or don't see your issue outlined below? Make sure to check\nout the [main Firebase FAQ](/support/faq) for more pan-Firebase or\nproduct-specific FAQ.\n\nYou can also check out the\n[Firebase Apple platforms SDK GitHub repo](https://github.com/firebase/firebase-ios-sdk/issues)\nfor an up-to-date list of reported issues and troubleshooting. We encourage you\nto file your own Firebase Apple platforms SDK related issues there, too! \n\nWhat versions of Xcode does Firebase support?\n\nFirebase supports up to two major versions of Xcode, not including versions\nof Xcode that Apple no longer supports. For example, starting in March 2019,\nApple required at least iOS 12 on all apps, meaning Xcode 9 support was\ndropped and Xcode 10 was the only major version supported.\n\nChanges to support for specific minor or patch versions of Xcode\n(for example, 9.2.0 to 9.4.1) are determined based on the needs of the\nFirebase Apple platforms SDK and a survey of developer usage. These changes\nare reflected in the\n[Firebase Apple platforms SDK release notes](/support/release-notes/ios)\nand on the [Firebase Apple platforms SDK setup page](/docs/ios/setup).\n\nTo see the minimum Xcode version supported by the SDK, check\nthe requirements listed in\n[Add Firebase to your Apple project](/docs/ios/setup).\n\nFirebase support for Beta releases of Xcode is available on a \"best effort\"\nbasis. Developers can track and submit issues in the\n[Firebase Apple platforms SDK repository on GitHub](//github.com/firebase/firebase-ios-sdk/issues). \n\nMy app prompts the user for their password to access Keychain items on macOS. How do I fix this?\n\nUpgrade your Firebase dependency to version 9.6.0 or higher and add the\n\\[Keychain Sharing capability\\](/docs/ios/troubleshooting-faq#macos-keychain-sharing)\nto your target. \n\nWhy does Firebase require the Keychain Sharing capability on macOS?\n\nFirebase SDKs use keychain to store information like the Firebase\ninstallation ID used for FCM. Without Keychain access, Firebase SDKs may not\nfunction correctly. The macOS keychain behaves differently than the iOS-style\nkeychain that is used on other platforms (iOS, tvOS, macCatalyst,\nand watchOS).\n\nOn macOS, apps use a shared keychain that may be modified by other apps and\nprocesses. Unlike iOS, there is no sandboxed keychain that the app has\nimplicit access to. So, when a Mac app interacts with the keychain, the system\nprompts the user for access since the Mac app may be modifying a keychain item\nthat it did not create. To address this discrepancy, Firebase queries the\nkeychain with the `kSecUseDataProtectionKeychain` key, which tells\nthe app to query a keychain item that is part of a keychain access group\n(this is default behavior on other platforms). The Keychain Sharing capability\nis required because the app needs it to synthesize an access group that can be\nshared amongst its targets, thus giving permission for the app to freely\naccess keychain items in the access group.\n\nFor more information, see Apple's\n[Keychain documentation](https://developer.apple.com/documentation/security/keychain_services/keychains). \n\nIn Xcode versions 13 and later, why can my UIKit apps not open some\nURLs I've registered\nin my Info.plist?\n\nApple introduced a limit of 50 `LSApplicationQueriesSchemes`\nentries in `Info.plist` files. In 2015, Apple introduced\n`LSApplicationQueriesSchemes` to limit the number of URL queries\neach app could make. With the release of Xcode 13, these limits are enforced,\nwhile in Xcode 12 and earlier there was no effective limit to the number of\nschemes.\n\nSome Firebase products, like Firebase Authentication and Firebase Dynamic Links,\nrequire the use of custom URL schemes to redirect to your application. These\nURLs conform to a concise and consistent URL scheme that should not count\nsignificantly against the 50 link scheme limit.\n\nNote that for apps that continue to register more than 50\n`LSApplicationQueriesSchemes`, some schemes will\nbe silently ignored. The app may be unable to execute certain deeplinks,\ndepending on the order in which they are added."]]
