O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Conectar seu app ao emulador do Cloud Functions

Antes de conectar seu app ao emulador do Cloud Functions, verifique se você entendeu o fluxo de trabalho geral do Pacote do emulador local do Firebase e que você instalou e configurou o Pacote do emulador local e analisou os comandos da CLI.

Escolher um projeto do Firebase

O pacote do emulador local do Firebase emula produtos para um único projeto.

Na CLI, execute firebase use no diretório de trabalho antes de iniciar os emuladores para selecionar o projeto a ser usado. Como opção, é possível transmitir a sinalização --project para cada comando do emulador.

O Pacote do emulador local é compatível com a emulação de projetos reais e de demonstração do Firebase.

Tipo de projeto Recursos Usar com emuladores
Real Um projeto real é aquele que você configurou e ativou no Console do Firebase. Esse projeto tem recursos ativos, como bancos de dados, buckets de armazenamento, funções ou qualquer outro recurso que você configura para o projeto. Ao trabalhar com projetos reais, é possível executar emuladores para quaisquer produtos compatíveis no projeto.

Para todos os produtos que você não estiver emulando, os apps e o código interagem com recursos ativos, como o banco de dados, o bucket de armazenamento, a função etc.
Demonstração Um projeto de demonstração não tem configuração do Console do Firebase e nenhum recurso ativo.

Os IDs dos projetos de demonstração têm o prefixo demo-.
Ao trabalhar com projetos de demonstração, os apps e códigos interagem apenas com emuladores. Se o app interagir com um recurso para o qual não há um emulador sendo executado, o código falhará.

Recomendamos que você use projetos de demonstração sempre que possível. Algumas das vantagens são:

  • configuração mais fácil, já que é possível executar os emuladores sem precisar criar um projeto do Firebase;
  • mais segurança, já que, se o código invocar acidentalmente recursos não emulados (produção), não haverá chance de alteração, uso e faturamento de dados;
  • melhor suporte off-line, já que não é necessário acessar a Internet para fazer o download da configuração do SDK.

Instruir o app a se comunicar com os emuladores

Instruir o app para funções chamáveis

Se as atividades de teste e protótipo envolverem funções de back-end chamáveis, configure a interação com o emulador do Cloud Functions para Firebase da seguinte maneira:

Android
        // 10.0.2.2 is the special IP address to connect to the 'localhost' of
        // the host computer from an Android emulator.
        FirebaseFunctions functions = FirebaseFunctions.getInstance();
        functions.useEmulator("10.0.2.2", 5001);
iOS – Swift
Functions.functions().useFunctionsEmulator(origin: "http://localhost:5001")

Web v8

firebase.functions().useEmulator("localhost", 5001);

Web v9

import { getApp } from "firebase/app";
import { getFunctions, useFunctionsEmulator } from "firebase/functions";

const functions = getFunctions(getApp());
useFunctionsEmulator(functions, "localhost", 5001);

Instruir o app para emulação de funções HTTPS

Cada função HTTPS no seu código será exibida pelo emulador local usando o seguinte formato de URL:

http://$HOST:$PORT/$PROJECT/$REGION/$NAME

Por exemplo, uma função helloWorld simples com a porta e a região de host padrão seria exibida em:

https://localhost:5001/$PROJECT/us-central1/helloWorld

Instruir o app para emulação de funções acionadas em segundo plano

O emulador do Cloud Functions é compatível com funções acionadas em segundo plano das seguintes fontes:

  • Emulador do Realtime Database
  • Emulador do Cloud Firestore
  • Emulador do Authentication
  • Emulador do Pub/Sub

Para acionar eventos em segundo plano, conecte seu app ou código de teste aos emuladores usando o SDK da sua plataforma.

Existem outras ferramentas para testar o Cloud Functions?

O emulador do Cloud Functions é complementado por outras ferramentas de teste e prototipagem:

  • O shell do Cloud Functions, que permite o desenvolvimento e a prototipagem de funções interativos e iterativos. O shell emprega o emulador do Cloud Functions com uma interface no estilo REPL para desenvolvimento. Nenhuma integração com os emuladores do Cloud Firestore ou do Realtime Database é fornecida. Ao usar o shell, você simula dados e executa chamadas de função para simular a interação com produtos sem suporte atualmente no pacote do emulador local: Cloud Storage, Pub/Sub, Analytics, configuração remota, Storage, Auth e Crashlytics.
  • O SDK de teste do Firebase para Cloud Functions, um Node.js com framework mocha para desenvolvimento de funções. Na verdade, o SDK de teste do Cloud Functions fornece automação sobre o shell do Cloud Functions.

Saiba mais sobre o shell do Cloud Functions e o SDK de teste do Cloud Functions em Testar funções interativamente e Teste de unidade do Cloud Functions.

A seguir