Konfigurowanie projektu Xcode

Menedżer pakietów Swift

Pakiet Maps SDK na iOS można zainstalować za pomocą: Menedżer pakietów Swift. Aby dodać pakiet SDK, upewnij się, że masz usunięto wszystkie zależności istniejących pakietów SDK Maps na iOS.

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

1. Otwórz Xcode project lub workspace i przejdź do File > (Plik >). Dodaj zależności pakietów.
2. Jako URL wpisz https://github.com/googlemaps/ios-maps-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
3. Aby zainstalować określony pakiet 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 za pomocą opcji „Dokładna wersja” . Gdy skończysz, kliknij „Dodaj pakiet”.
4. W oknie Wybierz produkty w pakiecie sprawdź GoogleMaps (w przypadku wersji starszych niż 9.0.0 sprawdź, GoogleMaps, GoogleMapsBase i GoogleMapsCore) zostanie dodany do wyznaczonego celu main. Gdy skończysz, kliknij „Dodaj pakiet”.
5. Aby sprawdzić instalację, przejdź do panelu General środowiska docelowego. W obszarze Frameworks, biblioteki i umieszczona treść powinny być widoczne zainstalowane pakiety. Możesz też wyświetlić „Zależności pakietów” w narzędziu „Project Navigator” aby zweryfikować pakiet i jego wersję.

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 informacjach o wersji 9.0.0.

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

   • GoogleMapsBase (tylko w przypadku uaktualnień z wersji starszych niż 9.0.0)
   • GoogleMapsCore (tylko w przypadku uaktualnień z wersji starszych niż 9.0.0)
   • GoogleMapsM4B (dotyczy tylko uaktualnień z wersji starszych niż 9.0.0)
2. W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
3. Aby sprawdzić poprawność instalacji, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator. aby zweryfikować pakiet i jego wersję.

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

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. Usuń Podfile, Podfile.resolved i Kod Xcode workspace, jeśli nie używasz ich do innych celów niż CocoaPods.

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, i Umieszczone treści. Aby usunąć strukturę, użyj znaku minusa(-):
   • GoogleMaps
   • GoogleMapsBase (tylko do instalacji wcześniej niż w wersji 9.0.0)
   • GoogleMapsCore (tylko do instalacji wcześniej niż w wersji 9.0.0)
   • GoogleMapsM4B (tylko do instalacji wcześniej niż w wersji 9.0.0)
2. W katalogu najwyższego poziomu projektu Xcode usuń GoogleMaps w pakiecie.

CocoaPods

Pakiet Maps SDK na iOS jest dostępny jako pakiet CocoaPods. CocoaPods to menedżer zależności open source dla rozwiązań Swift i Objective-C. Projekty Cocoa.

Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w systemie macOS przez uruchamiając poniższe polecenie w terminalu. Szczegółowe informacje znajdziesz w Przewodniku wdrożeniowym 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 teraz i zapisz w na komputerze lokalnym. Jeśli dopiero zaczynasz programowanie aplikacji na iOS:
   1. Utwórz nowy projekt.
   2. Wybierz kolejno iOS > App.
   3. Na ekranie opcji projektu:
      1. Wpisz nazwę projektu.
      2. Zapisz wartość pola Identyfikator pakietu. Możesz użyć tej wartości, aby ograniczyć poniżej swój klucz interfejsu API.
      3. Ustaw projekt Interface na Storyboard.
      4. Ustaw Language (Język) na Swift lub Objective-C.
2. Utwórz w katalogu projektu plik o nazwie Podfile. Ten definiuje zależności projektu.
3. Edytuj Podfile i dodaj zależności wraz z ich wersji. Oto przykład, który zawiera zależność wymaganą do korzystania z Maps SDK na iOS:

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

   Regularnie uruchamiaj aplikację pod outdated, aby wykryć, że jest dostępna nowsza wersja , by mieć pewność, że zawsze korzystasz z najnowszej wersji. W razie potrzeby zaktualizuj go do najnowszej wersji.
4. Zapisz Podfile.

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

   cd <path-to-project>

6. Uruchom polecenie pod install. Spowoduje to zainstalowanie Interfejsy API określone w Podfile wraz z zależnościami mogą mieć dostęp do treści.

   pod install

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

Aby zaktualizować interfejs API w istniejącym projekcie:

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

Instalacja ręczna

1. Pobierz te pliki binarne i pliki zasobów pakietu SDK:
   • GoogleMaps
   • GoogleMapsBase
   • GoogleMapsCore
   • Mapy GoogleM4B
   • GoogleMapsResources
2. Wypakuj pliki, aby uzyskać dostęp do XCFrameworks i zasobów.
3. Jeśli nie masz jeszcze projektu Xcode, utwórz go teraz i zapisz w na komputerze lokalnym. Jeśli dopiero zaczynasz programowanie aplikacji na iOS:
   1. Utwórz nowy projekt.
   2. Wybierz kolejno iOS > App.
   3. Na ekranie opcji projektu:
      1. Wpisz nazwę projektu.
      2. Zapisz wartość pola Identyfikator pakietu. Możesz użyć tej wartości, aby ograniczyć poniżej swój klucz interfejsu API.
      3. Ustaw projekt Interface na Storyboard.
      4. Ustaw Language (Język) na Swift lub Objective-C.
4. Otwórz kartę Ogólne. Przeciągnij do projektu te tagi XCFrameworks w sekcji Ramki, biblioteki i umieszczone treści. Upewnij się, wybierz Do Not Embed (Nie umieszczaj) dla każdego elementu XCFramework:
   • GoogleMaps.xcframework
   • GoogleMapsBase.xcframework
   • GoogleMapsCore.xcframework
5. Skopiuj GoogleMaps.bundle z GoogleMapsResources. pobrane do katalogu najwyższego poziomu projektu Xcode. Wybierz Skopiuj elementy do folderu grupy docelowej, gdy pojawi się odpowiedni komunikat.
6. W Nawigatorze projektów wybierz projekt, a potem element docelowy aplikacji.
7. Otwórz kartę Etapy kompilacji dla środowiska docelowego 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 (tylko jeśli używasz OpenGL)
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Wybierz projekt zamiast konkretnego miejsca docelowego i otwórz Na karcie Build Settings (Ustawienia kompilacji). W sekcji Łączenie – Ogólne -> Inny tag łączący Flagi, dodaj -ObjC do „Debugowanie”. i „Wycofaj”. Jeśli ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.

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

Swift

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

1. Dodaj instrukcję importu:

   import GoogleMaps

2. Dodaj te elementy do: application(_:didFinishLaunchingWithOptions:) za pomocą 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

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

1. Dodaj tę instrukcję importu:

   @import GoogleMaps;

2. Dodaj te elementy do: application:didFinishLaunchingWithOptions: za pomocą 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"];

Swift

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.

        let options = GMSMapViewOptions()
        options.camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        options.frame = self.view.bounds

        let mapView = GMSMapView(options: options)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}

Objective-C

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController()

@end

@implementation ViewController

-   (void)viewDidLoad {
  [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
  options.frame = self.view.bounds;
  GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end