Pular para o conteúdo

Criar um projeto Swift que abre um site

Configure a URL, a identificação do app e a janela, e a página mostra a lista de arquivos e o código Swift antes do download. O projeto padrão tem 5 arquivos e 3.821 bytes; o build.command o compila com as Xcode Command Line Tools em um .app sem assinatura. O ícone só é aceito se os bytes forem realmente PNG ou JPEG, até 10 MB; caso contrário é recusado e o ZIP sai sem ícone.

Funciona localmente no seu navegador
Geração local ·
ConfiguraçãoSwift + WKWebView
Prévia ao vivomacOS 12+
VoriTools Desktop
KNative WKWebView wrapperhttps://voritools.com/
Conteúdo do projeto
Compile no seu Mac

Sem assinatura por projeto

Privado e inspecionável

Como gerar um projeto de app para macOS

Preencha o formulário e a prévia acompanha: nome do app, URL do site, identificador de pacote, versão, tamanho da janela, as duas opções de janela e um ícone local opcional. O identificador é preenchido a partir do nome enquanto você não o editar, e a lista de arquivos e o código Swift aparecem à direita antes de qualquer download. Ainda não há compilador nem servidor envolvidos.

O que sai foi compilado de verdade durante os testes: o projeto padrão tem 5 arquivos em 3.821 bytes e o build.command o compilou com as Xcode Command Line Tools em um .app funcional. Um ícone PNG de 256 px virou um AppIcon.icns de 269.370 bytes, e a mesma imagem salva em JPEG um de 1.837.743 bytes. Um arquivo de texto renomeado para .png, e qualquer imagem acima de 10 MB, são recusados na linha de status — o ZIP é empacotado sem ícone em vez de levar um que quebraria a compilação no Mac.

  1. Informe o nome do app e a URL do site. Uma URL sem esquema recebe https:// antes, e a prévia mostra o endereço que o app vai carregar de fato.
  2. Ajuste o identificador de pacote (domínio invertido, como com.example.myapp) e a versão. O identificador continua seguindo o nome enquanto você não o editar.
  3. Defina largura e altura da janela dentro de 480–2560 × 320–1600 e escolha se a janela pode ser redimensionada e se mostra a barra de título.
  4. Escolha um ícone local PNG ou JPEG, se quiser; o limite é 10 MB. O arquivo é lido apenas no navegador e o script de compilação o converte em AppIcon.icns.
  5. Clique em Baixar projeto macOS (.zip). Descompacte e dê um duplo clique em build.command — ou rode chmod +x build.command && ./build.command — e o .app finalizado aparece na pasta build.

Os arquivos do ZIP, as regras do ícone e o que a compilação exige

O que o ZIP contém

O projeto são cinco arquivos: Sources/main.swift (o wrapper AppKit + WKWebView que abre a sua URL), Info.plist (nome, identificador de pacote, versão, sistema mínimo 12.0), build.command (o script que compila), README.md e .gitignore. Uma sexta entrada — icon.png ou icon.jpg — só aparece quando você escolhe um ícone. O download se chama <nome>-macos-project.zip e o ZIP padrão medido ocupa 3.821 bytes.

Não há mais nada no arquivo: nem binário compilado, nem assinatura, nem rastreamento. O Info.plist é XML simples e o arquivo Swift é curto o bastante para ler antes de compilar; o botão Copiar código copia exatamente esse arquivo.

Ícone, janela e letras miúdas

O ícone só é aceito se os bytes forem realmente PNG ou JPEG — a assinatura é verificada, não o nome do arquivo — e apenas até 10 MB; qualquer outra coisa é recusada com um aviso e deixa o projeto sem ícone. Na compilação o sips gera 16, 32, 128, 256 e 512 px (com os @2x) em um .iconset e o iconutil os empacota em Resources/AppIcon.icns: medido: 269.370 bytes a partir de um PNG de 256 px e 1.837.743 bytes da mesma imagem em JPEG.

A largura de janela aceita 480–2560 e a altura 320–1600 (2560 × 1600 foi compilada nos testes). Desmarcar “Permitir redimensionamento” remove .resizable da máscara de estilo; desmarcar “Mostrar barra de título” esconde o título e deixa a barra transparente. Uma URL http:// adiciona NSAllowsArbitraryLoadsInWebContent ao Info.plist para a web view poder carregá-la.

Compilar, assinar e privacidade

A compilação acontece no seu Mac e exige as Xcode Command Line Tools: o script chama xcrun swiftc, então o macOS pode pedir as ferramentas uma vez. Se o seu descompactador perder o bit de execução do build.command, rode antes chmod +x build.command.

O resultado é um .app sem assinatura e sem notarização: o Gatekeeper avisa na primeira abertura, e entregá-lo a outras pessoas exige assinar e notarizar com a sua própria identidade Apple Developer. A página mantém o trabalho local: ao gerar um projeto nos testes o navegador não enviou nenhuma requisição, a única entrada foi a URL blob da prévia do ícone.

Ferramentas recentes: