Depois de ativar o faturamento e criar uma chave de API, você poderá configurar o projeto Xcode usado para desenvolver seu app.
As notas da versão estão disponíveis para cada lançamento.
Etapa 1: instalar o software necessário
Para criar um projeto usando o SDK Navigation para iOS, faça o download e instale:
- Xcode versão 16.0 ou mais recente
Etapa 2: criar o projeto Xcode e instalar o SDK Navigation
Gerenciador de pacotes do Swift
O SDK Navigation pode ser instalado pelo Swift Package Manager. Para adicionar o SDK, remova todas as dependências do SDK Navigation atuais.
Para adicionar o SDK a um projeto novo ou existente, siga estas etapas:
-
Abra o
project
ouworkspace
do Xcode e acesse Arquivo > Adicionar dependências de pacote. - Insira https://github.com/googlemaps/ios-navigation-sdk como o URL, pressione Enter para extrair o pacote e clique em "Adicionar pacote".
-
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 "Versão exata". Quando terminar, clique em "Adicionar pacote".
Para atualizar o package
de um projeto, siga estas etapas:
- Para verificar a instalação, acesse a seção Dependências de pacote do Navegador de projetos para verificar o pacote e a versão dele.
-
Nas configurações de configuração do projeto Xcode, encontre Frameworks, Libraries,
and Embedded Content. Use o sinal de menos(-) para remover o seguinte framework:
GoogleMaps.xcframework
GoogleNavigation.xcframework
-
No diretório de nível superior do projeto do Xcode, remova o pacote
GoogleMaps
.
Instalação manual
Neste guia, mostramos como adicionar manualmente os XCFrameworks que contêm o SDK do Navigation para iOS e o SDK do Maps para iOS ao seu projeto e configurar as opções de build no Xcode. Um XCFramework é um pacote binário que pode ser usado em várias plataformas, incluindo máquinas com o chipset M1.
Siga estas etapas para instalar os XCFrameworks do SDK do Navigation para iOS e do SDK do Maps para iOS:
- Faça o download dos seguintes binários do SDK e arquivos de recursos:
- Inicialize o Xcode e abra ou crie um projeto. Se você não tem experiência com iOS, crie um projeto e selecione o modelo de app iOS.
- Remova todas as referências atuais do Maps, da Navegação e do Places do projeto.
- Arraste os seguintes XCFrameworks para seu projeto em
Frameworks, Libraries, and Embedded Content para instalar os SDKs do Maps
e Navigation. Quando solicitado, selecione Copy items if needed:
GoogleMaps.xcframework
GoogleNavigation.xcframework
- Arraste
GoogleMaps.bundle
de GoogleMapsResources que você baixou para o diretório de nível superior do seu projeto Xcode. Quando solicitado, verifique se a opção Copiar itens, se necessário está selecionada. - Arraste
GoogleNavigation.bundle
de GoogleNavigationResources que você baixou para o diretório de nível superior do seu projeto Xcode. Quando solicitado, verifique se a opção Copiar itens para a pasta do grupo de destino está selecionada. - Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.
- Abra a guia Build Phases e, em
Link Binary with Libraries, adicione os seguintes frameworks e bibliotecas:
Accelerate.framework
AudioToolbox.framework
AVFoundation.framework
Contacts.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libxml2.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
Security.framework
SystemConfiguration.framework
UIKit.framework
UserNotifications.framework
WebKit.framework
- Na meta do seu aplicativo, selecione a guia Recursos,
ative Modos em segundo plano e habilite os seguintes modos:
- Áudio, AirPlay e picture-in-picture
- Atualizações de local
- Escolha seu projeto, em vez de um destino específico, e abra a guia Build
Settings. Na seção Outras flags do vinculador, adicione
‑ObjC
para debug e release. Se essas configurações não estiverem visíveis, mude o filtro na barra Build Settings de Basic para All. - Abra
Info.plist
e adicione os seguintes pares de chave-valor:- Chave:
NSLocationWhenInUseUsageDescription
(Privacidade - Descrição de uso da localização durante o uso)
Valor: "Este app precisa de permissão para usar sua localização na navegação passo a passo." - Chave:
NSLocationAlwaysAndWhenInUseUsageDescription
(Privacidade - Descrição de uso de localização sempre e durante o uso)
Valor: "Este app precisa de permissão para usar sua localização na navegação curva a curva."
- Chave:
CocoaPods
O SDK Navigation para iOS está disponível como um pod do CocoaPods (em inglês). O CocoaPods é um gerenciador de dependências de código aberto para projetos Cocoa em Swift e Objective-C.
Se você ainda não tem essa ferramenta, instale-a no macOS executando o seguinte comando no terminal. Para saber mais, consulte o Guia de primeiros passos do CocoaPods (em inglês).
sudo gem install cocoapods
Crie um Podfile
para o SDK Navigation para iOS e instale a API e as dependências dela:
- Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você não tem experiência com desenvolvimento para iOS:
- Crie um novo projeto.
- Selecione o modelo iOS > App.
- Na tela de opções do projeto:
- Insira o Nome do projeto.
- Registre o valor do campo Identificador do pacote. Você pode usar esse valor para restringir sua chave de API abaixo.
- Defina a Interface do projeto como Storyboard.
- Defina a Linguagem como Swift ou Objective-C.
- Crie um arquivo chamado
Podfile
no seu diretório do projeto para definir as dependências. - Edite o
Podfile
e adicione suas dependências com as respectivas versões. Confira um exemplo que inclui a dependência necessária para o SDK Navigation para iOS: # Cocoapods install reference # Executesource 'https://github.com/CocoaPods/Specs.git' platform :ios, '16.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleNavigation', '10.1.0' end
pod outdated
regularmente para detectar versões mais recentes. Se necessário, faça upgrade para a versão mais recente. - Salve o
Podfile
. Abra um terminal e acesse o diretório que contém o
Podfile
:cd <path-to-project>
Execute o comando
pod install
. Isso instala as APIs especificadas noPodfile
e as respectivas dependências.pod install
Feche o Xcode e clique duas vezes no arquivo
.xcworkspace
do projeto para iniciar o programa. Depois disso, é preciso usar o arquivo.xcworkspace
para abrir o projeto.
Para atualizar a API de um projeto atual, siga estas etapas:
- Abra um terminal e acesse o diretório do projeto que contém o
Podfile
. - Execute o comando
pod update
. Isso atualiza todas as APIs especificadas noPodfile
para a versão mais recente.
Etapa 3: adicionar sua chave de API ao projeto
Os exemplos a seguir mostram como adicionar a chave de API ao projeto no Xcode:
Swift
Inclua sua chave de API ao AppDelegate.swift
da seguinte maneira:
- Adicione as seguintes declarações de importação:
import GoogleMaps import GoogleNavigation
- Adicione o seguinte ao método
application(_:didFinishLaunchingWithOptions:)
:GMSServices.provideAPIKey("YOUR_API_KEY")
Objective-C
Inclua sua chave de API ao AppDelegate.m
da seguinte maneira:
- Adicione as seguintes declarações de importação:
@import GoogleMaps; @import GoogleNavigation;
- Adicione o seguinte ao método
application:didFinishLaunchingWithOptions:
:[GMSServices 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 Apple App Store para 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.
Se você é cliente dos Serviços de mobilidade
Se você é cliente dos Serviços de mobilidade, saiba mais sobre o faturamento na documentação de mobilidade. Para mais informações sobre como registrar transações, consulte Configurar o faturamento. Para saber como adicionar IDs de transação à sua implementação do SDK Navigation, consulte Associar o uso do serviço a transações de mobilidade.
A seguir
Agora que você tem uma chave de API e um projeto do Xcode, já pode criar e executar apps. O SDK Navigation para iOS oferece tutoriais que podem ajudar você a começar. Confira mais detalhes em: