Introdução às extensões do macOS

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

• Androide
• iOS
• Extensões iOS
• Reagir Nativo
• MAUI/Xamarin
• UWP (Plataforma Universal do Windows)
• WPF/WinForms
• Unidade
• macOS
• Extensões macOS
• tvOS

As extensões suportam apenas relatórios de falhas.

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

Comecemos por configurar o SDK da macOS do App Center na sua extensão da aplicação para usar o App Center Crashes.

1. Pré-requisitos

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

• Seu projeto macOS está configurado no Xcode 13 ou posterior na versão 10.14.4 ou posterior do macOS.
• Está a dirigir-se a dispositivos com macOS 10.13 ou posterior.
• Você não está usando nenhuma outra biblioteca que forneça a funcionalidade de Relatório de Falhas.

2. Crie seu aplicativo no Portal do App Center para obter o Segredo do Aplicativo

Se já tiver criado a sua aplicação no portal do App Center, pode ignorar este passo.

1. Dirija-se a 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 suspenso.
3. Insira um nome e uma descrição opcional para seu aplicativo.
4. Selecione macOS como sistema operacional e Objective-C/Swift como plataforma.
5. Pressione o botão no canto inferior direito que diz Adicionar novo aplicativo.

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

Observação

Usar um App Secret existente de outro projeto macOS tem efeitos colaterais. O App Center não suporta filtragem por projeto no mesmo aplicativo do App Center. Por exemplo, listar 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

Alterações significativas foram introduzidas na versão do 4.0.0 App Center. 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. Adicione os módulos do SDK do App Center

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

3.1 Integração via Cocoapods

1. Adicione as seguintes dependências ao seu podfile para incluir os Crashes do App Center na sua aplicação. Isso atrai as seguintes estruturas: AppCenter e AppCenterCrashes.

    pod 'AppCenter/Crashes'
   

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

Observação

Se você vir um erro como [!] Unable to find a specification for `AppCenter` durante a execução pod install, execute pod repo update para obter os pods mais recentes do repositório Cocoapods e, em seguida, 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ência descentralizado que cria suas dependências e fornece estruturas binárias.

1. Adicione as seguintes dependências ao seu Cartfile para incluir o App Center no seu aplicativo. Isso puxa todas as estruturas. Em seguida, você pode vincular apenas 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, em seguida, 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. Será exibida uma caixa de diálogo, verifique se o alvo da aplicação está marcado. Em seguida, clique em Concluir.

   Observação

   Se você usar carthage copy-frameworks em sua fase de compilação , não deve adicionar os SDKs do App Center lá, 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.

3.3 Integração via Swift Package Manager

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

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 via SwiftPM e quiser usá-lo também no destino de extensão do seu aplicativo, 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 alvos.

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

Abaixo estão as etapas sobre como integrar os binários compilados no seu projeto Xcode para configurar os relatórios de falhas do App Center para a sua extensão de aplicação.

Observação

O SDK do App Center suporta o uso do XCframework. Se você quiser integrar XCframeworks em seu projeto, baixe o AppCenter-SDK-Apple-XCFramework.zip na 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. Podem ser integrados da mesma forma que os quadros habituais, 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 da 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, as bibliotecas de terceiros geralmente encontram-se num subdiretório, frequentemente 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 Fornecedor dentro do 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 para a pasta do seu projeto no local desejado. A pasta contém estruturas em subpastas para outras plataformas suportadas pelo SDK do App Center, portanto, talvez seja necessário excluir subpastas de que não precisa.

5. Adicione as estruturas SDK ao projeto no Xcode:

   • Certifique-se de que 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.
   • Será exibida uma caixa de diálogo, 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. Inicie o SDK

Para usar o App Center, você deve optar por usar o(s) módulo(s). 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 seguintes linhas no arquivo que contém o ponto de entrada da extensão do 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 seguinte linha no ponto de entrada da extensão do 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, apenas relatórios de falhas são suportados para extensões de aplicativos.

4.3 Substitua o espaço reservado pelo Segredo do Aplicativo

Certifique-se de substituir o texto {Your App Secret} pelo valor real da 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 seu Segredo de Aplicativo, você pode copiar e colar o exemplo inteiro.

Ó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 da sua aplicação e utilizar funcionalidades mais avançadas.