Tumia mradi wako wa Firebase

Firebase ni kundi la huduma za programu kutoka Google: hifadhidata ya hati inayoitwa Firestore, kuingia, hifadhi ya faili, arifa za push na zaidi. Ikiwa tayari una mradi wa Firebase — labda wenye programu ya simu iliyopo — unaweza kuunganisha mradi huo na programu ya MonstarX na kutumia huduma yoyote kati ya hizo kutoka humo.

Unaweza kutumia Firebase kwa jambo moja tu (kwa mfano, kutuma arifa za push kwa watumiaji wa programu yako ya simu) au kuifanya Firestore kuwa hifadhidata ya programu, ili programu yako ya wavuti na programu zako nyingine zitumie data ileile.

Kabla ya kuanza

• Mradi wa Firebase, na ufikiaji wa mipangilio yake kwenye Firebase console.
• Ili watu waingie kwa Firebase Authentication, programu ya wavuti (web app) iliyoongezwa kwenye mradi huo wa Firebase.

Ninaunganishaje Firebase?

1. Kwenye Firebase console, fungua Project settings → Service accounts na ubofye Generate new private key. Faili ya JSON inapakuliwa.

2. Kwenye MonstarX, fungua mradi wako na ubofye Huduma za wingu kwenye upau wa juu, kisha Wingu.

3. Chini ya Viunganishi, bofya Unganisha kando ya Firebase.

4. Fungua faili ya JSON kwenye kihariri cha maandishi, nakili maudhui yake yote, kisha uyabandike kwenye Faili ya ufunguo wa akaunti ya huduma. MonstarX inasoma ID ya mradi wako kutoka humo.

5. Jaza sehemu za hiari tu ikiwa unazihitaji:

   • Ufunguo wa Web API — kutoka Project settings → General → Your apps → Web app → apiKey. Unahitajika tu ili watu waingie kwa Firebase Authentication.
   • Kontena la hifadhi — tu ikiwa faili zako haziko kwenye kontena la chaguo-msingi la mradi.
   • URL ya Realtime Database — kwa Realtime Database pekee. Firestore haihitaji chochote hapa.

   

6. Bofya Unganisha Firebase. MonstarX inakagua ufunguo kwa Google kabla ya kuuhifadhi, na kuonyesha ilichopata kando ya Imeunganishwa — ID ya mradi wako na mikusanyiko yake ya Firestore, au “bado hakuna hifadhidata ya Firestore”.

Ukibandika faili isiyo sahihi — kwa mfano usanidi mdogo wa programu ya wavuti badala ya ufunguo wa akaunti ya huduma — MonstarX inaikataa na kusema ni sehemu zipi zinakosekana.

Tahadhari

Ufunguo wa akaunti ya huduma unaweza kufanya chochote kwenye mradi wako wa Firebase. Ubandike kwenye fomu hii pekee, kamwe si kwenye mazungumzo wala kwenye msimbo wa programu yako. MonstarX huuhifadhi kwa usimbaji fiche na kuutumia kwenye seva ya programu pekee.

Programu yangu inaweza kufanya nini kwa Firebase?

Ukishaunganisha, omba kipengele kwa maneno ya kawaida, kama “tuma arifa ya push kwa wanachama darasa linapoghairiwa”. MonstarX inakiunda kwa Firebase:

Huduma ya Firebase	Programu yako inachoweza kufanya
Firestore	Kuongeza, kusoma, kutafuta, kusasisha na kufuta hati; kuzihesabu
Authentication	Kuwasajili na kuwaingiza watu, kuweka upya manenosiri, na kusimamia watumiaji (inahitaji ufunguo wa Web API)
Cloud Storage	Kupakia faili, kupata viungo vyake vya kupakua, kuziorodhesha na kuzifuta
Cloud Messaging	Kutuma arifa za push kwa kifaa au kwa mada fulani
Realtime Database	Kusoma na kuandika data (inahitaji URL ya Realtime Database)

Kila kitu huendeshwa kwenye seva ya programu yako, kwa hiyo wageni kamwe hawaoni ufunguo wako.

Je, Firestore inaweza kuwa hifadhidata ya programu yangu?

Ndiyo. Kila programu huanza na hifadhidata ya MonstarX yenyewe, lakini unaweza kuifanya Firestore kuwa mahali inapohifadhi data yake badala yake.

1. Unganisha Firebase kwanza (angalia hapo juu).

2. Kwenye Huduma za wingu›Wingu, tafuta Mahali programu hii inapohifadhi data yake.

3. Chagua Firestore (mradi wako wa Firebase). Kabla Firebase haijaunganishwa, chaguo hili linasema “unganisha Firebase kwanza” na haliwezi kuchaguliwa.

   

4. Ikiwa programu tayari ina data, bofya Nakili data iliyopo ili kuihamishia huko, kisha uthibitishe.

Kuanzia hapo:

• MonstarX inaunda kwa mikusanyiko na hati badala ya majedwali, na inaangalia mikusanyiko yako halisi kabla ya kuandika msimbo — kamwe haibuni sehemu ambazo data yako haina.
• Huduma za wingu›Hifadhidata inaonyesha Mikusanyiko yako ya Firestore na hati zake. Huko zinaweza kusomwa tu; programu ndiyo inayoziandika.
• Akaunti zinabaki kwa MonstarX. Watu bado wanaingia kama walivyokuwa wakiingia, na Huduma za wingu›Watumiaji inafanya kazi kama awali. Ndiyo sababu MonstarX inabaki na hifadhidata yake badala ya kuifuta.

Ili kurudi, chagua Hifadhidata ya MonstarX mahali palepale. Programu inarudi kwenye hifadhidata yake ikiwa kama ilivyokuwa hasa.

Nakili data iliyopo hufanya nini?

• Kila jedwali linakuwa mkusanyiko wenye jina lilelile, na kila safu mlalo inakuwa hati. ID ya safu mlalo inakuwa ID ya hati.
• Ukiiendesha tena, inasasisha hati hizo badala ya kuziongeza mara mbili.
• Majedwali manne ya kuingia yanabaki kwenye hifadhidata ya MonstarX, ambapo akaunti zinahifadhiwa.
• Haifuti chochote, mahali popote kati ya hapo mbili.
• Programu kubwa inaweza kunakiliwa kwa awamu. Ikisema ilisimama ili kuweka ombi fupi, iendeshe tena nayo itaendelea pale ilipoishia.

Mambo ya kujua

• Firestore au Supabase, si zote mbili. Programu huhifadhi data yake mahali pamoja. Ili kutoka Supabase kwenda Firestore, rudisha data kwenye hifadhidata ya MonstarX kwanza. Kiunganishi cha Firebase chenyewe bado kinafanya kazi pamoja na Supabase kwa hifadhi ya faili, arifa au kuingia.
• Hakuna Firebase SDK kwenye programu yako. MonstarX hufikia Firebase kupitia kisaidizi kilicho ndani, kinachofanya kazi sawa kwenye hakikisho na kwenye programu iliyochapishwa.
• Arifa za push kwa vifaa vya mkononi zinahitaji tokeni ya kifaa kutoka kwa programu yako ya simu; MonstarX hutuma kwa tokeni ambazo programu inapewa.
• Kuchapisha kwenye Google Cloud Run ni kiunganishi tofauti: angalia Chapisha kwenye huduma nyingine za upangishaji.

Maswali ya kawaida

Ninapata wapi faili ya ufunguo wa akaunti ya huduma?

Kwenye Firebase console: Project settings → Service accounts → Generate new private key. Bandika faili nzima ya JSON kwenye Faili ya ufunguo wa akaunti ya huduma.

Je, ninaweza kutumia Firebase kwa arifa za push pekee?

Ndiyo. Kuunganisha Firebase hakuhamishi data yako. Programu inaendelea kutumia hifadhidata ya MonstarX isipokuwa uchague Firestore kwenye Mahali programu hii inapohifadhi data yake.

Je, watumiaji wangu watahitaji akaunti mpya nikihamia Firestore?

Hapana. Akaunti zinabaki kwenye hifadhidata ya MonstarX na kuingia kunafanya kazi kama awali. Ni data ya programu yenyewe pekee inayohamia Firestore.

Inasema “bado hakuna hifadhidata ya Firestore”. Je, hilo ni tatizo?

Tu ikiwa unataka Firestore. Bado inaunganishwa, kwa sababu huenda programu inahitaji hifadhi ya faili, kuingia au arifa za push pekee. Unda hifadhidata ya Firestore kwenye Firebase console ili uitumie.

Je, kunakili data yangu kunafuta chochote?

Hapana. Nakili data iliyopo huongeza au kusasisha hati kwenye Firestore pekee. Hifadhidata ya MonstarX yenyewe inaachwa kama ilivyo.

Angalia pia

SupabaseHifadhi data kwenye Postgres yako mwenyewe badala yake.

Hifadhidata ya programu yakoHifadhidata ambayo kila programu huanza nayo.

ViunganishiKila huduma ambayo programu yako inaweza kuunganishwa nayo.

Akaunti za watumiajiJinsi kujisajili na kuingia kunavyofanya kazi kwenye programu yako.