Na tej stronie opisujemy, jak skonfigurować bibliotekę narzędziową pakietuMaps SDK na iOS.
Aby wypróbować te narzędzia, możesz:
- zainstalować bibliotekę narzędziową w istniejącym projekcie Xcode; dodać te narzędzia do własnego projektu;
- Zainstaluj i uruchom aplikację w wersji demonstracyjnej. Jest to samodzielny projekt, który zawiera cały kod wymagany do wypróbowania narzędzi.
Dodawanie biblioteki narzędziowej pakietu Maps SDK na iOS do projektu Xcode
Aby dodać bibliotekę narzędziową do obszaru roboczego Xcode:
Używanie 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 Maps SDK na iOS jako zależność. Opcje znajdziesz w artykule Instalowanie pakietu SDK.
- W projekcie Xcode kliknij kolejno File (Plik) > Swift Packages (Pakiety Swift) > Add Package Dependency (Dodaj zależność pakietu).
- W wyświetlonym oknie wpisz adres URL repozytorium biblioteki narzędziowej pakietu Maps SDK na iOS
https://github.com/googlemaps/google-maps-ios-utilsi kliknij Next (Dalej). - W tym momencie może pojawić się prośba o uwierzytelnienie za pomocą konta GitHub. Aby kontynuować, postępuj zgodnie z instrukcjami tworzenia osobistego tokena dostępu do GitHuba.
- W następnym oknie wybierz opcję Version (Wersja), z listy wybierz Up to Next Major Version (Do następnej wersji głównej) i wpisz najnowszą version (wersję) biblioteki narzędziowej pakietu Maps SDK na iOS (np. „6.0.0”).
- Kliknij menu obok opcji Add to Project (Dodaj do projektu), wybierz swój projekt i kliknij Add Package (Dodaj pakiet).
Dodawanie klucza interfejsu API do aplikacji
Instrukcje generowania klucza interfejsu API i dodawania go do projektu Xcode znajdziesz w artykule Konfigurowanie projektu Xcode.Tworzenie i uruchamianie projektu
Po dodaniu klucza interfejsu API utwórz i uruchom projekt.
Używanie narzędzia w aplikacji
Więcej informacji o używaniu narzędzia w aplikacji znajdziesz w dokumentacji każdego narzędzia:
Instalowanie i uruchamianie aplikacji w wersji demonstracyjnej
Biblioteka narzędziowa zawiera aplikację w wersji demonstracyjnej, którą możesz zainstalować, a następnie wypróbować każde narzędzie.
Zainstaluj aplikację w wersji demonstracyjnej:Używanie plików z GitHuba
- Pobierz
archiwum z przykładowym kodem z
GitHub
i rozpakuj je. Możesz też sklonować repozytorium do katalogu lokalnego:
git clone https://github.com/googlemaps/google-maps-ios-utils.git
- Otwórz okno terminala, przejdź do katalogu, w którym rozpakowano pliki przykładowe, i
przejdź do odpowiedniego katalogu z przykładami w języku, którego chcesz używać:
Swift
cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeprojObjective-C
cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj
Dodawanie klucza interfejsu API do aplikacji w wersji demonstracyjnej
W artykule Uzyskiwanie klucza interfejsu API znajdziesz informacje o tym, jak wygenerować klucz interfejsu API dla aplikacji. Teraz dodaj ten klucz do projektu Xcode aplikacji w wersji demonstracyjnej. znajdziesz w artykule Uzyskiwanie klucza interfejsu API.Swift
Dodaj klucz interfejsu API do pliku AppDelegate.swift w ten sposób:
- Dodaj ten import:
import GoogleMaps
- Edytuj 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
Dodaj klucz interfejsu API do pliku AppDelegate.m w ten sposób:
- Dodaj ten import:
@import GoogleMaps;
- Edytuj 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 = @"";
Tworzenie i uruchamianie aplikacji w wersji demonstracyjnej
Po dodaniu klucza interfejsu API utwórz i uruchom projekt:
- Jeśli uruchamiasz wersję demonstracyjną w języku Swift, możesz wybrać, które narzędzie ma być wyświetlane 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żde narzędzie. Więcej informacji znajdziesz w sekcji Dodawanie narzędzia do aplikacji.