KEPLIN Docs

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.

Sidofältet med de fästa apparna i mittzonen, appen Kundhantering bland dem
Sidofältet med de fästa apparna i mittzonen, appen Kundhantering bland dem

  • 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.

  1. Klicka på Ny app i rubriken på Översikt eller i sidofältets appzon (knappen med plustecknet, i slutet av listan).
  2. 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.)
  3. Fyll i Namn. Det är namnet som visas i sidofältet och i sidhuvudena — till exempel Kundhantering.
  4. Om du vill, skriv en Beskrivning — en mening som säger resten av teamet vad appen är till för.
  5. Välj Ikon (se nästa avsnitt).
  6. 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önstret Ny app med fliken Skapa från grunden ifylld för appen Kundhantering
Fönstret Ny app med fliken Skapa från grunden ifylld för appen Kundhantering

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:

  1. Öppna appen, på Översikt eller i sidofältet.
  2. Överst i appens fält, klicka på kugghjulsknappen Appens inställningar och välj Allmänt.
  3. 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.
  4. Klicka på Spara. Bekräftelsen ”Inställningarna har sparats.” visas, och Översikt och sidofältet uppdateras genast.

Panelen Identifikation i avsnittet Allmänt i inställningarna för appen Kundhantering
Panelen Identifikation i avsnittet Allmänt i inställningarna för appen Kundhantering

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:

  1. Öppna Allmänt i Appens inställningar.
  2. 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.
  3. Valfritt: välj under Bakgrundsfärg färgen bakom bildens genomskinliga delar. Tomt är vitt.
  4. Kontrollera under Så ser den ut på Android att det viktiga i bilden ligger inom den streckade cirkeln.
  5. 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.

  1. Öppna Appens inställningar → Allmänt och rulla ner till panelen Ta bort — ”Appen, dess data och filerna. Det finns ingen väg tillbaka.”
  2. Klicka på Ta bort appen.
  3. 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.”
  4. Skriv appens slug (gestao-clientes) i bekräftelsefältet — knappen låses bara upp när texten stämmer exakt.
  5. Klicka på Ta bort permanent. Du är tillbaka på Översikten, utan appen.

Bekräftelsedialogen för att ta bort appen, med sluggen skriven för att låsa upp knappen
Bekräftelsedialogen för att ta bort appen, med sluggen skriven för att låsa upp knappen

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.