Assinatura de código

Passo a passo para iniciantes

Pré-requisitos: Conclua a configuração local do Desktop, incluindo Rust e as ferramentas de construção do sistema operacional. Pare o processo de desenvolvimento do Tauri antes de construir um instalador; deixe o back-end da Web em execução. Execute cada verificação abaixo na raiz do repositório e espere que ela termine antes de executar a próxima. Os comandos do pacote filtrado funcionam em checkouts somente para desktop e todas as plataformas.

Termos rápidos: um espaço de trabalho consiste em usuários, dados e configurações separados de uma equipe. O servidor é o back-end confiável; mantenha as chaves do provedor fora do navegador e do código do telefone. Uma migração é uma alteração de versão do banco de dados que cria ou atualiza tabelas. Um modelo de IA é o mecanismo que responde; o catálogo de modelos é a lista do servidor de IDs e preços de modelos disponíveis. Um provedor é um serviço externo, como IA, e-mail ou serviço de cobrança. Um direito é uma concessão que permite que um espaço de trabalho use um recurso. Um webhook é uma mensagem que um serviço envia para o URL de outro serviço.

1. Em uma filial local, peça ao seu agente de codificação para inspecionar apps/desktop/src-tauri/tauri.conf.json e definir o identificador do produto, o nome do aplicativo, os ícones e o back-end URL com os valores que você possui. Use um back-end HTTPS público URL para compilações de lançamento.

2. Na raiz do repositório, execute as verificações do pacote Desktop abaixo. Antes de check:release-config, defina SUPASTACK_APP_URL neste terminal usando o comando do sistema operacional na configuração local do desktop; o back-end público HTTPS deve estar em execução e o identificador do aplicativo deve ser seu.

3. Uma compilação bem-sucedida não assina, autentica ou publica um instalador; se Rust ou uma biblioteca do sistema estiver faltando, conclua a configuração local do Desktop.

Para código personalizado, comece com o prompts/README.md fornecido e copie o prompt mais próximo: prompts/new-app-screen.md para uma tela de aplicativo ou prompts/new-landing-page.md para uma página pública. Para trabalho de servidor, banco de dados ou provedor, dê ao seu agente de codificação a tarefa deste guia e peça-lhe para ler AGENTS.md, .ai/PROJECT_CONTEXT.md e espelhos .ai/ correspondentes; inspecione os arquivos de origem exatos nomeados aqui; listar arquivos e verificações antes de editar; preservar a propriedade do espaço de trabalho e os segredos apenas do servidor; e mostrar a diferença. Informe o comportamento desejado, campos de entrada e saída, funções permitidas, sucessos e erros esperados e a conta de teste, provedor ou dispositivo. Use valores de amostra; nunca cole um segredo real.

• Antes de começar
• Noções básicas sobre terminais
• Configuração local do desktop
• Avisos do agente e memória do projeto

corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build

Configurar o shell do produto

Revise src-tauri/tauri.conf.json, metadados de carga, recursos e identificadores de plataforma. Substitua os ícones do aplicativo por meio do processo de ativos compartilhados e defina o back-end pretendido URL em tempo de construção/execução. O aplicativo web hospedado já deve estar implantado e acessível.

Execute o portão de construção nativo

Esses comandos de pacote executam verificações e testes de tipo Rust, validam as configurações de versão e criam o instalador Tauri. A configuração de assinatura e distribuição depende da plataforma de destino e de sua conta/certificados; não armazene material de assinatura na fonte.

corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build

Verifique o instalador no sistema operacional de destino

Verifique instalação limpa, inicialização, acessibilidade de back-end, autenticação, menus/bandeja, registro de teclas de atalho, segunda instância, links diretos, nova tentativa offline e desinstalação. Verifique cada sistema operacional compatível separadamente. Uma construção local não comprova distribuição comercial assinada ou autenticada; configuração de assinatura, feed de atualização e automação de lançamento não estão incluídos.

• Lista de verificação de aceitação nativa
• Implante o back-end compartilhado

Instalação e configuração

1. Instaladores não assinados instalam bem na tua máquina mas disparam avisos de Gatekeeper e SmartScreen para todos os outros — assina antes de lançar.

2. No macOS, inscreve-te no Apple Developer Program para um certificado Developer ID, depois adiciona a configuração de assinatura e notarização na secção bundle de src-tauri/tauri.conf.json e alimenta o Tauri com o seu env de assinatura documentado (APPLE_CERTIFICATE, APPLE_CERTIFICATE_PASSWORD, APPLE_SIGNING_IDENTITY, mais as credenciais de notarização APPLE_API_KEY / APPLE_API_ISSUER) a partir do secret store do teu CI.

3. No Windows, configura a assinatura Windows do bundle — um thumbprint de certificado ou um comando signtool personalizado — com o certificado também entregue através do secret store do teu runner.

# tauri.conf.json ships unsigned today:
#   "bundle": { "active": true, "targets": "all", "icon": [...] }
# Add signing under bundle > macOS / bundle > windows
# and keep every certificate and password in your secret store,
# never in the repo.
# Auto-updater & release channels (stable / beta via {{channel}}):
# SUPASTACK_UPDATER_ENDPOINT=https://releases.example.com/{{channel}}/{{target}}/{{arch}}/{{current_version}}
# SUPASTACK_UPDATER_PUBKEY=…
# SUPASTACK_UPDATE_CHANNEL=stable

Fluxo de implementação

Provisiona certificados através do teu próprio secret store e injeta-os como variáveis de ambiente em build-time — um certificado commitado no repo é um certificado para revogar.

Embute a SUPASTACK_APP_URL de produção no mesmo build de release para que os shells instalados apontem para a app deployada.

Verificação e resolução de problemas

Verifica instalando o artefacto produzido numa máquina que não é tua: sem aviso de Gatekeeper ou SmartScreen, a app arranca e a sessão persiste. Um tauri build verde sem o teste de instalação assinada não é evidência de release.

A seguir: o Checklist de deployment do separador Web cobre os gates de lançamento do lado do servidor.