Compartilhar via

Envolver clientes com o SDK dos Serviços da Microsoft Store

O SDK dos Serviços da Microsoft Store fornece recursos que ajudam você a se envolver com clientes em seus aplicativos da Plataforma Universal do Windows (UWP), como enviar notificações direcionadas para seus aplicativos e executar experimentos A/B em seus aplicativos. Esse SDK é uma extensão para o Visual Studio 2015 e versões posteriores do Visual Studio.

Observação

Para exibir anúncios em seus aplicativos UWP, use o Microsoft Advertising SDK em vez do SDK dos Serviços da Microsoft Store. As bibliotecas de publicidade foram movidas do SDK dos Serviços da Microsoft Store para o SDK do Microsoft Advertising. Para obter mais informações, consulte Exibir anúncios em seu aplicativo.

Cenários compatíveis com o SDK dos Serviços da Microsoft Store

Atualmente, o SDK dos Serviços da Microsoft Store dá suporte aos seguintes cenários para aplicativos UWP. Para obter a documentação de referência da API, consulte referência da API do SDK dos Serviços da Microsoft Store.

Cenário Descrição
Registrar eventos personalizados em seu aplicativo UWP para o relatório de uso no Partner Center Use a classe StoreServicesCustomEventLogger em seu aplicativo UWP para registrar eventos personalizados associados ao seu aplicativo no Partner Center. Em seguida, examine o total de ocorrências para seus eventos personalizados na seção Eventos personalizados do relatório de uso no Partner Center.

Pré-requisitos

O SDK dos Serviços da Microsoft Store requer:

  • Visual Studio 2015 ou uma versão posterior.
  • Ferramentas do Visual Studio para Aplicativos Universais do Windows instalados com sua versão do Visual Studio.

Instalar o SDK

Há duas opções para instalar o SDK dos Serviços da Microsoft Store em seu computador de desenvolvimento:

  • instalador MSI Você pode instalar o SDK por meio do instalador MSI disponível aqui.
  • pacote NuGet Você pode instalar o SDK como um pacote NuGet.

A Microsoft lança periodicamente novas versões do SDK dos Serviços da Microsoft Store com melhorias de desempenho e novos recursos. Se você tiver projetos existentes que usam o SDK e quiser usar a versão mais recente, baixe e instale a versão mais recente do SDK em seu computador de desenvolvimento.

Instalar via MSI

Para instalar o SDK dos Serviços da Microsoft Store por meio do instalador msi:

  1. Feche todas as instâncias do Visual Studio.

  2. Se você instalou anteriormente o SDK do Microsoft Store Engagement e Monetização, o SDK do Cliente de Anúncios Universal, ou a extensão do Ad Mediator, desinstale esses SDKs agora. Opcionalmente, abra uma janela Prompt de Comando e execute estes comandos para limpar as versões mais antigas do SDK que possam ter sido instaladas com o Visual Studio, mas que podem não aparecer na lista de programas instalados em seu computador:

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Baixe e instale o SDK Microsoft Store Services . Pode levar alguns minutos para ser instalado. Certifique-se e aguarde até que o processo seja concluído.

  4. Reinicie o Visual Studio.

  5. Se você tiver um projeto existente que faça referência a bibliotecas de qualquer versão anterior do SDK dos Serviços da Microsoft Store, do SDK do Microsoft Advertising, do SDK do Cliente do Ad Universal ou do SDK do Microsoft Store Engagement e monetização, recomendamos que você abra seu projeto no Visual Studio e limpe e recompile seu projeto (em o Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e escolha Limpar, e clique com o botão direito do mouse no nó do projeto novamente e escolha Recompilar).

Caso contrário, se você estiver usando o SDK pela primeira vez em seu projeto, agora estará pronto para adicionar a referência de assembly ao seu projeto.

Instalar por meio do NuGet

Para instalar as bibliotecas do SDK dos Serviços da Microsoft Store por meio do NuGet:

  1. Feche todas as instâncias do Visual Studio.

  2. Se você instalou anteriormente o SDK do Microsoft Store Engagement e Monetização, o SDK do Cliente de Anúncios Universal, ou a extensão do Ad Mediator, desinstale esses SDKs agora. Opcionalmente, abra uma janela Prompt de Comando e execute estes comandos para limpar as versões mais antigas do SDK que possam ter sido instaladas com o Visual Studio, mas que podem não aparecer na lista de programas instalados em seu computador:

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Inicie o Visual Studio e abra o projeto no qual você deseja usar o SDK dos Serviços da Microsoft Store.

    Observação

    Se o projeto já incluir referências de biblioteca de uma instalação anterior da MSI do SDK, remova essas referências do seu projeto. Essas referências terão ícones de aviso ao lado porque as bibliotecas referenciadas foram removidas nas etapas anteriores.

  4. No Visual Studio, clique em Projeto e em Gerenciar Pacotes NuGet.

  5. Na caixa de pesquisa, digite Microsoft.Services.Store.Engagement e instale o pacote Microsoft.Services.Store.Engagement. Quando o pacote terminar de instalar, salve sua solução.

    Observação

    Se a janela Saída relatar um erro Install-Package que indica que o caminho especificado é muito longo, talvez seja necessário configurar o NuGet para extrair pacotes para um local alternativo com um caminho mais curto do que o local padrão. Para fazer isso, adicione o valor repositoryPath a um arquivo nuget.config em seu computador e atribua-o a um caminho de pasta curto em que os pacotes NuGet podem ser extraídos. Para obter mais informações, consulte este artigo na documentação do NuGet. Como alternativa, você pode tentar mover seu projeto do Visual Studio para uma pasta alternativa com um caminho mais curto. O problema também pode ser causado pelo caminho dos pacotes globais ser muito longo. Nesse caso, adicione o valor globalPackagesFolder ao arquivo nuget.config.

  6. Feche a solução do Visual Studio que contém seu projeto e reabra a solução.

  7. Se o projeto já fizer referência a bibliotecas de uma versão anterior do SDK dos Serviços da Microsoft Store que foi instalado por meio do NuGet e você tiver atualizado seu projeto para uma versão mais recente do SDK, recomendamos que você limpe e recompile seu projeto (no Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e escolha Limpar, e clique com o botão direito do mouse no nó do projeto novamente e escolha Recompilar).

Caso contrário, se você estiver usando o SDK pela primeira vez em seu projeto, agora estará pronto para adicionar a referência de assembly ao seu projeto.

Adicione a referência de assembly ao seu projeto

Após instalar o SDK dos Serviços da Microsoft Store por meio do instalador MSI ou NuGet, siga estas instruções para fazer referência ao assembly do SDK em seu projeto UWP.

  1. Abra seu projeto no Visual Studio.

    Observação

    Se o seu projeto for um aplicativo JavaScript direcionado para Any CPU, atualize seu projeto para usar um resultado de build específico para a arquitetura (por exemplo, x86).

  2. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência...

  3. Nodo Gerenciador de Referência do , expanda Universal do Windows, clique em Extensõese marque a caixa de seleção ao lado de do Microsoft Engagement Framework. Isso permite que você use as APIs no namespace Microsoft.Services.Store.Engagement.

  4. Clique em OK.

Observação

Se você instalou as bibliotecas do SDK por meio do NuGet, seu projeto conterá uma referência Microsoft.Services.Store.Engagement. A referência Microsoft.Services.Store.Engagement representa o pacote NuGet (em vez das bibliotecas nele) e você pode ignorá-lo.

Noções básicas sobre pacotes de estrutura no SDK

A biblioteca de Microsoft.Services.Store.Engagement.dll no SDK dos Serviços da Microsoft Store é configurada como um pacote de framework . Esta biblioteca contém as APIs no namespace Microsoft.Services.Store.Engagement.

Como essa biblioteca é um pacote de estrutura, isso significa que depois que um usuário instala uma versão do seu aplicativo que usa essa biblioteca, essa biblioteca é atualizada automaticamente em seu dispositivo por meio do Windows Update sempre que publicamos uma nova versão da biblioteca com correções e melhorias de desempenho. Isso ajuda a garantir que seus clientes sempre tenham a versão mais recente disponível da biblioteca instalada em seus dispositivos.

Se lançarmos uma nova versão do SDK que introduz novas APIs ou recursos nesta biblioteca, você precisará instalar a versão mais recente do SDK para usar esses recursos. Nesse cenário, você também precisaria publicar seu aplicativo atualizado na Loja.

  • Last updated on