உங்கள் சொந்த Firebase திட்டத்தைப் பயன்படுத்துதல்

Firebase என்பது Google-இன் செயலிச் சேவைகளின் தொகுப்பு: Firestore என்ற ஆவணத் தரவுத்தளம், உள்நுழைவு, கோப்புச் சேமிப்பு, புஷ் அறிவிப்புகள் மற்றும் பல. உங்களிடம் ஏற்கெனவே ஒரு Firebase திட்டம் இருந்தால் (ஒருவேளை ஏற்கெனவே உள்ள மொபைல் செயலியுடன்), அதை ஒரு MonstarX செயலியுடன் இணைத்து, அதிலிருந்து அந்தச் சேவைகளில் எதையும் பயன்படுத்தலாம்.

Firebase-ஐ ஒரு வேலைக்கு மட்டும் பயன்படுத்தலாம் (உதாரணமாக, உங்கள் மொபைல் செயலியின் பயனர்களுக்குப் புஷ் அறிவிப்புகள் அனுப்ப). அல்லது Firestore-ஐச் செயலியின் தரவுத்தளமாக ஆக்கலாம்; அப்போது உங்கள் இணையச் செயலியும் மற்ற செயலிகளும் ஒரே தரவைப் பகிர்ந்துகொள்ளும்.

தொடங்குவதற்கு முன்

• ஒரு Firebase திட்டமும், Firebase console-இல் அதன் அமைப்புகளுக்கான அணுகலும்.
• Firebase Authentication மூலம் மக்களை உள்நுழையச் செய்ய, அந்த Firebase திட்டத்தில் சேர்க்கப்பட்ட ஒரு web app.

Firebase-ஐ இணைப்பது எப்படி?

1. Firebase console-இல் Project settings → Service accounts பகுதியைத் திறந்து, Generate new private key என்பதைக் கிளிக் செய்யுங்கள். ஒரு JSON கோப்பு பதிவிறங்கும்.

2. MonstarX-இல் உங்கள் திட்டத்தைத் திறந்து, மேல் பட்டியில் உள்ள பின்தளம் என்பதையும், பிறகு கிளவுட் என்பதையும் கிளிக் செய்யுங்கள்.

3. இணைப்பிகள் என்பதன் கீழ், Firebase அருகே உள்ள இணை என்பதைக் கிளிக் செய்யுங்கள்.

4. JSON கோப்பை ஓர் உரை எடிட்டரில் திறந்து, அதை முழுவதுமாக நகலெடுத்து, சேவைக் கணக்கு விசைக் கோப்பு என்பதில் ஒட்டுங்கள். உங்கள் திட்டத்தின் id-ஐ MonstarX அதிலிருந்து படிக்கும்.

5. விருப்பப் புலங்களைத் தேவைப்பட்டால் மட்டும் நிரப்புங்கள்:

   • இணைய API விசை: Project settings → General → Your apps → Web app → apiKey பகுதியிலிருந்து. Firebase Authentication மூலம் மக்களை உள்நுழையச் செய்ய மட்டுமே தேவை.
   • சேமிப்பகப் பக்கெட்: உங்கள் கோப்புகள் திட்டத்தின் இயல்புநிலைப் பக்கெட்டில் இல்லையென்றால் மட்டும்.
   • Realtime Database-இன் URL: Realtime Database-க்கு மட்டும். Firestore-க்கு இங்கே எதுவும் தேவையில்லை.

   

6. Firebase-ஐ இணை என்பதைக் கிளிக் செய்யுங்கள். சேமிப்பதற்கு முன் MonstarX விசையை Google-இடம் சரிபார்க்கும். அது கண்டறிந்ததை இணைக்கப்பட்டது அருகே காட்டும்: உங்கள் திட்டத்தின் id-யும் அதன் Firestore தொகுப்புகளும், அல்லது “இதுவரை Firestore தரவுத்தளம் இல்லை”.

தவறான கோப்பை ஒட்டினால் (உதாரணமாக, சேவைக் கணக்கு விசைக்குப் பதிலாகச் சிறிய web app config), MonstarX அதை மறுத்து, எந்தப் புலங்கள் இல்லை என்று சொல்லும்.

எச்சரிக்கை

சேவைக் கணக்கு விசையால் உங்கள் Firebase திட்டத்தில் எதையும் செய்ய முடியும். அதை இந்தப் படிவத்தில் மட்டுமே ஒட்டுங்கள்; அரட்டையிலோ உங்கள் செயலியின் குறியீட்டிலோ ஒருபோதும் வேண்டாம். MonstarX அதை மறையாக்கம் செய்து வைத்திருக்கும்; செயலியின் சேவையகத்தில் மட்டுமே பயன்படுத்தும்.

Firebase-ஐக் கொண்டு என் செயலி என்ன செய்யலாம்?

