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, 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 é 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
- No celular, abra a página de releases do Obtainium: https://github.com/ImranR98/Obtainium/releases/latest.
- Baixe o arquivo
app-arm64-v8a-release.apk(a maioria dos celulares). Se a instalação falhar, use oapp-release.apk, que serve para todos.- O Obtainium também está no F-Droid e no IzzyOnDroid.
- 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.
- 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:
-
Toque em Add (canto de baixo).
-
Em App source URL, cole:
https://gitea.gobyz.com/giovane.barcelos/lancebids-apps/releases -
Deixe Override source em None: o Obtainium reconhece a página sozinho e mostra "Additional options for HTML".
-
Em Custom APK link filter by regular expression, escreva:
App Filtro LanceBids (produção) lancebids-prd-[0-9.]+\.apkLanceBids Staging (homologação) lancebids-stg-[0-9.]+\.apk -
O resto fica como está. Volte ao topo e toque no + ao lado da URL.
-
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. 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)
- No celular, abra Releases.
- Na versão mais recente (a primeira da lista), toque no APK que quiser.
- 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:
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
CHANGELOGdo 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.
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. |
| 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):
./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.