Na tej stronie dowiesz się, jak skonfigurować bibliotekę narzędziową pakietu SDK Map Google na iOS.
Aby wypróbować te narzędzia, wykonaj jedną z tych czynności:
- Zainstaluj i uruchom aplikację demonstracyjną. Aplikacja demonstracyjna to samodzielny projekt zawierający cały kod wymagany do wypróbowania narzędzi.
- Zainstaluj bibliotekę narzędziową w istniejącym projekcie Xcode. Dodaj te narzędzia do swojego projektu.
Opcjonalnie zainstaluj CocoaPods
Biblioteka narzędzi jest dostępna jako pod CocoaPods o nazwie Google-Maps-iOS-Utils
. CocoaPods to menedżer zależności typu open source dla projektów Swift i Objective-C Cocoa.
Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w macOS, uruchamiając z terminala to polecenie:
sudo gem install cocoapods
Szczegółowe informacje znajdziesz w przewodniku dla początkujących na temat CocoaPods.
Instalowanie i uruchamianie aplikacji w wersji demonstracyjnej
W bibliotece narzędzi znajduje się aplikacja demonstracyjna, którą możesz zainstalować, a następnie wypróbować każde narzędzie.
Zainstaluj aplikację w wersji demonstracyjnej, korzystając z jednej z tych 2 metod:Użyj plików z GitHuba
- Pobierz archiwum przykładowego kodu z GitHub i rozpakuj archiwum.
- Otwórz okno terminala, przejdź do katalogu, w którym rozwinięto przykładowe pliki, i przejdź do odpowiedniego katalogu z przykładami dla języka, którego chcesz używać:
- W przypadku Swift uruchom polecenie
cd google-maps-ios-utils-master/samples/SwiftDemoApp
- W przypadku zasobów Objective-C uruchom polecenie
cd google-maps-ios-utils-master/samples/ObjCDemoApp
- W przypadku Swift uruchom polecenie
- Uruchom to polecenie:
pod install
- Zamknij Xcode, a następnie otwórz (dwukrotnie) plik
.xcworkspace
swojego projektu, aby uruchomić Xcode. Od tej pory projekt będzie można otwierać tylko za pomocą pliku.xcworkspace
.
Używaj CocoaPods w wersji 1.6.1
- Otwórz okno terminala i zainstaluj wersję 1.6.1:
sudo gem install cocoapods -v1.6.1
- Pobierz pliki Map Google za pomocą Cocoapods:
pod try Google-Maps-iOS-Utils
Gdy pojawi się komunikat, wybierz Swift lub Objective-C. CocoaPods aktualizuje repozytoria specyfikacji, a następnie otwiera wersję demonstracyjną w tymczasowym projekcie Xcode o nazwie
SwiftDemoApp.xcodeproj
lubObjCDemoApp.xcodeproj
.
Dodawanie klucza interfejsu API do aplikacji demonstracyjnej
W sekcji Uzyskaj klucz interfejsu API generujesz klucz interfejsu API swojej aplikacji. Teraz dodaj ten klucz do projektu Xcode aplikacji demonstracyjnej.Swift
Dodaj klucz interfejsu API do urządzenia AppDelegate.swift
, wykonując 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
Dodaj klucz interfejsu API do urządzenia AppDelegate.m
, wykonując 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 = @"";
Tworzenie i uruchamianie aplikacji demonstracyjnej
Po dodaniu klucza interfejsu API skompiluj i uruchom projekt:
- Jeśli korzystasz z wersji demonstracyjnej Swift, możesz wybrać narzędzie do wyświetlenia w aplikacji.
- Jeśli używasz wersji demonstracyjnej w języku Objective-C, zobaczysz wersję demonstracyjną narzędzia do grupowania znaczników. Następnie możesz edytować wersję demonstracyjną w języku Objective-C, aby wypróbować poszczególne narzędzia. Więcej informacji znajdziesz w sekcji Dodawanie narzędzia do aplikacji poniżej.
Instalowanie biblioteki narzędziowej jako projektu Xcode
Aby dodać bibliotekę narzędziową do obszaru roboczego Xcode:
Używaj CocoaPods
- Jeśli nie masz jeszcze projektu Xcode, utwórz go teraz i zapisz na komputerze lokalnym. (Jeśli nie masz doświadczenia w programowaniu w systemie iOS, utwórz aplikację z jednym widokiem).
- Jeśli nie masz jeszcze pliku poda w projekcie, utwórz plik o nazwie
Podfile
w katalogu projektu. Ten plik określa zależności Twojego projektu. - Edytuj plik poda w projekcie i dodaj zależność od poda
Google-Maps-iOS-Utils
. Oto przykład, który przedstawia zależności wymagane w pakiecie SDK Map Google na iOS oraz w bibliotece narzędziowej: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
- Uruchom
pod install
. - Zamknij Xcode, a następnie otwórz (dwukrotnie) plik
.xcworkspace
swojego projektu, aby uruchomić Xcode. Od tej pory projekt będzie można otwierać tylko za pomocą pliku.xcworkspace
.
Uwaga: narzędzie do grupowania znaczników zależy od quadtree, ale możesz z niego korzystać bez grupowania znaczników. Jeśli chcesz używać tylko narzędzia quadtree, możesz zmienić pod 'Google-Maps-iOS-Utils'
na 'Google-Maps-iOS-Utils/QuadTree'
w pliku poda.
Użyj Kartaginy
- Zainstaluj Carthage. Jest kilka metod, więc szczegółowe instrukcje znajdziesz w pliku README Carthage.
- Jeśli nie masz jeszcze projektu Xcode, utwórz go teraz i zapisz na komputerze lokalnym. (Jeśli dopiero zaczynasz programować w iOS, utwórz nowy projekt i wybierz Szablon aplikacji na iOS. W Xcode 11.7 lub starszym utwórz aplikację pojedynczego widoku.
- W katalogu projektu utwórz plik o nazwie
Cartfile
. Ten plik definiuje zależności projektu. - Edytuj
Cartfile
i dodaj zależność z biblioteki narzędziowej pakietu Maps SDK na iOS:
github "googlemaps/google-maps-ios-utils"
- Zapisz
Cartfile
. - W oknie terminala przejdź do katalogu zawierającego
Cartfile
:
cd <path-to-project>
- Uruchom polecenie aktualizacji:
carthage update --platform iOS
Spowoduje to zainstalowanie interfejsów API określonych w plikuCartfile
oraz wszystkich zależności, jakie mogą one mieć. - W programie Finder w katalogu projektu odszukaj pobrane pliki platformy w obszarze
Carthage/Build/iOS
. - Dodaj do projektu platformy Maps SDK na iOS, przeciągając do projektu poniższe pakiety.
Gdy pojawi się taka prośba, wybierz Skopiuj elementy w razie potrzeby. Użyj tej samej wersji co powyżej.
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
- Kliknij prawym przyciskiem myszy
GoogleMaps.framework
w projekcie i wybierz Pokaż w Finderze. - Przeciągnij plik
Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
z folderuResources
do projektu. Gdy pojawi się komunikat, upewnij się, że Kopiuj elementy do folderu grupy docelowej nie jest zaznaczona. - Wybierz projekt z Nawigatora projektów i wybierz miejsce docelowe aplikacji.
- Otwórz kartę Etapy kompilacji dla celu aplikacji i w sekcji Połącz plik binarny z bibliotekami dodaj te platformy:
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
Wybierz projekt, a nie konkretny cel, i otwórz kartę Ustawienia kompilacji. W sekcji Inne flagi łączące dodaj
-ObjC
. Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.
Użyj menedżera pakietów Swift
- Jeśli nie masz jeszcze projektu Xcode, utwórz go teraz i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz programować w iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS. Xcode 11.7 lub starszej wersji utwórz aplikację z jednym widokiem.
- Dodaj zależność pakiet SDK Map Google na iOS. Dostępne opcje znajdziesz w sekcji Instalowanie pakietu SDK.
- W projekcie Xcode wybierz Plik -> Pakiety Swift -> Dodaj zależność pakietu.
- W wyświetlonym oknie wpisz adres URL repozytorium 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 na koncie GitHub. Aby kontynuować ten proces, wykonaj instrukcje tworzenia osobistego tokena dostępu GitHuba.
- W następnym oknie wybierz opcję Wersja, z listy wybierz Ścisłe, podaj najnowszą wersję biblioteki narzędziowej pakietu Maps SDK na iOS (np. „3.4.0”) i kliknij Dalej.
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 skompiluj i uruchom projekt.
Dodaj do aplikacji narzędzie
Aby dowiedzieć się więcej o korzystaniu z danego narzędzia w aplikacji, zapoznaj się z jego dokumentacją: