Paketdetailsv2.8.1

storage_client

Dart-Client-Bibliothek zur Interaktion mit Supabase Storage. Supabase Storage bietet eine Schnittstelle zum Verwalten von in S3 gespeicherten Dateien unter Verwendung von Postgres zur Verwaltung von Berechtigungen.

AndroidiOSWebmacOSWindowsLinux

pub.dev API-Dokumentation Quellcode

30-Tage-Downloads: 1,3 Mio.
Likes: 33
Pub-Punkte: 140

Paket installieren

flutter pub add storage_client

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das storage_client-Paket ist eine Dart-Bibliothek, die Flutter-Anwendungen die Interaktion mit dem Supabase Storage ermöglicht, einem Dienst zur Verwaltung von Dateien in S3-kompatibler Speicherung mit PostgreSQL-gesteuertem Zugriffskontrolle. Es bietet Methoden zum sicheren Hochladen, Herunterladen, Auflisten und Löschen von Dateien unter Nutzung des Authentifizierungs- und Berechtigungssystems von Supabase. Für nahtlose Integration mit Supabase-Projekten konzipiert, unterstützt es alle wichtigen Plattformen wie Mobilgeräte, Web und Desktop. Das Paket vereinfacht die Dateiverwaltung und gewährleistet durch rollenbasierten Zugriff eine starke Sicherheit.

Anwendungsfälle

Benutzererzeugten Inhalt wie Bilder oder Dokumente hochladen
Verwaltung von App-Ressourcen, die in der Cloud gespeichert sind
Sichere Dateifreigabe zwischen Benutzern implementieren
Speichern und Abrufen von Medien-Dateien in Echtzeit-Apps
Aktivieren der dynamischen Inhaltserstellung in Flutter-Apps

Hauptmerkmale

Sichere Dateioperationen über Supabase-Authentifizierung
Unterstützung für S3-kompatible Speicherbackend
Plattformübergreifende Kompatibilität (Android, iOS, Web, macOS, Windows, Linux)
Integration mit Postgres für feingranulierte Berechtigungen
Einfache API zum Hochladen, Herunterladen und Auflisten von Dateien

Geeignet für

Flutter-Apps, die Supabase als Backend verwenden
Anwendungen, die sichere Dateiverwaltung erfordern
Projekte, die skalierbaren Cloud-Speicher mit Zugriffssteuerung benötigen
Entwickler, die medienintensive oder dokumentbasierte Anwendungen erstellen
Teams, die bereits Supabase für Authentifizierung und Datenbanken verwenden

Hinweise

Erfordert ein Supabase-Projekt mit aktiviertem Speicher
Die Authentifizierung muss in der App eingerichtet werden
Die Dateizugriffsrechte hängen von Postgres-Richtlinien ab
Beschränkt auf die Speicherinfrastruktur von Supabase
Kann zusätzliche Einrichtung für benutzerdefinierte S3-Konfigurationen erfordern

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

Supabase Flutter

Flutter client library for Supabase.

Guides · Reference Docs · Migration Guides

Run locally

This repo is a monorepo powered by Melos containing supabase_flutter and its sub-libraries. All packages are located in the packages directory.

To install on a locally developed app:

Clone this repo
Install Melos globally if you haven't already: dart pub global activate melos
Run melos bootstrap or melos bs at the root of the cloned directory to install dependencies

Add the target package to your pubspec.yaml file specifying the path.

supabase_flutter:
  path: <your-path-to-the-local-supabase-flutter-repo>/packages/supabase_flutter

Testing your app

The helpers the test suites of these packages run on are published in package:supabase_test, so your tests can build on the same primitives: mock HTTP clients, JWT builders, auth session fixtures and realtime frames. Add the package as a dev dependency:

dev_dependencies:
  supabase_test: ^0.1.0

Then stub the endpoints the code under test talks to and run it against a real SupabaseClient, with no running stack required:

final httpClient = MockSupabaseHttpClient()
  ..stubTable('todos', rows: [
    {'id': 1, 'task': 'Ship it', 'status': false},
  ]);
final supabase = testSupabaseClient(httpClient: httpClient);
addTearDown(supabase.dispose);

final todos = await supabase.from('todos').select();
expect(todos, hasLength(1));

See the supabase_test README for the full guide: stubbing database, rpc, edge function and auth endpoints, asserting on recorded requests, running tests as a signed-in user, and wiring Supabase.initialize in Flutter widget tests.

Testing this repo

The tests for the packages postgrest, supabase_auth, supabase_realtime and supabase_storage run against a local Supabase stack. To run these tests locally you need docker and the Supabase CLI installed.

The single configuration for the stack lives in the supabase directory at the repository root. Start it with:

supabase start

Run the Dart tests within the package directory in packages/<package> with the following command. The -j 1 flag runs the tests not concurrently, which works better since the tests run against the same services.