KEPLIN Docs

Criar e gerir apps

Onde vivem as apps, como se cria uma no modal Nova app, como se muda o nome e o ícone, e como se apaga uma app sem surpresas.

No Keplin, a app é a unidade de tudo: cada aplicação que constróis — com o seu modelo de dados, os seus ecrãs, as suas APIs, os seus scripts, os seus utilizadores e as suas definições — é uma app, auto-contida e independente das outras. Esta página mostra onde as apps aparecem, como se cria uma, como se lhe muda a identificação, e o que acontece (exactamente) quando se apaga.

Onde vivem as apps

As apps estão em dois sítios:

  • O Dashboard, a primeira página depois de entrar, tem uma linha por app que a tua conta pode abrir, com a actividade das últimas 24 horas. Clica no nome de uma app para a abrir. Ver O espaço de trabalho.
  • A barra lateral esquerda mostra, ao centro, as apps que fixaste no Dashboard com o pin Fixar no menu lateral. A barra divide-se em três zonas: em cima o Dashboard, em baixo a administração (Observabilidade, Utilizadores, API Keys, Definições), e ao centro as apps fixas, cada uma com o seu ícone e o seu nome. É a única zona da barra que ganha scroll quando as apps são muitas.

A barra lateral com as apps na zona do meio, a app Gestão de Clientes entre elas
A barra lateral com as apps na zona do meio, a app Gestão de Clientes entre elas

  • Com a barra recolhida vês só os ícones; passa o rato por cima para a expandir, ou usa Afixar sidebar (o pin no topo) para a manter aberta.
  • Clica numa app para a abrir: entras no espaço de trabalho dela, no separador Visão geral, com as árvores de conteúdo (UI, Código, Dados, Testes, Radar) na barra própria da app.

Nota

Nem toda a gente vê as mesmas apps. Um administrador vê todas; um developer vê apenas as apps que lhe foram atribuídas na ficha dele, em Utilizadores. Se uma app "não aparece", quase sempre é isto.

Criar uma app

Criar uma app é abrir um modal, dar-lhe um nome e um ícone. Só os administradores têm o botão.

  1. No cabeçalho do Dashboard, ou na zona das apps da barra lateral (o botão com o sinal de mais, no fim da lista), clica em Nova app.
  2. Abre-se o modal Nova app — "Escolhe como a app nasce: vazia, com datasource, de um template, ou importada." — com quatro cartões: Aplicação vazia, Aplicação com datasource, A partir de template e Importar pacote. Para uma app de raiz, escolhe Aplicação vazia. (O cartão Aplicação com datasource faz o mesmo e cria já o primeiro datasource SQLite da app, pronto a usar nos ecrãs; os templates e a importação têm páginas próprias neste capítulo.)
  3. Preenche o Nome. É o nome que aparece na barra lateral e nos cabeçalhos — por exemplo, Gestão de Clientes.
  4. Se quiseres, escreve uma Descrição — uma frase que diga ao resto da equipa para que serve a app.
  5. Escolhe o Ícone (ver a secção seguinte).
  6. Clica em Criar app. A app nasce vazia, aparece no Dashboard e o espaço de trabalho dela abre-se de imediato. Para a teres também na barra lateral, fixa-a no Dashboard com Fixar no menu lateral.

O modal Nova app com o separador Criar de raiz preenchido para a app Gestão de Clientes
O modal Nova app com o separador Criar de raiz preenchido para a app Gestão de Clientes

Campo Obrigatório Limites Para que serve
Nome Sim 2 a 120 caracteres O nome visível da app, em todo o lado.
Descrição Não Até 500 caracteres Contexto para a equipa; aparece no cabeçalho da app.
Ícone Não — A cara da app na barra lateral. Sem escolha, fica o foguetão.

O slug — o identificador que nasce com a app

Ao lado do campo Nome está a nota: "O slug é derivado automaticamente do nome." O slug é a versão curta e técnica do nome — minúsculas, sem espaços nem acentos: Gestão de Clientes dá gestao-clientes. É ele que identifica a app nos endereços (a versão de trabalho responde em /app/gestao-clientes), na exportação e na confirmação de apagar.

Atenção

O slug tem de ser único na instalação e não se muda depois de a app existir. Se já houver uma app com o mesmo slug, a criação pára com o erro "Já existe um projecto com o slug…" — muda o nome (ou apaga a app antiga) e tenta de novo.

O ícone da app

O campo Ícone abre o selector Escolher ícone da plataforma: uma grelha com centenas de ícones e uma caixa "Pesquisar ícones…" para filtrar pelo nome. Clica num ícone para o escolher; Predefinido volta ao foguetão de origem.

O ícone escolhido acompanha a app em todo o lado: na barra lateral, no cabeçalho do espaço de trabalho, e viaja com ela quando a exportas num pacote. Numa instalação com muitas apps, um ícone distinto vale ouro — é por ele que se encontra a app com a barra recolhida.

Mudar o nome, a descrição ou o ícone

A identificação da app muda-se nas definições dela, a qualquer momento:

  1. Abre a app, no Dashboard ou na barra lateral.
  2. No topo da barra da app, clica no botão de engrenagem Definições da app e escolhe Geral.
  3. No painel Identificação, altera o Nome, a Descrição ou o ícone. O ícone está mesmo ao lado do nome, porque é assim que os dois aparecem no Dashboard e na barra lateral.
  4. Clica em Gravar. A confirmação "Settings gravadas." aparece, e o Dashboard e a barra lateral actualizam-se logo.

O painel Identificação na secção Geral das definições da app Gestão de Clientes
O painel Identificação na secção Geral das definições da app Gestão de Clientes

Nota

Mudar o nome não muda o slug nem nenhum endereço publicado — quem usa a app não nota nada. O nome é cosmético; o slug é estrutural.

O ícone no telemóvel

O KeplinGo põe um atalho de cada app no ecrã principal do telemóvel (ver Ligar o telemóvel a uma app). O ícone desse atalho escolhe-se no painel Ícone no telemóvel da secção Geral.

Para escolher o ícone no telemóvel, segue estes passos:

  1. Nas Definições da app, abre Geral.
  2. No painel Ícone no telemóvel, clica em Carregar imagem e escolhe a imagem. Para usar uma imagem que já está nos assets da app, clica no botão da imagem, à esquerda de Carregar imagem.
  3. Opcional: em Cor de fundo, escolhe a cor que fica por trás das partes transparentes da imagem. Vazio é branco.
  4. Em Como fica no Android, confirma que o desenho importante fica dentro do círculo tracejado.
  5. Clica em Gravar.

A imagem tem de ser PNG, JPG ou WebP, quadrada, com pelo menos 432 × 432 px. O Android corta os cantos com a forma escolhida pelo fabricante do telemóvel (círculo, superelipse ou quadrado arredondado), e só o círculo central, com cerca de 61 % do lado, aparece sempre. A pré-visualização mostra a imagem inteira com essa zona segura, e a imagem recortada por cada uma das três formas.

Sem imagem, o KeplinGo desenha o Ícone da app sobre a cor principal do tema. Os telemóveis actualizam o atalho na abertura seguinte da app.

Nota

Carregar imagem grava a imagem logo nos assets da app, na pasta mobile/. O ícone do atalho só muda depois de Gravar.

Apagar uma app

Apagar uma app é definitivo, e por isso a plataforma pede mais do que um clique.

  1. Abre Definições da app → Geral e desce até ao painel Apagar — "A app, os dados dela e os ficheiros. Não há volta."
  2. Clica em Eliminar app.
  3. Abre-se o diálogo de confirmação 'Eliminar "Gestão de Clientes"?', que avisa: 'Apaga a app "Gestão de Clientes" com todas as APIs, datasources, API keys e packages. Não há volta atrás — as apps consumidoras perdem acesso imediatamente.'
  4. Escreve o slug da app (gestao-clientes) no campo de confirmação — o botão só desbloqueia quando o texto coincidir exactamente.
  5. Clica em Eliminar definitivamente. Voltas ao Dashboard, já sem a app.

O diálogo de confirmação para eliminar a app, com o slug escrito para desbloquear o botão
O diálogo de confirmação para eliminar a app, com o slug escrito para desbloquear o botão

O que acontece, com precisão:

É apagado A app inteira nesta instalação: modelo, ecrãs, APIs, scripts, relatórios, workflows, todas as versões, as contas dos utilizadores da app, os ficheiros guardados no disco da app e o histórico dela.
Deixa de funcionar já Os endereços publicados e as API keys da app — qualquer sistema que a consumisse perde o acesso no momento.
Fica intacto A auditoria (quem fez o quê continua consultável na Observabilidade) e tudo o que é infraestrutura externa: bases de dados de outros sistemas a que a app se ligava, ficheiros em S3, SFTP ou partilhas de rede. Apagar a app nunca apaga dados fora dela.

Atenção

Não há reciclagem nem "anular". Antes de apagar uma app com trabalho dentro, exporta-a como pacote — a página "Importar e exportar apps" explica como, e um pacote guardado é a única forma de a recuperar depois.

Porque não vejo…?

  • …o botão Nova app? Criar e importar apps é exclusivo dos administradores. Com perfil de developer, o botão não aparece — pede a um administrador que crie a app e ta atribua.
  • …uma app que existe? A tua conta não tem essa app atribuída. Um administrador resolve na ficha da tua conta, em Utilizadores.
  • …o painel Apagar? Só os administradores entram na secção Geral das definições com poderes para eliminar. Se a secção abre mas algo falha ao gravar, confirma o teu perfil com um administrador.