Konfiguracja i prezentacja

Wybierz platformę: Android iOS

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:

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

  1. 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).
  2. Dodaj pakiet Maps SDK na iOS jako zależność. Zobacz Instalowanie pakietu SDK, aby wyświetlić opcje.
  3. W projekcie Xcode przejdź do File (Plik) -> Przesyłki Swift -> Dodaj zależność pakietu.
  4. 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.
  5. 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”).
  6. Kliknij menu obok opcji Dodaj do projektu, wybierz swój projekt i kliknij Dodaj pakiet.

Używaj CocoaPods

  1. 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ę)
  2. Jeśli nie masz jeszcze pliku poda dla swojego projektu, utwórz go Podfile. Ten plik określa w zależności od projektu.
  3. 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
  4. Uruchom pod install.
  5. 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

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

  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ę prośba, wybierz Swift lub Objective-C. CocoaPods aktualizuje repozytoria specyfikacji, i otwiera wersję demonstracyjną w tymczasowym projekcie Xcode o nazwie SwiftDemoApp.xcodeproj. lub ObjCDemoApp.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:

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

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