Methacore Apps
Methacore Apps sind kleine Anwendungen, die Vereine und Mitglieder direkt in Methacore öffnen: ein Exporter im Dashboard, ein Trainingsplaner in der Mitglieder-App, eine Pinnwand für die Abteilung. Jede App ist ein Projekt im Artim DevHub, für das die API „Methacore Apps“ freigeschaltet ist. Die App-ID in Methacore ist die Projekt-ID (prj_…).
Eine App handelt immer im Namen des Mitglieds, das sie gerade benutzt. Sie meldet sich per OAuth (PKCE) an, das Mitglied stimmt einmal zu, danach läuft sie still. Was sie sehen darf, legen ihre Berechtigungen fest – und nie mehr als das, was das Mitglied selbst sieht.
Zwei Arten von Apps
Gehostet (hosted) | Extern (external) | |
|---|---|---|
| Gebaut in | Methacore Studio: Builder, main.js, styling.css | deinem eigenen Stack (HTML, Next.js, …) |
| Ausgeliefert von | Methacore, unter apps-run.methacore.de | deinem Server, nur https |
| Läuft in | Sandbox-Iframe (Dashboard) bzw. WebView (Handy) mit fester CSP | Iframe bzw. WebView, deine Seite |
| Zugriff auf Methacore | eingebaute Datenquellen, Handler-Kontext | @methacore/sdk |
| Prüfung | jede Version, vor dem Livegang | keine |
| Im App Store | Siegel „Von Methacore geprüft“, sobald die Live-Version freigegeben ist | Hinweis „Extern – nicht von Methacore geprüft“ |
| Beim ersten Öffnen | Zustimmung zu den Berechtigungen | Warnung mit Anbieter und Datenschutzerklärung, danach Zustimmung |
Wenn du nicht sicher bist: fang gehostet an. Du brauchst keinen Server, keine Domain und kein Zertifikat, und deine App bekommt das Siegel.
Wo eine App läuft
Die Zielplattform (target) legst du im DevHub fest:
target | Wo die App erscheint |
|---|---|
dashboard | im Methacore-Dashboard im Browser, für Vereinsverwaltung und Vorstand |
mobile | in der Methacore-App auf dem Handy, für Mitglieder |
both | an beiden Stellen |
Im Dashboard öffnen sich Apps unter Apps, gespeicherte Apps lassen sich sortieren und bis zu drei davon in die Seitenleiste heften. In der Mitglieder-App liegen sie auf einem eigenen Homescreen unter Mehr → Apps.
App Store und Siegel
Der App Store zeigt jedem Verein zwei Dinge: die eigenen Apps des Vereins (das Projekt ist mit dieser Organisation verknüpft) und alle öffentlichen Apps. Ob eine öffentliche App dort auftaucht, entscheidet außerdem die Vereinsrichtlinie: Administratoren eines Vereins lassen je Plattform alle, keine oder nur ausgewählte Apps zu.
Das Siegel „Von Methacore geprüft“ trägt eine App genau dann, wenn sie gehostet ist und ihre Live-Version die Prüfung bestanden hat. Externe Apps bekommen es nie – ihr Code liegt auf fremden Servern und kann sich jederzeit ändern. Was die Prüfung ansieht, steht unter Veröffentlichen & Prüfung.
Der Weg einer App
- DevHub-Projekt anlegen – oder ein bestehendes nehmen. Das Projekt gehört einem Team; alle Mitglieder des Teams können die App bearbeiten.
- API „Methacore Apps“ freischalten und einen OAuth-Client dafür anlegen. Der Client trägt die Scopes, die deine App höchstens verlangen darf.
- Eintrag pflegen – im DevHub unter Methacore-App: Name, Beschreibungen, Kategorie, Icon, Screenshots, Zielplattform, Art der App, bei externen Apps die Adresse, der Schalter „Öffentlich“.
- Bauen – gehostete Apps in Methacore Studio, externe Apps in deinem eigenen Projekt mit dem SDK.
- Version veröffentlichen – im Studio friert eine Version (z. B.
1.0.0) deinen Entwurf ein und reicht ihn zur Prüfung ein. - Prüfung durch Artim – der Stand erscheint im DevHub je Version: In Prüfung, Freigegeben oder Abgelehnt.
- Live – die höchste freigegebene Version ist die, die Vereine und Mitglieder öffnen.
Begriffe
| Begriff | Bedeutung |
|---|---|
| App | DevHub-Projekt mit der API „Methacore Apps“ |
appId | die Projekt-ID, z. B. prj_3f9a1c0b7e |
| Eintrag (Listing) | was der App Store zeigt, gepflegt im DevHub |
| Entwurf | der aktuelle Stand im Studio, automatisch gespeichert, nur in der Vorschau sichtbar |
| Version | ein eingefrorener Entwurf mit Semver-Nummer und Änderungstext |
| Live-Version | die höchste freigegebene Version |
| Host | das Dashboard oder die Mitglieder-App, in der die App läuft |
| Bridge | der Kanal zwischen App und Host (postMessage) für Token, Kontext, Hinweise, Downloads |
Weiter
- Schnellstart: gehostete App – in zehn Minuten von leer zu einer App mit echten Daten
- app.json-Referenz und Datenquellen
- Externe Apps & SDK, wenn du deine eigene Web-App einbinden willst