Skip to content

docs: caminho canônico do keystore de release Android - #463

Merged
johnlaff merged 1 commit into
mainfrom
docs/keystore-canonico
Aug 14, 2026
Merged

docs: caminho canônico do keystore de release Android#463
johnlaff merged 1 commit into
mainfrom
docs/keystore-canonico

Conversation

@johnlaff

Copy link
Copy Markdown
Owner

O quê e por quê

O keystore de release Android precisa viver fora de qualquer worktree — worktrees de build são
descartáveis (git worktree add ... --detach), então gerar o .jks dentro de um deles arrisca
perdê-lo junto com a limpeza do worktree, como já aconteceu uma vez.

Este PR só documenta o fluxo já em uso: keystore em ~/.local/share/neko-finance/ (fora do repo,
durável), keystore.properties ao lado com storeFile absoluto, copiado (não gerado) para
src-tauri/gen/android/keystore.properties em cada worktree de build. Também registra uma
armadilha real do keytool moderno: o formato PKCS12 padrão não suporta senha de chave diferente
da senha de armazenamento — passar -keypass diferente é silenciosamente ignorado.

Como verificar

  • docs/building-android.md, seção "1. Provisioning the release keystore" — único arquivo tocado.
  • git diff origin/main..HEAD --stat mostra apenas esse arquivo.

O keystore vive fora de qualquer worktree (~/.local/share/neko-finance/) porque
worktrees de build são descartáveis; o keystore.properties é copiado para dentro
do worktree com storeFile absoluto, nunca gerado ali. Registra também a
armadilha do PKCS12 (keytool moderno ignora -keypass diferente de -storepass) e
a instrução de backup do .jks + properties num cofre pessoal.
@johnlaff
johnlaff merged commit 5a582f8 into main Aug 14, 2026
6 checks passed
@johnlaff
johnlaff deleted the docs/keystore-canonico branch August 14, 2026 17:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant