Jinsi ya Kuweka na Kuchapisha PWA App Kwenye Google Play Store – Hatua kwa Hatua

Kuwa na website inayofanya kazi kama Progressive Web App (PWA) ni hatua nzuri, lakini ili app hiyo ionekane kwenye Google Play Store, ni lazima ifungwe kwenye Android App Bundle (.aab) au APK inayokubalika na Google.

Mwongozo huu unaeleza hatua zote—kuanzia kuandaa PWA, kutengeneza app, kujaza taarifa za Google Play Console, kufanya testing hadi kuchapisha app kwenye Production.

1. Mahitaji ya awali

Kabla ya kuanza, hakikisha una vitu vifuatavyo:

• Website inayofanya kazi vizuri.
• SSL certificate na anwani ya https://.
• PWA Manifest, kwa kawaida manifest.json au manifest.webmanifest.
• Service Worker.
• Icon za app, hasa ukubwa wa 512 × 512.
• Akaunti ya Google Play Console.
• Android App Bundle yenye extension ya .aab.
• Privacy Policy inayopatikana kupitia URL ya umma.
• Screenshots za app.
• Maelezo mafupi na marefu ya app.

Mfano wa manifest:

{
  "name": "Amson Schools Tanzania",
  "short_name": "Amson Schools",
  "start_url": "/",
  "display": "standalone",
  "background_color": "#ffffff",
  "theme_color": "#0d6efd",
  "icons": [
    {
      "src": "/icons/icon-192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "/icons/icon-512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ]
}

2. Hakikisha PWA inafanya kazi vizuri

Kabla ya kuibadilisha kuwa Android app, fanya majaribio yafuatayo:

• Website ifunguke kwa HTTPS.
• Login na logout vifanye kazi.
• Kurasa zote zifunguke kwenye simu.
• Menyu iwe responsive.
• Picha na mafaili yasitumie URL za http://.
• Service Worker ifanye kazi.
• App iweze kuongezwa kwenye home screen.
• Kitufe cha kurudi nyuma kifanye kazi vizuri.
• Hakikisha hakuna ukurasa unaoonyesha blank page au error.

Kwa PWA inayotumia PHP na MySQL, database inaendelea kuwepo kwenye hosting. Android app inakuwa njia ya kumpeleka mtumiaji kwenye mfumo wako wa web.

3. Tengeneza Android App Bundle

PWA inaweza kuingizwa Google Play kwa kutumia Trusted Web Activity (TWA). Unaweza kutumia Bubblewrap au huduma nyingine inayotengeneza Android package kutoka kwenye PWA.

Package name inaweza kuwa:

com.amsonschools.twa

Package name inapaswa kuwa ya kipekee. Baada ya app kuchapishwa, si vizuri kuibadilisha kwa sababu Google huitumia kuitambua app.

Mfano wa kusakinisha Bubblewrap:

npm install -g @bubblewrap/cli

Kuanzisha project:

bubblewrap init --manifest=https://example.com/manifest.json

Kutengeneza app:

bubblewrap build

Baada ya build kukamilika, utapata faili la Android App Bundle:

app-release-bundle.aab

Usipoteze signing key/keystore iliyotumika kutengeneza app. Ihifadhi sehemu salama pamoja na password zake.

4. Weka Digital Asset Links

Digital Asset Links inaunganisha website yako na Android app. Bila uthibitisho huu, app inaweza kuonyesha address bar ya browser badala ya kufunguka kama app kamili.

Tengeneza faili:

assetlinks.json

Liweke kwenye:

https://example.com/.well-known/assetlinks.json

Mfano:

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.amsonschools.twa",
      "sha256_cert_fingerprints": [
        "SHA256_FINGERPRINT_YAKO"
      ]
    }
  }
]

Thibitisha kuwa URL hiyo inafunguka moja kwa moja bila login, redirect au error ya 404.

5. Fungua akaunti ya Google Play Console

