Instalação e configuração em plataformas Apple

O Firebase Realtime Database é um banco de dados hospedado na nuvem. Os dados são armazenados como JSON e sincronizados em tempo real para cada cliente conectado. Quando você cria apps multiplataforma com nossos SDKs para iOS, Android e JavaScript, todos os seus clientes compartilham uma instância do Realtime Database e recebem automaticamente atualizações com os dados mais recentes.

O Firebase Realtime Database está disponível em todas as plataformas Apple, incluindo iOS, macOS, macOS Catalyst, tvOS e watchOS. Porém, não está disponível para Clipes de apps. As instruções de configuração nesta página fazem referência ao iOS em exemplos específicos, mas são genéricas e funcionam com qualquer destino da plataforma Apple.

Pré-requisitos

  1. Instalar o SDK do Firebase.
  2. Adicionar o app ao projeto do Firebase no Console do Firebase.

Criar um banco de dados

  1. Navegue até a seção Realtime Database do Console do Firebase. Aparecerá uma solicitação para selecionar um projeto atual do Firebase. Siga o fluxo de trabalho de criação do banco de dados.

  2. Selecione um modo inicial para suas regras de segurança do Firebase:

    Modo de teste

    Esse modo é ideal para começar a usar as bibliotecas de cliente em dispositivos móveis e na Web, mas ele permite que qualquer pessoa leia e substitua os dados. Após o teste, leia a seção Noções básicas das regras do Firebase Realtime Database.

    Selecione "modo de teste" para começar a usar o SDK para Android, Apple ou Web.

    Modo bloqueado

    Nega todas as leituras e gravações de clientes de dispositivos móveis e Web. Seus servidores de aplicativos autenticados ainda podem acessar seu banco de dados.

  3. Escolha um local para o banco de dados.

    Dependendo do local, o URL do novo banco de dados terá um dos seguintes formatos:

    • DATABASE_NAME.firebaseio.com (para bancos de dados em us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (para bancos de dados em todos os outros locais)

  4. Clique em Concluído.

Ao ativar o Realtime Database, também é ativada a API no Gerenciador de APIs do Cloud.

Adicionar o Firebase Realtime Database ao seu app

Use o Swift Package Manager para instalar e gerenciar as dependências do Firebase.

  1. No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.
  2. Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Escolha a biblioteca do Realtime Database.
  5. Quando terminar, o Xcode vai iniciar a resolução e fazer o download das dependências em segundo plano automaticamente.

Configurar as regras de segurança do Realtime Database

O Realtime Database oferece uma linguagem de regras declarativas para que você defina como os dados devem ser estruturados e indexados, e quando podem ser lidos e gravados.

Configurar o Firebase Realtime Database

Você deve inicializar o Firebase antes de criar ou usar qualquer referência para um app do Firebase. Caso já tenha feito isso para outro recurso do Firebase, pule essa etapa.

  1. Importe o módulo FirebaseCore no UIApplicationDelegate, assim como qualquer outro módulo do Firebase usado pelo delegado do app. Por exemplo, para usar o Cloud Firestore e o Authentication:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure uma instância compartilhada do FirebaseApp no método application(_:didFinishLaunchingWithOptions:) do delegado do app:

    SwiftUI

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se você estiver usando a SwiftUI, crie um delegado do aplicativo e o anexe ao struct App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Também é necessário desativar o swizzling do delegado do app. Para mais informações, consulte as instruções da SwiftUI.

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. Crie uma referência ao seu banco de dados e especifique o local em que você quer gravar.

    Swift

    Observação: este produto do Firebase não está disponível no destino Clipes de apps.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Objective-C

    Observação: este produto do Firebase não está disponível no destino Clipes de apps.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

A seguir