Na tej stronie znajdziesz informacje o konfigurowaniu biblioteki narzędzi Mapy Google SDK na iOS.
Aby wypróbować te narzędzia, wykonaj jedną z tych czynności:
- Zainstaluj bibliotekę narzędzi w dotychczasowym projekcie Xcode. Dodaj te narzędzia w swoim projekcie.
- Zainstaluj i uruchom aplikację demonstracyjną. Aplikacja demonstracyjna to samodzielny projekt zawierający cały kod wymagany do wypróbowania narzędzi.
Dodawanie biblioteki narzędziowej Maps SDK na iOS do projektu Xcode
Aby dodać bibliotekę narzędzi do obszaru roboczego Xcode:
Korzystanie z menedżera pakietów Swift
- Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS. W Xcode 11.7 lub starszej wersji utwórz aplikację z jednym widokiem.
- Dodaj pakiet SDK Map na iOS jako zależność. Opcje znajdziesz w sekcji Instalowanie pakietu SDK.
- W projekcie Xcode kliknij Plik -> Pakiety Swift -> Dodaj zależność pakietu.
- W oknie, które się wyświetli, wpisz adres URL repozytorium biblioteki narzędziowej pakietu Maps SDK na iOS
https://github.com/googlemaps/google-maps-ios-utils
i kliknij Dalej. - W tym momencie może pojawić się prośba o uwierzytelnienie za pomocą konta GitHub. Aby kontynuować, postępuj zgodnie z instrukcjami dotyczącymi tworzenia osobowego tokena dostępu GitHuba.
- W następnym oknie kliknij opcję Wersja, a następnie na liście wybierz Do następnej głównej wersji i wpisz najnowszą wersję pakietu SDK Map na potrzeby biblioteki narzędzi na iOS (np. „6.0.0”).
- Kliknij menu Dodaj do projektu, wybierz projekt i kliknij Dodaj pakiet.
Korzystanie z CocoaPods
- Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze lokalnym. (Jeśli dopiero zaczynasz tworzyć aplikacje na iOS, utwórz aplikację jednoekranową).
- Jeśli nie masz jeszcze pliku pod w przypadku swojego projektu, utwórz w katalogu projektu plik o nazwie
Podfile
. Ten plik definiuje zależności projektu. - Zmień plik pod projektu i dodaj zależność od podu
Google-Maps-iOS-Utils
. Oto przykład, który zawiera zależności potrzebne do pakietu SDK Maps na iOS i biblioteki narzędziowej:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '9.0.0' pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version end
- Uruchom
pod install
. - Zamknij Xcode, a następnie otwórz (kliknij dwukrotnie) plik
.xcworkspace
projektu, aby uruchomić Xcode. Od tego momentu musisz używać pliku.xcworkspace
, aby otworzyć projekt.
Uwaga: narzędzie do grupowania znaczników zależy od kwadratu, ale możesz używać kwadratu bez grupowania znaczników. Jeśli chcesz używać tylko narzędzia quadtree, możesz zmienić wartość parametru pod 'Google-Maps-iOS-Utils'
na 'Google-Maps-iOS-Utils/QuadTree'
w pliku pod.
Dodawanie klucza interfejsu API do aplikacji
Instrukcje generowania klucza interfejsu API i dodawania go do projektu Xcode znajdziesz w artykule Konfigurowanie projektu Xcode.Kompilowanie i uruchamianie projektu
Po dodaniu klucza interfejsu API skompiluj i uruchom projekt.
Używanie narzędzia w aplikacji
Więcej informacji o każdym z tych narzędzi i o ich użyciu w aplikacji znajdziesz w odpowiednich dokumentach:
Instalowanie i uruchamianie aplikacji demonstracyjnej
Biblioteka zawiera aplikację demonstracyjną, którą możesz zainstalować i wypróbować poszczególne narzędzia.
Instalowanie aplikacji demonstracyjnej:Korzystanie z plików z GitHuba
- Pobierz z GitHub archiwum przykładowego kodu i rozpakuj je.
- Otwórz okno terminala, przejdź do katalogu, w którym znajdują się rozpakowane pliki przykładowe, a następnie przejdź do odpowiedniego katalogu przykładowych danych dla języka, którego chcesz użyć:
- W przypadku Swift uruchom
cd google-maps-ios-utils-master/samples/SwiftDemoApp
- W przypadku Objective-C uruchom
cd google-maps-ios-utils-master/samples/ObjCDemoApp
- W przypadku Swift uruchom
- Uruchom to polecenie:
pod install
- Zamknij Xcode, a następnie otwórz (kliknij dwukrotnie) plik
.xcworkspace
projektu, aby uruchomić Xcode. Od tego momentu musisz używać pliku.xcworkspace
, aby otworzyć projekt.
Dodawanie klucza interfejsu API do aplikacji demonstracyjnej
W sekcji Uzyskaj klucz interfejsu API wygeneruj klucz interfejsu API dla swojej aplikacji. Następnie dodaj ten klucz do projektu Xcode dla aplikacji demonstracyjnej.Swift
Aby dodać klucz interfejsu API do AppDelegate.swift
, wykonaj te czynności:
- Dodaj tę instrukcję importu:
import GoogleMaps
- Zmień ten wiersz, aby dodać klucz interfejsu API między podwójnymi cudzysłowami:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Aby dodać klucz interfejsu API do AppDelegate.m
, wykonaj te czynności:
- Dodaj tę instrukcję importu:
@import GoogleMaps;
- Zmień ten wiersz, aby dodać klucz interfejsu API między podwójnymi cudzysłowami:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Kompilowanie i uruchamianie aplikacji demonstracyjnej
Po dodaniu klucza interfejsu API skompiluj i uruchom projekt:
- Jeśli używasz wersji demonstracyjnej Swift, możesz wybrać, które narzędzie ma się wyświetlać w aplikacji.
- Jeśli uruchamiasz wersję demonstracyjną w języku Objective-C, zobaczysz demonstrację narzędzia do grupowania znaczników. Następnie możesz edytować wersję demonstracyjną w języku Objective-C, aby wypróbować każdą z tych funkcji. Więcej informacji znajdziesz w sekcji Dodawanie narzędzia do aplikacji.