इस पेज पर, Cloud Storage बकेट से फ़ाइलें डाउनलोड करने के लिए, Cloud Storage for Firebase SDK टूल इस्तेमाल करने का तरीका बताया गया है.
कोई रेफ़रंस फ़ाइल बनाना
कोई फ़ाइल डाउनलोड करने के लिए, सबसे पहले उस फ़ाइल के लिए Cloud Storage रेफ़रंस बनाएं जिसे आपको डाउनलोड करना है.
Cloud Storage बकेट के रूट में चाइल्ड पाथ जोड़कर रेफ़रंस बनाया जा सकता है. इसके अलावा, Cloud Storage में किसी ऑब्जेक्ट का रेफ़रंस देने वाले मौजूदा gs:// या https:// यूआरएल से भी रेफ़रंस बनाया जा सकता है.
// Create a storage reference from your app
final storageRef = FirebaseStorage.instance.ref();
// Create a reference with an initial file path and name
final pathReference = storageRef.child("images/stars.jpg");
// Create a reference to a file from a Google Cloud Storage URI
final gsReference =
FirebaseStorage.instance.refFromURL("gs://YOUR_BUCKET/images/stars.jpg");
// Create a reference from an HTTPS URL
// Note that in the URL, characters are URL escaped!
final httpsReference = FirebaseStorage.instance.refFromURL(
"https://firebasestorage.googleapis.com/b/YOUR_BUCKET/o/images%20stars.jpg");
फ़ाइलें डाउनलोड करना
रेफ़रंस मिलने के बाद, getData() को कॉल करके Cloud Storage से फ़ाइलें डाउनलोड की जा सकती हैं. अगर आपको किसी दूसरी लाइब्रेरी की मदद से फ़ाइल डाउनलोड करनी है, तो getDownloadUrl() का इस्तेमाल करके डाउनलोड यूआरएल पाएं.
मेमोरी में डाउनलोड करें
getData() तरीके का इस्तेमाल करके, फ़ाइल को UInt8List में डाउनलोड करें. यह किसी फ़ाइल को डाउनलोड करने का सबसे आसान तरीका है. हालांकि, इसके लिए फ़ाइल के पूरे कॉन्टेंट को मेमोरी में लोड करना ज़रूरी है. अगर आपने ऐसी फ़ाइल का अनुरोध किया है जिसका साइज़ आपके ऐप्लिकेशन के लिए उपलब्ध मेमोरी से ज़्यादा है, तो आपका ऐप्लिकेशन क्रैश हो जाएगा. मेमोरी से जुड़ी समस्याओं से बचने के लिए, getData()
डाउनलोड करने के लिए ज़्यादा से ज़्यादा बाइट लेता है. ज़्यादा से ज़्यादा साइज़ को उस साइज़ पर सेट करें जिसे आपका ऐप्लिकेशन हैंडल कर सके या डाउनलोड करने का कोई दूसरा तरीका इस्तेमाल करें.
final islandRef = storageRef.child("images/island.jpg");
try {
const oneMegabyte = 1024 * 1024;
final Uint8List? data = await islandRef.getData(oneMegabyte);
// Data for "images/island.jpg" is returned, use this as needed.
} on FirebaseException catch (e) {
// Handle any errors.
}
लोकल फ़ाइल में डाउनलोड करना
writeToFile() तरीके से, फ़ाइल को सीधे लोकल डिवाइस पर डाउनलोड किया जाता है. अगर आपके उपयोगकर्ताओं को ऑफ़लाइन होने पर फ़ाइल ऐक्सेस करनी है या किसी दूसरे ऐप्लिकेशन में फ़ाइल शेयर करनी है, तो इसका इस्तेमाल करें. writeToFile(), DownloadTask दिखाता है. इसका इस्तेमाल करके, डाउनलोड को मैनेज किया जा सकता है और डाउनलोड की स्थिति पर नज़र रखी जा सकती है.
final islandRef = storageRef.child("images/island.jpg");
final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/images/island.jpg";
final file = File(filePath);
final downloadTask = islandRef.writeToFile(file);
downloadTask.snapshotEvents.listen((taskSnapshot) {
switch (taskSnapshot.state) {
case TaskState.running:
// TODO: Handle this case.
break;
case TaskState.paused:
// TODO: Handle this case.
break;
case TaskState.success:
// TODO: Handle this case.
break;
case TaskState.canceled:
// TODO: Handle this case.
break;
case TaskState.error:
// TODO: Handle this case.
break;
}
});
यूआरएल से डेटा डाउनलोड करना
अगर आपके पास पहले से ही यूआरएल पर आधारित डाउनलोड इन्फ़्रास्ट्रक्चर है या आपको सिर्फ़ शेयर करने के लिए कोई यूआरएल चाहिए, तो Cloud Storage रेफ़रंस पर getDownloadURL() तरीके को कॉल करके, किसी फ़ाइल का डाउनलोड यूआरएल पाया जा सकता है.
final imageUrl =
await storageRef.child("users/me/profile.png").getDownloadURL();
गड़बड़ी ठीक करना
डाउनलोड करते समय गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल का मौजूद न होना या उपयोगकर्ता के पास फ़ाइल को ऐक्सेस करने की अनुमति न होना. गड़बड़ियों के बारे में ज़्यादा जानने के लिए, गड़बड़ियों को ठीक करना लेख पढ़ें.
पूरा उदाहरण
गड़बड़ी को ठीक करने के साथ-साथ, डाउनलोड करने का पूरा उदाहरण यहां दिया गया है:
final islandRef = storageRef.child("images/island.jpg");
final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/images/island.jpg";
final file = File(filePath);
final downloadTask = islandRef.writeToFile(file);
downloadTask.snapshotEvents.listen((taskSnapshot) {
switch (taskSnapshot.state) {
case TaskState.running:
// TODO: Handle this case.
break;
case TaskState.paused:
// TODO: Handle this case.
break;
case TaskState.success:
// TODO: Handle this case.
break;
case TaskState.canceled:
// TODO: Handle this case.
break;
case TaskState.error:
// TODO: Handle this case.
break;
}
});
Cloud Storage में सेव की गई फ़ाइलों के लिए, मेटाडेटा भी पाया और अपडेट किया जा सकता है.