Konfigurowanie projektu Xcode

Po włączeniu płatności i utworzeniu klucza interfejsu API skonfiguruj projekt Xcode, którego używasz do tworzenia aplikacji.

Informacje o wersji są dostępne dla każdej wersji.

Krok 1. Zainstaluj wymagane oprogramowanie

Aby utworzyć projekt za pomocą pakietu Maps SDK na iOS, pobierz i zainstaluj:

  • Xcode w wersji 26.0 lub nowszej

Krok 2. Utwórz projekt Xcode i zainstaluj pakiet Maps SDK na iOS

Rozmiar instalacji pakietu SDK jest różny. Na przykład rozmiar instalacji pakietu Maps SDK na iOS w wersji 9.0 wynosi około 18 MB.

Swift Package Manager

Pakiet Maps SDK na iOS można zainstalować za pomocą Swift Package Manager. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie dotychczasowe zależności pakietu Maps SDK na iOS.

Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:

  1. Otwórz project lub workspace Xcode, a następnie kliknij File > Add Package Dependencies.
  2. Wpisz adres URL https://github.com/googlemaps/ios-maps-sdk, naciśnij Enter , aby pobrać pakiet, a następnie kliknij „Add Package” (Dodaj pakiet).
  3. Aby zainstalować konkretną version, ustaw pole Dependency Rule na jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Exact Version” (Dokładna wersja). Gdy skończysz, kliknij „Add Package” (Dodaj pakiet).
  4. W oknie Choose Package Products (Wybierz produkty pakietu) sprawdź, czy pakiet GoogleMaps (w przypadku wersji starszych niż 9.0.0 sprawdź, czy pakiety GoogleMaps, GoogleMapsBase, i GoogleMapsCore) zostanie dodany do wyznaczonego elementu docelowego main. Gdy skończysz, kliknij „Add Package” (Dodaj pakiet).
  5. Aby sprawdzić instalację, otwórz panel General (Ogólne) elementu docelowego. W sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) powinny być widoczne zainstalowane pakiety. Aby sprawdzić pakiet i jego wersję, możesz też otworzyć sekcję „Package Dependencies” (Zależności pakietu) w „Project Navigator” (Nawigator projektu)

Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:

  1. Jeśli uaktualniasz wersję starszą niż 9.0.0, po uaktualnieniu musisz usunąć te zależności: GoogleMapsBase, GoogleMapsCore i GoogleMapsM4B. Nie usuwaj zależności GoogleMaps. Więcej informacji znajdziesz w informacjach o wersji 9.0.0.

    W ustawieniach konfiguracji projektu Xcode znajdź sekcję Frameworks, Libraries, i Embedded Content. Użyj znaku minusa(-) , aby usunąć te platformy:

    • GoogleMapsBase (tylko w przypadku uaktualniania z wersji starszych niż 9.0.0)
    • GoogleMapsCore (tylko w przypadku uaktualniania z wersji starszych niż 9.0.0)
    • GoogleMapsM4B (tylko w przypadku uaktualniania z wersji starszych niż 9.0.0)
  2. W Xcode kliknij File > Packages > Update To Latest Package Versions (Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów).
  3. Aby sprawdzić instalację, otwórz sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu) aby sprawdzić pakiet i jego wersję.

Aby usunąć dotychczasowe zależności pakietu Maps SDK na iOS dodane za pomocą CocoaPods:

  1. Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj to polecenie: 
    sudo gem install cocoapods-deintegrate cocoapods-clean
pod deintegrate
pod cache clean --all
  2. Jeśli nie używasz plików Podfile, Podfile.resolved i Xcode workspace do niczego innego niż CocoaPods, usuń je.
Aby usunąć dotychczasowy pakiet Maps SDK na iOS zainstalowany ręcznie: wykonaj następujące czynności:
  1. W ustawieniach konfiguracji projektu Xcode znajdź sekcję Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Użyj znaku minusa (-) , aby usunąć te platformy:
    • GoogleMaps
    • GoogleMapsBase (tylko w przypadku instalacji starszych niż wersja 9.2.0)
    • GoogleMapsCore (tylko w przypadku instalacji starszych niż wersja 9.2.0)
    • GoogleMapsM4B (tylko w przypadku instalacji starszych niż wersja 9.0.0)
  2. W katalogu najwyższego poziomu projektu Xcode usuń pakiet GoogleMaps.

