KEPLIN Docs

Apps erstellen und verwalten

Wo die Apps leben, wie man eine im Modal Neue App erstellt, wie man Name und Symbol ändert und wie man eine App ohne Überraschungen löscht.

In Keplin ist die App die Einheit von allem: Jede Anwendung, die Sie bauen — mit ihrem Datenmodell, ihren Bildschirmen, ihren APIs, ihren Skripten, ihren Benutzern und ihren Einstellungen — ist eine App, in sich geschlossen und unabhängig von den anderen. Diese Seite zeigt, wo die Apps erscheinen, wie man eine erstellt, wie man ihre Identifikation ändert und was (genau) passiert, wenn man sie löscht.

Wo die Apps leben

Die Apps stehen an zwei Stellen:

  • Das Dashboard, die erste Seite nach der Anmeldung, hat eine Zeile pro App, die Ihr Konto öffnen kann, mit der Aktivität der letzten 24 Stunden. Klicken Sie auf den Namen einer App, um sie zu öffnen. Siehe Der Arbeitsbereich.
  • Die linke Seitenleiste zeigt in der Mitte die Apps, die Sie im Dashboard mit der Nadel An die Seitenleiste anheften angeheftet haben. Die Leiste teilt sich in drei Zonen: oben das Dashboard, unten die Administration (Observability, Benutzer, API-Schlüssel, Einstellungen) und in der Mitte die angehefteten Apps, jede mit ihrem Symbol und ihrem Namen. Es ist die einzige Zone der Leiste, die bei vielen Apps scrollt.

Die Seitenleiste mit den angehefteten Apps in der mittleren Zone, darunter die App Kundenverwaltung
Die Seitenleiste mit den angehefteten Apps in der mittleren Zone, darunter die App Kundenverwaltung

  • Bei eingeklappter Leiste sehen Sie nur die Symbole; fahren Sie mit der Maus darüber, um sie aufzuklappen, oder verwenden Sie Sidebar anheften (die Nadel oben), um sie offen zu halten.
  • Klicken Sie auf eine App, um sie zu öffnen: Sie gelangen in ihren Arbeitsbereich, auf den Tab Übersicht, mit den Inhaltsbäumen (UI, Code, Daten, Tests, Radar) in der eigenen Leiste der App.

Hinweis

Nicht alle sehen dieselben Apps. Ein Administrator sieht alle; ein Developer sieht nur die Apps, die ihm in seinem Datenblatt unter Benutzer zugewiesen wurden. Wenn eine App „nicht erscheint“, ist es fast immer das.

Eine App erstellen

Eine App zu erstellen heißt, ein Modal zu öffnen und ihr einen Namen und ein Symbol zu geben. Nur Administratoren haben den Button.

  1. Klicken Sie in der Kopfzeile des Dashboard oder in der App-Zone der Seitenleiste (der Button mit dem Pluszeichen am Ende der Liste) auf Neue App.
  2. Es öffnet sich das Modal Neue App — „Wählen Sie, wie die App entsteht: leer, mit Datasource, aus einer Vorlage oder importiert.“ — mit vier Karten: Leere App, App mit Datasource, Aus einer Vorlage und Paket importieren. Für eine App von Grund auf wählen Sie Leere App. (Die Karte App mit Datasource tut dasselbe und erstellt gleich die erste SQLite-Datasource der App; Vorlagen und Import haben in diesem Kapitel eigene Seiten.)
  3. Füllen Sie den Namen aus. Es ist der Name, der in der Seitenleiste und in den Kopfzeilen erscheint — zum Beispiel Gestão de Clientes.
  4. Wenn Sie mögen, schreiben Sie eine Beschreibung — einen Satz, der dem Rest des Teams sagt, wozu die App da ist.
  5. Wählen Sie das Symbol (siehe den nächsten Abschnitt).
  6. Klicken Sie auf App erstellen. Die App entsteht leer, erscheint im Dashboard, und ihr Arbeitsbereich öffnet sich sofort. Um sie auch in der Seitenleiste zu haben, heften Sie sie im Dashboard mit An die Seitenleiste anheften an.

