Envie seu manifesto para o repositório

Depois de criar um manifesto de pacote que descreva seu aplicativo, você estará pronto para enviar seu manifesto para o repositório do Gerenciador de Pacotes do Windows. Este é um repositório voltado para o público que contém uma coleção de manifestos que a ferramenta winget pode acessar. Para enviar seu manifesto, você o carregará no repositório de código https://github.com/microsoft/winget-pkgs aberto no GitHub.

Depois de enviar uma solicitação pull para adicionar um novo manifesto ao repositório GitHub, um processo automatizado validará seu arquivo de manifesto e verificará se o pacote está em conformidade com as políticas do Gerenciador de Pacotes do Windows e não é conhecido por ser mal-intencionado. Se essa validação for bem-sucedida, seu pacote será adicionado ao repositório público do Gerenciador de Pacotes do Windows para que possa ser descoberto pela ferramenta cliente winget . Observe a distinção entre os manifestos no repositório GitHub de código aberto e no repositório do Gerenciador de Pacotes do Windows voltado para o público.

Validação de manifesto

Quando você envia um manifesto para o https://github.com/microsoft/winget-pkgs repositório no GitHub, seu manifesto será automaticamente validado e avaliado quanto à segurança do ecossistema do Windows. Os manifestos também podem ser revistos manualmente.

Para mais informações sobre o processo de validação, consulte a secção do processo de validação abaixo.

Como apresentar o seu manifesto

Para enviar um manifesto para o repositório, siga estas etapas.

Etapa 1: Validar seu manifesto

A ferramenta winget fornece o comando validate para confirmar que criou o seu manifesto corretamente. Para validar seu manifesto, use este comando.

winget validate \<path-to-the-manifests>

Se a validação falhar, use os erros para localizar o número da linha e fazer uma correção. Depois que o manifesto for validado, você poderá enviá-lo ao repositório.

Etapa 2: testar seu manifesto com o Windows Sandbox

O repositório do Gestor de Pacotes do Windows inclui um script que instalará o Gestor de Pacotes do Windows numa Sandbox para testar envios de manifesto. Para executar o script powershell, navegue até o repositório winget-pkgs. No PowerShell, digite o seguinte comando:

powershell .\Tools\SandboxTest.ps1 manifests\m\Microsoft\VisualStudioCode\1.56.0

Talvez seja necessário atualizar esse script com o caminho correto para o arquivo de manifesto: .\Tools\SandboxTest.ps1 <path to manifest or manifest folder>

Veja o script completo de teste de sandbox no repositório winget-pkgs.

Etapa 3: clonar o repositório

Para criar uma bifurcação do repositório da Comunidade do Gerenciador de Pacotes do Windows e clonar o repositório para sua máquina local:

1. Vá para https://github.com/microsoft/winget-pkgs no seu navegador e selecione Fork.

2. No Prompt de Comando do Windows ou PowerShell, use o seguinte comando para clonar sua bifurcação.

   git clone <your-fork-name>
   

3. Se você estiver inserindo vários envios, crie uma ramificação em vez de uma bifurcação. Atualmente, permitimos apenas um arquivo de manifesto por envio.

   git checkout -b <branch-name>
   

Etapa 4: Adicionar seu manifesto ao repositório local

Você deve adicionar seus arquivos de manifesto ao repositório na seguinte estrutura de pastas:

manifesta / carta / editor / aplicativo / versão

• A pasta manifests é a pasta principal de todos os manifestos no repositório.
• A pasta de cartas letra é a primeira letra do nome do editor em letra minúscula. Por exemplo, m do editor Microsoft.
• O pasta do editor é o nome da empresa que publica o software. Por exemplo, a Microsoft.
• A pasta de aplicação é o nome da aplicação ou ferramenta. Por exemplo, VSCode.
• A pasta da versão é a versão da aplicação ou ferramenta. Por exemplo, 1.0.0.

Os valores em PackageIdentifier e PackageVersion no manifesto devem corresponder ao editor, aos nomes dos aplicativos e à versão no caminho da pasta do manifesto. Para obter mais informações, consulte Criar o manifesto do pacote.

Etapa 5: Enviar seu manifesto para o repositório remoto

Agora você está pronto para enviar seu novo manifesto para o repositório remoto.

1. Use o commit comando para adicionar arquivos e confirmar a alteração e fornecer informações sobre o envio.

   git commit -m "Submitting ContosoApp version 1.0.0" --all
   

2. Use o push comando para enviar as alterações por push para o repositório remoto.

   git push
   

Etapa 6: Criar uma solicitação pull

Depois de enviar as alterações, retorne ao https://github.com/microsoft/winget-pkgs e crie uma solicitação pull para mesclar sua bifurcação ou ramificação para a ramificação principal.

Processo de submissão

Quando cria um pull request, inicia um processo automatizado que valida os manifestos e verifica o seu pull request. Durante este processo, executaremos testes no instalador e instalaremos binários para validar o envio.

Adicionamos etiquetas ao seu pull request para que possa acompanhar o seu progresso. Para obter mais informações sobre rótulos e o processo, consulte a seção pull request labels abaixo.

Uma vez concluído, seu envio será revisado manualmente por um moderador e, depois de aprovado, seu aplicativo será adicionado ao catálogo do Gerenciador de Pacotes do Windows.

Se houver algum erro durante o processo, você será notificado e nossos rótulos e bot irão ajudá-lo a corrigir seu envio. Para obter a lista de erros comuns, consulte a seção do processo de validação abaixo.

Processo de validação

Quando você criar uma solicitação pull enviar seu manifesto para o repositório do Gerenciador de Pacotes do Windows, isso iniciará um processo de automação que valida o manifesto e processa sua solicitação pull. Os rótulos do GitHub são usados para compartilhar o progresso e permitir que você se comunique conosco.

Expectativas de submissão

Todos os envios de aplicativos para o repositório do Gerenciador de Pacotes do Windows devem aderir às políticas de repositório do Gerenciador de Pacotes do Windows.

Expectativas para submissões:

• O manifesto está em conformidade com os requisitos do esquema .
• Todos os URLs no manifesto levam a sites seguros.
• O instalador e a aplicação estão livres de vírus. O pacote pode ser identificado como malware por engano. Se acreditas que é um falso positivo, podes enviar o instalador à equipa do Microsoft Defender para análise.
• O aplicativo instala e desinstala corretamente para administradores e não administradores.
• O instalador suporta modos não interativos.
• Todas as entradas de manifesto são precisas e não enganosas.
• O instalador vem diretamente do site da editora.

Para obter uma lista completa das políticas, consulte Políticas do Gerenciador de Pacotes do Windows.

Etiquetas de pull request

Durante a validação, uma série de rótulos são aplicados aos pull requests para comunicar o progresso. Alguns rótulos direcionarão você a agir, enquanto outros serão direcionados para a equipe de engenharia do Gerenciador de Pacotes do Windows.

Rótulos de status

A tabela a seguir descreve os rótulos de status que você pode encontrar.

Rótulos de erro

A tabela a seguir descreve os rótulos de erro você pode encontrar. Nem todos os casos de erro serão atribuídos a você imediatamente. Alguns podem desencadear a validação manual.

Rótulos de política de conteúdo

A tabela a seguir lista rótulos de política de conteúdo. Se um desses rótulos for adicionado, algo nos metadados de manifesto acionou a revisão manual de conteúdo adicional para garantir que os metadados estejam seguindo as políticas Gerenciador de Pacotes do Windows.

Rótulos internos

A tabela a seguir lista os rótulos de erro internos. Quando forem encontrados erros internos, sua solicitação pull será atribuída aos engenheiros do Gerenciador de Pacotes do Windows para investigar.

Erro de validação binária

Se a validação do seu Pull Request falhar ao teste Installers Scan e receber um rótulo Binary-Validation-Error, isso significa que a sua aplicação falhou ao instalar em todos os ambientes.

Teste de verificação de instaladores

Para fornecer uma excelente experiência de usuário de instalação de aplicativos, o Gerenciador de Pacotes do Windows deve garantir que todos os aplicativos sejam instalados em PCs sem erros, independentemente do ambiente. Um teste importante é garantir que todos os aplicativos sejam instalados sem avisos em várias configurações antivírus populares. O Windows fornece o programa antivírus interno Microsoft Defender, mas muitos clientes corporativos e usuários usam outro software antivírus.

Cada envio para o Repositório do Gerenciador de Pacotes do Windows é executado através de vários programas antivírus. Todos esses programas têm diferentes algoritmos de deteção de vírus para identificar aplicações potencialmente indesejadas (PUA) e malware.

Corrigir erros de validação binária

Se um aplicativo falhar na validação, a Microsoft primeiro tentará verificar com o fornecedor do antivírus se o software sinalizado é um falso positivo. Em muitos casos, após a notificação e validação, o fornecedor do antivírus atualiza seu algoritmo e o aplicativo passa.

Em alguns casos, o fornecedor do antivírus não pode determinar se a anomalia de código detetada é um falso positivo. Nesse caso, o aplicativo não pode ser adicionado ao repositório do Gerenciador de Pacotes do Windows. A pull request é rejeitada com um rótulo Binary-Validation-Error.

Se receberes um rótulo de Binary-Validation-Error na tua solicitação de pull, atualiza o software para remover o código detetado como PUA.

Às vezes, as ferramentas genuínas, utilizadas para depuração e atividades de baixo nível, são identificadas como PUA pelo software antivírus. Isso ocorre porque o código de depuração necessário tem uma assinatura semelhante ao software indesejado. Embora essa prática de codificação seja legítima, o repositório do Gerenciador de Pacotes do Windows, infelizmente, não pode permitir esses aplicativos.

Solução de problemas de envio

Se o envio do Gerenciador de Pacotes do Windows falhar, você poderá usar os rótulos descritos acima para investigar o motivo da falha.

Para investigar falhas de pull request, siga os seguintes passos:

1. Uma falha de solicitação pull aparece na parte inferior da página da Web com a cadeia de caracteres Algumas verificações não foram bem-sucedidas. Selecione o link Detalhes ao lado de uma validação com falha para acessar a página Azure Pipelines.

   

2. Na página Pipelines do Azure, selecione o link 0 erros / 0 avisos.

   

3. Na página seguinte, selecione o trabalho falhado.

   

4. A próxima página mostra a saída para o trabalho com falha. A saída deve ajudá-lo a identificar a alteração necessária para corrigir o manifesto.

   No exemplo a seguir, a falha ocorreu durante a tarefa de Validação de Instalação .