Files

142 lines
8.1 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.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). Conferido com o Obtainium 1.7.4:
1. Toque em **Add** (canto de baixo).
2. Em **App source URL**, cole: `https://gitea.gobyz.com/giovane.barcelos/lancebids-apps/releases`
3. Deixe **Override source** em **None**: o Obtainium reconhece a página sozinho e mostra
"Additional options for HTML".
4. Em **Custom APK link filter by regular expression**, escreva:
| App | Filtro |
|---|---|
| LanceBids (produção) | `lancebids-prd-[0-9.]+\.apk` |
| LanceBids Staging (homologação) | `lancebids-stg-[0-9.]+\.apk` |
5. O resto fica como está. Volte ao topo e toque no **+** ao lado da URL.
6. Na tela do app, toque em **Install**:
- na primeira vez, o Android pede para permitir que o **Obtainium** instale apps: ative e volte;
- o **Google Play Protect** avisa que não conhece o app e recomenda uma análise: toque em **Scan app** e,
quando disser que o app parece seguro, em **Install**.
Na lista do Obtainium, a versão do LanceBids aparece como um código curto (por exemplo `cf614a6d`), tirado do
próprio arquivo. Ele muda a cada versão, e é assim que o Obtainium percebe que saiu uma nova. O número de
verdade (1.41.2, por exemplo) está no nome do arquivo e nas notas do release.
Opcional, para mais segurança: em **Expected signing certificate hashes**, cole a impressão digital da seção
[Assinatura](#assinatura). Assim o Obtainium recusa um APK que não tenha sido assinado pela chave do LanceBids.
### 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`.
## Verificação de desenvolvedores do Google
Desde 30/09/2026, no Brasil (e na Indonésia, em Singapura e na Tailândia), o Google exige desenvolvedor
registrado para apps instalados por algumas lojas (Play, Galaxy Store, Xiaomi GetApps e outras). Pelo FAQ do
Google, APK baixado direto, como os daqui, ainda não é afetado nesta fase. Em **2027**, a exigência passa a valer
no mundo todo, para qualquer app em celular Android certificado. App de desenvolvedor não registrado só instala
por um "fluxo avançado" (modo de desenvolvedor, uma espera de 24 h e um aviso de "desenvolvedor não
verificado") ou por ADB.
O LanceBids vai registrar os seus pacotes antes disso, para a instalação por aqui continuar simples. Detalhes:
[Android developer verification](https://developer.android.com/developer-verification).
## 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. |
| Aviso de "desenvolvedor não verificado" | Veja [Verificação de desenvolvedores do Google](#verificação-de-desenvolvedores-do-google). |
| 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.