Instalacja ręczna

Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu pakiety XCFramework zawierające pakiet Maps SDK na iOS i skonfigurować ustawienia kompilacji w Xcode. XCFramework to pakiet binarny, którego możesz używać na wielu platformach, w tym na komputerach z procesorami Apple.

  1. Pobierz te pliki binarne i pliki zasobów pakietu SDK:
  2. Rozpakuj pliki, aby uzyskać dostęp do pakietów XCFramework i zasobów.
  3. Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS:
    1. Utwórz nowy projekt.
    2. Wybierz szablon iOS > App (iOS > Aplikacja).
    3. Na ekranie opcji projektu:
      1. Wpisz Project Name (Nazwa projektu).
      2. Zapisz wartość pola Bundle identifier (Identyfikator pakietu). Możesz użyć tej wartości, aby ograniczyć klucz interfejsu API poniżej.
      3. Ustaw Interface (Interfejs) projektu na Storyboard (Scenorys).
      4. Ustaw Language (Język) na Swift lub Objective-C.
  4. Otwórz kartę General (Ogólne). Przeciągnij te pakiety XCFramework do projektu w sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Pamiętaj, aby wybrać Do Not Embed:
    • GoogleMaps.xcframework
  5. Skopiuj plik GoogleMaps.bundle z pobranego pakietu GoogleMapsResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się prośba, pamiętaj, aby wybrać Copy items into destination group's folder (Skopiuj elementy do folderu grupy docelowej).
  6. Wybierz projekt w Nawigatorze projektu i wybierz element docelowy aplikacji.
  7. Otwórz kartę Build Phases (Fazy kompilacji) elementu docelowego aplikacji. W sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te frameworki i biblioteki:
    • Accelerate.framework
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • MetricKit.framework
    • OpenGLES.framework (tylko jeśli używasz OpenGL)
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework

  8. Wybierz projekt, a nie konkretny element docelowy, i otwórz kartę Build Settings (Ustawienia kompilacji). W sekcji Linking - General -> Other Linker Flags (Łączenie – Ogólne – > Inne flagi linkera) dodaj -ObjC do „Debug” (Debugowanie) i „Release” (Wersja). Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Build Settings (Ustawienia kompilacji) z Basic (Podstawowe) na All (Wszystkie).

  9. Aby zainstalować pakiet Places SDK na iOS XCFramework, przeczytaj artykuł Pierwsze kroki z pakietem Places SDK na iOS.

Krok 3. Dodaj klucz interfejsu API do projektu

W artykule Uzyskiwanie klucza interfejsu API wygenerowano klucz interfejsu API dla aplikacji. Teraz dodaj ten klucz do projektu Xcode.

W tych przykładach zastąp YOUR_API_KEY swoim kluczem interfejsu API.

Swift

Dodaj klucz interfejsu API do pliku AppDelegate.swift w ten sposób:

  1. Dodaj to stwierdzenie importu: 
    import GoogleMaps
  2. Dodaj to do metody application(_:didFinishLaunchingWithOptions:), używając klucza interfejsu API: 
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Jeśli używasz też interfejsu Places API, dodaj klucz ponownie w sposób pokazany tutaj: 
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Dodaj klucz interfejsu API do pliku AppDelegate.m w ten sposób:

  1. Dodaj to stwierdzenie importu: 
    @import GoogleMaps;
  2. Dodaj to do metody application:didFinishLaunchingWithOptions:, używając klucza interfejsu API: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Jeśli używasz też interfejsu Places API, dodaj klucz ponownie w sposób pokazany tutaj: 
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Krok 4 (opcjonalny). Sprawdź plik manifestu prywatności Apple

Firma Apple wymaga, aby aplikacje w App Store zawierały informacje o ochronie prywatności. Aktualne informacje i inne szczegóły znajdziesz na stronie Apple App Store Privacy Details.

Plik manifestu prywatności Apple jest zawarty w pakiecie zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został dołączony, i sprawdzić jego zawartość, utwórz archiwum aplikacji i wygeneruj raport o ochronie prywatności na podstawie tego archiwum.

Krok 5 (opcjonalny). Zadeklaruj schematy adresów URL używane przez interfejs API

Od wersji iOS 9 i Xcode 7 aplikacje deklarują schematy adresów URL, które mają być otwierane, określając je w pliku Info.plist aplikacji. Pakiet Maps SDK na iOS otwiera aplikację mobilną Mapy Google, gdy użytkownik kliknie logo Google na mapie, dlatego Twoja aplikacja może deklarować odpowiednie schematy adresów URL.

Aby zadeklarować schematy adresów URL używane przez pakiet Maps SDK na iOS, dodaj te wiersze do pliku Info.plist:

 <key>LSApplicationQueriesSchemes</key>
 <array>
        <string>googlechromes</string>
        <string>comgooglemaps</string>
    </array>

Ten obraz przedstawia konfigurację w interfejsie Xcode:

Konfigurowanie `LSApplicationQueriesSchemes` w Xcode

Bez powyższej deklaracji, gdy użytkownik kliknie logo Google na mapie, mogą wystąpić te błędy:

  • -canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
  • -canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

Aby wyeliminować te błędy, dodaj deklarację do pliku Info.plist.

Co dalej?

Teraz, gdy masz klucz interfejsu API i projekt Xcode, możesz tworzyć i uruchamiać aplikacje. Pakiet Navigation SDK na iOS zawiera wiele samouczków i przykładowych aplikacji, które pomogą Ci zacząć. Więcej informacji znajdziesz w tych artykułach: