Introdução ao iOS

2025-05-05

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.

Você pode encontrar informações sobre dados coletados pelo App Center sobre dados coletados por SDKs do App Center, Regulamento Geral de Proteção de Dados e páginas de perguntas frequentes . Além disso, as perguntas frequentes contêm as respostas, que você precisa fornecer para a configuração de privacidade da App Store.

Vamos começar a configurar o SDK do iOS do App Center em seu aplicativo para usar o App Center Analytics e o App Center Crashes. Para adicionar o App Center Distribute ao seu aplicativo, consulte a documentação sobre ele.

1. Pré-requisitos

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

Seu projeto do iOS é configurado no Xcode 13 ou posterior no macOS versão 10.14.4 ou posterior.
Você está direcionando dispositivos que rodam o iOS 11.0 ou posterior.
Você não está usando nenhuma outra biblioteca que forneça funcionalidade do Crash Reporting (somente para falhas no App Center).
Se você estiver usando CocoaPods para integrar o App Center, precisará do CocoaPods versão 1.10 ou posterior.

A Análise e falhas do SDK do App Center são compatíveis com o Mac Catalyst via XCFramework ou SwiftPM.

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.

Vá para appcenter.ms.
Inscreva-se ou faça login e clique no 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 o iOS como o sistema operacional e o Objective-C/Swift como uma plataforma.
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.

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

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

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

Observação

Simuladores ARM64 (quando iniciados do Xcode em execução no Apple Silicon Mac) não têm suporte por meio do CocoaPods, considere usar outros métodos de integração para que funcione.

Adicione as seguintes dependências ao podfile para incluir o App Center Analytics e o App Center Crashes no seu aplicativo. Essa ação inclui os seguintes frameworks: AppCenter, AppCenterAnalytics e AppCenterCrashes. Em vez disso, você pode especificar os serviços desejados em seu aplicativo. Cada serviço tem seu próprio subespec e todos dependem do AppCenter. Será processado automaticamente.
```
 # Use the following line to use App Center Analytics and Crashes.x
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
 pod 'AppCenter/Distribute'
```
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.

Observação

A integração do Carthage não funciona diretamente no Xcode 12. Para fazer funcionar, consulte esta instrução de Cartago

Adicione as seguintes dependências ao seu Cartfile para incluir o App Center. Essas dependências importam todos os frameworks. Em seguida, você pode vincular somente 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 o comando carthage update para buscar dependências na pasta Carthage/Checkouts. Em seguida, crie 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/iOS no 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.
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

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

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.

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 de 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.
- 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.
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 que você não precisa.
Adicione as estruturas do SDK ao projeto no Xcode:
- Verifique se o Project Navigator está visível (⌘+1).
- Agora arraste e solte AppCenter.framework, AppCenterAnalytics.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 seu aplicativo não será compilado.
- Uma caixa de diálogo será exibida, verifique se a opção referente ao seu aplicativo está selecionada. Em seguida, clique em Concluir.

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

4. Iniciar o SDK

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

As instruções abaixo são ligeiramente diferentes dependendo do ciclo de vida que você está usando. A partir do Xcode 12, você pode selecionar um dos dois ciclos de vida: "Aplicativo de interface do usuário Swift" (selecionado por padrão no Xcode 12) e "UI Kit AppDelegate". Se você estiver desenvolvendo para uma extensão, consulte a página de introdução da extensão.

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

Abra o arquivo AppDelegate do projeto (para o ciclo de vida do AppDelegate do UI Kit) ou o arquivo <ProjectName>App.swift (para o ciclo de vida do aplicativo SwiftUI) 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

AppDelegate do Kit de Interface do Usuário

Adicione o código de inicialização ao didFinishLaunchingWithOptions método delegado:

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

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

Swift UI Ciclo de Vida do Aplicativo

Para garantir que o SDK do App Center funcione corretamente com a interface do usuário do Swift, inicialize-a após o carregamento da interface do usuário. A maneira mais simples de fazer isso é usando o UIApplicationDelegate:

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
          AppCenter.start(withAppSecret: "{Your App Secret}", services:[
            Crashes.self, Analytics.self, Distribute.self])
        return true
    }
}

Em seguida, use UIApplicationDelegateAdaptor em struct:

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

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

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

Aviso

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

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

Configure ou inicie-o com a Chave Secreta do Aplicativo.
Se o código puder ser chamado várias vezes, verifique se o App Center já está configurado.
Inicie os serviços necessários sem o Segredo do Aplicativo.

[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 marcador pelo segredo do seu aplicativo

Certifique-se de substituir o texto {Your App Secret} 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 Segredo do Aplicativo nele, você pode copiar e colar todo o exemplo.

O exemplo acima mostra como usar o start:withServices método (start(withAppSecret:services:) para Swift) e incluir tanto o App Center Analytics quanto 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 um parâmetro no método de início, não é possível 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 somente os módulos incluídos na primeira chamada estarão disponíveis.

Por exemplo- Se você quiser integrar o App Center Analytics, deverá modificar a start:withServices chamada à 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])

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

Examine os documentos do App Center Analytics e os documentos de falhas do App Center para saber como personalizar e usar funcionalidades mais avançadas de ambos os serviços.

Para aprender como começar com atualizações dentro do aplicativo, leia a documentação da Distribuição do App Center.

Compartilhar via

Introdução ao iOS

1. Pré-requisitos

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

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

3.1 Integração via Cocoapods

3.2 Integração via Cartago

Integração 3.3 por meio do Swift Package Manager

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

4. Iniciar o SDK

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

4.2 Adicionar o start:withServices: método

AppDelegate do Kit de Interface do Usuário

Swift UI Ciclo de Vida do Aplicativo

4.3 Substitua o marcador pelo segredo do seu aplicativo

Comentários

Recursos adicionais

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