इस क्विकस्टार्ट में, आपको एक छोटा सैंपल डेटाबेस बनाने और उसे डिप्लॉय करने का तरीका बताया जाएगा. साथ ही, इसे Flutter फ़्रंटएंड से ऐक्सेस करने का तरीका भी बताया जाएगा.
ज़रूरी शर्तें
क्विकस्टार्ट को पूरा करने के लिए, आपको इनकी ज़रूरत होगी:
- ऐसा एनवायरमेंट जिसमें ये टूल इंस्टॉल हों:
- Node.js के साथ अपनी पसंद का पैकेज मैनेजर. इस ट्यूटोरियल में यह माना गया है कि
npm. - Firebase CLI:
npm i -g firebase-tools@latest - Flutter कमांड लाइन टूल.
- FlutterFire CLI
dart pub global activate flutterfire_cli
- Node.js के साथ अपनी पसंद का पैकेज मैनेजर. इस ट्यूटोरियल में यह माना गया है कि
- Google खाता.
ट्यूटोरियल
| ट्यूटोरियल | |
|---|---|
1. अपना प्रोजेक्ट शुरू करनानई डायरेक्ट्री बनाएं और उसमें Firebase प्रोजेक्ट शुरू करें. जब कहा जाए, तब यहां दिए गए विकल्प चुनें:
|
|
2. GraphQL की परिभाषाओं का उदाहरण देखनाData Connect में, GraphQL का इस्तेमाल करके अपने सभी डेटाबेस स्कीमा और ऑपरेशन तय किए जाते हैं. प्रोजेक्ट शुरू करते समय, Firebase CLI ने कुछ उदाहरण परिभाषाएं बनाई थीं, ताकि आप शुरू कर सकें. |
dataconnect/schema/schema.gql (excerpt)
type Movie @table { title: String! imageUrl: String! genre: String } type MovieMetadata @table { movie: Movie! @unique rating: Float releaseYear: Int description: String } query ListMovies @auth(level: PUBLIC) { movies { id title imageUrl genre } } |
3. अपने स्कीमा और कार्रवाइयां डिप्लॉय करनाजब भी अपने डेटाबेस स्कीमा, क्वेरी या म्यूटेशन में बदलाव किए जाते हैं, तो आपको उन्हें डिप्लॉय करना होगा. ऐसा करने पर ही, डेटाबेस पर बदलाव लागू होंगे. |
|
4. डेटाबेस में सैंपल डेटा डालनाइस सीड डेटा से, आपको सैंपल ऐप्लिकेशन की जांच करते समय कुछ डेटा देखने को मिलेगा. ध्यान दें कि इस चरण में, आपको मनमुताबिक GraphQL को लागू करना होगा. इसकी अनुमति एडमिन से जुड़े कामों के लिए दी जाती है. |
|
5. Dart क्लाइंट एसडीके जनरेट करनायह कमांड, आपके GraphQL डेफ़िनिशन का इस्तेमाल करके, खास तौर पर आपके डेटाबेस के लिए एक Dart लाइब्रेरी जनरेट करती है. इस लाइब्रेरी का इस्तेमाल, क्लाइंट ऐप्लिकेशन में सभी डेटाबेस ऑपरेशन करने के लिए किया जाता है.
|
class ExampleConnector { ListMoviesVariablesBuilder listMovies() { return ListMoviesVariablesBuilder(dataConnect); } // ... } |
6. Flutter ऐप्लिकेशन सेट अप करनाअपने Firebase प्रोजेक्ट का इस्तेमाल करने के लिए, Flutter ऐप्लिकेशन को सेट अप करने के लिए इन कमांड को चलाएं.
|
|
7. Flutter क्लाइंट का सैंपल लिखेंइस आसान Flutter ऐप्लिकेशन की मदद से, ध्यान दें कि ऐप्लिकेशन, जनरेट किए गए एसडीके के फ़ंक्शन का इस्तेमाल करके, ज़रूरी डेटाबेस ऐक्सेस करता है. |
import 'package:firebase_core/firebase_core.dart'; import 'package:firebase_data_connect/firebase_data_connect.dart'; import 'package:flutter/material.dart'; import 'package:flutter_app/dataconnect_generated/generated.dart'; import 'package:flutter_app/firebase_options.dart'; class MyApp extends StatelessWidget { late final Future<QueryResult<ListMoviesData, void>> _movieListFuture; MyApp({super.key}) { _movieListFuture = ExampleConnector.instance .listMovies() .execute(); } @override Widget build(BuildContext context) { return MaterialApp( home: FutureBuilder( future: _movieListFuture, builder: (context, snapshot) { if (snapshot.connectionState == ConnectionState.done) { return ListView.builder( scrollDirection: Axis.vertical, itemBuilder: (context, index) => Card( child: Text( snapshot.data?.data.movies[index].title ?? "", ), ), itemCount: snapshot.data?.data.movies.length ?? 0, ); } return const CircularProgressIndicator(); }, ), ); } } Future<void> main() async { await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, ); runApp(MyApp()); } |
8. ऐप्लिकेशन आज़माएंउदाहरण ऐप्लिकेशन को काम करते हुए देखने के लिए, डेवलपमेंट सर्वर शुरू करें. |
|
अगले चरण
Visual Studio Code एक्सटेंशन आज़माना
Data Connect का इस्तेमाल करके डेवलपमेंट करते समय, हमारा सुझाव है कि आप Visual Studio Code एक्सटेंशन का इस्तेमाल करें. अगर आपने Visual Studio Code को अपने प्राइमरी डेवलपमेंट एनवायरमेंट के तौर पर इस्तेमाल नहीं किया है, तो भी एक्सटेंशन कई ऐसी सुविधाएं देता है जिनसे स्कीमा और ऑपरेशन डेवलपमेंट को ज़्यादा आसानी से किया जा सकता है:
- GraphQL लैंग्वेज सर्वर, जो Data Connect के लिए सिंटैक्स की जांच करने और ऑटोकंप्लीट के सुझाव देने की सुविधा देता है
- आपके कोड के साथ लाइन में CodeLens बटन होते हैं. इनकी मदद से, स्कीमा की परिभाषा वाली फ़ाइलों से डेटा पढ़ा और लिखा जा सकता है. साथ ही, ऑपरेशन की परिभाषाओं से क्वेरी और म्यूटेशन लागू किए जा सकते हैं.
- जनरेट किए गए एसडीके को GraphQL की परिभाषाओं के साथ अपने-आप सिंक करके रखें.
- लोकल एम्युलेटर को आसानी से सेट अप किया जा सकता है.
- आसानी से प्रोडक्शन में डिप्लॉय करने की सुविधा.
लोकल डेवलपमेंट के लिए Data Connect एम्युलेटर का इस्तेमाल करना
इस ट्यूटोरियल में, Data Connect स्कीमा और कार्रवाइयों को सीधे तौर पर प्रोडक्शन में डिप्लॉय करने का तरीका बताया गया है. हालांकि, ऐप्लिकेशन को डेवलप करते समय, आपको प्रोडक्शन डेटाबेस में बदलाव नहीं करने चाहिए. इसके बजाय, Data Connect एम्युलेटर सेट अप करें और प्रोडक्शन के बजाय, इस पर डेवलपमेंट का काम करें. यह एम्युलेटर, लोकल PGlite इंस्टेंस सेट अप करता है. यह CloudSQL पर मौजूद लाइव Postgres इंस्टेंस की तरह काम करता है.
अपने ऐप्लिकेशन के लिए स्कीमा और ऑपरेशन लिखने का तरीका जानें
Data Connect की मदद से ऐप्लिकेशन डेवलप करते समय, आपको सबसे पहले और सबसे ज़रूरी डेवलपमेंट टास्क के तौर पर, अपने स्कीमा और ऑपरेशन का डिज़ाइन तैयार करना होगा.
- Firebase कंसोल में Gemini एक एआई टूल है. यह आपके ऐप्लिकेशन के बारे में सामान्य भाषा में दी गई जानकारी से Data Connect स्कीमा जनरेट कर सकता है. इस टूल की मदद से, बहुत कम समय में काम शुरू किया जा सकता है. खास तौर पर, अगर आपने पहले कभी रिलेशनल डेटाबेस के साथ काम नहीं किया है.
- इसके अलावा, GraphQL का इस्तेमाल करके सीधे तौर पर डेटाबेस स्कीमा, क्वेरी, और म्यूटेशन लिखे जा सकते हैं. डिज़ाइन Data Connect स्कीमा पेज से शुरू करें. इसके बाद, फ़ॉलो-अप पेजों पर जाकर, ऑपरेशन लिखने का तरीका जानें.