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 Stg 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

  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.
  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 Stg (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.
  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: 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 Stg 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):

./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.

S
Description
APKs do LanceBids para Android (produção e homologação), para instalar fora da loja
Readme
41 KiB
0 Stars 1 Watchers 0 Forks
2026-11-20 10:03:57 -03:00