Conecte seu aplicativo ao emulador do Cloud Storage

Antes de conectar seu aplicativo ao emulador do Cloud Storage, certifique-se de entender o fluxo de trabalho geral do Firebase Local Emulator Suite , instalar e configurar o Local Emulator Suite e revisar os comandos da CLI .

Escolha um projeto do Firebase

O Firebase Local Emulator Suite emula produtos para um único projeto do Firebase.

Para selecionar o projeto a ser usado, antes de iniciar os emuladores, na CLI, execute firebase use em seu diretório de trabalho. Ou você pode passar o sinalizador --project para cada comando do emulador.

O Local Emulator Suite oferece suporte à emulação de projetos reais do Firebase e projetos de demonstração .

Tipo de projeto Recursos Usar com emuladores
Real

Um projeto real do Firebase é aquele que você criou e configurou (provavelmente por meio do console do Firebase).

Projetos reais têm recursos ativos, como instâncias de banco de dados, buckets de armazenamento, funções ou qualquer outro recurso que você configurou para esse projeto do Firebase.

Ao trabalhar com projetos reais do Firebase, você pode executar emuladores para qualquer um ou todos os produtos compatíveis.

Para qualquer produto que você não esteja emulando, seus aplicativos e código irão interagir com o recurso ativo (instância de banco de dados, bucket de armazenamento, função etc.).

Demonstração

Um projeto de demonstração do Firebase não tem configuração real do Firebase nem recursos ativos. Esses projetos geralmente são acessados ​​via codelabs ou outros tutoriais.

IDs de projeto para projetos de demonstração têm o prefixo demo- .

Ao trabalhar com projetos de demonstração do Firebase, seus aplicativos e código interagem apenas com emuladores . Se seu aplicativo tentar interagir com um recurso para o qual um emulador não está em execução, esse código falhará.

Recomendamos que você use projetos de demonstração sempre que possível. Os benefícios incluem:

  • Configuração mais fácil, pois você pode executar os emuladores sem nunca criar um projeto do Firebase
  • Segurança mais forte, pois se o seu código invocar acidentalmente recursos não emulados (produção), não há chance de alteração de dados, uso e cobrança
  • Melhor suporte offline, pois não há necessidade de acessar a internet para baixar sua configuração do SDK.

Instrumente seu aplicativo para conversar com os emuladores

Plataformas Android, Apple e SDKs da Web

Configure sua configuração no aplicativo ou classes de teste para interagir com o emulador do Cloud Storage da seguinte maneira.

Android
FirebaseStorage.getInstance().useEmulator('10.0.2.2', 9199);
Rápido
Storage.storage().useEmulator(withHost:"localhost", port:9199)
Web v8
var storage = firebase.storage();
storage.useEmulator("localhost", 9199);
Web v9
import { getStorage, connectStorageEmulator } from "firebase/storage";

const storage = getStorage();
connectStorageEmulator(storage, "localhost", 9199);

Nenhuma configuração adicional é necessária para testar as funções do Cloud acionadas por eventos do Cloud Storage usando o emulador. Quando os emuladores do Cloud Storage e do Cloud Functions estão em execução, eles trabalham juntos automaticamente.

SDKs de administração

Os SDKs Admin do Firebase se conectam automaticamente ao emulador do Cloud Storage quando a variável de ambiente FIREBASE_STORAGE_EMULATOR_HOST é definida:

export FIREBASE_STORAGE_EMULATOR_HOST="localhost:9199"

Observe que o emulador do Cloud Functions reconhece automaticamente o emulador do Cloud Storage para que você possa pular esta etapa ao testar integrações entre o Cloud Functions e os emuladores do Cloud Storage. A variável de ambiente será definida automaticamente para o SDK Admin no Cloud Storage.

Se você quiser que o código do SDK Admin se conecte a um emulador compartilhado em execução em outro ambiente, será necessário especificar o mesmo ID do projeto definido usando a Firebase CLI . Você pode passar um ID de projeto para initializeApp diretamente ou definir a variável de ambiente GCLOUD_PROJECT .

SDK Admin Node.js
admin.initializeApp({ projectId: "your-project-id" });
Variável de ambiente
export GCLOUD_PROJECT="your-project-id"

Importar e exportar dados

Os emuladores de banco de dados e do Cloud Storage permitem exportar dados de uma instância de emulador em execução. Defina um conjunto de dados de linha de base para usar em seus testes de unidade ou fluxos de trabalho de integração contínua e exporte-o para ser compartilhado entre a equipe.

firebase emulators:export ./dir

Nos testes, na inicialização do emulador, importe os dados da linha de base.

firebase emulators:start --import=./dir

Você pode instruir o emulador a exportar dados no desligamento, especificando um caminho de exportação ou simplesmente usando o caminho passado para o sinalizador --import .

firebase emulators:start --import=./dir --export-on-exit

Essas opções de importação e exportação de dados também funcionam com o comando firebase emulators:exec . Para obter mais informações, consulte a referência de comando do emulador .

Como o emulador do Cloud Storage difere da produção

Para testes de aplicativos cliente, o emulador do Cloud Storage se alinha quase perfeitamente à produção em relação à área de superfície da API do Firebase. Espera-se que todos os comandos do Firebase funcionem entre os SDKs regulares do Firebase (plataformas Web, Android e Apple).

Para testes de aplicativos do lado do servidor, existem limitações. Os SDKs Admin do Firebase usam a superfície da API do Google Cloud, e nem todos os endpoints dessa API são emulados. Como regra geral, tudo o que pode ser feito a partir dos SDKs do cliente (carregar ou excluir arquivos, obter e definir metadados) também é implementado para uso dos SDKs Admin, mas nada além disso não é. Exclusões notáveis ​​estão listadas abaixo.

Cloud IAM

O Firebase Emulator Suite não tenta replicar ou respeitar nenhum comportamento relacionado ao IAM para execução. Os emuladores seguem as regras de segurança do Firebase fornecidas, mas em situações em que o IAM normalmente seria usado, por exemplo, para definir o Cloud Functions invocando a conta de serviço e, portanto, as permissões, o emulador não é configurável e usará a conta disponível globalmente na máquina do desenvolvedor. semelhante a executar um script local diretamente.

Notificações do Pub/Sub

O emulador do Cloud Storage não se integra ao emulador do Cloud Pub/Sub e, portanto, não é compatível com a criação de canais/notificações para alterações de objetos de armazenamento. Recomendamos usar os acionadores do Cloud Functions Storage diretamente.

Metadados no nível do bucket

O emulador do Cloud Storage não é compatível com nenhuma configuração no nível do bucket, incluindo classe de armazenamento, configuração CORS no nível do bucket, rótulos ou políticas de retenção. O Firebase pretende melhorar esse suporte ao longo do tempo.

Qual o proximo?