Solução de problemas e perguntas frequentes sobre as plataformas Apple e o Firebase
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página conta com dicas e soluções de problemas específicos da plataforma Apple
que podem ser encontrados ao usar o Firebase.
Você está enfrentando algum outro desafio ou seu problema não está descrito abaixo? Confira
as Perguntas frequentes sobre o Firebase para ver mais dúvidas relacionadas ao Firebase ou
a um produto específico.
Confira também o
repositório do SDK do Firebase para as plataformas Apple no GitHub (em inglês)
para ter acesso a uma lista atualizada dos problemas informados e respectivas soluções. Recomendamos que você
também registre os seus próprios problemas relacionados ao SDK do Firebase para plataformas Apple no repositório.
Quais versões do Xcode são aceitas pelo Firebase?
O Firebase tem suporte a duas versões principais do Xcode, com exceção daquelas
que não recebem mais suporte da Apple. Por exemplo, a partir de março de 2019,
a Apple exigiu pelo menos o iOS 12 em todos os apps. Ou seja, o suporte ao Xcode 9 foi
descontinuado, e o Xcode 10 foi a única versão principal com suporte.
Meu app está solicitando a senha do usuário para acessar itens do conjunto de chaves no macOS. Como resolvo esse problema?
Faça upgrade da sua dependência do Firebase para a versão 9.6.0 ou mais recente e adicione o
[recurso de compartilhamento de conjunto de chaves](/docs/ios/troubleshooting-faq#macos-keychain-sharing)
ao seu destino.
Por que o Firebase exige o recurso de compartilhamento de conjuntos de chaves no macOS?
Os SDKs do Firebase usam o conjunto de chaves para armazenar informações como o ID
de instalação do Firebase usado para o FCM. Sem o acesso ao conjunto de chaves, os SDKs do Firebase podem
não funcionar corretamente. O conjunto de chaves do macOS se comporta de maneira diferente do
conjunto de chaves no estilo iOS usado em outras plataformas (iOS, tvOS, macCatalyst
e watchOS).
No macOS, um app usa um conjunto de chaves compartilhado que pode ser modificado por outros apps e
processos. Ao contrário do iOS, não há um conjunto de chaves no sandbox ao qual o app tenha
acesso implícito. Portanto, quando um app Mac interage com o conjunto de chaves, o sistema
pede acesso ao usuário, já que o aplicativo está modificando um item do conjunto de chaves
que ele não criou. Para resolver essa discrepância, o Firebase consulta o
conjunto de chaves com a chave kSecUseDataProtectionKeychain, que instrui
o app a consultar um item do conjunto que faz parte de um grupo de acesso de conjuntos de chaves
(esse é o comportamento padrão em outras plataformas). O recurso de compartilhamento de conjunto de chaves
é necessário porque o app precisa sintetizar um grupo de acesso que pode ser
compartilhado entre os destinos, concedendo permissão para que o app acesse
livremente os itens do conjunto de chaves no grupo de acesso.
Nas versões do Xcode a partir da 13, por que meus apps do UIKit não podem abrir
alguns URLs que eu registrei no Info.plist?
A Apple introduziu um limite de 50 entradas LSApplicationQueriesSchemes
nos arquivos Info.plist. Em 2015, a Apple introduziu
LSApplicationQueriesSchemes para limitar o número de consultas de URL
que cada app pode fazer. Com o lançamento do Xcode 13, esses limites foram aplicados,
mas no Xcode 12 e nas versões anteriores não havia um limite para o número de
esquemas.
Alguns produtos do Firebase, como Firebase Authentication e Firebase Dynamic Links,
exigem o uso de esquemas de URLs personalizados para redirecionar ao aplicativo. Esses
URLs estão em conformidade com um esquema de URL conciso e consistente que não vai ser pesar
significativamente no limite de 50 esquemas de links.
Observe que, para apps que continuam registrando mais de 50
LSApplicationQueriesSchemes, alguns esquemas são
ignorados silenciosamente. O app pode não conseguir executar determinados links diretos
dependendo da ordem em que são adicionados.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 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."]]
