Testes de aplicativo de Ponte de Desktop do Windows

  • Artigo

Aplicativos da Ponte de Desktop (confira Como criar um pacote MSIX por meio do código) são aplicativos para desktop do Windows convertidos em aplicativos UWP (Plataforma Universal do Windows) usando a Ponte de Desktop. Após a conversão, o aplicativo da área de trabalho do Windows é empacotado, reparado e implantado na forma de pacote do aplicativo UWP (.appx ou .appxbundle) para Windows 10 Desktop.

Testes obrigatórios versus opcionais

Testes opcionais para aplicativos da Ponte de Desktop do Windows são apenas para fins informativos e não serão usados para avaliar seu aplicativo durante a integração à Microsoft Store. Recomendamos investigar esses resultados de teste para produzir aplicativos de melhor qualidade. Os critérios gerais de aprovação/reprovação para a integração à loja são determinados pelos testes obrigatórios e não por esses testes opcionais.

Testes opcionais atuais

1. Teste de arquivo assinado digitalmente

Tela de fundo
Este teste verifica que todos os arquivos executáveis portáteis (PE) contêm uma assinatura válida. A presença de arquivos assinados digitalmente permite que os usuários saibam que o software é original.

Detalhes do teste
O teste verifica todos os arquivos executáveis portáteis no pacote e verifica seus cabeçalhos em busca de uma assinatura. É recomendável assinar digitalmente todos os arquivos PE. Um aviso será gerado se qualquer um dos arquivos PE não estiver assinado.

Ações corretivas
Sempre é recomendável ter arquivos assinados digitalmente. Para saber mais, veja Introdução à assinatura de código.

2. Verbos de associação de arquivo

Tela de fundo
Esse teste examina o registro do pacote para verificar se qualquer verbo de associação de arquivo está registrado.

Detalhes do teste
Os aplicativos da área de trabalho convertidos podem ser aprimorados com uma ampla gama de APIs do Windows Runtime. Este teste verifica se os binários da UWP no aplicativo não chamam APIs que não sejam do Windows Runtime. Os binários UWP têm o sinalizador AppContainer definido.

Ações corretivas
Veja Ponte de Desktop para UWP: extensões de aplicativos para obter uma explicação sobre essas extensões e como usá-las corretamente.

3. Teste de configuração de depuração

Esse teste verifica se o .appx ou .msix não é um build de depuração.

Tela de fundo
Para serem certificados para a Microsoft Store, os aplicativos não podem ser compilados para depuração e não devem referenciar versões de depuração de um arquivo executável. Além disso, você deve criar seu código como otimizado para que seu aplicativo passe nesse teste.

Detalhes do teste
Teste o aplicativo para garantir que ele não é uma compilação de depuração e que não está vinculado a estruturas de depuração.

Ações corretivas

  • Crie o aplicativo como um build de versão antes de enviá-lo para a Microsoft Store.
  • Verifique se a versão correta do .NET framework está instalada.
  • Certifique-se de que o aplicativo não está vinculando versões de depuração de uma estrutura e se a versão é de liberação. Se o aplicativo contém componentes .NET, certifique-se de instalar a versão correta da estrutura .NET.

4. Testes de integridade do pacote

4.1 Uso de arquivos mortos

Tela de fundo
Esse teste ajuda a criar os melhores aplicativos da Ponte de Desktop para execução nos computadores com Windows 10 S.

Detalhes do teste
Este teste verifica todos os arquivos executáveis dentro dos arquivos mortos ou do conteúdo com extração automática. Como os arquivos executáveis contidos nesse tipo de conteúdo não são sinalizados durante a integração com a Microsoft Store, pode ser que o arquivo não seja executado como esperado nos sistemas com Windows 10 S.

Ações corretivas

  • Considere a possibilidade de avaliar os arquivos sinalizados pelo teste para determinar se há impacto para seu aplicativo sendo executado em um ambiente com Windows 10 S.
  • Se houver a possibilidade de que seu aplicativo seja afetado, remova os arquivos executáveis dos arquivos mortos e não use arquivos com extração automática para colocar arquivos executáveis no disco. Isso deve evitar a perda de funcionalidade do aplicativo.

4.2 Executáveis bloqueados

Tela de fundo
Esse teste ajuda a criar os melhores aplicativos da Ponte de Desktop para execução nos computadores com Windows 10 S.

Detalhes do teste
Este teste verifica se o aplicativo está tentando iniciar arquivos executáveis, o que está restrito nos sistemas do Windows 10 S. Aplicativos que dependem dessa funcionalidade podem não funcionar como esperado em sistemas com Windows 10 S.

Ações corretivas

  • Identifique qual das entradas sinalizadas do teste representa uma chamada para iniciar um arquivo executável que não faz parte do seu aplicativo e remova essas chamadas.
  • Se os arquivos sinalizados fizerem parte do seu aplicativo, você poderá ignorar o aviso.

Testes necessários atuais

1. Teste de funcionalidades de aplicativo (funcionalidades de uso especial)

Tela de fundo
As funcionalidades de uso especial destinam-se a cenários bastante específicos. Somente contas empresariais podem usar esses recursos.

Detalhes do teste
Valide se o aplicativo está declarando qualquer uma das capacidades abaixo:

  • EnterpriseAuthentication
  • SharedUserCertificates
  • DocumentsLibrary

Se qualquer uma dessas capacidades for declarada, o teste exibirá um aviso para o usuário.

Ações corretivas
Considere a remoção da funcionalidade de uso especial caso ela não seja necessária ao seu aplicativo. Além disso, o uso dessas funcionalidades está sujeito à análise da política do serviço.

2. Testes de recursos do manifesto do aplicativo

2.1 Validação de recursos do aplicativo

O aplicativo poderá não ser instalado adequadamente se as cadeias de caracteres ou imagens declaradas no manifesto do seu aplicativo estiverem incorretas. Se o aplicativo não for instalado com esses erros, o logotipo do aplicativo ou outras imagens poderão não ser exibidas corretamente.

Detalhes do teste
Inspeciona os recursos definidos no manifesto do aplicativo para garantir que estão presentes e são válidos.

Ação corretiva
Use a tabela a seguir como guia.

Mensagem de erro Comentários
A imagem {image name} define os qualificadores Scale e TargetSize; você pode definir somente um qualificador por vez. Você pode personalizar imagens para resoluções diferentes. Na mensagem real, {image name} contém o nome da imagem com o erro. Verifique se cada imagem define Scale ou TargetSize como o qualificador.
Houve falha nas restrições de tamanho da imagem {image name}. Verifique se todas as imagens do aplicativo atendem às restrições adequadas de tamanho. Na mensagem real, {image name} contém o nome da imagem com o erro.
A imagem {image name} está ausente no pacote. Uma imagem necessária está ausente. Na mensagem real, {image name} contém o nome da imagem que está ausente.
A imagem {image name} não é um arquivo de imagem válido. Verifique se todas as imagens do aplicativo atendem às restrições adequadas de tipo de formato de arquivo. Na mensagem real, {image name} contém o nome da imagem que não é válida.
A imagem "BadgeLogo" tem um valor ABGR {value} na posição (x, y) que não é válido. O pixel deve ser branco (##FFFFFF) ou transparente (00######) O logotipo de selo é uma imagem mostrada ao lado da notificação de selo para identificar o aplicativo na tela de bloqueio. Essa imagem deve ser monocromática (pode conter somente pixels brancos ou transparentes). Na mensagem real, {value} contém o valor da cor na imagem que não é válido.
A imagem "BadgeLogo" tem um valor ABGR {value} na posição (x, y) que não é válido para a imagem branca de alto contraste. O pixel deve ser (##2A2A2A) ou mais escuro, ou transparente (00######). O logotipo de selo é uma imagem mostrada ao lado da notificação de selo para identificar o aplicativo na tela de bloqueio. Como o logotipo de selo é mostrado em uma tela de fundo branca quando está em branco de alto contraste, ele deve ser uma versão mais escura do logotipo padrão do selo. No banco de alto contraste, o logotipo do selo pode conter somente pixels que são mais escuros que (##2A2A2A) ou transparentes. Na mensagem real, {value} contém o valor da cor na imagem que não é válido.
A imagem deve definir pelo menos uma variante, sem um qualificador TargetSize. Ela deve definir um qualificador Scale ou deixar Scale e TargetSize não especificados, que tem o padrão Scale-100. Para saber mais, veja os guias sobre design responsivo e recursos do aplicativo.
O pacote tem um arquivo "resources.pri" ausente. Se você tiver conteúdo localizável no manifesto do aplicativo, verifique se o pacote do aplicativo inclui um arquivo resources.pri válido.
O arquivo "resources.pri" deve conter um mapa de recursos com um nome que corresponda ao nome do pacote {package full name} Você pode obter esse erro quando o manifesto é alterado e o nome do mapa de recursos no resources.pri não corresponde mais ao nome do pacote no manifesto. Na mensagem real, {package full name} contém o nome do pacote que resources.pri deve conter. Para corrigir isso, você precisa recompilar o resources.pri e a maneira mais fácil de fazer isso é recompilando o pacote do aplicativo.
O arquivo "resources.pri" não deve ter o AutoMerge habilitado. O MakePRI.exe dá suporte a uma opção denominada AutoMerge. O valor padrão de AutoMerge é desativado. Quando está habilitado, AutoMerge mescla os recursos de pacote de idiomas do aplicativo em um só resources.pri no runtime. Não recomendamos isso para os aplicativos que você pretende distribuir por meio da Microsoft Store. O resources.pri de um aplicativo que é distribuído por meio da Microsoft Store deve estar na raiz do pacote do aplicativo e conter todas as referências de idiomas compatíveis com o aplicativo.
A cadeia de caracteres {string} falhou na restrição de comprimento máximo de {number} caracteres. Consulte os Requisitos do pacote do aplicativo. Na mensagem real, {string} é substituído pela cadeia de caracteres com o erro e {number} contém o comprimento máximo.
A cadeia de caracteres {string} não pode ser espaço inicial/final. O esquema dos elementos no manifesto do aplicativo não permite caracteres de espaço iniciais ou finais. Na mensagem real, {string} é substituído pela cadeia de caracteres com o erro. Verifique se algum dos valores localizados nos campos do manifesto no resources.pri contém caracteres de espaço iniciais ou finais.
A cadeia de caracteres não pode estar vazia (o comprimento deve ser maior que zero) Para obter mais informações, consulte Requisitos do pacote do aplicativo.
Não há recurso padrão especificado no arquivo "resources.pri". Para saber mais, veja o guia sobre recursos do aplicativo. Na configuração de build padrão, o Visual Studio inclui apenas os recursos de imagem de escala 200 no pacote do aplicativo quando gera pacotes, colocando outros recursos no pacote de recursos. Inclua recursos de imagem de escala 200 ou configure seu projeto para incluir os recursos que você tem.
Não há valor de recurso especificado no arquivo "resources.pri". Verifique se o manifesto do aplicativo tem recursos válidos definidos no resources.pri.
O arquivo de imagem {filename} deve ter menos de 204800 bytes. Reduza o tamanho das imagens indicadas.
O arquivo {filename} não deve conter uma seção de mapa reverso. Apesar do mapa reverso ser gerado durante a "depuração F5" do Visual Studio durante a chamada no makepri.exe, ele pode ser removido. Basta executar makepri.exe sem o parâmetro /m ao gerar um arquivo pri.

2.2 Validação de marca

Tela de fundo
Espera-se que os Apps de Ponte de Desktop estejam completos e totalmente funcionais. Os aplicativos que usam as imagens padrão (de modelos ou exemplos de SDK) apresentam uma experiência do usuário ruim e não podem ser identificados facilmente no catálogo da loja.

Detalhes do teste
O teste valida se as imagens usadas pelo aplicativo não são imagens padrão de exemplos do SDK ou do Visual Studio.

Ações corretivas
Substitua as imagens padrão por algo mais distinto e que representa seu aplicativo.

3. Testes de conformidade do pacote

3.1 Manifesto do aplicativo

Testa o conteúdo do manifesto do aplicativo para garantir que seu conteúdo esteja correto.

Tela de fundo
Os aplicativos devem ter um manifesto corretamente formatado.

Detalhes do teste
Analisa o manifesto do aplicativo para verificar se o conteúdo está correto, conforme descrito em Requisitos do pacote do aplicativo. As seguintes verificações estão concluídas neste teste:

  • Protocolos e extensões de arquivo
    Seu aplicativo pode declarar os tipos de arquivo aos quais ele pode ser associado. Uma declaração de um grande número de tipos de arquivo incomuns prejudica a experiência de usuário. Este teste limita o número de extensões de arquivo aos quais um aplicativo pode se associar.
  • Regra de dependência de estrutura
    Esse teste enfatiza o requisito de que os aplicativo declarem as devidas dependências na UWP. Se existir uma dependência inadequada, o teste falhará. Se houver incompatibilidade entre a versão do sistema operacional ao qual o aplicativo se destina e as dependências de estrutura que foram feitas, o teste falhará. O teste também falha quando o aplicativo se refere a versões prévias das dlls de estrutura.
  • Verificação de comunicação entre processos (IPC)
    Esse teste impõe o requisito de que os aplicativos de Ponte de Desktop não se comunicam fora do contêiner do aplicativo para componentes de desktop. A comunicação entre processos é destinada apenas a aplicativos de sideload. Os aplicativos que especificarem o ActivatableClassAttribute com nome igual a DesktopApplicationPath falharão nesse teste.

Ação corretiva
Analise o manifesto do aplicativo em relação aos requisitos descritos em Requisitos do pacote do aplicativo.

3.2 Contagem de aplicativos

Esse teste verifica se um pacote do aplicativo (.appx, lote de aplicativo) contém um aplicativo.

Tela de fundo
Esse teste é implementado de acordo com a política da Store.

Detalhes do teste
Este teste verifica se o número total de pacotes .appx no lote é inferior a 512 e se há apenas um pacote "principal" no lote. Ele também verifica se o número de revisão da versão do pacote está definido como 0.

Ações corretivas
Garantir que o lote e o pacote do aplicativo atendam aos requisitos declarados em Detalhes do teste.

3.3 Verificações de registro

Tela de fundo
Este teste verifica se o aplicativo instala ou atualiza todos os novos serviços ou drivers.

Detalhes do teste
O teste busca no arquivo registry.dat atualizações em locais específicos do Registro que indiquem que um novo serviço ou driver está sendo registrado. Se o aplicativo estiver tentando instalar um driver ou serviço, o teste falhará.

Ações corretivas
Examine as falhas e remova os serviços ou drivers em questão se eles forem desnecessários. Se o aplicativo depender deles, será necessário revisá-lo se você quiser integrar-se à Loja.

4. Teste de arquivos apropriados para a plataforma

Os aplicativos que instalam binários mistos podem falhar ou não funcionar corretamente dependendo da arquitetura do processador do usuário.

Tela de fundo
Este teste examina os binários no pacote do aplicativo em busca de conflitos de arquitetura. Um pacote de aplicativo não deve incluir os binários que não podem ser utilizados na arquitetura do processador especificado no manifesto. Incluir binários sem suporte pode levar o aplicativo à falhas ou um aumento desnecessário no tamanho do pacote do aplicativo.

Detalhes do teste
Valida se o "número de bits" de cada arquivo no cabeçalho executável portátil é apropriado em caso de referência cruzada com a declaração de arquitetura do processador do pacote do aplicativo.

Ações corretivas
Siga estas diretrizes para garantir que seu pacote de aplicativos contenha apenas arquivos suportados pela arquitetura especificada no manifesto do aplicativo:

  • Se a Arquitetura do processador alvo para o aplicativo for Tipo de processador neutro, o pacote do aplicativo não poderá conter binário x86, x64 ou ARM ou arquivos do tipo imagem.
  • Se a Arquitetura do processador alvo para o aplicativo for tipo de processador x86, o pacote de aplicativo deve conter apenas binário x86 ou arquivos do tipo imagem. Se o pacote contiver binário x64 ou ARM ou tipos de imagem, ele falhará no teste.
  • Se a Arquitetura do processador alvo para o aplicativo for tipo de processador x64, o pacote de aplicativo deve conter binário x64 ou arquivos do tipo imagem. Observe que, neste caso, o pacote pode também incluir arquivos x86, mas a experiência aplicativo primário deve utilizar o binário x64. Se o pacote contiver binário ARM ou arquivos do tipo imagem ou se contiver apenas binários x86 ou arquivos de tipo de imagem, ele falhará no teste.
  • Se a Arquitetura do Processador Alvo para o aplicativo for do tipo de processador ARM, o pacote do aplicativo deverá conter apenas binário ARM ou arquivos do tipo imagem. Se o pacote contiver binário x64 ou x86 ou arquivos de tipos de imagem, ele falhará no teste.

5. Teste de API compatível

Verifica o aplicativo em relação ao uso de APIs que não estão em conformidade.

Tela de fundo
Os aplicativos de Ponte de Desktop podem aproveitar algumas APIs Win32 herdadas juntamente com APIs modernas (componentes da UWP). Esse teste identifica binários gerenciados que usam APIs sem suporte.

Detalhes do teste
Esse teste verifica todos os componentes da UWP no aplicativo:

  • Verifica se cada binário gerenciado no pacote do aplicativo não depende de uma API do Win32 incompatível com o desenvolvimento do aplicativo UWP verificando a tabela de endereço de importação do binário.
  • Verifica se cada binário gerenciado no pacote do aplicativo não depende de uma função fora do perfil aprovado.

Ações corretivas
Isso pode ser corrigido, garantindo que o aplicativo foi compilado como um build de versão e não como um build de depuração.

Observação

O build de depuração de um aplicativo não passará neste teste mesmo se o aplicativo usar somente APIs para aplicativos UWP. Examine as mensagens de erro para identificar a API presente que não é uma API permitida para aplicativos UWP.

Observação

Os aplicativos C++ integrados em uma configuração de depuração falharão no teste se a configuração usar somente APIs do SDK do Windows para aplicativos UWP. Para saber mais, confira Alternativas às APIs do Windows em aplicativos UWP.

6. Teste de UAC (Controle de Conta de Usuário)

Tela de fundo
Garante que o aplicativo não esteja solicitando o controle de conta de usuário em runtime.

Detalhes do teste
Um aplicativo não pode solicitar a elevação de administrador ou UIAccess de acordo com a política da Microsoft Store. As permissões de segurança elevadas não têm suporte.

Ações corretivas
Os aplicativos devem ser executados como um usuário interativo. Veja Visão Geral de Segurança da Automação da Interface do Usuário para obter detalhes.

7. Validação dos metadados do Windows Runtime

Tela de fundo
Verifica se os componentes que vêm com o aplicativo são compatíveis com o sistema de tipo UWP.

Detalhes do teste
Esse teste gera alguns sinalizadores relacionados ao uso apropriado de tipos.

Ações corretivas

  • Atributo ExclusiveTo
    Garantir que as classes UWP não implementem interfaces marcadas como outra classe ExclusiveTo
  • Exatidão dos Metadados Gerais
    Garanta que o compilador que você está usando para gerar seus tipos esteja atualizado de acordo com as especificações da UWP.
  • Propriedades
    Garanta que todas as propriedades em uma classe UWP tenham um método get (os métodos set são opcionais). Para todas as propriedades, verifique se o tipo retornado pelo método get corresponde ao tipo do parâmetro de entrada do método set.
  • Localização do tipo
    Verifique se os metadados de todos os tipos UWP estão localizados no arquivo .winmd que tem o nome correspondente ao namespace mais longo no pacote do aplicativo.
  • Diferenciação de maiúsculas e minúsculas de nomes de tipo
    Verifique se todos os tipos UWP têm nomes exclusivos que não diferenciam maiúsculas de minúsculas no pacote do aplicativo. Assegure-se também de que nenhum nome de tipo UWP seja usado como nome de namespace no pacote do aplicativo.
  • Exatidão do nome de tipo
    Verifique se não há tipos UWP no namespace global nem no namespace de nível superior do Windows.

8. Teste dos recursos de segurança do Windows

Alterar as proteções de segurança padrão do Windows pode colocar os clientes em risco elevado.

8.1 Analisador de arquivos banidos

Tela de fundo
Determinados arquivos foram atualizados com aprimoramentos importantes de segurança, confiabilidade etc. Os aplicativos de Ponte de Desktop do Windows devem conter as versões mais recentes desses arquivos, já que as versões desatualizadas representam um risco. O Kit de Certificação de Aplicativos Windows bloqueia esses arquivos para garantir que todos os aplicativos usem a versão atual.

Detalhes do teste
A verificação de arquivo banido no Kit de Certificação de Aplicativos Windows atualmente verifica os seguintes arquivos:

  • Bing.Maps.JavaScript\js\veapicore.js
    Essa verificação geralmente falha quando um aplicativo está usando uma versão "Release Preview" do arquivo em vez da versão mais recente oficial.

Ações corretivas
Para corrigir esse problema, use a versão mais recente SDK do Bing Mapas para aplicativos UWP.

8.2 Assinatura de código privado

Testes para a existência de binários de assinatura de código privado no pacote de aplicativo.

Tela de fundo
Os arquivos de assinatura de código privado devem ser mantidos privados, já que eles podem ser utilizados para fins maliciosos no caso de serem comprometidos.

Detalhes do teste
Verifica se há arquivos no pacote do aplicativo com uma extensão .pfx ou .snk, que indica que as chaves de assinatura privadas foram incluídas.

Ações corretivas
Remova todas as chaves de assinatura de código privado (como arquivos .snk e .pfx) do pacote.