README: APKs de stg e prd

This commit is contained in:
giovane.barcelos committed 2026-11-20 15:18:12 -03:00
1 parent 9effcb6fe6
commit 4a67b63871
1 file changed
+22 -9
+22 -9
View File
@@ -1,12 +1,16 @@
# OptiqScale: APK para Android
# OptiqScale: APKs para Android
O aplicativo do OptiqScale para instalar **fora da loja**, enquanto o app não está na Play Store.
Os aplicativos do OptiqScale 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/optiqscale-apps/releases),
com as notas do que mudou e um arquivo:
com as notas do que mudou e dois arquivos:
| Arquivo | App no celular | Fala com |
|---|---|---|
| `optiqscale-X.Y.Z.apk` | **OptiqScale** (`com.optiqscale.app`) | `api.optiqscale.com` |
| Arquivo | App no celular | Fala com | Para quê |
|---|---|---|---|
| `optiqscale-prd-X.Y.Z.apk` | **OptiqScale** | produção (`api.optiqscale.com`) | o app de verdade, com dados reais |
| `optiqscale-stg-X.Y.Z.apk` | **OptiqScale Staging** | homologação (`stg.api.optiqscale.gobyz.com`) | testar a versão nova sem mexer em dados reais |
Os dois têm identificadores diferentes (`com.optiqscale.app` e `com.optiqscale.app.stg`), então podem ficar
instalados **lado a lado**. Os dados de homologação podem ser apagados e recriados a qualquer momento.
Há dois tipos de release:
@@ -38,11 +42,19 @@ O [Obtainium](https://github.com/ImranR98/Obtainium) é um app gratuito e de có
### Adicionar o OptiqScale no Obtainium
Faça uma vez para cada app que quiser (produção, homologação ou os dois).
1. Toque em **Add** (canto de baixo).
2. Em **App source URL**, cole: `https://gitea.gobyz.com/giovane.barcelos/optiqscale-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 `optiqscale-[0-9][^/]*\.apk`.
4. Em **Custom APK link filter by regular expression**, escreva:
| App | Filtro |
|---|---|
| OptiqScale (produção) | `optiqscale-prd-[^/]*\.apk` |
| OptiqScale Staging (homologação) | `optiqscale-stg-[^/]*\.apk` |
5. Para receber também as **prévias**, ligue **Include prereleases**. Desligado, só as versões fechadas.
6. O resto fica como está. Volte ao topo e toque no **+** ao lado da URL.
7. Na tela do app, toque em **Install**:
@@ -61,7 +73,7 @@ O Obtainium confere a página de tempos em tempos e manda uma notificação quan
## Jeito 2: download direto (sem atualização automática)
1. No celular, abra [Releases](https://gitea.gobyz.com/giovane.barcelos/optiqscale-apps/releases).
2. Na versão mais recente (a primeira da lista), toque no APK.
2. Na versão mais recente (a primeira da lista), toque no APK que quiser (`prd` ou `stg`).
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).
@@ -100,6 +112,7 @@ disso. Detalhes: [Android developer verification](https://developer.android.com/
| "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. Se a versão nova é uma prévia, ligue **Include prereleases**. |
| O app abre, mas não entra | Confira a internet. Se persistir, pode ser manutenção do servidor: tente mais tarde. |
| Instalei a prévia `v0.1.0-dev.53` | Ela saiu antes da homologação, com um arquivo só (`optiqscale-0.1.0-dev.53.apk`, produção). Troque o filtro do Obtainium para o de produção da tabela acima; a atualização instala por cima. |
## Para quem publica
@@ -107,7 +120,7 @@ O APK sai do repositório do projeto:
```bash
./scripts/publish-apks.sh X.Y.Z # versão fechada (tag vX.Y.Z)
./scripts/publish-apks.sh --dev # prévia do commit atual
./scripts/publish-apks.sh --dev # prévia do commit atual (stg e prd)
```
O script compila, assina com a chave de release (que fica fora do Git), confere a assinatura e cria o release