Participe do Firebase Summit on-line e presencialmente em 18 de outubro de 2022. Veja como o Firebase pode ajudar. Usando essa plataforma, é possível acelerar o desenvolvimento de apps, lançar seu aplicativo com confiança e fazer o escalonamento facilmente. Inscreva-se agora

Comece a usar o Cloud Storage no Flutter

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O Cloud Storage para Firebase permite fazer upload e compartilhar conteúdo gerado pelo usuário, como imagens e vídeos, o que permite criar conteúdo de mídia avançada em seus aplicativos. Seus dados são armazenados em um bucket do Google Cloud Storage , uma solução de armazenamento de objetos em escala de exabytes com alta disponibilidade e redundância global. O Cloud Storage para Firebase permite que você carregue esses arquivos com segurança diretamente de dispositivos móveis e navegadores da Web, lidando com redes irregulares com facilidade.

Pré-requisitos

Instale e inicialize os SDKs do Firebase para Flutter , caso ainda não tenha feito isso.

Criar um bucket padrão do Cloud Storage

  1. No painel de navegação do console do Firebase , selecione Armazenamento e clique em Começar .

  2. Revise as mensagens sobre como proteger seus dados do Cloud Storage usando regras de segurança. Durante o desenvolvimento, considere configurar suas regras para acesso público .

  3. Selecione um local para seu bucket padrão do Cloud Storage.

    • Essa configuração de local é o local de recurso padrão do Google Cloud Platform (GCP) do seu projeto . Observe que esse local será usado para serviços do GCP em seu projeto que exigem uma configuração de local, especificamente, seu banco de dados do Cloud Firestore e seu aplicativo do App Engine (o que é necessário se você usar o Cloud Scheduler).

    • Se você não conseguir selecionar um local, seu projeto já tem um local de recurso padrão do GCP. Ele foi definido durante a criação do projeto ou ao configurar outro serviço que requer uma configuração de local.

    Se você estiver no plano Blaze, poderá criar vários buckets , cada um com seu próprio local .

  4. Clique em Concluído .

Configurar acesso público

O Cloud Storage para Firebase fornece uma linguagem de regras declarativas que permite definir como seus dados devem ser estruturados, como devem ser indexados e quando seus dados podem ser lidos e gravados. Por padrão, o acesso de leitura e gravação ao Cloud Storage é restrito para que apenas usuários autenticados possam ler ou gravar dados. Para começar sem configurar o Firebase Authentication , você pode configurar suas regras para acesso público .

Isso torna o Cloud Storage aberto a qualquer pessoa, até mesmo pessoas que não usam seu aplicativo, portanto, restrinja seu Cloud Storage novamente ao configurar a autenticação.

Adicione o SDK do Cloud Storage ao seu aplicativo

  1. Na raiz do seu projeto Flutter, execute o seguinte comando para instalar o plug-in:

    flutter pub add firebase_storage
    
  2. Depois de concluído, reconstrua seu aplicativo Flutter:

    flutter run
    
  3. Importe o plug-in em seu código Dart:

    import 'package:firebase_storage/firebase_storage.dart';
    

Configurar o armazenamento em nuvem

A primeira etapa para acessar seu bucket do Cloud Storage é criar uma instância do FirebaseStorage :

final storage = FirebaseStorage.instance;

Você está pronto para começar a usar o Cloud Storage!

Primeiro, vamos aprender como criar uma referência do Cloud Storage .

Configuração avançada

Existem alguns casos de uso que exigem configuração adicional:

O primeiro caso de uso é perfeito se você tiver usuários em todo o mundo e quiser armazenar seus dados perto deles. Por exemplo, você pode criar buckets nos EUA, Europa e Ásia para armazenar dados de usuários nessas regiões para reduzir a latência.

O segundo caso de uso é útil se você tiver dados com padrões de acesso diferentes. Por exemplo: você pode configurar um bucket multirregional ou regional que armazena imagens ou outro conteúdo acessado com frequência e um bucket nearline ou coldline que armazena backups de usuários ou outro conteúdo acessado com pouca frequência.

Em qualquer um desses casos de uso, convém usar vários buckets do Cloud Storage .

O terceiro caso de uso é útil se você estiver criando um aplicativo, como o Google Drive, que permite que os usuários tenham várias contas conectadas (por exemplo, uma conta pessoal e uma conta de trabalho). Você pode usar uma instância personalizada do aplicativo Firebase para autenticar cada conta adicional.

Use vários buckets do Cloud Storage

Se você quiser usar um bucket do Cloud Storage diferente do padrão fornecido acima ou usar vários buckets do Cloud Storage em um único aplicativo, crie uma instância do FirebaseStorage que faça referência ao seu bucket personalizado:

// Get a non-default Storage bucket
final storage = FirebaseStorage.instanceFor(bucket: "gs://my-custom-bucket");

Trabalhando com buckets importados

Ao importar um bucket existente do Cloud Storage para o Firebase, você precisará conceder ao Firebase a capacidade de acessar esses arquivos usando a ferramenta gsutil , incluída no Google Cloud SDK :

gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://YOUR-CLOUD-STORAGE-BUCKET

Você pode encontrar o número do seu projeto conforme descrito na introdução aos projetos do Firebase .

Isso não afeta os buckets recém-criados, pois eles têm o controle de acesso padrão definido para permitir o Firebase. Esta é uma medida temporária e será executada automaticamente no futuro.

Usar um aplicativo personalizado do Firebase

Se você estiver criando um aplicativo mais complicado usando um FirebaseApp personalizado, poderá criar uma instância do FirebaseStorage inicializada com esse aplicativo:

// Use a non-default App
final storage = FirebaseStorage.instanceFor(app: customApp);

Próximos passos