Tópicos

Usar sua exportação

Quando uma exportação terminar e você baixar o arquivo, siga as instruções do formato correspondente.

Pacote Kohana (.koha)

Consulte Compartilhar um pacote.

Exportação HTML (.html)

Você recebe um .zip. Extraia-o: dentro há index.html e arquivos de suporte que, juntos, formam um pequeno site capaz de reproduzir a novel sem código de servidor.

  • Para testar localmente, não dê apenas dois cliques em index.html — os navegadores bloqueiam as requisições de carregamento de recursos que ele precisa fazer quando o arquivo é aberto diretamente do disco, então a novel não carrega. Em vez disso, rode um servidor local rápido a partir da pasta extraída: python -m http.server (depois abra http://localhost:8000), ou uma extensão de editor como o Live Server do VS Code.
  • Para hospedar para outras pessoas, envie a pasta extraída inteira — não apenas index.html — para qualquer hospedagem web estática, preservando a estrutura: GitHub Pages, Netlify (ou Netlify Drop para um deploy rápido de arrastar e soltar, sem conta), Cloudflare Pages, Neocities, ou seu próprio servidor. Compartilhe o endereço onde index.html ficar.
  • Para compartilhar em um site de jogos, envie o .zip como está: itch.io (escolha "This file will be played in the browser" e defina index.html como ponto de entrada) e Game Jolt hospedam jogos HTML5 diretamente, assim como o Newgrounds.
  • Para incorporar em uma página, depois de hospedado em algum lugar, use um <iframe src="https://seuservidor.exemplo.com/caminho/" width="960" height="540"></iframe>. Isso é diferente de Compartilhar e incorporar do Web Player — aquilo incorpora uma novel que o Kohana hospeda e revisa sob as Diretrizes da comunidade; uma exportação HTML autohospedada é inteiramente seu próprio site e sua própria responsabilidade.

Pacote Android (.apk)

Um .apk instala diretamente em um celular ou tablet Android, sem a Play Store. É uma build de release realmente assinada (o Kohana gera e mantém uma chave de assinatura própria para o nome do seu pacote, não um certificado de depuração) — então o único aviso que você verá vem de instalar fora da loja, não de algo parecendo não confiável.

  1. Envie o arquivo ao dispositivo.
  2. Abra-o. O Android pedirá permissão para instalar aplicativos dessa origem em Configurações > apps que podem instalar apps desconhecidos; o texto varia por versão. Esse aviso é normal.
  3. Conclua a instalação e abra o app normalmente.

Para compartilhar além de um link direto, itch.io e Game Jolt aceitam um .apk para download como build Android na página do seu jogo.

Android App Bundle (.aab)

Um .aab não é instalado diretamente: ele deve ser enviado ao Google Play. É assinado com a mesma chave real do seu .apk.

  1. Crie uma conta no Google Play Console (há uma taxa única) e um novo aplicativo.
  2. Vá a Versão > Produção, ou primeiro a Teste para um grupo pequeno.
  3. Crie uma versão e envie o .aab. Na primeira vez, o Play Console pode pedir para configurar o Play App Signing, e como parte disso pode solicitar as impressões digitais do seu certificado de assinatura.
  4. Preencha descrição, capturas, ícone, classificação etária e política de privacidade; depois envie para análise.

Se sua conta do Play Console for nova (criada após 13 de novembro de 2023), o Google exige um teste fechado com pelo menos 12 testadores inscritos por 14 dias seguidos antes de liberar a Produção — isso vale para toda conta pessoal nova, não é algo específico do Kohana. Contas criadas antes dessa data, e contas de organização, estão isentas. É um processo inteiramente do Google e pode mudar por parte deles — consulte a Central de Ajuda do Google Play Console para os requisitos e passos exatos atuais.

Executável do Windows (.exe)

Um único arquivo .exe autocontido — nada mais precisa acompanhá-lo. Envie-o a um PC Windows; dê dois cliques para executar, sem instalador. Ele depende do runtime WebView2, que já vem incluído no Windows 11 e na maioria dos Windows 10 atualizados; se estiver faltando, o Windows vai pedir para instalá-lo (um download gratuito e único da Microsoft). Como o .exe em si não tem assinatura de código, o Windows SmartScreen pode alertar na primeira execução. Clique em Mais informações > Executar assim mesmo. Isso é normal em qualquer app pequeno e não assinado.

Para enviar a mais do que algumas pessoas, compacte o .exe em .zip primeiro (fica em um único anexo e evita alguns avisos de download voltados a links .exe soltos). itch.io e Game Jolt aceitam uma build do Windows compactada como jogo para download.

Saves e Steam Cloud

O player para Windows armazena todos os slots de save em:

%APPDATA%/<identificador do pacote de exportação>/save_states.json

O identificador do pacote é o informado ao solicitar a exportação. Não o altere entre versões, para que as atualizações continuem usando os mesmos saves. O Kohana valida e prepara cada gravação, mantém um backup local válido e pode recuperar automaticamente saves antigos baseados em WebView.

Para sincronizar saves pelo Steam Auto-Cloud, configure o jogo no Steamworks assim:

Configuração Valor
Root WinAppDataRoaming
Subdirectory O identificador exato do pacote de exportação do Kohana
Pattern save_states.json
OS Windows
Recursive Desativado

Defina cotas adequadas de bytes e arquivos por usuário, publique a configuração do Steamworks e teste-a em uma ramificação privada com dois computadores Windows. Feche o jogo antes de esperar que a Steam envie o arquivo. O Steam Cloud é opcional e pode ser desativado pelo jogador; o save local continua sendo a fonte principal enquanto o jogo está aberto. Não inclua save_states.backup.json no padrão da nuvem: ele serve apenas para recuperação local.

Relacionado

Exportar como aplicativo · Solicitações de exportação · Compartilhar um pacote