Apple प्लैटफ़ॉर्म पर Cloud Storage का इस्तेमाल शुरू करना

Cloud Storage for Firebase की मदद से, इमेज और वीडियो जैसे यूज़र जनरेटेड कॉन्टेंट (यूजीसी) को अपलोड और शेयर किया जा सकता है. इससे, अपने ऐप्लिकेशन में रिच मीडिया कॉन्टेंट बनाया जा सकता है. आपका डेटा, Google Cloud Storage बकेट में सेव होता है. यह एक ऐसा ऑब्जेक्ट स्टोरेज सलूशन है जो एक्जाबाइट के स्केल पर काम करता है. इसमें डेटा को आसानी से ऐक्सेस किया जा सकता है और दुनिया भर में डेटा का बैकअप मौजूद होता है. Cloud Storage for Firebase की मदद से, इन फ़ाइलों को सीधे मोबाइल डिवाइसों और वेब ब्राउज़र से सुरक्षित तरीके से अपलोड किया जा सकता है. साथ ही, खराब नेटवर्क की समस्या को आसानी से हल किया जा सकता है.

शुरू करने से पहले

  1. अगर आपने अब तक Apple के प्लैटफ़ॉर्म पर ऐप्लिकेशन बनाने के लिए शुरुआती गाइड को पूरा नहीं किया है, तो इसे ज़रूर पूरा करें. इसमें इस तरह का कॉन्टेंट शामिल है:

    • Firebase प्रोजेक्ट बनाना.

    • अपने Apple प्लैटफ़ॉर्म ऐप्लिकेशन को प्रोजेक्ट के साथ रजिस्टर करना और अपने ऐप्लिकेशन में Firebase लाइब्रेरी और Firebase कॉन्फ़िगरेशन फ़ाइल (GoogleService-Info.plist) जोड़कर, अपने ऐप्लिकेशन को Firebase से कनेक्ट करना.

  2. पक्का करें कि आपका Firebase प्रोजेक्ट, इस्तेमाल के हिसाब से पैसे चुकाने वाले ब्लेज़ प्लान पर हो. अगर आपने Firebase और Google Cloud का इस्तेमाल पहले कभी नहीं किया है, तो देखें कि क्या आपके पास 300 डॉलर के क्रेडिट पाने की ज़रूरी शर्तें पूरी हैं.

डिफ़ॉल्ट Cloud Storage बकेट बनाना

  1. Firebase कंसोल के नेविगेशन पैनल से, स्टोरेज चुनें.

    अगर आपका प्रोजेक्ट अब तक, 'इस्तेमाल के हिसाब से पैसे चुकाएं' वाले Blaze प्लान पर नहीं है, तो आपको प्रोजेक्ट को अपग्रेड करने के लिए कहा जाएगा.

  2. शुरू करें पर क्लिक करें.

  3. अपनी डिफ़ॉल्ट बकेट के लिए कोई जगह चुनें.

  4. अपनी डिफ़ॉल्ट बकेट के लिए Firebase Security Rules को कॉन्फ़िगर करें. ऐप्लिकेशन डेवलप करने के दौरान, सार्वजनिक ऐक्सेस के लिए नियम सेट अप करना न भूलें.

  5. हो गया पर क्लिक करें.

अब Firebase कंसोल के Cloud Storage फ़ाइलें टैब में जाकर, बकेट देखी जा सकती है. आपकी बकेट के नाम का डिफ़ॉल्ट फ़ॉर्मैट, PROJECT_ID.firebasestorage.app है.

सार्वजनिक ऐक्सेस सेट अप करना

Cloud Storage for Firebase, नियमों की ऐसी भाषा उपलब्ध कराता है जिससे यह तय किया जा सकता है कि आपके डेटा का स्ट्रक्चर कैसा होना चाहिए, उसे कैसे इंडेक्स किया जाना चाहिए, और आपके डेटा को कब पढ़ा और लिखा जा सकता है. डिफ़ॉल्ट रूप से, Cloud Storage को पढ़ने और उसमें बदलाव करने पर पाबंदी होती है. इसलिए, सिर्फ़ पुष्टि किए गए उपयोगकर्ता ही डेटा पढ़ सकते हैं या उसमें बदलाव कर सकते हैं. Authentication सेट अप किए बिना शुरू करने के लिए, आपके पास सार्वजनिक ऐक्सेस के लिए अपने नियम कॉन्फ़िगर करने का विकल्प है.

ऐसा करने पर, Cloud Storage सभी के लिए खुल जाता है. यहां तक कि वे लोग भी Cloud Storage को ऐक्सेस कर सकते हैं जो आपके ऐप्लिकेशन का इस्तेमाल नहीं करते. इसलिए, पुष्टि करने की सुविधा सेट अप करते समय, Cloud Storage पर फिर से पाबंदी लगाना न भूलें.

अपने ऐप्लिकेशन में Cloud Storage जोड़ना

Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift Package Manager का इस्तेमाल करें.

अपने Apple प्रोजेक्ट में Firebase SDK टूल जोड़ने के अलग-अलग तरीकों के बारे में जानने के लिए,
  1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलकर, फ़ाइल > पैकेज जोड़ें पर जाएं.
  2. जब कहा जाए, तब Firebase के Apple प्लैटफ़ॉर्म के SDK टूल का रिपॉज़िटरी जोड़ें:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Cloud Storage लाइब्रेरी चुनें.
  4. अपने टारगेट की बिल्ड सेटिंग के अन्य लिंकर फ़्लैग सेक्शन में -ObjC फ़्लैग जोड़ें.
  5. प्रोसेस पूरी होने के बाद, Xcode बैकग्राउंड में आपकी डिपेंडेंसी को अपने-आप हल और डाउनलोड करना शुरू कर देगा.

अपने ऐप्लिकेशन में Cloud Storage सेट अप करना

  1. Firebase का कोई भी रेफ़रंस बनाने या इस्तेमाल करने से पहले, Firebase को शुरू करें.

    अगर आपने पहले ही कोई दूसरा Firebase प्रॉडक्ट सेट अप कर लिया है, तो हो सकता है कि आपने यह काम पहले ही कर लिया हो. हालांकि, आपको अपनी इंपोर्ट की सूची में FirebaseStorage लाइब्रेरी को ज़रूर जोड़ना होगा.

    1. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल और FirebaseStorage मॉड्यूल इंपोर्ट करें. हमारा सुझाव है कि आप FirebaseAuth भी जोड़ें.

      SwiftUI 

      import SwiftUI
import FirebaseCore
import FirebaseStorage
import FirebaseAuth
// ...

      Swift 

      import FirebaseCore
import FirebaseStorage
import FirebaseAuth
// ...

      Objective-C 

      @import FirebaseCore;
@import FirebaseStorage;
@import FirebaseAuth;
// ...

    2. अपने ऐप्लिकेशन डेलीगेट के application(_:didFinishLaunchingWithOptions:) तरीके में, FirebaseApp शेयर किया गया इंस्टेंस कॉन्फ़िगर करें:

      SwiftUI 

      // Use Firebase library to configure APIs
FirebaseApp.configure()

      Swift 

      // Use Firebase library to configure APIs
FirebaseApp.configure()

      Objective-C 

      // Use Firebase library to configure APIs
[FIRApp configure];

    3. (सिर्फ़ SwiftUI के लिए) ऐप्लिकेशन डेलिगेट बनाएं और UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor का इस्तेमाल करके, उसे अपने App स्ट्रक्चर से अटैच करें. आपको ऐप्लिकेशन डेलीगेट के स्विज़ल करने की सुविधा भी बंद करनी होगी. ज़्यादा जानकारी के लिए, SwiftUI के निर्देश देखें.

      SwiftUI 

      @main
struct YourApp: App {
  // Register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  2. डिफ़ॉल्ट Firebase ऐप्लिकेशन का इस्तेमाल करके, Cloud Storage सेवा का रेफ़रंस पाएं.

    1. पक्का करें कि आपके ऐप्लिकेशन के कोडबेस में मौजूद Firebase कॉन्फ़िगरेशन फ़ाइल (GoogleService-Info.plist), डिफ़ॉल्ट Cloud Storageबकेट के नाम से अपडेट की गई हो.

      1. अपनी अपडेट की गई कॉन्फ़िगरेशन फ़ाइल पाएं..

      2. डाउनलोड की गई इस config फ़ाइल का इस्तेमाल करके, अपने Xcode प्रोजेक्ट के रूट में मौजूद GoogleService-Info.plist फ़ाइल को बदलें. अगर आपसे कहा जाए, तो सभी टारगेट में कॉन्फ़िगरेशन फ़ाइल जोड़ने का विकल्प चुनें.

        पक्का करें कि आपके ऐप्लिकेशन में सिर्फ़ डाउनलोड की गई सबसे नई कॉन्फ़िगरेशन फ़ाइल हो और उसके फ़ाइल नाम में (2) जैसे अन्य वर्ण न जोड़े गए हों.

    2. डिफ़ॉल्ट Firebase ऐप्लिकेशन का इस्तेमाल करके, Cloud Storage सेवा का रेफ़रंस पाएं:

      Swift 

      let storage = Storage.storage()
       
      // Alternatively, explicitly specify the bucket name URL.
storage = Storage.storage(url:"gs://BUCKET_NAME")

      Objective-C 

      FIRStorage *storage = [FIRStorage storage];
       
      // Alternatively, explicitly specify the bucket name URL.
// FIRStorage storage = [FIRStorage storageWithURL:@"gs://BUCKET_NAME"];

अब Cloud Storage का इस्तेमाल किया जा सकता है!

अगला चरण क्या है? Cloud Storage रेफ़रंस बनाने का तरीका जानें.

बेहतर सेटअप

इस्तेमाल के कुछ उदाहरणों के लिए, अलग से सेटअप करने की ज़रूरत होती है:

पहला इस्तेमाल का उदाहरण तब सही है, जब आपके उपयोगकर्ता दुनिया भर में हों और आपको उनके डेटा को उनके आस-पास सेव करना हो. उदाहरण के लिए, अमेरिका, यूरोप, और एशिया में बकेट बनाई जा सकती हैं, ताकि उन इलाकों के उपयोगकर्ताओं के लिए डेटा स्टोर किया जा सके और रीडायरेक्ट में लगने वाला समय कम किया जा सके.

दूसरा इस्तेमाल का उदाहरण तब मददगार होता है, जब आपके पास अलग-अलग ऐक्सेस पैटर्न वाला डेटा हो. उदाहरण के लिए: एक से ज़्यादा क्षेत्रों या क्षेत्र के हिसाब से बकेट सेट अप की जा सकती है. इसमें फ़ोटो या अक्सर ऐक्सेस किया जाने वाला कॉन्टेंट सेव किया जाता है. साथ ही, नेरललाइन या कोल्डलाइन बकेट सेट अप की जा सकती है. इसमें उपयोगकर्ता के बैकअप या अक्सर ऐक्सेस न किया जाने वाला कॉन्टेंट सेव किया जाता है.

इस्तेमाल के इन दोनों उदाहरणों में, आपको एक से ज़्यादा Cloud Storage बकेट का इस्तेमाल करना होगा.

तीसरा इस्तेमाल का उदाहरण तब काम आता है, जब Google Drive जैसे ऐप्लिकेशन को बनाया जा रहा हो. इस ऐप्लिकेशन में, उपयोगकर्ताओं को एक से ज़्यादा खातों से लॉग इन करने की सुविधा मिलती है. उदाहरण के लिए, निजी खाता और काम से जुड़ा खाता. हर दूसरे खाते की पुष्टि करने के लिए, कस्टम Firebase ऐप्लिकेशन के इंस्टेंस का इस्तेमाल किया जा सकता है.

एक से ज़्यादा Cloud Storage बकेट का इस्तेमाल करना

अगर आपको ऊपर दिए गए डिफ़ॉल्ट के अलावा किसी अन्य Cloud Storage बकेट का इस्तेमाल करना है या किसी एक ऐप्लिकेशन में कई Cloud Storage बकेट का इस्तेमाल करना है, तो FIRStorage का ऐसा इंस्टेंस बनाएं जो आपकी कस्टम बकेट का रेफ़रंस देता हो:

Swift

// Get a non-default Cloud Storage bucket
storage = Storage.storage(url:"gs://my-custom-bucket")

Objective-C

// Get a non-default Cloud Storage bucket
FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];

इंपोर्ट की गई बकेट के साथ काम करना

Firebase में किसी मौजूदा Cloud Storage बकेट को इंपोर्ट करते समय, आपको Firebase को इन फ़ाइलों को ऐक्सेस करने की अनुमति देनी होगी. इसके लिए, Google Cloud SDK में शामिल gsutil टूल का इस्तेमाल करें:

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

Firebase प्रोजेक्ट के बारे में जानकारी में बताए गए तरीके से, अपना प्रोजेक्ट नंबर देखा जा सकता है.

इसका असर, हाल ही में बनाई गई बकेट पर नहीं पड़ता. इसकी वजह यह है कि उनमें डिफ़ॉल्ट रूप से ऐक्सेस कंट्रोल सेट होता है, ताकि Firebase को अनुमति दी जा सके. यह कुछ समय के लिए है. आने वाले समय में, यह कार्रवाई अपने-आप की जाएगी.

कस्टम Firebase ऐप्लिकेशन का इस्तेमाल करना

अगर कस्टम FirebaseApp का इस्तेमाल करके, ज़्यादा जटिल ऐप्लिकेशन बनाया जा रहा है, तो उस ऐप्लिकेशन के साथ शुरू किए गए Storage का इंस्टेंस बनाया जा सकता है:

Swift

// Get the default bucket from a custom FirebaseApp
storage = Storage.storage(app:customApp)

// Get a non-default bucket from a custom FirebaseApp
storage = Storage.storage(app:customApp, url:"gs://my-custom-bucket")

Objective-C

// Get the default bucket from a custom FIRApp
FIRStorage storage = [FIRStorage storageForApp:customApp];

// Get a non-default bucket from a custom FIRApp
FIRStorage storage = [FIRStorage storageForApp:customApp withURL:@"gs://my-custom-bucket"];

अगले चरण