Na tej stronie dowiesz się, jak skonfigurować biblioteka narzędzi w przypadku pakietu Maps SDK na iOS.
Aby wypróbować te narzędzia, możesz:
- Zainstaluj bibliotekę narzędzia w istniejącym projekcie Xcode Dodaj te narzędzia do swojego projektu.
- Zainstaluj i uruchom aplikację w wersji demonstracyjnej Aplikacja demonstracyjna 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ędzia do obszaru roboczego Xcode:
Użyj menedżera pakietów Swift
- Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze lokalnym. (Jeśli dopiero zaczynasz programowanie na iOS, utwórz nowy projekt i wybierz aplikację na iOS). . W Xcode w wersji 11.7 lub starszej utwórz aplikację jednokrotnego widoku).
- Dodaj pakiet Maps SDK na iOS jako zależność. Zobacz Instalowanie pakietu SDK, aby wyświetlić opcje.
- W projekcie Xcode przejdź do File (Plik) -> Przesyłki Swift -> Dodaj zależność pakietu.
- W wyświetlonym oknie wpisz adres URL repozytorium biblioteki narzędziowej 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. Postępuj zgodnie z instrukcje tworzenia GitHub osobisty token dostępu, aby kontynuować ten proces.
- W następnym oknie wybierz opcję Wersja, a następnie Do następnej wersji głównej. i wpisz najnowszą wersję pakietu narzędziowego Maps SDK na iOS. (np. „6.0.0”).
- Kliknij menu obok opcji Dodaj do projektu, wybierz swój projekt i kliknij Dodaj pakiet.
Używaj CocoaPods
- Jeśli nie masz jeszcze projektu Xcode, utwórz go teraz i zapisz w na komputerze lokalnym. (Jeśli nie masz doświadczenia w programowaniu aplikacji na iOS, utwórz single Wyświetl aplikację)
- Jeśli nie masz jeszcze pliku poda dla swojego projektu, utwórz go
Podfile
. Ten plik określa w zależności od projektu. - Edytuj plik poda projektu i dodaj zależność
Google-Maps-iOS-Utils
blok reklamowy. Oto który zawiera zależności potrzebne dla Maps SDK na iOS i biblioteka narzędzi: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.0.0' # x-release-please-version end
- Uruchom
pod install
. - Zamknij Xcode, a następnie otwórz projekt
.xcworkspace
, aby uruchomić Xcode. Od tego momentu musi użyć pliku.xcworkspace
, aby otworzyć projekt.
Uwaga: narzędzie do grupowania znaczników zależy od
quadtree, ale nie można używać
drzewa bez grupowania znaczników. Jeśli chcesz
można zmienić tylko
pod 'Google-Maps-iOS-Utils'
do
'Google-Maps-iOS-Utils/QuadTree'
w pliku poda.
Dodawanie klucza interfejsu API do aplikacji
Instrukcje generowania znajdziesz w artykule o konfigurowaniu projektu Xcode. klucz interfejsu API i dodanie go do projektu Xcode.Kompilowanie i uruchamianie projektu
Po dodaniu klucza interfejsu API skompiluj i uruchom projekt.
Korzystanie z narzędzia w aplikacji
Aby dowiedzieć się więcej o korzystaniu z danego narzędzia w aplikacji, zapoznaj się z jego dokumentacją:
Zainstaluj i uruchom aplikację w wersji demonstracyjnej
Biblioteka narzędzi zawiera aplikację w wersji demonstracyjnej, którą możesz zainstalować, a następnie wypróbować poszczególne narzędzia.
Zainstaluj aplikację w wersji demonstracyjnej, korzystając z jednej z tych 2 metod:Użyj plików z GitHuba
- Pobierz z przykładowego archiwum kodu GitHub i rozpakuj archiwum.
- Otwórz okno terminala, przejdź do katalogu, do którego zostały rozwinięte przykładowe pliki,
przejdź do odpowiedniego katalogu przykładów dla języka, którego chcesz używać:
- 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 projekt
.xcworkspace
, aby uruchomić Xcode. Od tego momentu musi użyć pliku.xcworkspace
, aby otworzyć projekt.
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ę prośba, wybierz Swift lub Objective-C. CocoaPods aktualizuje repozytoria specyfikacji, i otwiera wersję demonstracyjną w tymczasowym projekcie Xcode o nazwie
SwiftDemoApp.xcodeproj
. lubObjCDemoApp.xcodeproj
.
Dodaj klucz interfejsu API do aplikacji w wersji demonstracyjnej
Korzystając z narzędzia Uzyskaj klucz interfejsu API, generujesz klucz interfejsu API aplikacji. Teraz dodaj ten klucz do projektu Xcode aplikacji w wersji demonstracyjnej.Swift
Dodaj klucz interfejsu API do AppDelegate.swift
w ten sposób:
- Dodaj instrukcję importu:
import GoogleMaps
- Edytuj ten wiersz, aby dodać klucz interfejsu API między cudzysłowami podwójnymi:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Dodaj klucz interfejsu API do AppDelegate.m
w ten sposób:
- Dodaj instrukcję importu:
@import GoogleMaps;
- Edytuj ten wiersz, aby dodać klucz interfejsu API między cudzysłowami podwójnymi:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Utwórz i uruchom aplikację w wersji demonstracyjnej
Po dodaniu klucza interfejsu API skompiluj i uruchom projekt:
- Jeśli korzystasz z wersji demonstracyjnej w wersji Swift, możesz wybrać narzędzie, które zostanie wyświetlone w aplikacji.
- Jeśli używasz wersji demonstracyjnej w języku Objective-C, zobaczysz narzędzie do grupowania znaczników. Następnie możesz edytować wersję demonstracyjną Objective-C, aby wypróbować poszczególne narzędzia. Więcej informacji znajdziesz w sekcji Dodawanie narzędzia do aplikacji poniżej.