---
title: "Integrar o SDK do iOS"
slug: "ios-sdk-integration"
updated: 2026-06-12T10:30:57Z
published: 2026-06-12T10:30:57Z
canonical: "docs.xtremepush.com/ios-sdk-integration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrar o SDK do iOS

Use o Xtremepush SDK para integrar seu aplicativo iOS com a Plataforma

1. Para inicializar o Xtremepush, você deve modificar seu Application Delegate. Dentro da aplicação `didFinishLaunchingWithOptions` , adicione o seguinte código para importar o *SDK XPush* :

**Swift**

```swift
import XPush
```

**Objective-C**

```objectivec
#import <XPush/XPush.h>
```

1. Dentro adicione `applicationDidFinishLaunching:withOptions` o seguinte, substituindo `XPUSH_APP_KEY` pela chave de aplicação SDK fornecida ao [adicionar o aplicativo à plataforma](/documentation/docs/pt-br/ios-integration) :

**Swift**

```swift
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {    
    XPush.setAppKey("XPUSH_APP_KEY")
    #if DEBUG
    // Show Debug logs in debug builds
    XPush.setShouldShowDebugLogs(true)
    #endif
    XPush.applicationDidFinishLaunching(options: launchOptions)    
    return true
}
```

**Objective-C**

```objectivec
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [XPush setAppKey: @"XPUSH_APP_KEY"];
    #if DEBUG
    // Show Debug logs in debug builds
    [XPush setShouldShowDebugLogs:YES]; 
    #endif 
    [XPush applicationDidFinishLaunchingWithOptions:launchOptions];
}
```

1. Caso seu projeto seja provisionado em nuvem compartilhada dos EUA, adicione o seguinte código após `XPush.setAppKey`:

**Swift**

```swift
XPush.setServerURL("https://sdk.us.xtremepush.com")
```

**Objective-C**

```objectivec
[XPush setServerURL: @"https://sdk.us.xtremepush.com"];
```

1. Caso seu projeto seja provisionado na Região dos EUA ou em uma nuvem privada, além de definir a URL do servidor, você também precisará implementar o Pin de Chave Pública. Para isso:

a. Gerar um `.der` arquivo para a URL do servidor do cliente, por exemplo: `sdk.example.xtremepush.com` ([entre em contato conosco](/documentation/docs/pt-br/contact-us) para que possamos fornecer essa URL).

b. No Terminal, execute o seguinte comando com a URL apropriada do servidor:
  1. ```plaintext
openssl s_client -servername [https://sdk.example.xtremepush.com](https://sdk.example.xtremepush.com) -connect sdk.example.xtremepush.com:443 2>/dev/null | openssl x509 -outform der -out cert.der`
```

c. Arraste e solte o `cert.der` arquivo que foi criado no seu projeto Xcode. Certifique-se de incluí-lo também nos Recursos do Pacote de Cópias nas Fases de Construção
  2. d. Referenciar este certificado em didFinishLaunching no AppDelegate após definir a URL do servidor:

**Swift**

```swift
XPush.setServerURL("https://sdk.example.xtremepush.com")
let path = Bundle.main.path(forResource: "cert", ofType: "der")
XPush.setServerExpectedCertificateFromFile(path)
```

**Objective-C**

```objectivec
[XPush setServerURL:@"https://sdk.example.xtremepush.com"];
NSString* path = [[NSBundle mainBundle] pathForResource:@"cert" ofType:@"der"];
[XPush setServerExpectedCertificateFromFile:path];
```

## Adicionar descrição para CoreBluetooth

Como o iOS 10 `NSBluetoothPeripheralUsageDescription` precisa ser configurado se seu app incluir *CoreBluetooth*, mesmo que ele não seja usado ativamente. Como o SDK Xtremepush inclui *CoreBluetooth* , você deve adicionar a `NSBluetoothPeripheralUsageDescription` chave e a descrição de uso associada ao seu `Info.plist` arquivo.

> [!TIP]
> Se você não estiver usando os [recursos Bluetooth do SDK para iBeacons](/documentation/docs/pt-br/ios-sdk-location), pode simplesmente definir a descrição para algo simples como "Usando Bluetooth".

Essa descrição de uso só é usada quando *atua como um acessório Bluetooth LE* adicionado aos modos em segundo plano. O SDK Xtremepush não usa esse modo, e o suporte ao iBeacon só é habilitado seguindo as instruções nas [permissões de localização do iOS](/documentation/docs/pt-br/ios-sdk-location). A menos que você use *o Acts como acessório Bluetooth LE* em outra parte do seu app, isso não será mostrado ao usuário.

A falha em incluir essa chave de descrição resultará em uma rejeição automática ao enviar seu app para a App Store e uma notificação por e-mail semelhante à abaixo:

![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/97065eb-ios13_bluetooth_infoplist-3(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A47Z&se=2026-11-04T10%3A28%3A47Z&sr=c&sp=r&sig=RXfyHep1zi50nYUE3nf0wv6Udy%2FUjCoIEGvBgNAkQqM%3D)

> [!TIP]
> Certifique-se de definir o ID do usuário
> 
> Recomenda-se que, nesta fase, você use nosso método SDK para definir IDs de usuário, seguindo nosso [guia dedicado](/documentation/docs/pt-br/set-user-id) para garantir que os dispositivos possam ser associados e direcionados em suas campanhas por seu próprio identificador único.