Introdução ao 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.

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

Vamos começar por configurar o SDK do macOS do App Center na sua aplicação para usar o App Center Analytics e 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.

Observação

O SDK do App Center descartará o suporte para o Xcode 10 com a versão de junho do SDK.

O SDK do App Center, o Analytics e o Crashes são compatíveis com o Mac Catalyst via XCFramework ou SwiftPM.

O SDK do App Center é compatível com o Apple Silicon.

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.

Dirija-se a appcenter.ms.
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.
Insira um nome e uma descrição opcional para seu aplicativo.
Selecione macOS como sistema operacional e Objective-C/Swift como plataforma.
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.

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

O SDK do App Center para macOS pode ser adicionado ao seu aplicativo via Cocoapods, Carthage, Swift Package Manager ou adicionando manualmente os binários ao seu projeto.

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.1 Integração via Cocoapods

Adicione as seguintes dependências ao seu podfile para incluir o App Center Analytics e o App Center Crashes no seu aplicativo. Isso atrai as seguintes estruturas: AppCenter, AppCenterAnalytics e AppCenterCrashes. Em vez disso, você pode especificar quais serviços deseja usar em seu aplicativo. Cada serviço tem sua própria subespecificação e todos eles dependem do AppCenter. Vai ser puxado automaticamente.
```
 # Use the following line to use App Center Analytics and Crashes.
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
```
Execute pod install para instalar o vosso pod recém-definido e abrir o projeto .xcworkspace.

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.

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 as estruturas que deseja 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

Execute carthage update --platform macOS. Isso busca dependências em uma pasta Carthage/Checkouts e, em seguida, cria cada estrutura.
Abra a guia Configurações gerais do destino do aplicativo. Arraste e solte os arquivos AppCenter.framework, AppCenterAnalytics.framework e AppCenterCrashes.framework da pasta Carthage/Build/macOS 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.
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

No menu Xcode, clique em File > Swift Packages > Add Package Dependency.
Na caixa de diálogo exibida, digite o URL do repositório: https://github.com/microsoft/appcenter-sdk-apple.git.
Em Versão, selecione Próxima Versão Principal e escolha a opção padrão.
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 em seu projeto Xcode para configurar o App Center Analytics e o App Center Crashes para seu aplicativo macOS.

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.

Baixe as estruturas do SDK do App Center fornecidas como um arquivo zip.
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.
[Opcional] Crie um subdiretório para bibliotecas de terceiros.
- As bibliotecas de terceiros geralmente estão num subdiretório (que frequentemente é chamado de Vendor), portanto, se o seu projeto não usa um subdiretório para bibliotecas, crie agora um subdiretório Vendor.
- Crie um grupo chamado Fornecedor dentro do seu projeto Xcode para imitar sua estrutura de arquivos no disco.
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 desnecessárias.
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, AppCenterAnalytics.framework e AppCenterCrashes.framework do Finder (aqueles dentro da pasta Vendor ) no Project Navigator do Xcode. O AppCenter.framework é necessário para iniciar o SDK. Se estiver faltando, os outros módulos não funcionarão e seu aplicativo não será compilado.
- Será exibida uma caixa de diálogo, verifique se o alvo da aplicação está marcado. Em seguida, clique em Concluir.

Observação

O binário do SDK não é empacotado seguindo a convenção de estrutura do macOS. O motivo é que o SDK do App Center para Mac não é uma estrutura convencional, mas estática. Você precisa vinculá-lo como uma estrutura estática: certifique-se de que não está incorporando os binários e não os inclua na fase de compilação "copiar recursos do pacote".

Agora que você integrou as estruturas em seu 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) que deseja usar. Por padrão, nenhum módulo é iniciado e você deve chamar cada um deles ao iniciar o SDK. Se você estiver desenvolvendo para uma extensão, consulte a página Introdução à extensão.

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

Abra o arquivo AppDelegate do projeto e adicione as seguintes instruções de importação:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Adicionar o `start:withServices:` método

Insira a seguinte linha no método delegado da didFinishLaunchingWithOptions aplicação:

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

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

Se você tiver um aplicativo Catalyst, poderá passar segredos do aplicativo para iOS e macOS ao mesmo tempo:

[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])

Advertência

Não é recomendado incorporar o segredo do aplicativo no código-fonte.

Se precisar iniciar os serviços do App Center separadamente, você deve:

Configure ou inicie-o com o Segredo do aplicativo.
Se o código puder ser chamado várias vezes, verifique se o App Center já está configurado.
Inicie o(s) serviço(s) necessário(s) sem o Segredo da Aplicação.

[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
   [MSACAppCenter startService:[MSACAnalytics class]];
   [MSACAppCenter startService:[MSACCrashes class]];
}

AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
    AppCenter.startService(Analytics.self)
    AppCenter.startService(Crashes.self)
}

4.3 Substitua o espaço reservado pelo Segredo do Aplicativo

Certifique-se de substituir {Your App Secret} o texto pelo valor real 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.

O exemplo acima mostra como usar o start:withServices método (start(withAppSecret:services:) for Swift) e incluir o App Center Analytics e o App Center Crashes.

Se você não quiser usar um dos dois serviços, remova o parâmetro correspondente da chamada de método acima.

A menos que você especifique explicitamente cada módulo como parâmetros no método start, não poderá usar esse serviço do App Center. Além disso, a start:withServices API (start(withAppSecret:services:) para Swift) pode ser usada apenas uma vez no ciclo de vida do seu aplicativo – todas as outras chamadas registrarão um aviso no console e apenas os módulos incluídos na primeira chamada estarão disponíveis.

Por exemplo - Se você quiser integrar ao App Center Analytics, modifique a chamada de start:withServices API (start(withAppSecret:services:) para Swift) da seguinte maneira:

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

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

4.4 Adicionar recursos da Internet para aplicativos em área restrita

Se a sua aplicação estiver a utilizar a Sandbox da Aplicação, tem de definir a capacidade para permitir ligações de saída (Cliente) para permitir que a aplicação tenha acesso à Internet. O Xcode 9 habilita o App Sandbox por padrão, mas os recursos para conexões de saída precisam ser definidos explicitamente.

Selecione seu projeto no navegador do projeto, selecione a guia Recursos e, se seu aplicativo estiver usando a área restrita, habilite as conexões de saída.

Ótimo, você está pronto para visualizar dados do Google Analytics e Crashes no portal que o SDK coleta automaticamente.

Consulte os documentos do App Center Analytics e o App Center Crashes para saber como personalizar e usar os recursos avançados de cada serviço.

Comentários

Esta página foi útil?

Last updated on 2025-05-05

Partilhar via

Introdução ao macOS

1. Pré-requisitos

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

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

3.1 Integração via Cocoapods

3.2 Integração via Cartago

3.3 Integração via Swift Package Manager

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

4. Inicie o SDK

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

4.2 Adicionar o start:withServices: método

4.3 Substitua o espaço reservado pelo Segredo do Aplicativo

4.4 Adicionar recursos da Internet para aplicativos em área restrita

Comentários

Recursos adicionais

4.2 Adicionar o `start:withServices:` método