Programa de Aplicativo da Área de Trabalho do Windows

Você pode obter dados de telemetria detalhados e relatórios de análise que permitem ver como seus aplicativos da área de trabalho do Windows estão se saindo por meio do novo Programa de Aplicativo da Área de Trabalho do Windows. Para exibir esses relatórios, navegue até o painel do Partner Center >Insights> Aplicativos da Área de Trabalho do Windows e clique em Visão Geral.

Não há nenhum custo para acessar esses dados, basta inscrever-se e aceitar o o Contrato de Programa de Aplicativo da Área de Trabalho do Windowse carregar um arquivo assinado usando o mesmo certificado usado para assinar os arquivos executáveis do aplicativo.

Ingressar no Programa de Aplicativo da Área de Trabalho do Windows

Se sua empresa já tiver uma conta do Partner Center: entre em sua conta do Partner Center (usando a conta da Microsoft associada ao proprietário da conta) e navegue até a página programas (nas configurações da conta ou selecionando Todos os no menu de navegação à esquerda). Em programa de aplicativos da área de trabalho do Windows, clique em Introdução para ingressar no programa sem nenhum custo adicional. Se você tiver um locatário do Azure AD associado à sua conta do Partner Center, os usuários adicionados poderão acessar o Programa de Aplicativo da Área de Trabalho do Windows. Em breve, permitiremos que você defina acesso mais granular para este programa.

Se sua empresa não tiver uma conta do Partner Center: você pode inscrever-se no Programa de Aplicativo da Área de Trabalho do Windows diretamente sem custo. Em breve, forneceremos a opção de associar um locatário do Azure AD à sua conta para que outras pessoas em sua empresa também possam entrar.

Adicionar seus aplicativos da área de trabalho

Depois de ingressar no programa, você precisará adicionar seus aplicativos da área de trabalho do Windows ao painel para que possamos começar a mostrar seus relatórios de análise.

Usamos a assinatura de código para estabelecer a identidade da sua empresa e recuperar análises para aplicativos que você publica.

Forneceremos um arquivo e solicitaremos que você assine com os mesmos certificados de assinatura de código válidos, não expirados e não revogados que você usa para assinar seus aplicativos da área de trabalho. Depois disso, você carregará esse arquivo assinado no painel. Isso nos informa que todos os aplicativos da área de trabalho assinados com o mesmo certificado pertencem à sua conta. Não usamos suas informações de certificado para qualquer outra finalidade.

Para adicionar um ou mais aplicativos da área de trabalho

1. Na página Visão geral , selecione Adicionar aplicativos da área de trabalho.
2. Na próxima página, baixe o arquivo que pode ser assinado selecionando Baixe o arquivoe salve o arquivo no computador.
3. Assine o arquivo que você acabou de baixar usando o mesmo certificado de assinatura de código que você usa para autenticar seus aplicativos da área de trabalho. Você pode usar SignTool.exe (disponível no Microsoft Visual Studio e como parte do do SDK do Windows) para assinar esse arquivo. Mais detalhes sobre esse processo são descritos abaixo.
4. Carregue o arquivo que você acabou de assinar arrastando-o para o campo (ou clique para procurar seus arquivos).
5. Selecione Enviar para concluir o processo.

Se você usar mais de um certificado de assinatura de código, poderá repetir as etapas acima para cada um dos certificados. Você pode baixar, assinar e carregar um arquivo para cada certificado atual que você usa para assinar seus aplicativos. No entanto, você só pode usar um certificado por arquivo baixado.

Depois de concluir essas etapas, identificaremos quais aplicativos da área de trabalho do Windows são assinados com o mesmo certificado usado para assinar nosso arquivo. Na maioria dos casos, começaremos a mostrar relatórios analíticos dentro de 48 horas, embora ocasionalmente possa demorar um pouco mais.

Usar signtool.exe para assinar o arquivo baixado

A Microsoft fornece uma ferramenta para assinar arquivos, SignTool.exe, com o Visual Studio e no do SDK do Windows. Você pode usar essa ferramenta para executar e verificar o processo de assinatura de código. Mais informações sobre SignTool.exe estão disponíveis aqui.

Aqui estão duas das maneiras mais comuns de usar essa ferramenta para assinar o arquivo que pode ser assinado.

• Se você tiver acesso ao certificado de assinatura de código como um arquivo do PFX (Troca de Informações Pessoais):

  signtool sign /f MyCert.pfx /p MyCertPassword /v SignableFile.bin
  

  

• Se o certificado de assinatura de código estiver disponível no repositório de certificados local:

  Signtool sign /v /s MY /n CertSubjectName SignableFile.bin
  

  

Depois de assinar o arquivo, você pode verificar se ele foi assinado com êxito com um certificado válido com o seguinte:

signtool verify /a SignableFile.bin

Exibindo seus dados analíticos

Depois que seus arquivos assinados tiverem sido carregados e identificarmos seus aplicativos da área de trabalho, seu painel mostrará uma visão geral dos seus aplicativos, juntamente com as principais métricas.

Nossos dados de telemetria mostrarão informações de integridade, como falhas para cada aplicativo associado ao seu certificado. Seu painel mostrará uma visão geral de seus aplicativos, juntamente com as principais métricas. Você pode selecionar qualquer aplicativo para exibir seu relatório Health, Instalade relatório e Blocos de no painel. Você também pode recuperar dados analíticos programaticamente usando a API de análise da Microsoft Store.

Relatório de integridade

O relatório Health permite obter dados relacionados ao desempenho e à qualidade do seu aplicativo, incluindo falhas e eventos sem resposta. Quando aplicável, você pode exibir rastreamentos de pilha e/ou arquivos CAB para depuração adicional.

relatório de integridade do

Você pode filtrar os dados de várias maneiras, permitindo que você:

• Exibir um resumo de todos os tipos de falha, classificados pelo número de ocorrências
• Fazer drill down em uma falha específica e baixar rastreamentos de pilha para depurar o problema mais rapidamente
• Comparar uma nova versão do aplicativo com as versões anteriores
• Exibir dados de integridade na agregação ou por região, permitindo que você isole problemas específicos a uma região
• Compare o desempenho de seus aplicativos da área de trabalho em versões do Windows ou em uma versão específica, como a versão mais recente do Windows 10
• Exibir informações de integridade para um arquivo executável específico incluído em seu aplicativo

Selecione Carregar símbolos na parte superior da tabela falhas de para carregar um arquivo de .zip que contém os arquivos de símbolo do aplicativo. Esses arquivos de símbolo serão indexados e usados para produzir rastreamentos de pilha mais precisos. Os tipos de arquivo de símbolo no .zip devem ser .pdb, .dllou .exe. Depois de carregar com êxito seu arquivo de .zip, você deverá ver menos ! Valores desconhecidos para novas falhas na lista de falhas do aplicativo em aproximadamente 5 dias.

Instala o relatório

O relatório Instalações permite ver quantos dispositivos um aplicativo foi instalado para um determinado dia e o número médio de dispositivos em que cada versão do aplicativo foi instalada nos últimos 30 dias.

Você pode filtrar os dados de várias maneiras, permitindo que você:

• Exibir um resumo de suas instalações, classificado por popularidade
• Comparar uma nova versão do aplicativo com as versões anteriores
• Exibir dados de instalação na agregação ou por região
• Compare o desempenho de seus aplicativos da área de trabalho em versões do Windows ou em uma versão específica, como a versão mais recente do Windows 10 ou versões rápidas e lentas do Windows Insider

Relatório de blocos de aplicativo

O aplicativo bloqueia relatório permite que você veja informações sobre dispositivos Windows 10 nos quais seu aplicativo está afetando as atualizações do Windows 10. Você pode ver quantos dispositivos são afetados em um determinado dia, juntamente com o número médio de dispositivos nos últimos 30 dias.

Os tipos de blocos de atualização incluídos são os seguintes:

Recuperar dados analíticos usando a API de análise da Microsoft Store

A API de análise da Microsoft Store permite que você recupere programaticamente dados de análise para aplicativos que você adicionou à sua conta.

Essa API oferece os seguintes métodos específicos para o Programa de Aplicativo da Área de Trabalho do Windows:

• instalações
• Falha atinge
• Detalhes da falha
• de rastreamento do Stack
• arquivo CAB
• blocos de atualização
• detalhes do bloco de atualização

Para obter mais informações sobre como usar essa API, consulte Dados analíticos do Access usando os serviços da Store.

Gerenciando metadados do aplicativo da área de trabalho

Usamos o nome do arquivo, a versão do arquivo, o nome do produto e os metadados de versão do produto em seus arquivos executáveis para inferir os agrupamentos lógicos de executáveis em aplicativos. Se os arquivos executáveis não tiverem metadados precisos, eles poderão aparecer juntos em um nome do aplicativo desconhecido ou o nome do aplicativo será o padrão para o nome do executável individual.

Manter os metadados de seus aplicativos e arquivos atualizados ajuda a garantir que eles sejam representados corretamente em seu painel. Aqui estão algumas recomendações:

• Use o certificado para assinar todos os arquivos executáveis que você deseja ver no relatório de análise, não apenas os executáveis de configuração.
• Forneça informações consistentes sobre o nome do produto e a versão do produto para todos os arquivos executáveis que pertencem ao mesmo aplicativo (ou seja, Meu aplicativo). Se alguns de seus arquivos executáveis forem distribuídos com vários aplicativos, dê a eles nomes exclusivos (ou seja, componentes compartilhados) para que você possa ver a análise desses executáveis separadamente dos aplicativos com os quais eles foram distribuídos.
• Sempre que fizer alterações nos metadados, você poderá ver uma nova entrada para seu aplicativo no painel. Se você fizer uma alteração, novos dados de telemetria de entrada refletirão suas alterações, mas seus dados de telemetria antigos ainda aparecerão como um aplicativo Unknown.
• Ao revisar um arquivo, atualize a versão do aplicativo e os números de versão do produto.

  Ponta

  Use recursos versioninfo para definir o FileDescription, FileVersion, ProductNamee ProductVersion para seus arquivos e aplicativos. O exemplo a seguir define um recurso VERSIONINFO:

  #define VER_PRODUCTNAME_STR      "Sample App"
  #define VER_PRODUCTVERSION       3,10,349,0
  #define VER_PRODUCTVERSION_STR   "3.10.349.0\0"
  #define VER_FILEDESCRIPTION_STR  "Sample File"
  #define VER_FILEVERSION          3,10,349,0
  #define VER_FILEVERSION_STR      "3.10.349.0\0"
  #define VER_COMPANYNAME_STR     "XYZ Corp."
  #define VER_LEGALCOPYRIGHT_STR   "Copyright \251 XYZ Corp." 
   
  VS_VERSION_INFO VERSIONINFO
  FILEVERSION VER_FILEVERSION
  PRODUCTVERSION VER_PRODUCTVERSION
  FILEFLAGSMASK VER_FILEFLAGSMASK
  FILEFLAGS VER_FILEFLAGS
  FILEOS VER_FILEOS
  FILETYPE VER_FILETYPE
  FILESUBTYPE VER_FILESUBTYPE
  BEGIN
      BLOCK "StringFileInfo"
      BEGIN
          BLOCK "040904E4"
          BEGIN
              VALUE "ProductName",      VER_PRODUCTNAME_STR
              VALUE "ProductVersion",   VER_PRODUCTVERSION_STR
              VALUE "FileDescription",  VER_FILEDESCRIPTION_STR
              VALUE "FileVersion",      VER_FILEVERSION_STR
              VALUE "CompanyName",      VER_COMPANYNAME_STR
              VALUE "LegalCopyright",   VER_LEGALCOPYRIGHT_STR
          END
      END
       
  END 
  

Adicionar e gerenciar usuários de conta

Você pode usar o Azure Active Directory para adicionar e gerenciar usuários adicionais em sua conta do Programa de Aplicativo da Área de Trabalho do Windows. Você pode adicionar usuários individuais, grupos de usuários ou aplicativos do Azure AD, dando a cada um uma função predefinida (Gerenciador ou Desenvolvedor).

Associar o Azure Active Directory à sua conta

Para adicionar e gerenciar usuários de conta, primeiro você deve associar sua conta ao Azure Active Directory da sua organização. Se sua organização já usa o Office 365 ou outros serviços de negócios da Microsoft, você já tem o Azure AD. Caso contrário, você poderá criar um novo locatário do Azure AD sem custo adicional.

Consulte Associar o Azure Active Directory à sua conta do Partner Center para obter mais informações. Embora o tópico se concentre no programa de desenvolvedor de aplicativos do Windows, a associação de um locatário funciona da mesma maneira para o Programa de Aplicativo da Área de Trabalho do Windows.

Adicionar usuários, grupos e aplicativos do Azure AD à sua conta

Depois de configurar a associação do Azure AD, você pode adicionar usuários acessando a seção Usuários nas configurações da Conta. Cada usuário recebe uma função que define seu acesso à conta. Você também pode adicionar grupos de usuários e aplicativos do Azure AD para conceder-lhes acesso à sua conta do Partner Center. Para obter mais informações sobre como adicionar usuários, consulte Adicionar usuários, grupos e aplicativos do Azure AD.

Cada usuário, grupo ou aplicativo do Azure AD que você adicionar à sua conta deve receber uma função. Esse processo é descrito em Definir funções ou permissões personalizadas para usuários de conta. No entanto, observe que, para o Programa de Aplicativo da Área de Trabalho do Windows, não há capacidade de atribuir permissões personalizadas ou restringir o acesso por produto. Em vez disso, cada usuário deve receber uma das seguintes funções padrão.

Perguntas Freqüentes

• Por que não vejo dados para um aplicativo? Não mostraremos dados até detectarmos usuários suficientes para coletar informações significativas. Se você acabou de lançar seu aplicativo, pode levar algum tempo para atingir esse limite mínimo de adoção. Outro motivo pelo qual talvez você não veja dados é se você não assinou um arquivo com o certificado para um determinado aplicativo. Certifique-se de carregar arquivos assinados com todos os certificados que você usa para assinar seus aplicativos.
• Posso acessar esses dados por meio de uma API? Sim, os dados serão disponibilizados por meio de uma API pública quando o programa estiver disponível para todos os desenvolvedores.
• E os aplicativos com certificados mais antigos? Infelizmente, não há suporte para o envio de certificados expirados ou revogados, mesmo se você renová-los com a mesma chave.
• Por que vejo um aplicativo que não reconheço? Se o certificado usado para assinar arquivos em seu aplicativo também for usado por outra pessoa em sua empresa para assinar outro aplicativo, você verá telemetria para esse aplicativo também. No futuro, forneceremos uma opção para ocultar aplicativos do seu painel. Se sua conta da empresa estiver anexada a um locatário do Azure AD, você poderá solicitar que o administrador modifique as permissões de usuário para que apenas aplicativos específicos fiquem visíveis para você.
• Como posso fornecer comentários sobre a experiência ou obter suporte? Se precisar de assistência, você poderá criar uma solicitação de suporte aqui. Para compartilhar seus comentários, use o link Comentários (em Configurações da Conta) e selecione a área análise de para nos informar o que você acha.