← Alle gidsen

Een woordjes-app bouwen en als Android-APK inpakken met GitHub Actions

Woordjes oefenen werkt het best met korte, regelmatige sessies, en dus het liefst op je telefoon. Een webapp is daarvoor een prima begin. Wil je hem ook als echte app installeren, dan kun je hem in een Android WebView stoppen en de APK automatisch laten bouwen door GitHub. Je hebt daarvoor geen Android Studio op je eigen computer nodig.

GitHub Actions-run met een geslaagde APK-build
De workflow die de APK bouwt. Groen is het enige vakje dat telt.

Wat maakt een goede woordjes-app?

  • Meerdere taalparen in plaats van vastgezet op bijvoorbeeld Frans naar Nederlands. Een lijst is simpelweg een lijst van paren.
  • Beide richtingen: zowel van de doeltaal naar je moedertaal als omgekeerd. Terugvertalen is moeilijker en leert meer.
  • Intypen in plaats van alleen kiezen: actief ophalen uit je geheugen blijft beter hangen dan herkennen.
  • Herhaling in intervallen: woorden die je fout had komen vaker terug. Het Leitner-systeem met vakjes doet dat al: goed beantwoord gaat naar het volgende vakje en komt minder vaak, fout gaat terug naar vak 1.
  • Lokale opslag: bewaar voortgang in localStorage, zodat alles ook offline blijft werken.

De opzet: een WebView-wrapper

Een WebView is een stukje Android dat webpagina’s toont binnen een eigen app. Zet je HTML-bestand in de map app/src/main/assets/ en laat de app dat bestand laden. Twee instellingen zijn belangrijk: JavaScript aan, en DOM-opslag aan, anders verdwijnt je voortgang.

WebView web = findViewById(R.id.webview);
WebSettings s = web.getSettings();
s.setJavaScriptEnabled(true);
s.setDomStorageEnabled(true);
web.loadUrl("file:///android_asset/index.html");

De APK laten bouwen door GitHub Actions

Zet het Android-project in een GitHub-repository. Maak daarna het bestand .github/workflows/build.yml aan:

name: Build APK
on:
  push:
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-java@v4
        with:
          distribution: temurin
          java-version: "17"
      - uses: gradle/actions/setup-gradle@v4
      - run: gradle assembleDebug
      - uses: actions/upload-artifact@v4
        with:
          name: woordjes-apk
          path: app/build/outputs/apk/debug/*.apk

Na elke push start GitHub de build. Op het tabblad Actions klik je op de laatste run en download je onder Artifacts het APK-bestand. Staat er een Gradle-wrapper in je project, dan gebruik je ./gradlew assembleDebug in plaats van gradle.

Installeren op je telefoon

Zet het APK-bestand op je telefoon en open het. Android vraagt dan toestemming om apps van onbekende bronnen te installeren; dat staat uit voor je browser of bestandsbeheerder tot je het goedkeurt. Een debug-APK is bedoeld voor eigen gebruik. Wil je de app in de Play Store zetten, dan heb je een ondertekende release-build nodig, waarvoor je een sleutelbestand (keystore) maakt en de wachtwoorden als GitHub-geheimen opslaat, nooit in de code zelf.

Tips

  • Test eerst in de browser van je telefoon. Dat is sneller dan telkens een APK bouwen.
  • Gebruik relatieve paden voor je bestanden in assets.
  • Voeg een exportfunctie toe, zodat je je woordenlijsten kunt back-uppen. Opslag in een WebView verdwijnt als je de app-gegevens wist.

Vragen of een fout gevonden?

Staat er iets onduidelijks of onjuists in deze gids, of heb je een aanvulling? Laat het me weten via de contactpagina. Meer uitleg over wat ik bouw lees je op Over mij, en meer gidsen vind je in het overzicht.

Android-telefoon met de geïnstalleerde app op het startscherm
Het eindresultaat: geen browser meer, maar een echte app.

Wat niet werkt (en waarom)

  • Een WebView zonder internetpermissie. Je app opent, blijft wit en je ziet geen fout. Zet INTERNET in het manifest, ook al laad je alleen lokale bestanden.
  • Een keystore weggooien. Dit is de duurste fout in deze lijst. Zonder de originele ondertekeningssleutel kun je je app nooit meer updaten. Bewaar hem buiten de repository, met het wachtwoord ergens veilig.
  • De versiecode niet ophogen. De versienaam mag gelijk blijven, de versionCode moet omhoog. Anders weigert Android de installatie als "app niet geïnstalleerd".
  • Een te oude targetSdkVersion. Nieuwe Android-versies blokkeren apps die te ver achterlopen. Zet hem op een recente waarde, ook als je de app alleen zelf gebruikt.

Snel oplossen: symptoom, oorzaak, oplossing

SymptoomMeestal de oorzaakOplossing
App opent met een witte paginaGeen internetpermissie of verkeerde URLINTERNET-permissie toevoegen en de URL testen in de browser
"App niet geïnstalleerd"versionCode niet verhoogd of andere sleutelVersiecode ophogen en altijd met dezelfde keystore ondertekenen
Build faalt in ActionsVerkeerde SDK-versie of ontbrekende secretsLogboek lezen, SDK pinnen, keystore als base64-secret toevoegen
Opgeslagen gegevens kwijtWebView-cache of localStorage gewistOpslag toestaan en data niet in de cache zetten
Werkt op mijn telefoon, niet op die van iemand andersPlay Protect blokkeert onbekende bronnenInstallatie toestaan, of via Play Store distribueren

Veelgestelde vragen

Heb ik de Play Store nodig?

Nee. Voor eigen gebruik of een paar mensen is een APK genoeg. Wil je hem breder verspreiden, dan is de Play Store de enige nette route: daar gelden wel eisen aan privacybeleid, doelgroep en ondertekening.

APK of AAB?

Voor de Play Store is een AAB verplicht. Voor sideloaden heb je een APK nodig. GitHub Actions kan beide bouwen; begin met een APK.

Wat als ik mijn keystore kwijt ben?

Dan kun je alleen een nieuwe app publiceren onder een nieuwe pakketnaam. Bestaande installaties kunnen niet bijgewerkt worden. Bewaar de keystore dus op twee plekken, buiten je repository.

Verder lezen

← Subdomeinen en zoekmachines: zo zorg je dat Google je kleine website vindt3D-printen: passingen, wanddikte en chamfers goed ontwerpen →