Konfigurowanie projektu Xcode

Menedżer pakietów Swift

Pakiet SDK Maps na iOS można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie istniejące zależności Maps SDK na iOS.

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

1. Otwórz Xcode project lub workspace, a następnie kliknij Plik > Dodaj zależności pakietu.
2. Wpisz https://github.com/googlemaps/ios-maps-sdk jako adres URL, naciśnij Enter, aby zaimportować pakiet, i kliknij „Dodaj pakiet”.
3. Aby zainstalować określoną wersję version, ustaw pole Reguła zależności na jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.

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

1. Jeśli przechodzisz z wersji starszej niż 9.0.0, musisz usunąć te zależności: GoogleMapsBase, GoogleMapsCore i GoogleMapsM4B. Nie usuwaj zależności dla GoogleMaps. Więcej informacji znajdziesz w notatkach do wersji 9.0.0.

   W ustawieniach konfiguracji projektu Xcode znajdź Frameworki, biblioteki i zawartość osadzona. Aby usunąć te ramy, użyj znaku minusa(-):

   • GoogleMapsBase (dotyczy tylko uaktualnień z wersji starszych niż 9.0.0)
   • GoogleMapsCore (tylko w przypadku uaktualnienia z wersji starszych niż 9.0.0)
   • GoogleMapsM4B (tylko w przypadku uaktualnienia z wersji starszych niż 9.0.0)
2. W Xcode wybierz „Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów”.
3. Aby zweryfikować instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu i sprawdź pakiet oraz jego wersję.

Aby usunąć istniejące zależności Maps SDK na iOS dodane za pomocą funkcji CocoaPods, wykonaj te czynności:

1. Zamknij obszar roboczy Xcode. Otwórz terminal i uruchom to polecenie:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Usuń Podfile, Podfile.resolved i Xcode workspace, jeśli nie używasz ich do niczego innego niż CocoaPods.

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworki, biblioteki i zawartość osadzona. Aby usunąć te ramy, kliknij minus(-):
   • GoogleMaps
   • GoogleMapsBase (dotyczy tylko instalacji w wersjach starszych niż 9.2.0)
   • GoogleMapsCore (dotyczy tylko instalacji w wersjach starszych niż 9.2.0)
   • GoogleMapsM4B (dotyczy tylko instalacji w wersjach starszych niż 9.0.0)
2. W najwyższym katalogu projektu Xcode usuń pakiet GoogleMaps.

Instalacja ręczna

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

1. Pobierz te pliki binarne i pliki zasobów pakietu SDK:
   • GoogleMaps
   • GoogleMapsM4B
   • GoogleMapsResources
2. Wypakuj pliki, aby uzyskać dostęp do XCFrameworks i zasobów.
3. Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze. Jeśli dopiero zaczynasz zajmować się programowaniem na iOS:
   1. Utwórz nowy projekt.
   2. Wybierz szablon iOS > Aplikacja.
   3. Na ekranie opcji projektu:
      1. Wpisz Nazwa projektu.
      2. Zapisz wartość w polu Identyfikator pakietu. Możesz użyć tej wartości, aby ograniczyć klucz API poniżej.
      3. Ustaw w projekcie opcję Interfejs na Storyboard.
      4. W polu Język wybierz Swift lub Objective-C.
4. Otwórz kartę Ogólne. Przeciągnij ten XCFramework do projektu w sekcji Frameworky, biblioteki i osadzone treści. Pamiętaj, aby wybrać Nie wklejaj:
   • GoogleMaps.xcframework
5. Skopiuj plik GoogleMaps.bundle z katalogu GoogleMapsResources, który został pobrany do katalogu głównego projektu Xcode. Gdy pojawi się odpowiedni komunikat, wybierz Skopiuj elementy do folderu grupy docelowej.
6. W Nawigatorze projektów wybierz projekt, a potem element docelowy aplikacji.
7. Otwórz kartę Etapy kompilacji dla docelowego urządzenia aplikacji. W sekcji 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
   • OpenGLES.framework (dotyczy tylko OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Wybierz projekt, a nie konkretny element docelowy, i otwórz kartę Ustawienia kompilacji. W sekcji Łączenie – Ogólne –> Inne flagi linkera dodaj -ObjC do opcji „Debugowanie” i „Wersja produkcyjna”. Jeśli te ustawienia są niewidoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.

9. Aby zainstalować pakiet SDK Miejsc na iOS w ramach XCFramework, zapoznaj się z artykułem Pierwsze kroki z pakietem SDK Miejsc na iOS.

CocoaPods

Pakiet SDK Map na iOS jest dostępny jako pakiet CocoaPods. CocoaPods to menedżer zależności typu open source dla projektów Cocoa w Swift i Objective-C.

Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w systemie macOS, uruchamiając to polecenie w terminalu. Więcej informacji znajdziesz w przewodniku CocoaPods.

sudo gem install cocoapods

Utwórz Podfile dla pakietu Maps SDK na iOS i użyj go do zainstalowania interfejsu API i jego zależności:

1. Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz zajmować się programowaniem na iOS:
   1. Utwórz nowy projekt.
   2. Wybierz szablon iOS > Aplikacja.
   3. Na ekranie opcji projektu:
      1. Wpisz Nazwa projektu.
      2. Zapisz wartość w polu Identyfikator pakietu. Możesz użyć tej wartości, aby ograniczyć klucz API poniżej.
      3. Ustaw w projekcie opcję Interfejs na Storyboard.
      4. W polu Język wybierz Swift lub Objective-C.
2. Utwórz w katalogu projektu plik o nazwie Podfile. Ten plik definiuje zależności projektu.
3. Zmodyfikuj Podfile i dodaj zależności wraz z ich wersjami. Oto przykład, który zawiera zależność wymaganą przez pakiet SDK Map Google na iOS:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '9.2.0'
   end

   Regularnie uruchamiaj pod outdated, aby wykrywać nowsze wersje i utrzymywać najnowszą. W razie potrzeby zaktualizuj ją do najnowszej wersji.
4. Zapisz Podfile.

5. Otwórz terminal i przejdź do katalogu zawierającego Podfile:

   cd <path-to-project>

6. Uruchom polecenie pod install. Spowoduje to zainstalowanie interfejsów API określonych w Podfile wraz z ich zależnościami.

   pod install

7. Zamknij Xcode, a następnie otwórz (kliknij dwukrotnie) plik .xcworkspace projektu, aby uruchomić Xcode. Od tego momentu do otwierania projektu musisz używać pliku .xcworkspace.

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

1. Otwórz terminal i przejdź do katalogu projektu zawierającego plik Podfile.
2. Uruchom polecenie pod update. Spowoduje to zaktualizowanie wszystkich interfejsów API określonych w Podfile do najnowszej wersji.

Swift

Aby dodać klucz interfejsu API do AppDelegate.swift:

1. Dodaj to polecenie importowania:

   import GoogleMaps

2. Dodaj do metody application(_:didFinishLaunchingWithOptions:) te informacje, korzystając z klucza interfejsu API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Jeśli używasz też interfejsu Places API, dodaj klucz ponownie w ten sposób:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Aby dodać klucz interfejsu API do AppDelegate.m:

1. Dodaj to polecenie importowania:

   @import GoogleMaps;

2. Dodaj do metody application:didFinishLaunchingWithOptions: te informacje, korzystając z klucza interfejsu API:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Jeśli używasz też interfejsu Places API, dodaj klucz ponownie w ten sposób:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];