Files
lancebids-apps/README.md
T

119 lines
6.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# LanceBids: APKs para Android
Os aplicativos do LanceBids para instalar **fora da loja**, enquanto o app não está na Play Store.
Cada versão publicada aparece em [Releases](https://gitea.gobyz.com/giovane.barcelos/lancebids-apps/releases),
com as notas do que mudou e dois arquivos:
| Arquivo | App no celular | Fala com | Para quê |
|---|---|---|---|
| `lancebids-prd-X.Y.Z.apk` | **LanceBids** | produção (`api.lancebids.com`) | o app de verdade, com dados reais |
| `lancebids-stg-X.Y.Z.apk` | **LanceBids Staging** | homologação (`stg.api.lancebids.gobyz.com`) | testar a versão nova com dados de demonstração |
Os dois têm identificadores diferentes (`com.lancebids.auctions` e `com.lancebids.auctions.stg`), então podem
ficar instalados **lado a lado**. Requisito: **Android 7.0 ou mais novo**. Para iPhone não há instalação fora da
App Store (a Apple exige conta de desenvolvedor paga).
> Este repositório só guarda os instaláveis. O código do LanceBids é privado.
## Jeito 1: com o Obtainium (recomendado, atualiza sozinho)
O [Obtainium](https://github.com/ImranR98/Obtainium) é um app gratuito e de código aberto que faz o papel de
"loja": acompanha esta página, avisa quando sai versão nova, mostra as notas e instala com um toque.
### Instalar o Obtainium
1. No celular, abra a página de releases do Obtainium:
<https://github.com/ImranR98/Obtainium/releases/latest>.
2. Baixe o arquivo `app-arm64-v8a-release.apk` (a maioria dos celulares). Se a instalação falhar, use o
`app-release.apk`, que serve para todos.
- O Obtainium também está no [F-Droid](https://f-droid.org/packages/dev.imranr.obtainium.fdroid/) e no
[IzzyOnDroid](https://apt.izzysoft.de/fdroid/index/apk/dev.imranr.obtainium).
3. Abra o arquivo baixado. Na primeira vez, o Android pede para **permitir instalar apps desta fonte** (o
navegador ou o gerenciador de arquivos): permita e volte.
4. Abra o Obtainium e aceite as notificações (é por elas que chega o aviso de versão nova).
### Adicionar o LanceBids no Obtainium
Faça uma vez para cada app que quiser (produção, homologação ou os dois). Em **Adicionar app**:
| Campo | LanceBids (produção) | LanceBids Staging (homologação) |
|---|---|---|
| URL da fonte | `https://gitea.gobyz.com/giovane.barcelos/lancebids-apps/releases` | a mesma |
| Fonte (override) | **HTML** | **HTML** |
| Filtro de links de APK (regex) | `lancebids-prd-[0-9.]+\.apk` | `lancebids-stg-[0-9.]+\.apk` |
| Extrair versão (regex) | `[0-9]+\.[0-9]+\.[0-9]+` | a mesma |
Depois toque em **Adicionar**, e então em **Instalar**. O Android pede, na primeira vez, para permitir que o
**Obtainium** instale apps: permita.
Se aparecer a fonte **Forgejo (Codeberg)** e ela aceitar a URL do repositório
(`https://gitea.gobyz.com/giovane.barcelos/lancebids-apps`), ela também serve: o Gitea fala a mesma API. Aí use
só o filtro de APK da tabela.
### Atualizar
O Obtainium confere a página de tempos em tempos (o intervalo fica nas configurações dele) e manda uma
notificação quando sai versão nova. Toque em **Atualizar**; as notas da versão aparecem antes. Para conferir na
hora, puxe a lista para baixo.
## Jeito 2: download direto (sem atualização automática)
1. No celular, abra [Releases](https://gitea.gobyz.com/giovane.barcelos/lancebids-apps/releases).
2. Na versão mais recente (a primeira da lista), toque no APK que quiser.
3. Abra o arquivo baixado e permita **instalar apps desta fonte** quando o Android pedir.
Para atualizar, repita: o Android instala a versão nova por cima e mantém os seus dados (e o login).
## Versões
- O número segue o [Versionamento Semântico](https://semver.org/lang/pt-BR/): `MAJOR.MINOR.PATCH`.
- **PATCH** (1.41.**1**): correções.
- **MINOR** (1.**42**.0): novidades que não quebram nada.
- **MAJOR** (**2**.0.0): mudança que pede atenção (por exemplo, reinstalar ou entrar de novo).
- Cada release traz as notas do que mudou, as mesmas do `CHANGELOG` do projeto.
- O app de produção é o mesmo que roda em `lancebids.com`. O de homologação recebe a versão antes ou junto,
para conferir.
- O Android só aceita atualizar para uma versão **igual ou mais nova**. Para voltar a uma versão anterior,
desinstale e instale a antiga (os dados locais do app se perdem; os da sua conta ficam no servidor).
## Assinatura
Todos os APKs são assinados com a mesma chave. É ela que permite instalar uma versão por cima da outra. A
impressão digital do certificado (SHA-256) é:
```
4A:17:AC:3E:7F:07:6C:55:F8:9D:DE:AE:AB:5F:09:5D:B8:FA:EF:1D:B7:EE:52:98:63:DB:94:FC:D1:64:98:96
```
Para conferir um APK no computador (com o Android SDK): `apksigner verify --print-certs lancebids-prd-X.Y.Z.apk`.
## Contas de teste (homologação)
O app **LanceBids Staging** tem dados de demonstração: leilões ao vivo, eventos, vendas e contas em vários perfis
(compradora, comitente, leiloeira, admin). As contas e a senha **não ficam aqui**, porque esta página é pública:
peça a quem mantém o projeto. Os dados de homologação podem ser apagados e recriados a qualquer momento.
No app de **produção** não há dados de teste: crie a sua conta normalmente.
## Problemas comuns
| Sintoma | O que fazer |
|---|---|
| "App não instalado" ou "conflito com pacote existente" | O app instalado foi assinado com outra chave (uma versão de desenvolvimento, por exemplo). Desinstale o LanceBids e instale de novo. |
| "Instalação bloqueada" / "fonte desconhecida" | Permita instalar apps da fonte que pediu (navegador, gerenciador de arquivos ou Obtainium) em Configurações › Apps › Acesso especial › Instalar apps desconhecidos. |
| O Obtainium não acha versão nova | Confira a URL e o filtro de APK da tabela; puxe a lista para baixo para conferir na hora. |
| O app abre, mas não carrega nada | Confira a internet. Se persistir, pode ser manutenção do servidor: tente mais tarde. |
| Instalei pela Play Store e por aqui | Quando o app chegar à Play Store, a versão de lá terá outra assinatura (a do Google). Para trocar de uma para a outra, desinstale e instale de novo. |
## Para quem publica
Os APKs saem do repositório do projeto, depois de fechar a versão (tag `vX.Y.Z`):
```bash
./scripts/publish-apks.sh X.Y.Z
```
O script compila a partir da tag, assina com a chave de release (que fica fora do Git), confere a assinatura e
cria o release aqui com as notas do `CHANGELOG.md`. A chave de assinatura **não pode se perder**: sem ela,
nenhuma versão nova atualiza as instaladas, e todo mundo precisa desinstalar e instalar de novo.