> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Assinatura de código Assina os instaladores para que macOS e Windows parem de avisar os teus utilizadores. ## 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](https://supastack.dev/pt/docs/web/before-you-start.md) [Noções básicas sobre terminais](https://supastack.dev/pt/docs/web/terminal-basics.md) [Configuração local do desktop](https://supastack.dev/pt/docs/desktop/ship-in-5-minutes.md) [Avisos do agente e memória do projeto](https://supastack.dev/pt/docs/web/agents.md) ``` 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](https://supastack.dev/pt/docs/desktop/run.md) [Implante o back-end compartilhado](https://supastack.dev/pt/docs/web/deployment.md) ## 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. Para continuar a configuração, leia [Checklist de deployment](https://supastack.dev/pt/docs/web/deployment.md). ## Seguinte [Checklist de deployment](https://supastack.dev/pt/docs/web/deployment.md)