# Aplicativo

> A sua plataforma como aplicativo no celular do aluno, sem loja: nome, ícone, cores, como o aluno instala e o vínculo com um app Android.

A sua plataforma pode ficar na tela inicial do celular do aluno como um aplicativo, com o seu nome e o seu ícone. Em **Configurações > Aplicativo** você configura esse aplicativo. Ele não vai para a App Store nem para a Play Store: o aluno instala pelo navegador do celular.

## A ideia em um minuto

O aplicativo é a própria área do aluno, instalada como um app. A tecnologia se chama PWA. Ele abre numa janela própria, sem a barra do navegador, com o seu ícone na tela inicial.

**A regra mais importante:** o aplicativo só fica disponível quando há um **Ícone** enviado. Sem ícone, o celular não oferece a instalação.

O aviso no topo da aba **Identidade do aplicativo** mostra o estado:

- **Aplicativo configurado**: "O ícone está definido e o aplicativo pode ser instalado em dispositivos compatíveis."
- **Configuração pendente**: "Envie um ícone para disponibilizar o aplicativo em dispositivos compatíveis."

## As três abas

As três abas são salvas juntas, por **Salvar agora** na barra do rodapé.

| Aba | O que define |
|---|---|
| **Identidade do aplicativo** | **Nome do aplicativo**, **Ícone** e **ID do aplicativo** |
| **Instalação** | **Descrição do aplicativo**, **Categoria**, **Capturas de tela** e, em **Aparência**, **Cor de fundo** e **Cor do tema** |
| **Vínculo Android** | **Package name** e **SHA256 do certificado** de um app Android próprio, para gerar o **Arquivo de vínculo** |

### Identidade do aplicativo

- **Nome do aplicativo**: o nome na instalação e na tela inicial do celular. Em branco, vale o **Título das páginas** da área do aluno. Prefira um nome curto, porque nomes longos podem ser cortados na tela inicial.
- **Ícone**: PNG quadrado de 1024×1024, até 350 kb. É ele que ativa o aplicativo.
- **ID do aplicativo**: o identificador único do aplicativo, como minha-escola. Não mude depois de publicado: é por ele que o celular reconhece o aplicativo já instalado.

### Instalação

O que o celular mostra quando oferece a instalação:

- **Descrição do aplicativo**: o texto que apresenta o aplicativo.
- **Categoria**: a que melhor representa o conteúdo. As opções são **Negócios (Business)**, **Educação (Education)**, **Finanças (Finance)**, **Estilo de Vida (Lifestyle)**, **Produtividade (Productivity)** e **Utilitários (Utilities)**.
- **Capturas de tela**: imagens mostradas durante a instalação. PNG ou JPG vertical (9:16), até 800 kb por imagem. Você pode enviar mais de uma.
- **Cor de fundo**: a cor da tela de carregamento, quando o aplicativo abre.
- **Cor do tema**: a cor de partes da interface do aplicativo, conforme o aparelho. Por exemplo, a barra de status.

### Vínculo Android

Esta aba é só para quem tem um aplicativo Android próprio, publicado na Play Store, que abre este domínio. O Android pede um arquivo público no seu domínio que prove o vínculo entre o app e o site.

- Informe o **Package name**, como com.suaempresa.seuapp.
- Informe o **SHA256 do certificado** de assinatura do app, no formato AA:BB:CC:… ou AABBCC….

Com os dois salvos, a tela mostra o **Arquivo de vínculo** e o botão **Abrir arquivo**. O arquivo de vínculo é o endereço público que o Android consulta. Até lá, o status é **Vínculo pendente**.

Os dois campos são opcionais e independentes. Com só um preenchido, o arquivo não é publicado, mas o resto da tela salva normalmente. Um valor fora do formato é recusado, com a mensagem do campo.

## Passo a passo

Para ativar o aplicativo:

1. No painel, abra **Configurações > Aplicativo**.
2. Em **Identidade do aplicativo**, preencha **Nome do aplicativo**.
3. Envie o **Ícone**.
4. Defina o **ID do aplicativo**. Faça isso uma vez só.
5. Abra a aba **Instalação**.
6. Escreva a **Descrição do aplicativo** e escolha a **Categoria**.
7. Envie as **Capturas de tela**.
8. Ajuste **Cor de fundo** e **Cor do tema**.
9. Clique em **Salvar agora**.

O aviso da primeira aba passa a **Aplicativo configurado**. Para ver o resultado como o aluno vê, abra a plataforma no celular e instale.

## Como o aluno instala

1. No celular, o aluno abre o endereço da plataforma no navegador.
2. Ele usa a opção de instalar do próprio navegador: **Adicionar à Tela de Início** no Safari do iPhone, ou **Instalar** ou **Adicionar à tela inicial** no Android.

Depois de instalado, o ícone fica na tela inicial com o **Nome do aplicativo**. O aplicativo abre direto na plataforma.

Na tela de login do modelo Clássico ([Telas de acesso](https://help.cademi.cloud/pt/configuracoes/telas-de-acesso.md)), a plataforma ajuda o aluno. Por alguns segundos, ela mostra a instrução do navegador em uso, com o ícone do botão a tocar.

**Atenção: é aqui que mais acontece erro.** A Bia tenta instalar pelo Chrome do iPhone e não acha a opção. No iPhone, a instalação só funciona pelo Safari. Em outro navegador, o aviso pede para abrir pelo Safari.

## Bom saber

- **O aplicativo é a área do aluno.** O aluno vê no aplicativo o mesmo que no navegador: os mesmos produtos, as mesmas regras de acesso, o mesmo login. Não há conteúdo para usar sem internet.
- **A Cademí não envia notificações pelo aplicativo.** Instalar o aplicativo não cadastra o aluno em nenhum aviso no celular.
- **No iPhone, o nome é o Título das páginas.** O Safari usa o **Título das páginas** da área do aluno como nome do aplicativo na tela inicial. O **Nome do aplicativo** vale no Android e nos outros navegadores.
- **Mudou o ícone ou o nome?** Quem já instalou pode continuar vendo o ícone e o nome antigos. Reinstalar resolve. Mudar o **ID do aplicativo** depois que alunos instalaram pode fazer o celular tratar o aplicativo como outro. Evite.
- **Domínio próprio.** O aplicativo fica ligado ao endereço pelo qual foi instalado. Com um [Domínio](https://help.cademi.cloud/pt/configuracoes/dominio.md) ativo, peça aos alunos para instalar pelo domínio próprio.

## Perguntas frequentes

**A Cademí tem aplicativo na App Store ou na Play Store?** Não. O aplicativo é a sua plataforma instalada pelo navegador, com o seu nome e o seu ícone, sem loja. O **Vínculo Android** é só para quem publicou um app Android próprio.

**O aluno não acha a opção de instalar.** No iPhone, só o Safari instala. Peça para ele abrir o endereço no Safari, tocar em compartilhar e depois em **Adicionar à Tela de Início**. No Android, a opção fica no menu do navegador. Confira também se o aviso do topo da tela diz **Aplicativo configurado**.

**Instalei e o ícone é o padrão da Cademí.** O ícone é o enviado em **Ícone**. Sem envio, o aplicativo não é oferecido. Se você trocou o ícone depois de o aluno instalar, ele pode continuar vendo o antigo. Reinstalar resolve.