இணைத்ததும், “ஒரு வகுப்பு ரத்தானால் உறுப்பினர்களுக்குப் புஷ் அறிவிப்பு அனுப்பு” என்பது போல எளிய சொற்களில் அம்சத்தைக் கேளுங்கள். MonstarX அதை Firebase கொண்டு உருவாக்கும்:

Firebase சேவை	உங்கள் செயலி செய்யக்கூடியது
Firestore	ஆவணங்களைச் சேர்க்கலாம், படிக்கலாம், தேடலாம், புதுப்பிக்கலாம், நீக்கலாம்; எண்ணலாம்
Authentication	மக்களைப் பதிவுசெய்யவும் உள்நுழையவும் வைக்கலாம், கடவுச்சொற்களை மீட்டமைக்கலாம், பயனர்களை நிர்வகிக்கலாம் (இணைய API விசை தேவை)
Cloud Storage	கோப்புகளைப் பதிவேற்றலாம், அவற்றின் பதிவிறக்க இணைப்புகளைப் பெறலாம், பட்டியலிடலாம், நீக்கலாம்
Cloud Messaging	ஒரு சாதனத்துக்கோ ஒரு topic-க்கோ புஷ் அறிவிப்புகள் அனுப்பலாம்
Realtime Database	தரவைப் படிக்கலாம், எழுதலாம் (Realtime Database URL தேவை)

எல்லாம் உங்கள் செயலியின் சேவையகத்திலேயே இயங்கும்; அதனால் பார்வையாளர்கள் உங்கள் விசையை ஒருபோதும் பார்க்க மாட்டார்கள்.

Firestore என் செயலியின் தரவுத்தளமாக இருக்கலாமா?

ஆம். ஒவ்வொரு செயலியும் MonstarX-இன் சொந்தத் தரவுத்தளத்துடன் தொடங்கும்; ஆனால் அதற்குப் பதிலாக Firestore-ஐத் தரவை வைக்கும் இடமாக ஆக்கலாம்.

1. முதலில் Firebase-ஐ இணையுங்கள் (மேலே பாருங்கள்).

2. பின்தளம்›கிளவுட் பகுதியில், இந்தச் செயலி தரவைச் சேமிக்கும் இடம் என்பதைக் கண்டுபிடியுங்கள்.

3. Firestore (உங்கள் Firebase திட்டம்) என்பதைத் தேர்ந்தெடுங்கள். Firebase இணைக்கப்படுவதற்கு முன், அது “முதலில் Firebase-ஐ இணைக்கவும்” எனக் காட்டும்; தேர்ந்தெடுக்க முடியாது.

   

4. செயலியில் ஏற்கெனவே தரவு இருந்தால், அதைக் கொண்டுவர இருக்கும் தரவை நகலெடு என்பதைக் கிளிக் செய்து உறுதிப்படுத்துங்கள்.

அதன் பிறகு:

• MonstarX அட்டவணைகளுக்குப் பதிலாக தொகுப்புகளையும் (collections) ஆவணங்களையும் (documents) கொண்டு உருவாக்கும். குறியீடு எழுதுவதற்கு முன் உங்கள் உண்மையான தொகுப்புகளைப் பார்க்கும்; உங்கள் தரவில் இல்லாத புலங்களை ஒருபோதும் கற்பனை செய்யாது.
• பின்தளம்›தரவுத்தளம் பகுதி உங்கள் Firestore தொகுப்புகள் என்பதையும் அவற்றின் ஆவணங்களையும் காட்டும். அங்கே அவை படிக்க மட்டுமே; அவற்றில் செயலி எழுதும்.
• கணக்குகள் MonstarX-இடமே இருக்கும். மக்கள் முன்பு போலவே உள்நுழைவார்கள்; பின்தளம்›பயனர்கள் பகுதியும் முன்பு போலவே வேலை செய்யும். அதனால்தான் MonstarX தன் சொந்தத் தரவுத்தளத்தை நீக்காமல் வைத்திருக்கிறது.

திரும்ப மாற, அதே இடத்தில் MonstarX தரவுத்தளம் என்பதைத் தேர்ந்தெடுங்கள். செயலி தன் சொந்தத் தரவுத்தளத்துக்கு, அது இருந்தபடியே திரும்பும்.

“இருக்கும் தரவை நகலெடு” என்ன செய்யும்?

• ஒவ்வோர் அட்டவணையும் அதே பெயரில் ஒரு தொகுப்பு (collection) ஆகும்; ஒவ்வொரு வரிசையும் ஒரு ஆவணம் (document) ஆகும். வரிசையின் id ஆவணத்தின் id ஆகும்.
• மீண்டும் இயக்கினால், அந்த ஆவணங்களை இரட்டிப்பாக்காமல் புதுப்பிக்கும்.
• நான்கு உள்நுழைவு அட்டவணைகளும், கணக்குகள் இருக்கும் MonstarX-இன் தரவுத்தளத்திலேயே இருக்கும்.
• இரண்டு இடங்களிலும் அது எதையும் நீக்காது.
• பெரிய செயலி பகுதி பகுதியாக நகலெடுக்கப்படலாம். கோரிக்கையைச் சுருக்கமாக வைக்க நிறுத்தியதாக அது சொன்னால், மீண்டும் இயக்குங்கள்; விட்ட இடத்திலிருந்து தொடரும்.