Das Modal Neue App mit dem ausgefüllten Tab Von Grund auf erstellen für die App Kundenverwaltung
Das Modal Neue App mit dem ausgefüllten Tab Von Grund auf erstellen für die App Kundenverwaltung

Feld Pflicht Grenzen Wofür es da ist
Name Ja 2 bis 120 Zeichen Der sichtbare Name der App, überall.
Beschreibung Nein Bis zu 500 Zeichen Kontext für das Team; erscheint in der Kopfzeile der App.
Symbol Nein — Das Gesicht der App in der Seitenleiste. Ohne Wahl bleibt die Rakete.

Der Slug — der Bezeichner, der mit der App entsteht

Neben dem Feld Name steht der Hinweis: „Der Slug wird automatisch aus dem Namen abgeleitet.“ Der Slug ist die kurze, technische Fassung des Namens — Kleinbuchstaben, ohne Leerzeichen und ohne Akzente: Gestão de Clientes ergibt gestao-clientes. Er identifiziert die App in den Adressen (die Arbeitsversion antwortet unter /app/gestao-clientes), beim Export und in der Bestätigung zum Löschen.

Achtung

Der Slug muss in der Installation eindeutig sein und lässt sich nicht mehr ändern, sobald die App existiert. Wenn es bereits eine App mit demselben Slug gibt, hält das Erstellen mit dem Fehler „Es existiert bereits ein Projekt mit dem Slug…“ an — ändern Sie den Namen (oder löschen Sie die alte App) und versuchen Sie es erneut.

Das Symbol der App

Das Feld Symbol öffnet den Selektor Symbol auswählen der Plattform: ein Raster mit Hunderten von Symbolen und ein Feld „Symbole suchen…“, um nach dem Namen zu filtern. Klicken Sie auf ein Symbol, um es zu wählen; Standard kehrt zur ursprünglichen Rakete zurück.

Das gewählte Symbol begleitet die App überallhin: in der Seitenleiste, in der Kopfzeile des Arbeitsbereichs, und es reist mit ihr, wenn Sie sie als Paket exportieren. In einer Installation mit vielen Apps ist ein unverwechselbares Symbol Gold wert — daran findet man die App bei eingeklappter Leiste wieder.

Name, Beschreibung oder Symbol ändern

Die Identifikation der App ändert man jederzeit in ihren Einstellungen:

  1. Öffnen Sie die App, im Dashboard oder in der Seitenleiste.
  2. Klicken Sie oben in der Leiste der App auf den Zahnrad-Button Einstellungen der App und wählen Sie Allgemein.
  3. Ändern Sie im Panel Identifikation den Namen, die Beschreibung oder das Symbol. Das Symbol steht direkt neben dem Namen, weil die beiden im Dashboard und in der Seitenleiste genau so erscheinen.
  4. Klicken Sie auf Speichern. Die Bestätigung „Einstellungen gespeichert.“ erscheint, und das Dashboard und die Seitenleiste aktualisieren sich sofort.

Das Panel Identifikation im Abschnitt Allgemein der Einstellungen der App Kundenverwaltung
Das Panel Identifikation im Abschnitt Allgemein der Einstellungen der App Kundenverwaltung

Hinweis

Den Namen zu ändern ändert nicht den Slug und keine veröffentlichte Adresse — wer die App nutzt, merkt nichts davon. Der Name ist kosmetisch; der Slug ist strukturell.

Das Symbol auf dem Smartphone

KeplinGo legt für jede App eine Verknüpfung auf den Startbildschirm des Smartphones (siehe Das Smartphone mit einer App verbinden). Das Symbol dieser Verknüpfung wählen Sie im Panel Symbol auf dem Smartphone des Abschnitts Allgemein.

So wählen Sie das Symbol auf dem Smartphone:

  1. Öffnen Sie in den Einstellungen der App den Abschnitt Allgemein.
  2. Klicken Sie im Panel Symbol auf dem Smartphone auf Bild hochladen und wählen Sie das Bild. Um ein Bild zu verwenden, das schon in den Assets der App liegt, klicken Sie auf den Bild-Button links von Bild hochladen.
  3. Optional: Wählen Sie unter Hintergrundfarbe die Farbe hinter den transparenten Teilen des Bildes. Leer ist Weiß.
  4. Prüfen Sie unter So sieht es auf Android aus, dass das Wichtige der Zeichnung im gestrichelten Kreis liegt.
  5. Klicken Sie auf Speichern.

