Flutter पर Cloud Storage का इस्तेमाल करके फ़ाइलें अपलोड करना

'Firebase के लिए Cloud Storage' की मदद से, फ़ाइलों को तेज़ी और आसानी से Cloud Storage बकेट में अपलोड किया जा सकता है. यह बकेट, Firebase से मैनेज की जाती है और दी जाती है.

फ़ाइलें अपलोड करें

Cloud Storage में कोई फ़ाइल अपलोड करने के लिए, आपको सबसे पहले फ़ाइल के पूरे पाथ का रेफ़रंस बनाना होगा. इसमें फ़ाइल का नाम भी शामिल होना चाहिए.

// Create a storage reference from our app
final storageRef = FirebaseStorage.instance.ref();

// Create a reference to "mountains.jpg"
final mountainsRef = storageRef.child("mountains.jpg");

// Create a reference to 'images/mountains.jpg'
final mountainImagesRef = storageRef.child("images/mountains.jpg");

// While the file names are the same, the references point to different files
assert(mountainsRef.name == mountainImagesRef.name);
assert(mountainsRef.fullPath != mountainImagesRef.fullPath);

सही पहचान फ़ाइल बनाने के बाद, फ़ाइल को Cloud Storage में अपलोड करने के लिए, putFile(), putString() या putData() तरीके का इस्तेमाल करें.

अपने Cloud Storage बकेट के रूट के रेफ़रंस के साथ, डेटा अपलोड नहीं किया जा सकता. आपका संदर्भ किसी चाइल्ड यूआरएल पर ले जाना चाहिए.

किसी फ़ाइल से अपलोड करें

किसी फ़ाइल को अपलोड करने के लिए, आपको पहले डिवाइस पर उसकी जगह का ऐब्सलूट पाथ पाना होगा. उदाहरण के लिए, अगर कोई फ़ाइल ऐप्लिकेशन की दस्तावेज़ डायरेक्ट्री में मौजूद है, तो फ़ाइल पाथ जनरेट करने और उसे putFile() को पास करने के लिए, आधिकारिक path_provider पैकेज का इस्तेमाल करें:

Directory appDocDir = await getApplicationDocumentsDirectory();
String filePath = '${appDocDir.absolute}/file-to-upload.png';
File file = File(filePath);

try {
  await mountainsRef.putFile(file);
} on firebase_core.FirebaseException catch (e) {
  // ...
}

किसी स्ट्रिंग से अपलोड करें

putString() तरीके का इस्तेमाल करके, रॉ, base64, base64url या data_url कोड में बदली गई स्ट्रिंग के तौर पर डेटा अपलोड किया जा सकता है. उदाहरण के लिए, डेटा यूआरएल के तौर पर एन्कोड की गई टेक्स्ट स्ट्रिंग को अपलोड करने के लिए:

String dataUrl = 'data:text/plain;base64,SGVsbG8sIFdvcmxkIQ==';

try {
  await mountainsRef.putString(dataUrl, format: PutStringFormat.dataUrl);
} on FirebaseException catch (e) {
  // ...
}

अपरिष्कृत डेटा अपलोड करना

उन मामलों में जहां स्ट्रिंग या File अपलोड करना व्यावहारिक नहीं होता है, वहां आप Uint8List के रूप में निचले स्तर के टाइप किए गए डेटा को अपलोड कर सकते हैं. इस मामले में, अपने डेटा के साथ putData() तरीके को कॉल करें:

try {
  // Upload raw data.
  await mountainsRef.putData(data);
} on firebase_core.FirebaseException catch (e) {
  // ...
}

डाउनलोड करने का यूआरएल पाएं

फ़ाइल अपलोड करने के बाद, आप Reference पर getDownloadUrl() तरीके को कॉल करके फ़ाइल डाउनलोड करने का यूआरएल पा सकते है:

await mountainsRef.getDownloadURL();

फ़ाइल मेटाडेटा जोड़ें

फ़ाइलें अपलोड करते समय भी मेटाडेटा को शामिल किया जा सकता है. इस मेटाडेटा में सामान्य फ़ाइल मेटाडेटा प्रॉपर्टी होती हैं, जैसे कि contentType (इसे आम तौर पर MIME टाइप कहा जाता है). putFile() तरीका, File एक्सटेंशन से MIME टाइप का अपने-आप अनुमान लगा लेता है. हालांकि, मेटाडेटा में contentType तय करके, अपने-आप पता लगाए जाने वाले टाइप को बदला जा सकता है. अगर आप contentType नहीं देते हैं और Cloud Storage, फ़ाइल एक्सटेंशन से डिफ़ॉल्ट अनुमान नहीं लगा पाता है, तो Cloud Storage, application/octet-stream का इस्तेमाल करता है. फ़ाइल मेटाडेटा का इस्तेमाल करना देखें.

try {
  await mountainsRef.putFile(file, SettableMetadata(
    contentType: "image/jpeg",
  ));
} on firebase_core.FirebaseException catch (e) {
  // ...
}

अपलोड प्रबंधित करें

अपलोड शुरू करने के अलावा, आपके पास pause(), resume(), और cancel() तरीके इस्तेमाल करके, अपलोड को रोकने, फिर से शुरू करने, और रद्द करने का विकल्प होता है. इवेंट रोकने और फिर से शुरू करने की रेंज में, pause और progress इवेंट की सेटिंग में बदलाव होता है. किसी अपलोड को रद्द करने से, अपलोड नहीं हो पाता है और आपको गड़बड़ी का यह मैसेज मिलता है कि अपलोड रद्द हो गया है.

final task = mountainsRef.putFile(largeFile);

// Pause the upload.
bool paused = await task.pause();
print('paused, $paused');

// Resume the upload.
bool resumed = await task.resume();
print('resumed, $resumed');

// Cancel the upload.
bool canceled = await task.cancel();
print('canceled, $canceled');

अपलोड की स्थिति पर नज़र रखें

अपलोड किए जा रहे टास्क के पूरा होने, फ़ेल होने, प्रोग्रेस होने या रुकने का पता लगाने के लिए, टास्क की इवेंट स्ट्रीम सुनी जा सकती है:

इवेंट टाइप आम तौर पर इस्तेमाल किए जाने वाले तरीके
TaskState.running डेटा ट्रांसफ़र होने पर, यह डेटा समय-समय पर जनरेट होता है. इसका इस्तेमाल, अपलोड/डाउनलोड इंडिकेटर को पॉप्युलेट करने के लिए किया जा सकता है.
TaskState.paused टास्क को रोकने पर किसी भी समय मिटा दिया जाता है.
TaskState.success टास्क पूरा होने के बाद, फ़ीड का डेटा मिट जाता है.
TaskState.canceled टास्क रद्द किए जाने पर भी मिट जाता है.
TaskState.error फ़ाइल अपलोड न हो पाने पर, यह फ़ीड भेज दिया जाता है. नेटवर्क के टाइम आउट होने, अनुमति न मिलने या टास्क रद्द करने की वजह से ऐसा हो सकता है. 
mountainsRef.putFile(file).snapshotEvents.listen((taskSnapshot) {
  switch (taskSnapshot.state) {
    case TaskState.running:
      // ...
      break;
    case TaskState.paused:
      // ...
      break;
    case TaskState.success:
      // ...
      break;
    case TaskState.canceled:
      // ...
      break;
    case TaskState.error:
      // ...
      break;
  }
});

गड़बड़ी ठीक करना

अपलोड करते समय गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, डिवाइस पर मौजूद फ़ाइल का मौजूद न होना या उपयोगकर्ता को अपनी पसंद की फ़ाइल अपलोड करने की अनुमति न होना. आपको दस्तावेज़ों के गड़बड़ियां मैनेज करना सेक्शन में, गड़बड़ियों के बारे में ज़्यादा जानकारी मिल सकती है.

पूरा उदाहरण

प्रोग्रेस मॉनिटर करने और गड़बड़ियों को ठीक करने के तरीके के साथ अपलोड का पूरा उदाहरण नीचे दिया गया है:

final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/path/to/mountains.jpg";
final file = File(filePath);

// Create the file metadata
final metadata = SettableMetadata(contentType: "image/jpeg");

// Create a reference to the Firebase Storage bucket
final storageRef = FirebaseStorage.instance.ref();

// Upload file and metadata to the path 'images/mountains.jpg'
final uploadTask = storageRef
    .child("images/path/to/mountains.jpg")
    .putFile(file, metadata);

// Listen for state changes, errors, and completion of the upload.
uploadTask.snapshotEvents.listen((TaskSnapshot taskSnapshot) {
  switch (taskSnapshot.state) {
    case TaskState.running:
      final progress =
          100.0 * (taskSnapshot.bytesTransferred / taskSnapshot.totalBytes);
      print("Upload is $progress% complete.");
      break;
    case TaskState.paused:
      print("Upload is paused.");
      break;
    case TaskState.canceled:
      print("Upload was canceled");
      break;
    case TaskState.error:
      // Handle unsuccessful uploads
      break;
    case TaskState.success:
      // Handle successful uploads on complete
      // ...
      break;
  }
});

अब जब आपने फ़ाइलें अपलोड कर ली हैं, तो आइए अब Cloud Storage से उन्हें डाउनलोड करने का तरीका जानें.