தெரிந்துகொள்ள வேண்டியவை

• Firestore அல்லது Supabase — இரண்டும் ஒரே நேரத்தில் அல்ல. ஒரு செயலி தன் தரவை ஓர் இடத்தில் மட்டுமே வைத்திருக்கும். Supabase-இலிருந்து Firestore-க்குப் போக, முதலில் தரவை MonstarX-இன் தரவுத்தளத்துக்குத் திருப்புங்கள். இருந்தாலும், சேமிப்பு, செய்தி அனுப்புதல், உள்நுழைவு ஆகியவற்றுக்கு Firebase இணைப்பி Supabase-உடன் சேர்ந்தே வேலை செய்யும்.
• உங்கள் செயலியில் Firebase SDK இல்லை. MonstarX உள்ளடங்கிய ஓர் உதவிக் கருவி மூலம் Firebase-ஐ அணுகும்; அது முன்னோட்டத்திலும் வெளியிட்ட செயலியிலும் ஒரே மாதிரி வேலை செய்யும்.
• மொபைல் சாதனங்களுக்குப் புஷ் அனுப்ப உங்கள் மொபைல் செயலியிலிருந்து ஒரு device token தேவை; செயலிக்குக் கொடுக்கப்படும் டோக்கன்களுக்கு MonstarX அனுப்பும்.
• Google Cloud Run-இல் வெளியிடுதல் வேறோர் இணைப்பி: பிற ஹோஸ்ட்களில் வெளியிடுதல் பக்கத்தைப் பாருங்கள்.

அடிக்கடி கேட்கப்படும் கேள்விகள்

சேவைக் கணக்கு விசைக் கோப்பை எங்கே கண்டுபிடிப்பது?

Firebase console-இல்: Project settings → Service accounts → Generate new private key. முழு JSON கோப்பையும் சேவைக் கணக்கு விசைக் கோப்பு என்பதில் ஒட்டுங்கள்.

புஷ் அறிவிப்புகளுக்கு மட்டும் Firebase-ஐப் பயன்படுத்தலாமா?

ஆம். Firebase-ஐ இணைத்தால் உங்கள் தரவு இடம் மாறாது. இந்தச் செயலி தரவைச் சேமிக்கும் இடம் என்பதில் Firestore-ஐத் தேர்ந்தெடுக்காத வரை, செயலி MonstarX-இன் தரவுத்தளத்தையே தொடர்ந்து பயன்படுத்தும்.

Firestore-க்கு மாறினால் என் பயனர்களுக்குப் புதிய கணக்குகள் தேவையா?

தேவையில்லை. கணக்குகள் MonstarX-இன் தரவுத்தளத்திலேயே இருக்கும்; உள்நுழைவு முன்பு போலவே வேலை செய்யும். செயலியின் சொந்தத் தரவு மட்டுமே Firestore-க்கு இடம் மாறும்.

“இதுவரை Firestore தரவுத்தளம் இல்லை” என்கிறது. இது சிக்கலா?

Firestore வேண்டுமென்றால் மட்டுமே. செயலிக்குச் சேமிப்பு, உள்நுழைவு அல்லது புஷ் மட்டுமே தேவைப்படலாம் என்பதால், இணைப்பு அப்போதும் வேலை செய்யும். Firestore-ஐப் பயன்படுத்த, Firebase console-இல் ஒரு Firestore தரவுத்தளத்தை உருவாக்குங்கள்.

என் தரவை நகலெடுத்தால் ஏதாவது நீக்கப்படுமா?

இல்லை. இருக்கும் தரவை நகலெடு Firestore-இல் ஆவணங்களைச் சேர்க்கும் அல்லது புதுப்பிக்கும் மட்டுமே. MonstarX-இன் சொந்தத் தரவுத்தளம் அப்படியே இருக்கும்.

தொடர்புடையவை

Supabaseஅதற்குப் பதிலாகத் தரவை உங்கள் சொந்த Postgres-இல் வையுங்கள்.

உங்கள் செயலியின் தரவுத்தளம்ஒவ்வொரு செயலியும் தொடங்கும் தரவுத்தளம்.

இணைப்பிகள்உங்கள் செயலி இணையக்கூடிய எல்லாச் சேவைகளும்.

பயனர் கணக்குகள்உங்கள் செயலியில் பதிவும் உள்நுழைவும் எப்படி வேலை செய்கின்றன.