Tembelea Google Play Console na uingie kwa akaunti yako ya Google.

Kamilisha:

• Jina la developer.
• Anwani ya mawasiliano.
• Email na namba ya simu.
• Developer account verification.
• Malipo ya usajili yanapotakiwa.
• Android developer verification.
• Package name registration inapohitajika.

Taarifa zako zinapaswa kuwa sahihi na kuendana na mtu au taasisi inayomiliki app.

6. Tengeneza app mpya

Ndani ya Google Play Console:

1. Fungua All apps.
2. Bonyeza Create app.
3. Andika jina la app.
4. Chagua lugha kuu.
5. Chagua kama ni App au Game.
6. Chagua kama ni app ya bure au ya kulipia.
7. Kubali developer declarations.
8. Bonyeza Create app.

Kwa mfumo wa shule unaweza kutumia:

App name: Amson Schools Tanzania
Default language: English au Kiswahili
App or game: App
Free or paid: Free

7. Jaza Store Listing

Nenda kwenye:

Grow users → Store presence → Main store listing

App name

Amson Schools Tanzania

Short description

Mfumo rahisi wa kusimamia taarifa za shule, wanafunzi na matokeo.

Full description

Amson Schools Tanzania ni mfumo wa kidijitali unaosaidia shule kusimamia
taarifa za wanafunzi, madarasa, masomo, mitihani na matokeo kwa urahisi.

Mfumo unawawezesha watumiaji walioidhinishwa kuingia kwenye akaunti zao,
kuangalia taarifa muhimu na kutekeleza majukumu ya shule kupitia simu.

Vipengele muhimu:
• Usimamizi wa wanafunzi
• Usimamizi wa madarasa na masomo
• Uingizaji na uchambuzi wa matokeo
• Taarifa na matangazo ya shule
• Mfumo salama wa akaunti za watumiaji
• Muonekano unaofanya kazi kwenye simu na kompyuta

Epuka kuweka madai ambayo hayapatikani ndani ya app.

8. Pakia icon na screenshots

Utahitaji vifaa vya kuonyesha app kwenye Google Play Store, kama:

• App icon ya 512 × 512.
• Feature graphic ya 1024 × 500.
• Screenshots za simu.
• Screenshots za tablet ikiwa app inalenga tablet.
• Video ya YouTube ni ya hiari.

Screenshots zinapaswa kuonyesha app halisi, kwa mfano:

• Login page.
• Dashboard.
• Orodha ya wanafunzi.
• Matokeo.
• Matangazo.
• Ripoti.

Usitumie screenshots zenye password, taarifa nyeti za wanafunzi au data halisi ya mteja.

9. Weka Privacy Policy

Privacy Policy inapaswa kueleza:

• Data inayokusanywa.
• Sababu za kuikusanya.
• Jinsi inavyohifadhiwa na kulindwa.
• Ikiwa data inashirikishwa.
• Jinsi mtumiaji anaweza kuomba data ifutwe.
• Mawasiliano ya mmiliki wa app.

Privacy Policy iwe kwenye URL ya umma, kwa mfano:

https://example.com/privacy-policy

Google inahitaji Data Safety ijazwe kwa usahihi na iendane na tabia halisi ya app, SDK na WebView/PWA yako. Hata app isiyokusanya data inahitaji Data Safety na Privacy Policy. Soma mwongozo rasmi wa Data Safety.

10. Jaza App Access

Kama app ina login, Google anahitaji akaunti ya majaribio.

Nenda:

Policy and programs → App content → App access

Chagua:

All or some functionality is restricted

Kisha toa:

• Username ya majaribio.
• Password ya majaribio.
• Hatua za kuingia.
• Maelezo ya sehemu muhimu za app.

Mfano:

Username: reviewer@example.com
Password: Review@2026
Instructions: Open the app, enter the credentials and tap Login.

Akaunti hiyo lazima ifanye kazi muda wote, isiwe na OTP inayokwisha muda na isimlazimishe reviewer kuunda akaunti mpya. Masharti rasmi ya taarifa za kuingia.

11. Jaza Ads Declaration

Google itauliza kama app ina matangazo.

Chagua:

• Yes ikiwa una AdMob, AdSense au matangazo mengine ndani ya app.
• No ikiwa app haina matangazo.

Jibu hili lazima lilingane na kile reviewer atakachokiona ndani ya app.

12. Jaza Content Rating

Fungua Content rating na:

1. Weka email yako.
2. Chagua category ya app.
3. Jibu maswali kuhusu violence, sexuality, lugha, gambling na maudhui mengine.
4. Kagua majibu.
5. Wasilisha ili app ipate rating.

Kwa app ya kawaida ya shule, majibu mengi yanaweza kuwa No, lakini jibu kulingana na maudhui halisi.

13. Chagua Target Audience

Kwa app ya shule, umri unaolengwa unahitaji kuamuliwa kwa uangalifu.

Kama app inalenga walimu, wazazi na wasimamizi pekee, chagua makundi ya watu wazima yanayohusika.

Kama watoto wanaweza kutumia app moja kwa moja, lazima utangaze makundi yao ya umri na kufuata Families Policy. Google inahitaji ukusanyaji wa taarifa za watoto, SDK na matangazo vitangazwe kwa usahihi. Soma Families Policy.

14. Jaza sehemu ya News/Education

Kwa Amson Schools Tanzania:

Is the app a web browser or search engine? No
Is the app primarily a news or educational product? Yes

App ni bidhaa ya elimu, si browser wala search engine.

15. Jaza Data Safety

Kwa mfumo wa shule unaotuma taarifa kwenye hosting/database:

Does the app collect or share required user data? Yes

Kwa sababu Google huhesabu data inayotumwa kutoka PWA/WebView kwenda kwenye server yako kama data iliyokusanywa.

Encryption in transit

Chagua Yes ikiwa:

• App yote inatumia HTTPS.
• API zote zinatumia HTTPS.
• Picha, forms na login hazitumii HTTP.
• SSL certificate ni halali.

Account creation

• Kama watumiaji wanajisajili: chagua Username and password.
• Kama admin ndiye anatengeneza akaunti na watumiaji wana-login tu: chagua My app does not allow users to create an account.

Data types zinazoweza kuhusika

Kwa mfumo wa shule, zinaweza kuwa:

• Name.
• Email address.
• User IDs.
• Address.
• Phone number.
• Other personal information.
• Photos, ikiwa profile/student photos zinapakiwa.
• Files and documents, ikiwa PDF/Excel zinapakiwa.
• Other financial information, ikiwa ada na madeni yanahifadhiwa.

Kwa kila data inayohifadhiwa kwenye database:

Collected: Yes
Shared: No, ikiwa haipelekwi kwa kampuni nyingine
Processed ephemerally: No
Purpose: App functionality
Purpose: Account management, ikiwa inahusika na akaunti

Usitangaze data ambayo app haikusanyi, lakini pia usifiche data inayokusanywa. Google inaweka jukumu la usahihi wa taarifa hizi kwa developer. Mwongozo rasmi wa Google Play.

16. Financial Features

Kwa app ya shule isiyotoa huduma za kifedha, chagua:

My app doesn’t provide any financial features

Kurekodi ada au michango ya shule pekee si sawa na kutoa mkopo, banking, wallet au money transfer.

Kama app inapokea malipo moja kwa moja kupitia M-Pesa, Airtel Money au huduma nyingine, jibu kulingana na payment integration inayotumika.

17. Health Apps na Government Apps

Kama app si ya afya:

Health apps declaration: No health features

Kama app haiwakilishi serikali:

Government apps declaration: No

Usidai kuwa app ni ya serikali au taasisi fulani bila uthibitisho na ruhusa.

18. Chagua App Category

Kwa mfumo wa shule, category inayofaa kwa kawaida ni:

Education

Ongeza pia:

• Developer email.
• Website.
• Support contact.
• Privacy Policy URL.

19. Pakia app kwenye Internal Testing

Kabla ya Production, anza na Internal testing:

1. Nenda Test and release.
2. Chagua Testing.
3. Fungua Internal testing.
4. Bonyeza Create new release.
5. Chagua au tengeneza Play App Signing.
6. Pakia faili la .aab.
7. Andika release notes.
8. Bonyeza Save.
9. Bonyeza Review release.
10. Anzisha rollout ya testing.

Mfano wa release notes:

Toleo la kwanza la Amson Schools Tanzania.

• Mfumo wa kuingia kwenye akaunti
• Usimamizi wa taarifa za shule
• Uingizaji na uangalizi wa matokeo
• Maboresho ya matumizi kwenye simu

Google inapendekeza kuanza na internal test, kisha kuendelea na closed testing. Mwongozo wa testing.

20. Closed Testing

Kwa baadhi ya akaunti mpya za developer binafsi, Production haiwezi kufunguliwa moja kwa moja.

Akaunti binafsi zilizoundwa baada ya tarehe 13 Novemba 2023 zinaweza kuhitajika kufanya closed test yenye angalau testers 12 walioendelea kuwa opted-in kwa siku 14 mfululizo kabla ya kuomba Production access. Masharti rasmi ya closed testing.

Hatua zake:

1. Fungua Closed testing.
2. Tengeneza testing track.
3. Ongeza email za testers.
4. Pakia .aab.
5. Publish closed test.
6. Tuma opt-in link kwa testers.
7. Hakikisha angalau testers 12 wamejiunga.
8. Waache wakiwa opted-in kwa siku 14 mfululizo.
9. Kusanya maoni na rekebisha matatizo.
10. Omba Production access baada ya masharti kutimia.

Usiwaondoe testers kabla ya kipindi kukamilika.

21. Tengeneza Production Release

Baada ya dashboard na app content kukamilika:

1. Nenda Test and release.
2. Chagua Production.
3. Bonyeza Create new release.
4. Pakia .aab yenye version mpya.
5. Ongeza release notes.
6. Bonyeza Next.
7. Kagua errors na warnings.
8. Rekebisha errors zote.
9. Bonyeza Start rollout to Production au Send for review.

Google hukagua app, taarifa za Store Listing, Data Safety, Privacy Policy, login credentials na sera nyingine kabla ya kuidhinisha. Maandalizi ya app review.

22. Kutatua error ya “This release does not add or remove any app bundles”

Error hii hutokea unapojaribu kutuma release bila kupakia bundle mpya.

Suluhisho:

1. Rudi kwenye Create release.
2. Pakia .aab mpya.
3. Hakikisha bundle ina version code kubwa kuliko iliyopita.
4. Hifadhi release.
5. Rudi Preview and confirm.

Mfano:

versionCode 2
versionName "1.1"

Kila update mpya lazima iwe na versionCode kubwa kuliko toleo lililopo.

23. Kutatua error ya watumiaji kushindwa kufanya upgrade

Google inaweza kuonyesha ujumbe kwamba existing users hawawezi ku-upgrade kwenda kwenye bundle mpya.

Sababu zinaweza kuwa:

• Package name imebadilishwa.
• Signing key si ile iliyotumika awali.
• Version code si kubwa.
• Device support imepunguzwa.
• Bundle mpya haijapakiwa.
• Release mpya haiendani na version iliyopo.

Kwa update ya app ya zamani:

• Tumia package name ileile.
• Tumia signing configuration sahihi.
• Ongeza version code.
• Usitengeneze app mpya Play Console kwa update ya app iliyopo.

24. Jinsi ya kusasisha PWA baada ya kuchapishwa

Kwa PWA/TWA, kuna aina mbili za update.

Update ya mafaili ya hosting

Unaweza kubadilisha:

• PHP.
• CSS.
• JavaScript.
• Picha.