142 lines
8.1 KiB
Markdown
142 lines
8.1 KiB
Markdown
# 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). 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.
|