Das Bild muss ein quadratisches PNG, JPG oder WebP mit mindestens 432 × 432 px sein. Android schneidet die Ecken mit der Form ab, die der Hersteller des Smartphones gewählt hat (Kreis, Superellipse oder abgerundetes Quadrat), und nur der mittlere Kreis, etwa 61 % der Seite, ist immer zu sehen. Die Vorschau zeigt das ganze Bild mit dieser sicheren Zone, und das Bild in jeder der drei Formen.

Ohne Bild zeichnet KeplinGo das Symbol der App auf die Hauptfarbe des Designs. Die Smartphones aktualisieren die Verknüpfung beim nächsten Öffnen der App.

Hinweis

Bild hochladen speichert das Bild sofort in den Assets der App, im Ordner mobile/. Das Symbol der Verknüpfung ändert sich erst nach Speichern.

Eine App löschen

Eine App zu löschen ist endgültig, und deshalb verlangt die Plattform mehr als einen Klick.

  1. Öffnen Sie Einstellungen der App → Allgemein und gehen Sie hinunter bis zum Panel Löschen — „Die App, ihre Daten und ihre Dateien. Es gibt kein Zurück.“
  2. Klicken Sie auf App löschen.
  3. Es öffnet sich der Bestätigungsdialog „Kundenverwaltung“ löschen?, der warnt: „Löscht die App ‚Kundenverwaltung‘ mit allen APIs, Datenquellen, API-Schlüsseln und Paketen. Es gibt kein Zurück — die konsumierenden Apps verlieren sofort den Zugriff.“
  4. Schreiben Sie den Slug der App (gestao-clientes) in das Bestätigungsfeld — der Button entsperrt sich erst, wenn der Text exakt übereinstimmt.
  5. Klicken Sie auf Endgültig löschen. Sie kehren zum Dashboard zurück, schon ohne die App.

Der Bestätigungsdialog zum Löschen der App, mit dem eingetippten Slug, der den Button entsperrt
Der Bestätigungsdialog zum Löschen der App, mit dem eingetippten Slug, der den Button entsperrt

Was genau passiert:

Wird gelöscht Die gesamte App in dieser Installation: Modell, Bildschirme, APIs, Skripte, Berichte, Workflows, alle Versionen, die Konten der Benutzer der App, die auf der Festplatte der App gespeicherten Dateien und ihre Historie.
Funktioniert sofort nicht mehr Die veröffentlichten Adressen und die API-Schlüssel der App — jedes System, das sie konsumiert hat, verliert im selben Moment den Zugriff.
Bleibt unangetastet Das Audit (wer was getan hat, bleibt in der Observability abrufbar) und alles, was externe Infrastruktur ist: Datenbanken anderer Systeme, mit denen sich die App verbunden hat, Dateien in S3, SFTP oder Netzlaufwerken. Eine App zu löschen löscht nie Daten außerhalb von ihr.

Achtung

Es gibt keinen Papierkorb und kein „Rückgängig“. Bevor Sie eine App mit Arbeit darin löschen, exportieren Sie sie als Paket — die Seite „Apps importieren und exportieren“ erklärt, wie, und ein aufbewahrtes Paket ist die einzige Möglichkeit, sie später zurückzuholen.

Warum sehe ich nicht…?

  • …den Button Neue App? Apps zu erstellen und zu importieren ist Administratoren vorbehalten. Mit der Rolle Developer erscheint der Button nicht — bitten Sie einen Administrator, die App zu erstellen und sie Ihnen zuzuweisen.
  • …eine App, die es gibt? Ihrem Konto ist diese App nicht zugewiesen. Ein Administrator löst das im Datenblatt Ihres Kontos, unter Benutzer.
  • …das Panel Löschen? Nur Administratoren betreten den Abschnitt Allgemein der Einstellungen mit der Befugnis zu löschen. Wenn der Abschnitt sich öffnet, aber beim Speichern etwas fehlschlägt, klären Sie Ihre Rolle mit einem Administrator.