Konfiguracja i prezentacja

Wybierz platformę: Android iOS

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:

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

  1. Pobierz archiwum przykładowego kodu z GitHub i rozpakuj archiwum.
  2. 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
  3. Uruchom to polecenie:
    pod install
  4. 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

  1. Otwórz okno terminala i zainstaluj wersję 1.6.1: 
    sudo gem install cocoapods -v1.6.1
  2. 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 lub ObjCDemoApp.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:

  1. Dodaj tę instrukcję importu: 
    import GoogleMaps
  2. 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:

  1. Dodaj tę instrukcję importu: 
    @import GoogleMaps;
  2. 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

  1. 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).
  2. 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.
  3. 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
  4. Uruchom pod install.
  5. 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

  1. Zainstaluj Carthage. Jest kilka metod, więc szczegółowe instrukcje znajdziesz w pliku README Carthage.
  2. 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.
  3. W katalogu projektu utwórz plik o nazwie Cartfile. Ten plik definiuje zależności projektu.
  4. Edytuj Cartfile i dodaj zależność z biblioteki narzędziowej pakietu Maps SDK na iOS:
    github "googlemaps/google-maps-ios-utils"
  5. Zapisz Cartfile.
  6. W oknie terminala przejdź do katalogu zawierającego Cartfile:
    cd <path-to-project>
  7. Uruchom polecenie aktualizacji:
    carthage update --platform iOS

    Spowoduje to zainstalowanie interfejsów API określonych w pliku Cartfile oraz wszystkich zależności, jakie mogą one mieć.
  8. W programie Finder w katalogu projektu odszukaj pobrane pliki platformy w obszarze Carthage/Build/iOS.
  9. 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
  10. Kliknij prawym przyciskiem myszy GoogleMaps.framework w projekcie i wybierz Pokaż w Finderze.
  11. Przeciągnij plik Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle z folderu Resources do projektu. Gdy pojawi się komunikat, upewnij się, że Kopiuj elementy do folderu grupy docelowej nie jest zaznaczona.
  12. Wybierz projekt z Nawigatora projektów i wybierz miejsce docelowe aplikacji.
  13. 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

  14. 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

  1. 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.
  2. Dodaj zależność pakiet SDK Map Google na iOS. Dostępne opcje znajdziesz w sekcji Instalowanie pakietu SDK.
  3. W projekcie Xcode wybierz Plik -> Pakiety Swift -> Dodaj zależność pakietu.
  4. 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.
  5. 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ą: