Compartilhar via

Introdução às extensões do macOS

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.

As extensões só dão suporte a relatórios de falha.

Para saber como adicionar o SDK do App Center ao seu aplicativo de contêiner, consulte a documentação de Introdução ao MacOS do App Center.

Vamos começar a configurar o SDK do macOS do App Center na extensão do aplicativo para usar o módulo Crashes do App Center.

1. Pré-requisitos

Os seguintes requisitos devem ser atendidos para usar o SDK do App Center:

  • Seu projeto macOS é configurado no Xcode 13 ou posterior no macOS versão 10.14.4 ou posterior.
  • Você está direcionando dispositivos que estão rodando em macOS 10.13 ou posterior.
  • Você não está usando nenhuma outra biblioteca que forneça a funcionalidade do Crash Reporting.

2. Criar seu aplicativo no Portal do App Center para obter 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 faça login e pressione o botão azul no canto superior direito do portal que diz Adicionar novo e selecione Adicionar novo aplicativo no menu drop-down.
  3. Insira um nome e uma descrição opcional para seu aplicativo.
  4. Selecione macOS como o sistema operacional e Objective-C/Swift como uma plataforma.
  5. Pressione o botão na parte inferior direita que diz Adicionar novo aplicativo.

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.

Observação

O uso de um Segredo de Aplicativo existente de outro projeto do macOS tem efeitos colaterais. O App Center não dá suporte à filtragem por projeto no mesmo aplicativo do App Center. Por exemplo, a listagem de falhas para uma versão específica listará todas as falhas de ambos os projetos para esta versão sem distinção. Pode ser confuso.

Observação

Na versão 4.0.0 do App Center, foram introduzidas alterações de ruptura. Siga a seção Migrar para o SDK do App Center 4.0.0 e superior para migrar o App Center de versões anteriores.

3. Adicionar os módulos do SDK do App Center

O SDK do App Center pode ser integrado ao seu aplicativo por meio de Cocoapods, Carthage ou adicionando manualmente os binários ao seu projeto.

3.1 Integração via Cocoapods

  1. Adicione as seguintes dependências ao podfile para incluir o App Center Crashes no seu app. Isso efetua pull nas seguintes estruturas: AppCenter e AppCenterCrashes.

     pod 'AppCenter/Crashes'

  2. Execute pod install para instalar o pod recém-definido e abrir o projeto..xcworkspace

Observação

Se você vir um erro como [!] Unable to find a specification for `AppCenter` ao executar pod install, execute pod repo update para obter os pods mais recentes do repositório Cocoapods e depois execute pod install.

Agora que você integrou as estruturas em seu aplicativo, é hora de iniciar o SDK e usar os serviços do App Center.

3.2 Integração via Cartago

Abaixo estão as etapas sobre como integrar o SDK do App Center em seu projeto Xcode usando o Carthage versão 0.30 ou superior, um gerenciador de dependências descentralizado que cria suas dependências e fornece estruturas binárias.

  1. Adicione as dependências a seguir ao seu Cartfile para incluir o App Center em seu aplicativo. Isso puxa todos os frameworks. Em seguida, você pode vincular somente essas estruturas para usar em seu aplicativo.

    # Use the following line to get the latest version of App Center
github "microsoft/appcenter-sdk-apple"

    # Use the following line to get the specific version of App Center
github "microsoft/appcenter-sdk-apple" ~> X.X.X

  2. Execute carthage update. Isso busca dependências em uma pasta Carthage/Checkouts e cria cada estrutura.

  3. Abra a guia Configurações gerais do destino do aplicativo. Arraste e solte os arquivos AppCenter.framework e AppCenterCrashes.framework da pasta Carthage/Build/ para o Project Navigator do Xcode. O AppCenter.framework é necessário para iniciar o SDK. Se ele não for adicionado ao projeto, os outros módulos não funcionarão e seu aplicativo não será compilado.

  4. Uma caixa de diálogo será exibida, verifique se a opção referente ao seu aplicativo está selecionada. Em seguida, clique em Concluir.

    Observação

    Se você usar carthage copy-frameworks em sua Fase de Build , não deverá adicionar os SDKs do App Center, pois eles são enviados como estruturas estáticas.

Agora que você integrou as estruturas em seu aplicativo, é hora de iniciar o SDK e usar os serviços do App Center.

Integração 3.3 por meio do Swift Package Manager

  1. No menu do Xcode, clique em File > Swift Packages > Add Package Dependency.
  2. Na caixa de diálogo exibida, insira a URL do repositório: https://github.com/microsoft/appcenter-sdk-apple.git.
  3. Na Versão, selecione Até a Próxima Versão Principal e escolha a opção padrão.
  4. Escolha os módulos necessários na coluna Empacotar Produto .

Agora que você integrou as estruturas em seu aplicativo, é hora de iniciar o SDK e usar os serviços do App Center.

Observação

Se você estiver integrando o App Center por meio do SwiftPM e quiser usá-lo no destino de extensão do aplicativo também, certifique-se de fornecer DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES em sua configuração. Isso é necessário para evitar limitações do SwiftPM ao vincular um módulo a vários destinos.

Integração 3.4 copiando os binários em seu projeto

Abaixo estão as etapas sobre como integrar os binários compilados em seu projeto Xcode para configurar o recurso App Center Crashes para sua extensão do aplicativo.

Observação

O SDK do App Center dá suporte ao uso de XCframework. Se você quiser integrar o XCframeworks ao seu projeto, baixe o AppCenter-SDK-Apple-XCFramework.zip da página de versões e descompacte-o. O conteúdo da pasta resultante não é específico da plataforma, em vez disso, contém XCframeworks para cada módulo. Eles podem ser integrados da mesma maneira que as estruturas usuais, conforme descrito abaixo.

  1. Baixe as estruturas do SDK do App Center fornecidas como um arquivo zip.

  2. Descompacte o arquivo e você verá uma pasta chamada AppCenter-SDK-Apple que contém estruturas diferentes para cada serviço do App Center em cada pasta de plataforma. A estrutura chamada AppCenter é necessária no projeto, pois contém código compartilhado entre os diferentes módulos.

  3. [Opcional] Crie um subdiretório para bibliotecas de terceiros.

    • Como prática recomendada, bibliotecas de terceiros geralmente estão em um subdiretório, geralmente chamado Vendor. Se o projeto não estiver organizado com um subdiretório para bibliotecas, crie um subdiretório vendor agora.
    • Crie um grupo chamado Vendor dentro de seu projeto Xcode para imitar sua estrutura de arquivos no disco.

  4. Abra a pasta AppCenter-SDK-Apple descompactada no Finder e copie a pasta na pasta do projeto no local onde você deseja. A pasta contém estruturas em subpastas para outras plataformas compatíveis com o SDK do App Center, portanto, talvez seja necessário excluir subpastas de que você não precisa.

  5. Adicione as estruturas do SDK ao projeto no Xcode:

    • Verifique se o Project Navigator está visível (⌘+1).
    • Agora, arraste e solte AppCenter.framework e AppCenterCrashes.framework do Finder (no local da etapa anterior) para o Project Navigator do Xcode. O AppCenter.framework é necessário para iniciar o SDK. Se ele não for adicionado ao projeto, os outros módulos não funcionarão e sua extensão de aplicativo não será compilada.
    • Uma caixa de diálogo será exibida, verifique se o destino da extensão do aplicativo está marcado. Em seguida, clique em Concluir.

Agora que você integrou as estruturas em sua extensão de aplicativo, é hora de iniciar o SDK e usar os serviços do App Center.

4. Iniciar o SDK

Para usar o App Center, você deve optar pelos módulos que deseja utilizar. Por padrão, nenhum módulo é iniciado e você deve chamar explicitamente cada um deles ao iniciar o SDK.

4.1 Adicionar as instruções de importação

Insira as linhas a seguir no arquivo que contém o ponto de entrada da extensão de aplicativo. Por exemplo, dentro do arquivo ViewController principal de uma extensão Today.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

4.2 Adicionar o start:withServices: método

Insira a linha a seguir no ponto de entrada da extensão de aplicativo. Por exemplo, dentro do viewDidLoad método do arquivo ViewController principal de uma extensão Today.

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Crashes.self])

Atualmente, há suporte apenas para relatórios de falha para extensões de aplicativo.

4.3 Substitua o marcador pelo segredo do seu aplicativo

Certifique-se de substituir o texto {Your App Secret} pelo valor real para a extensão do seu aplicativo. O Segredo do Aplicativo pode ser encontrado na página Introdução ou na página Configurações no portal do App Center.

A página Introdução contém o exemplo de código acima com o Segredo do Aplicativo nele, você pode copiar e colar todo o exemplo.

Ótimo, você está pronto para visualizar dados de falhas no portal que o SDK coleta automaticamente.

Consulte a documentação do App Center Crashes para saber como personalizar a extensão do aplicativo e utilizar funcionalidades mais avançadas.