Configurar um projeto do Xcode

Depois de ativar o faturamento e criar uma chave de API, você poderá configurar o projeto do Xcode usado para desenvolver seu app.

As notas da versão estão disponíveis para cada versão.

Etapa 1: instalar o software necessário

Para criar um projeto usando o SDK do Places para iOS, você precisa de:

  • Xcode versão 26.0 ou mais recente

Etapa 2: criar o projeto do Xcode e instalar o SDK do Places para iOS

Gerenciador de pacotes do Swift

O SDK do Places para iOS pode ser instalado pelo Gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências do SDK do Places para iOS.

Para adicionar o SDK a um projeto novo ou atual, siga estas etapas:

  1. Abra o project ou workspace do Xcode e acesse File > Add Package Dependencies.
  2. Insira https://github.com/googlemaps/ios-places-sdk como o URL, pressione Enter para extrair o pacote e clique em "Add Package".
  3. Para instalar um version específico, defina o campo Regra de dependência como uma das opções baseadas em versão. Para novos projetos, recomendamos especificar a versão mais recente e usar a opção "Exact Version". Quando terminar, clique em "Adicionar pacote".
  4. Na janela Choose Package Products, verifique se GooglePlaces, GooglePlacesSwift ou ambos serão adicionados ao destino principal designado. Quando terminar, clique em Adicionar pacote.

    Se você estiver atualizando o Google Places Swift do URL descontinuado do GitHub

    Importante: o URL do GitHub para acessar o Google Places Swift mudou a partir da versão 0.3.0. Se você estiver atualizando uma versão do GooglePlacesSwift que foi acessada pelo URL antigo, https://github.com/googlemaps/ios-places-swift-sdk, remova-a da seção de dependências de pacotes do Xcode.

  5. Para verificar a instalação, acesse o painel General do destino. Em Frameworks, Libraries, and Embedded Content, você verá os pacotes instalados. Você também pode conferir a seção Package Dependencies do Project Navigator para verificar o pacote e a versão dele.

Para atualizar o package de um projeto, siga estas etapas:

  1. No Xcode, acesse File > Packages > Update To Latest Package Versions.

    Se você estiver atualizando o Google Places Swift do URL descontinuado do GitHub

    Importante: o URL do GitHub para acessar o Google Places Swift mudou a partir da versão 0.3.0. Se você estiver atualizando uma versão do GooglePlacesSwift que foi acessada pelo URL antigo, https://github.com/googlemaps/ios-places-swift-sdk, remova-a da seção de dependências de pacotes do Xcode.

  2. Para verificar a instalação, acesse a seção Package Dependencies do Project Navigator para verificar o pacote e a versão dele.

Para remover o SDK do Places para iOS instalado manualmente, siga estas etapas:

  1. Nas configurações do projeto do Xcode, encontre Frameworks, Libraries, and Embedded Content. Use o sinal de menos (-) para remover os seguintes frameworks:
    • GooglePlaces.xcframework
    • GooglePlacesSwift.xcframework
  2. No diretório de nível superior do projeto do Xcode, remova o pacote GooglePlaces.

Instalação manual

Neste guia, mostramos como adicionar manualmente os XCFrameworks que contêm o SDK do Places para iOS e o SDK do Places para Swift para iOS ao seu projeto e definir as configurações de build no Xcode. Um XCFramework é um pacote binário que pode ser usado em várias plataformas, incluindo máquinas que usam o Apple Silicon. Você pode adicionar o SDK do Places para iOS, o SDK do Places para iOS em Swift ou ambos.

  1. Faça o download dos seguintes arquivos binários e de recursos do SDK:
  2. Se você estiver instalando o SDK do Places para iOS em Swift, instale os seguintes arquivos:
  3. Extraia os arquivos para acessar o XCFramework e os recursos.
  4. Inicialize o Xcode e abra ou crie um projeto. Se você não tem muita experiência com o desenvolvimento para iOS, crie um novo projeto e selecione o modelo de app iOS.
  5. Remova todas as versões anteriores do Maps do projeto.
  6. Abra a guia Geral. Arraste o seguinte XCFramework para seu projeto em Frameworks, Libraries, and Embedded Content. Selecione Não incorporar:
    • GooglePlaces.xcframework
    Se você estiver instalando o SDK do Places para Swift, arraste o seguinte XCFramework para seu projeto em Frameworks, Libraries, and Embedded Content. Selecione Não incorporar:
    • GooglePlacesSwift.xcframework
  7. Copie o GooglePlaces.bundle do GooglePlacesResources que você baixou para o diretório de nível superior do seu projeto do Xcode. Selecione Copiar itens para a pasta do grupo de destino quando solicitado.

    Se você estiver instalando o SDK do Places para Swift, copie o GooglePlacesSwift.bundle do GooglePlacesSwiftResources que você baixou para o diretório de nível superior do seu projeto do Xcode. Selecione Copiar itens para a pasta do grupo de destino quando solicitado.
  8. Selecione seu projeto no Project Navigator e escolha o destino do aplicativo.
  9. Abra a guia Build Phases. Em Link Binary with Libraries, adicione os seguintes frameworks e bibliotecas:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. Escolha seu projeto, em vez de um destino específico, e abra a guia Build Settings. Na seção Linking - General -> Other Linker Flags, adicione -ObjC a "Debug" e "Release". Se essas configurações não estiverem visíveis, mude o filtro na barra Build Settings de Basic para All.

Etapa 3: adicionar a chave de API ao seu app

Nos exemplos a seguir, substitua YOUR_API_KEY pela chave de API.

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

Inclua sua chave de API ao AppDelegate.swift da seguinte maneira:

  • Adicione a seguinte declaração de importação:
    import GooglePlacesSwift
  • Adicione o seguinte ao método application(_:didFinishLaunchingWithOptions:), substituindo YOUR_API_KEY pela sua chave de API:
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

Inclua sua chave de API ao AppDelegate.swift da seguinte maneira:

  • Adicione a seguinte declaração de importação:
    import GooglePlaces
  • Adicione o seguinte ao método application(_:didFinishLaunchingWithOptions:), substituindo YOUR_API_KEY pela sua chave de API:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Inclua sua chave de API ao AppDelegate.m da seguinte maneira:

  • Adicione a seguinte declaração de importação:
    @import GooglePlaces;
  • Adicione o seguinte ao método application:didFinishLaunchingWithOptions:, substituindo YOUR_API_KEY pela sua chave de API:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Etapa 4 (opcional): inspecionar o arquivo de manifesto de privacidade da Apple

A Apple exige detalhes de privacidade para apps na App Store. Acesse a página de detalhes de privacidade da App Store da Apple para ver atualizações e mais informações.

O arquivo de manifesto de privacidade da Apple está incluído no pacote de recursos do SDK. Para verificar se o arquivo de manifesto de privacidade foi incluído e inspecionar o conteúdo dele, crie um arquivo do app e gere um relatório de privacidade com base nele.

Próximas etapas