Nesta página, descrevemos como configurar a biblioteca de utilitários do SDK do Maps para iOS.
Para testar esses utilitários, você pode:
- Instale e execute o app de demonstração. O app de demonstração é um projeto independente que contém todo o código necessário para testar os utilitários.
- Instale a biblioteca de utilitários em um projeto do Xcode existente. Adicione esses utilitários ao seu projeto.
Como opção, instale o CocoaPods
A biblioteca de utilitários está disponível como um pod do CocoaPods chamado Google-Maps-iOS-Utils
. 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 a ferramenta CocoaPods, instale-a no macOS executando o seguinte comando no terminal:
sudo gem install cocoapods
Para mais detalhes, consulte o Guia de primeiros passos do CocoaPods (em inglês).
Instalar e executar o app de demonstração
A biblioteca de utilitários inclui um aplicativo de demonstração que você pode instalar e testar.
Instale o app de demonstração usando um destes dois métodos:Usar arquivos do GitHub
- Faça o download do arquivo de exemplo de código no GitHub e descompacte o arquivo.
- Abra uma janela do terminal, navegue até o diretório em que você expandiu os arquivos de exemplo e
detalhe o diretório de exemplos apropriado para a linguagem que você quer usar:
- Para Swift, execute
cd google-maps-ios-utils-master/samples/SwiftDemoApp
- Para Objective-C, execute
cd google-maps-ios-utils-master/samples/ObjCDemoApp
.
- Para Swift, execute
- Execute este comando:
pod install
- Feche o Xcode e clique duas vezes no arquivo
.xcworkspace
do projeto para iniciar o Xcode. A partir desse momento, use o arquivo.xcworkspace
para abrir o projeto.
Usar o CocoaPods v1.6.1
- Abra uma janela do terminal e instale a versão 1.6.1:
sudo gem install cocoapods -v1.6.1
- Busque os arquivos do Google Maps usando o Cocoapods:
pod try Google-Maps-iOS-Utils
Quando solicitado, escolha Swift ou Objective-C. O CocoaPods atualiza seus repositórios de especificações e, em seguida, abre a demonstração em um projeto temporário do Xcode chamado
SwiftDemoApp.xcodeproj
ouObjCDemoApp.xcodeproj
.
Adicionar a chave de API ao app de demonstração
Em Gerar uma chave de API, gere uma chave de API para seu app. Agora adicione essa chave ao projeto Xcode do app de demonstração.Swift
Inclua sua chave de API ao AppDelegate.swift
da seguinte maneira:
- Adicione a seguinte instrução de importação:
import GoogleMaps
- Edite a linha a seguir para adicionar sua chave de API entre aspas duplas:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Inclua sua chave de API ao AppDelegate.m
da seguinte maneira:
- Adicione a seguinte instrução de importação:
@import GoogleMaps;
- Edite a linha a seguir para adicionar sua chave de API entre aspas duplas:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Criar e executar o app de demonstração
Depois de adicionar a chave de API, crie e execute o projeto:
- Se você estiver executando a versão Swift da demonstração, poderá selecionar qual utilitário exibir no app.
- Se você estiver executando a versão Objective-C da demonstração, será exibida a demonstração do utilitário de clustering de marcadores. Em seguida, edite a versão em Objective-C da demonstração para experimentar cada utilitário. Consulte a seção Adicionar um utilitário ao app abaixo para ver mais informações.
Instalar a biblioteca de utilitários como um projeto Xcode
Siga estas etapas para adicionar a biblioteca de utilitários ao espaço de trabalho do Xcode:
Usar o CocoaPods
- Se você ainda não tiver um projeto Xcode, crie um agora e salve-o na sua máquina local. Se você não tem experiência com o desenvolvimento para iOS, crie um aplicativo de visualização única.
- Se você ainda não tiver um arquivo pod para o projeto, crie um arquivo
chamado
Podfile
no diretório do projeto. Esse arquivo define as dependências do seu projeto. - Edite o arquivo pod do projeto e adicione uma dependência ao pod
Google-Maps-iOS-Utils
. Este exemplo inclui as dependências necessárias para o SDK do Maps para iOS e a biblioteca de utilitários:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '13.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '7.4.0' pod 'Google-Maps-iOS-Utils', '4.2.2' end
- Execute
pod install
. - Feche o Xcode e clique duas vezes no arquivo
.xcworkspace
do projeto para iniciar o Xcode. A partir desse momento, use o arquivo.xcworkspace
para abrir o projeto.
Observação:o utilitário de clustering de marcadores depende do quadtree, mas é possível usar o quadtree sem clustering de marcadores. Se você quiser
apenas o utilitário quadtree, altere
pod 'Google-Maps-iOS-Utils'
para
'Google-Maps-iOS-Utils/QuadTree'
no arquivo pod.
Usar o Cartago
- Instale o Carthage. Há vários métodos. Portanto, consulte o arquivo README do Carthage para ver as etapas exatas.
- Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você tem pouca experiência com desenvolvimento para iOS, crie um novo projeto e selecione o modelo de app iOS. No Xcode 11.7 ou versões anteriores, crie um aplicativo de visualização única.
- Crie um arquivo chamado
Cartfile
no seu diretório do projeto Esse arquivo define as dependências do seu projeto. - Edite o
Cartfile
e adicione a dependência da biblioteca de utilitários do SDK do Maps para iOS:
github "googlemaps/google-maps-ios-utils"
- Salve o
Cartfile
. - Em uma janela de terminal, acesse o diretório que contém
Cartfile
:
cd <path-to-project>
- Execute o comando de atualização:
carthage update --platform iOS
Isso vai instalar as APIs especificadas noCartfile
e as respectivas dependências. - No Finder, no diretório do seu projeto, acesse os arquivos de framework baixados em
Carthage/Build/iOS
. - Para adicionar os frameworks do SDK do Maps para iOS ao seu projeto, arraste os pacotes a seguir.
Quando solicitado, selecione Copiar itens se necessário, use a mesma versão acima.
GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
- Clique com o botão direito do mouse em
GoogleMaps.framework
no projeto e selecione Show In Finder. - Arraste
Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
da pastaResources
para seu projeto. Quando solicitado, verifique se Copy items into destination group's folder não está selecionado. - Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.
- Abra a guia Fases de build do destino do aplicativo e, em Vincular binário com
bibliotecas, adicione os seguintes frameworks:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
Escolha seu projeto, em vez de um destino específico, e abra a guia Build Settings. Na seção Other Linker Flags, adicione
-ObjC
. Se essas configurações não estiverem visíveis, altere o filtro na barra Build Settings de Basic para All.
Usar o Gerenciador de pacotes do Swift
- Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você tem pouca experiência com o desenvolvimento para iOS, crie um novo projeto e selecione o Modelo de app iOS. No Xcode 11.7 ou anterior, crie um aplicativo de visualização única.
- Adicione o SDK do Maps para iOS como uma dependência. Consulte Como instalar o SDK para mais opções.
- No seu projeto do Xcode, acesse File -> Swift Packages -> Add Package Dependency.
- Na janela apresentada, insira o URL do repositório da biblioteca de utilitários do SDK do Maps para iOS
https://github.com/googlemaps/google-maps-ios-utils
e selecione Próxima. - Nesse momento, talvez seja necessário autenticar com sua conta do GitHub. Siga as instruções para criar um token de acesso pessoal do GitHub e continuar o processo.
- Na janela seguinte, escolha a opção Versão, escolha Exata na lista suspensa, insira a versão mais recente da biblioteca de utilitários do SDK do Maps para iOS (por exemplo, "3.4.0") e selecione Próxima.
Adicionar a chave de API ao seu app
Consulte Configurar um projeto do Xcode para ver instruções sobre como gerar uma chave de API e adicioná-la ao projeto.Criar e executar o projeto
Depois de adicionar a chave de API, crie e execute o projeto.
Adicionar um utilitário ao app
Consulte a documentação sobre cada utilitário para mais informações sobre como usá-lo no seu app: