Fehlerbehebung & FAQ

Die häufigsten Stolpersteine, sortiert danach, wo sie auftreten.

Studio

Das Studio zeigt meine App nicht

Das Studio listet Projekte, die „Methacore Apps“ freigeschaltet haben und zu einem Team gehören, in dem dein verknüpftes Artim-Dev-Konto Mitglied ist. Prüf im DevHub, ob die API aktiv ist und ob du im richtigen Team bist. Hast du ein anderes Artim-Dev-Konto verknüpft als das, mit dem du im DevHub arbeitest, siehst du dessen Apps.

„Noch kein OAuth-Client“ in den Einstellungen

Das Projekt hat noch keinen Client für die API „Methacore Apps“. Leg ihn im DevHub unter OAuth an; danach steht er in den Einstellungen zur Auswahl.

Mein Entwurf wird nicht gespeichert

Das Studio speichert kein ungültiges app.json. Oben steht dann die Fehlermeldung – häufig eine doppelte id, ein Tab ohne Beschriftung oder ein Tippfehler im JSON. Außerdem darf der Entwurf höchstens 512 KB groß sein.

„Behebe zuerst die Fehler in app.json“ beim Veröffentlichen

Siehe oben: Eine Version entsteht nur aus einem gültigen Entwurf.

„Die Version muss höher sein als die letzte“

Versionen folgen Semver und steigen immer. Nach 1.2.0 geht 1.2.1, 1.3.0 oder 2.0.0 – auch wenn 1.2.0 abgelehnt wurde.

Vorschau

„In app.json fehlt auth.clientId“

Wähl unter Einstellungen einen OAuth-Client. Ohne Client kann die App keine Daten laden.

„Anmeldefenster blockiert“

Die Zustimmung öffnet sich als Pop-up. Erlaube Pop-ups für studio.methacore.de und klick erneut.

Die Vorschau zeigt keine Daten, der Builder schon

Der Builder zeigt Beispieldaten, die Vorschau deine echten. Hast du im gewählten Verein keine Termine, bleibt die Tabelle leer. Prüf außerdem, ob der Scope der Quelle in auth.scopes steht.

Laufzeit

„Aktion fehlgeschlagen: This token does not carry the … scope.“

Der Scope fehlt im Token, und das Mitglied hat „Zugriff erweitern“ abgelehnt – oder der Scope fehlt schon am OAuth-Client. Trag ihn am Client und in auth.scopes ein.

„Aktion fehlgeschlagen: Handler "x" is not exported by main.js.“

Die Funktion ist nicht exportiert oder heißt anders. Handler brauchen export: export async function x(ctx) { … }. Prüf auch die Konsole – ein Syntaxfehler in main.js verhindert das Laden aller Handler.

„Die Daten für den Export sind keine Liste.“

data der Export-Aktion muss allein stehen und auf eine Liste zeigen: "{{state.termine}}", nicht "Termine: {{state.termine}}". Bei Quellen mit pick prüf, dass im State die Liste liegt und nicht das ganze Objekt { items: … }.

Ein Ausdruck bleibt leer

Ausdrücke sind reine Pfade. {{state.termine.length}} geht, {{state.termine.length > 0}} nicht. Pfade sind groß-/kleinschreibungsempfindlich, und Werte aus Bindungen stehen erst im State, wenn die Quelle geantwortet hat – während des Ladens ist {{state.$loading.<schlüssel>}} true.

`413 App storage quota exceeded.`

Die App hat in diesem Verein 10 MB belegt. Lösch alte Einträge oder speichere weniger pro Eintrag. Das Kontingent gilt je Verein – in anderen Vereinen ist die App nicht betroffen.

Meine Webfont / mein externes Stylesheet lädt nicht

Die Sicherheitsrichtlinie gehosteter Apps erlaubt keine Webfonts und kein @import fremder Adressen. Nimm Systemschriften über --mc-font-family. Bilder über https: gehen. Details unter Styling.

Meine Farben verschwinden im dunklen Thema

Die Runtime setzt im dunklen Thema eigene Farben unter :root[data-mc-theme="dark"]. Überschreib sie dort ebenfalls – siehe Helles und dunkles Thema.

`fetch` auf meinen Server scheitert

Gehostete Apps erreichen nur *.api.methacore.de und den DevHub. Brauchst du einen eigenen Server, ist eine externe App der richtige Weg.

Store und Freigabe

Meine App steht im Store, lässt sich aber nicht öffnen

Eine gehostete App braucht eine freigegebene Version – auch im eigenen Verein. Solange die erste Version in Prüfung ist, nutz die Vorschau im Studio.

Andere Vereine sehen meine App nicht

Drei Dinge müssen stimmen: der Schalter „Öffentlich“ ist an, die App ist freigegeben, und die Richtlinie des Vereins lässt sie zu. Außerdem erscheint sie nur auf der Plattform ihres target.

„Öffentlich“ lässt sich nicht speichern

Für einen öffentlichen Eintrag fehlen Pflichtfelder: Name, beide Beschreibungen, Kategorie, Icon und mindestens ein Screenshot, bei externen Apps die Adresse. Die Meldung („Für eine öffentliche App fehlt noch: …“) zählt auf, was fehlt.

Wie lange dauert die Prüfung?

Das hängt vom Umfang ab. Die Entscheidung erscheint spätestens eine Minute, nachdem sie getroffen wurde, im Studio und im DevHub.

Warum hat meine gehostete App kein Siegel?

Das Siegel gibt es, sobald die Live-Version freigegeben ist. Solange noch keine Version freigegeben ist, steht im Store „Noch nicht geprüft“.

Externe Apps

Die App bleibt im Dashboard weiß

Meist verbietet deine Seite das Einbetten (X-Frame-Options oder frame-ancestors). Erlaube https://admin.methacore.de. Prüf auch die Browser-Konsole auf CSP-Fehler deiner eigenen Seite.

„Die Adresse der App liegt außerhalb der autorisierten Domains deines Projekts.“

Trag die Domain im DevHub-Projekt unter den autorisierten Domains ein und bestätige sie, dann speichere den Eintrag erneut.

Der Store zeigt meine App als nicht erreichbar

Der tägliche Check hat keine gültige https-Antwort bekommen. Nach dem nächsten erfolgreichen Check verschwindet der Hinweis.

state der Rückkehr passt nicht zur gestarteten Anmeldung – meist, weil die Anmeldung in einem anderen Tab oder auf einer anderen Domain (mit/ohne www) begann. Starte und beende die Anmeldung unter derselben Adresse.

Weiterhelfen

Findest du hier nichts, schreib uns über den Support im DevHub. Nenn dabei die App-ID (prj_…), die Version und – bei Fehlern der API – die request_id aus der Fehlerantwort.