Compartilhar via

Comece com o Unity

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

O SDK do App Center usa uma arquitetura modular para que você possa usar qualquer um ou todos os serviços.

Vamos começar a configurar o Unity SDK do App Center para usar o App Center Analytics e Crashes. Para adicionar a Distribuição do App Center ao seu aplicativo, consulte a documentação da Distribuição do App Center.

1. Pré-requisitos

Antes de começar, verifique se o projeto está configurado no Unity 2018.1 ou posterior.

O SDK do App Center para Unity dá suporte às seguintes plataformas:

  • iOS (9.0 ou posterior)
  • Android (5.0/API 21 ou posterior)
  • UWP (Build 16299 ou versão posterior)

Observação

Não há mais suporte para a versão de runtime de script do .NET 3.5 e o back-end de script do .NET na plataforma UWP.

Para aprender como usar coroutines/callbacks em vez de async/await com o back-end .NET 3.5, consulte a seção APIs assíncronas no SDK do Unity da documentação.

Além disso, o SDK do App Center para Unity só está disponível em C#.

2. Criar seu aplicativo no Portal do App Center para adquirir o Segredo do Aplicativo

Se você já criou seu aplicativo no portal do App Center, ignore esta etapa.

  1. Vá para appcenter.ms.
  2. Inscreva-se ou entre no App Center.
  3. Clique no botão azul no canto superior direito do portal que diz Adicionar novo e selecione Adicionar novo aplicativo no menu suspenso.
  4. Insira um nome e uma descrição opcional para seu aplicativo.
  5. Selecione o sistema operacional e a plataforma apropriados, dependendo do seu projeto, conforme descrito acima.
  6. Clique no botão Adicionar novo aplicativo na parte inferior direita da página.

Depois de criar um aplicativo, você pode obter seu Segredo do Aplicativo na página Configurações no Portal do App Center. No canto superior direito da página Configurações , clique nos pontos verticais triplos e selecione Copy app secret para obter o Segredo do Aplicativo.

3. Adicionar o SDK do App Center ao seu projeto

3a Instalar o Editor de Extensão

O SDK do App Center é integrado importando pacotes do Unity para seu projeto. Para fazer isso, primeiro instale o plug-in Extensões do Editor do Unity do App Center . Abra as Extensões do Editor por meio do menu Unity: Extensões do Editor do Windows > App Center > e selecione "Instalar o SDK do App Center".

Observação

Nas versões do Unity 2019.1.2f1 e mais recentes, pode haver erros nos logs durante a instalação, como Coroutine continue failure. É um problema conhecido do Unity e você deve ignorá-lo.

3.1b Instalar pacotes individuais

Como alternativa, cada um dos pacotes individuais do Unity pode ser baixado e importado. Eles são encontrados na página gitHub do SDK do Unity do App Center. Baixe a versão mais recente dos pacotes que você deseja usar. Seu nome deve estar no formato AppCenter{Analytics/Crashes/Distribute}-v{version}.unitypackage.

3.2b Importar o pacote

Abra o projeto do Unity e clique duas vezes no pacote que você baixou. Uma janela pop-up deve aparecer em seu projeto do Unity que contém uma lista de arquivos. Selecione Importar e o SDK será adicionado ao seu projeto. Repita esta etapa para cada pacote que você baixou e planeje usar em seu projeto.

4. Habilitar o SDK

4.1 Criar um objeto de jogo vazio

O App Center funciona como um componente que você anexa a um objeto de jogo na cena em que o jogo é iniciado. Navegue até esta cena e adicione um objeto de jogo vazio. Dê a ele um nome descritivo, como "App Center".

4.2 Anexar o script do App Center

Na janela Projeto , navegue até a pasta "AppCenter" que foi adicionada ao seu projeto. Localize o script chamado AppCenterBehavior e arraste-o para o objeto de jogo recém-criado na janela Hierarquia .

Observação

Você não precisa adicionar o App Center a todas as cenas em que deseja usá-lo. Adicioná-lo à primeira cena carregada é suficiente.

4.3 Definir configurações do App Center

Clique neste novo objeto "App Center" e adicione os segredos do aplicativo aos campos correspondentes na janela Inspetor . Certifique-se de também marcar as caixas de seleção "Usar {service}" para cada serviço do App Center que você pretende usar.

Configuração de script do App Center

Aviso

Não é recomendável inserir o Segredo do Aplicativo no código-fonte.

Observação

Se o projeto não der suporte a uma das três plataformas listadas nas configurações, deixe o campo de segredo do aplicativo as-is; não terá efeito. Se o projeto der suporte a plataformas que o App Center não dá suporte, as APIs e a configuração não terão efeito para essas plataformas.

Ótimo, você está pronto para visualizar dados de Analíticas e Diagnósticos (Falhas e Erros) no portal que o SDK coletará automaticamente.

Examine a documentação do App Center Analytics e do App Center Crashes para saber como usar funcionalidades mais avançadas com ambos os serviços.

Para saber como começar a usar atualizações no aplicativo, leia a documentação para App Center Distribute.

5. Regras de backup (somente Android)

Observação

Os aplicativos destinados ao Android 6.0 (nível de API 23) ou superior têm o Backup Automático habilitado automaticamente.

Observação

Se você já tiver um arquivo personalizado com regra de backup, alterne para a terceira etapa.

Observação

Se você ainda não tiver seu próprio arquivo AndroidManifest.xml , crie-o na pasta Ativos/Plug-ins/Android . Esse manifesto será mesclado com o padrão criado pelo Unity no momento do build.

Se você usar o backup automático para evitar obter informações incorretas sobre o dispositivo, siga as próximas etapas:

5.1. Para Android 11 (nível de API 30) ou inferior.

  1. Crie appcenter_backup_rule.xml arquivo na pasta Assets/Plugins/Android/res/xml .
  1. Abra o arquivoAndroidManifest.xmldo projeto. Adicione o android:fullBackupContent atributo ao <application> elemento. Ele deve apontar para o arquivo de recurso appcenter_backup_rule.xml .
android:fullBackupContent="@xml/appcenter_backup_rule"
  1. Adicione as seguintes regras de backup ao arquivo appcenter_backup_rule.xml :
<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Para Android 12 (nível de API 31) ou superior.

  1. Crie appcenter_backup_rule.xml arquivo na pasta Assets/Plugins/Android/res/xml .
  1. Abra o arquivoAndroidManifest.xmldo projeto. Adicione o android:dataExtractionRules atributo ao <application> elemento. Ele deve apontar para o arquivo de recurso appcenter_backup_rule.xml .
android:dataExtractionRules="@xml/appcenter_backup_rule"
  1. Adicione as seguintes regras de backup ao arquivo appcenter_backup_rule.xml :
<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>