firebase-storage
/firebase-storage
Obsługuje Firebase Storage: konfigurację, wysyłanie i pobieranie plików, metadane, obsługę błędów i reguły bezpieczeństwa.
- Autor
- evanca ↗
- Repozytorium
- flutter-ai-rules ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 10.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 4
Brak sygnałów. Repozytorium zmienione 10.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Obsługuje Firebase Storage: konfigurację, wysyłanie i pobieranie plików, metadane, obsługę błędów i reguły bezpieczeństwa.
Oryginalny opis (EN)
Use when setting up Storage, uploading/downloading files, managing metadata, handling errors, or applying security rules.
Jak działa
- When to Use
- 1. Setup and Configuration
- 2. File Operations
- 3. Metadata Management
- 4. Error Handling
- 5. Performance and Best Practices
- 6. Security
- References
Podgląd SKILL.md
---
name: firebase-storage
description: "Use when setting up Storage, uploading/downloading files, managing metadata, handling errors, or applying security rules."
license: MIT
---
# Firebase Cloud Storage Skill
This skill defines how to correctly use Firebase Cloud Storage in Flutter applications.
## When to Use
Use this skill when:
* Setting up Cloud Storage in a Flutter project.
* Uploading or downloading files.
* Managing file metadata.
* Handling Storage errors and monitoring upload progress.
---
## 1. Setup and Configuration
```
flutter pub add firebase_storage
```
```dart
import 'package:firebase_storage/firebase_storage.dart';
final storage = FirebaseStorage.instance;
// Or specify a bucket explicitly:
// final storage = FirebaseStorage.instanceFor(bucket: "gs://BUCKET_NAME");
```
- Firebase Storage requires the **Blaze (pay-as-you-go) plan**.
- Run `flutterfire configure` to update your Firebase config with the default Storage bucket name.
> **Security note:** By default, a Cloud Storage bucket requires Firebase Authentication for any action. Configuring public access may also make App Engine files publicly accessible — restrict access again when you set up Authentication.
---
## 2. File Operations
**Create a reference:**
```dart
final storageRef = FirebaseStorage.instance.ref();
final fileRef = storageRef.child("uploads/file.jpg");
```
**Upload:**
```dart
final uploadTask = fileRef.putFile(file);
final snapshot = await uploadTask;
final downloadUrl = await snapshot.ref.getDownloadURL();
```
**Download (in-memory):**
```dart
final data = await fileRef.getData();
```
**Download URL:**
```dart
final downloadUrl = await fileRef.getDownloadURL();
```
**Delete:**
```dart
await fileRef.delete();
```
---
## 3. Metadata Management
**Get metadata:**
```dart
final metadata = await fileRef.getMetadata();
print('Content type: ${metadata.contentType}');
print('Size: ${metadata.size}');
```
**Update metadata:**
```dart
final newMetadata = SettableMetadata(
contentType: "image/jpeg",
customMetadata: {'uploaded_by': 'user123'},
);
await fileRef.updateMetadata(newMetadata);
```
Use **custom metadata** to store additional key/value pairs with your files.
---
## 4. Error Handling
Use `try-catch` with `FirebaseException`. Key error codes:
| Code | Meaning |
|---|---|
| `storage/object-not-found` | File doesn't exist at the reference |
| `storage/bucket-not-found` | No bucket configured for Cloud Storage |
| `storage/project-not-found` | No project configured for Cloud Storage |
| `storage/quota-exceeded` | Storage quota exceeded |
| `storage/unauthenticated` | User needs to authenticate |
| `storage/unauthorized` | User lacks permission |
| `storage/retry-limit-exceeded` | Operation timeout exceeded |
- For `quota-exceeded` on the Spark plan, upgrade to Blaze.
- Implement retry logic for network-related errors and timeouts.
---
## 5. Performance and Best Practices
**Monitor upload progress:**
```dart
final uploadTask = fileRef.putFile(file);
uploadTask.snapshotEvents.listen((TaskSnapshot snapshot) {
print('Progress: ${(snapshot.bytesTransferred / snapshot.totalBytes) * 100}%');
});
```
- **Cancel** uploads with `uploadTask.cancel()`.
- **Pause / resume** with `uploadTask.pause()` and `uploadTask.resume()`.
- Optimize file sizes before upload to reduce costs and improve performance.
- Use Cloud Storage with Firestore for comprehensive data management.
- Use the **Firebase Local Emulator Suite** for local development and testing.
---
## 6. Security
- Use **Firebase Security Rules** to control access to files.
- Combine Storage rules with **Firebase Authentication** for user-based access control.
- Test security rules thoroughly before deploying to production.
---
## References
- [Firebase Cloud Storage Flutter documentation](https://firebase.google.com/docs/storage/flutter/start)
- [Upload files](https://firebase.google.com/docs/storage/flutter/upload-files)
- [Download files](https://firebase.google.com/docs/storage/flutter/download-files)
- [Handle errors](https://firebase.google.com/docs/storage/flutter/handle-errors)
Wersje
W bazie nie ma innych skilli o nazwie firebase-storage.
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki 984058b703ec (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100gcp-firebase-developer
Buduje i obsługuje aplikacje webowe i mobilne na Firebase: Firestore, Firebase Auth, Hosting, Cloud Functions, Storage, App Check, Remote Config, Analytics i reguły bezpieczeństwa. - 100firebase-data-connect
Pomaga skonfigurować Firebase Data Connect: zapytania i mutacje GraphQL, generowane SDK, tryb offline i reguły bezpieczeństwa. - 100mcp-server-firebase
Instaluje serwer MCP Firebase do dokumentów Firestore, reguł uwierzytelniania i bezpieczeństwa oraz obsługuje jego narzędzia. - 95firebase
Pomaga w Firebase: Firestore, uwierzytelnianie, Cloud Storage, funkcje chmurowe i reguły bezpieczeństwa, z modelowaniem danych i kosztami zapytań. - 100azure-storage-file-share-ts
Obsługuje Azure File Share SDK dla JavaScriptu i TypeScriptu (@azure/storage-file-share): tworzenie udziałów SMB, katalogi, wysyłanie i pobieranie plików oraz metadane. - 100firebase-rules-generator
Prawdopodobnie generuje reguły Firebase w ramach skilli GCP, uruchamiając się automatycznie przy frazach o generatorze reguł Firebase.