From 15cc959890c1f252106703ae7ee67458be9c9eea Mon Sep 17 00:00:00 2001 From: Giovane Barcelos Date: Tue, 17 Nov 2026 22:13:20 -0300 Subject: [PATCH] =?UTF-8?q?README:=20como=20instalar=20os=20APKs=20do=20La?= =?UTF-8?q?nceBids=20e=20acompanhar=20as=20vers=C3=B5es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 118 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 118 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..22226dc --- /dev/null +++ b/README.md @@ -0,0 +1,118 @@ +# 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 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](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: + . +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 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](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 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`): + +```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.