Skapa och hantera appar
Var apparna bor, hur man skapar en i fönstret Ny app, hur man byter namn och ikon, och hur man tar bort en app utan överraskningar.
I Keplin är appen enheten för allt: varje applikation du bygger — med sin datamodell, sina skärmar, sina API:er, sina skript, sina användare och sina inställningar — är en app, självständig och oberoende av de andra. Den här sidan visar var apparna dyker upp, hur man skapar en, hur man ändrar dess identifikation, och vad som (exakt) händer när man tar bort en.
Var apparna bor
Apparna finns på två ställen:
- Översikt, den första sidan efter inloggningen, har en rad per app som ditt konto kan öppna, med aktiviteten de senaste 24 timmarna. Klicka på en apps namn för att öppna den. Se Arbetsytan.
- Det vänstra sidofältet visar i mitten de appar som du har fäst på Översikt med nålen Fäst i sidomenyn. Fältet är delat i tre zoner: överst Översikt, nederst administrationen (Observerbarhet, Användare, API-nycklar, Inställningar) och i mitten de fästa apparna, var och en med sin ikon och sitt namn. Det är den enda zonen i fältet som får scroll när apparna blir många.

- Med fältet hopfällt ser du bara ikonerna; håll muspekaren över det för att fälla ut det, eller använd Fäst sidofältet (nålen överst) för att hålla det öppet.
- Klicka på en app för att öppna den: du kommer till dess arbetsyta, på fliken Översikt, med innehållsträden (UI, Kod, Data, Tester, Radar) i appens eget fält.
Obs
Alla ser inte samma appar. En administratör ser alla; en developer ser bara de appar som tilldelats hen i hens formulär, under Användare. Om en app ”inte syns” är det nästan alltid det här.
Skapa en app
Att skapa en app är att öppna ett fönster, ge den ett namn och en ikon. Bara administratörerna har knappen.
- Klicka på Ny app i rubriken på Översikt eller i sidofältets appzon (knappen med plustecknet, i slutet av listan).
- Fönstret Ny app öppnas — ”Välj hur appen föds: tom, med datasource, från en mall eller importerad.” — med fyra kort: Tom app, App med datasource, Från en mall och Importera paket. För en app från grunden, välj Tom app. (Kortet App med datasource gör detsamma och skapar direkt appens första SQLite-datasource; mallar och import har egna sidor i det här kapitlet.)
- Fyll i Namn. Det är namnet som visas i sidofältet och i
sidhuvudena — till exempel
Kundhantering. - Om du vill, skriv en Beskrivning — en mening som säger resten av teamet vad appen är till för.
- Välj Ikon (se nästa avsnitt).
- Klicka på Skapa app. Appen föds tom, dyker upp på Översikt och dess arbetsyta öppnas direkt. Om du vill ha den i sidofältet också fäster du den på Översikt med Fäst i sidomenyn.

| Fält | Obligatoriskt | Gränser | Vad det är till för |
|---|---|---|---|
| Namn | Ja | 2 till 120 tecken | Appens synliga namn, överallt. |
| Beskrivning | Nej | Upp till 500 tecken | Kontext för teamet; visas i appens sidhuvud. |
| Ikon | Nej | — | Appens ansikte i sidofältet. Utan val blir det raketen. |
Sluggen — identifieraren som föds med appen
Bredvid fältet Namn står anteckningen: ”Sluggen härleds automatiskt
från namnet.” Sluggen är namnets korta, tekniska version — gemener, utan
mellanslag eller accenter: Gestão de Clientes ger gestao-clientes. Det
är den som identifierar appen i adresserna (arbetsversionen svarar på
/app/gestao-clientes), i exporten och i bekräftelsen vid borttagning.
Varning
Sluggen måste vara unik i installationen och ändras inte efter att appen finns. Om det redan finns en app med samma slug stannar skapandet med felet ”Det finns redan ett projekt med sluggen…” — byt namn (eller ta bort den gamla appen) och försök igen.
Appens ikon
Fältet Ikon öppnar plattformens väljare Välj ikon: ett rutnät med hundratals ikoner och en ruta ”Sök ikoner…” för att filtrera på namnet. Klicka på en ikon för att välja den; Standard går tillbaka till raketen.
Den valda ikonen följer appen överallt: i sidofältet, i arbetsytans sidhuvud, och den reser med appen när du exporterar den i ett paket. I en installation med många appar är en distinkt ikon guld värd — det är på den man hittar appen med sidofältet hopfällt.
Byta namn, beskrivning eller ikon
Appens identifikation ändras i dess inställningar, när som helst:
- Öppna appen, på Översikt eller i sidofältet.
- Överst i appens fält, klicka på kugghjulsknappen Appens inställningar och välj Allmänt.
- I panelen Identifikation, ändra Namn, Beskrivning eller ikonen. Ikonen ligger alldeles bredvid namnet, för det är så de två visas på Översikt och i sidofältet.
- Klicka på Spara. Bekräftelsen ”Inställningarna har sparats.” visas, och Översikt och sidofältet uppdateras genast.

Obs
Att byta namn ändrar inte sluggen eller någon publicerad adress — den som använder appen märker ingenting. Namnet är kosmetiskt; sluggen är strukturell.
Ikonen i telefonen
KeplinGo lägger en genväg till varje app på mobilens hemskärm (se Ansluta mobilen till en app). Ikonen för den genvägen väljs i panelen Ikon i telefonen i avsnittet Allmänt.
Så här väljer du ikonen i telefonen:
- Öppna Allmänt i Appens inställningar.
- Klicka på Ladda upp bild i panelen Ikon i telefonen och välj bilden. Om du vill använda en bild som redan finns bland appens assets klickar du på bildknappen till vänster om Ladda upp bild.
- Valfritt: välj under Bakgrundsfärg färgen bakom bildens genomskinliga delar. Tomt är vitt.
- Kontrollera under Så ser den ut på Android att det viktiga i bilden ligger inom den streckade cirkeln.
- Klicka på Spara.
Bilden måste vara en kvadratisk PNG, JPG eller WebP på minst 432 × 432 px. Android beskär hörnen med den form som mobilens tillverkare har valt (cirkel, superellips eller rundad kvadrat), och bara den mittersta cirkeln, ungefär 61 % av sidan, syns alltid. Förhandsgranskningen visar hela bilden med den säkra zonen, och bilden beskuren av var och en av de tre formerna.
Utan bild ritar KeplinGo appens Ikon på temats huvudfärg. Mobilerna uppdaterar genvägen nästa gång appen öppnas.
Obs
Ladda upp bild sparar bilden direkt bland appens assets, i mappen
mobile/. Genvägens ikon ändras först efter Spara.
Ta bort en app
Att ta bort en app är definitivt, och därför kräver plattformen mer än ett klick.
- Öppna Appens inställningar → Allmänt och rulla ner till panelen Ta bort — ”Appen, dess data och filerna. Det finns ingen väg tillbaka.”
- Klicka på Ta bort appen.
- Bekräftelsedialogen ”Ta bort ’Kundhantering’?” öppnas och varnar: ”Tar bort appen ’Kundhantering’ med alla dess API:er, datakällor, API-nycklar och paket. Det finns ingen väg tillbaka — de appar som använder den förlorar åtkomsten omedelbart.”
- Skriv appens slug (
gestao-clientes) i bekräftelsefältet — knappen låses bara upp när texten stämmer exakt. - Klicka på Ta bort permanent. Du är tillbaka på Översikten, utan appen.

Vad som händer, med precision:
| Tas bort | Hela appen i den här installationen: modell, skärmar, API:er, skript, rapporter, arbetsflöden, alla versioner, appanvändarnas konton, filerna som sparats på appens disk och dess historik. |
| Slutar fungera direkt | Appens publicerade adresser och API-nycklar — varje system som använde den förlorar åtkomsten i samma ögonblick. |
| Förblir intakt | Granskningen (vem som gjorde vad går fortfarande att slå upp i Observerbarheten) och allt som är extern infrastruktur: andra systems databaser som appen kopplade sig till, filer i S3, SFTP eller nätverksutdelningar. Att ta bort appen tar aldrig bort data utanför den. |
Varning
Det finns ingen papperskorg och inget ”ångra”. Innan du tar bort en app med arbete i, exportera den som ett paket — sidan ”Importera och exportera appar” förklarar hur, och ett sparat paket är det enda sättet att få tillbaka den efteråt.
Varför ser jag inte…?
- …knappen Ny app? Att skapa och importera appar är förbehållet administratörerna. Med developer-profil visas inte knappen — be en administratör att skapa appen och tilldela dig den.
- …en app som finns? Ditt konto har inte den appen tilldelad. En administratör löser det i ditt kontos formulär, under Användare.
- …panelen Ta bort? Bara administratörer kommer in i avsnittet Allmänt i inställningarna med rätt att ta bort. Om avsnittet öppnas men något misslyckas när du sparar, bekräfta din profil med en administratör.