Ta strona została przetłumaczona przez Cloud Translation API.

Konfigurowanie projektu Xcode

Po włączeniu płatności i utworzeniu klucza interfejsu API możesz skonfigurować 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 SDK Miejsc na iOS, musisz mieć:

Xcode w wersji 15.0 lub nowszej.

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

Menedżer pakietów Swift

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

Aby dodać pakiet SDK do nowego lub istniejącego projektu:

Otwórz Xcode project lub workspace i kliknij Plik > Dodaj zależności pakietu.
Wpisz https://github.com/googlemaps/ios-places-sdk jako adres URL, naciśnij Enter, aby zaimportować pakiet, i kliknij „Dodaj pakiet”.
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 podanie najnowszej wersji i używanie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.
W oknie Wybieranie produktów w pakiecie sprawdź, czy do głównego celu zostaną dodane GooglePlaces, GooglePlacesSwift czy oba te elementy. Gdy skończysz, kliknij Dodaj pakiet.
Jeśli aktualizujesz Google Places Swift z nieużywanego adresu URL GitHub

Ważne: od wersji 0.3.0 adres URL GitHuba, który umożliwia dostęp do Google Places Swift, zmienił się. Jeśli aktualizujesz wersję GooglePlacesSwift, do której dostęp uzyskiwano za pomocą starego adresu URL, https://github.com/googlemaps/ios-places-swift-sdk, usuń ją z sekcji zależności pakietu Xcode.
Aby sprawdzić instalację, otwórz panel Ogólne celu. W sekcji Frameworki, biblioteki i wbudowane treści powinny być widoczne zainstalowane pakiety. Możesz też wyświetlić sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję. Xcode pokazuje wersję GitHuba, która jest zgodna z wersją GooglePlaces (np. 9.2.0), ale nie jest zgodna z wersją GooglePlacesSwift (np. 0.3.0).

Aby zaktualizować package w istniejącym projekcie:

W Xcode wybierz „Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów”.
Jeśli aktualizujesz Google Places Swift z nieużywanego adresu URL GitHub

Ważne: od wersji 0.3.0 adres URL GitHuba, który umożliwia dostęp do Google Places Swift, zmienił się. Jeśli aktualizujesz wersję GooglePlacesSwift, do której dostęp uzyskiwano za pomocą starego adresu URL, https://github.com/googlemaps/ios-places-swift-sdk, usuń ją z sekcji zależności pakietu Xcode.
Aby sprawdzić instalację, otwórz sekcję Zależność pakietu w Nawigatorze projektu, aby zweryfikować pakiet i jego wersję.

Aby usunąć istniejący pakiet SDK Miejsc na iOS zainstalowany ręcznie: wykonaj te czynności:

W ustawieniach konfiguracji projektu Xcode znajdź Frameworki, biblioteki i zawartość osadzona. Aby usunąć te ramy: kliknij znak minusa(-).
- GooglePlaces.xcframework
- GooglePlacesSwift.xcframework
W najwyższym katalogu projektu Xcode usuń pakiet GooglePlaces.

Instalacja ręczna

Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu pakiety XCFramework zawierające pakiet SDK Miejsca na iOS i pakiet SDK Miejsca Swift na iOS (wersja podglądowa) oraz skonfigurować ustawienia kompilacji w Xcode. XCFramework to pakiet binarny, którego możesz używać na wielu platformach, w tym na maszynach z procesorami Apple. Możesz dodać pakiet SDK Miejsc na iOS, pakiet SDK Swift Miejsc na iOS (wersja podglądowa) lub oba te pakiety.

Pobierz te pliki binarne i zasoby pakietu SDK:
- GooglePlaces
- GooglePlacesResources
Jeśli instalujesz pakiet SDK Miejsc Swift na iOS (wersja podglądowa), zainstaluj te pliki:
- GooglePlacesSwift
- GooglePlacesSwiftResources
Wyodrębnij pliki, aby uzyskać dostęp do XCFramework i zasobów.
Uruchom Xcode i otwórz istniejący projekt lub utwórz nowy. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS, utwórz nowy projekt i wybierz Szablon aplikacji na iOS.
Usuń z projektu wszystkie pakiety Map z poprzednich wersji.
Otwórz kartę Ogólne. Przeciągnij do projektu te biblioteki XCFramework w sekcji Frameworky, biblioteki i osadzony zawartość. Pamiętaj, aby wybrać Nie umieszczaj:
- GooglePlaces.xcframework
Jeśli instalujesz pakiet SDK Miejsca Swift na iOS (wersja podglądowa), przeciągnij ten XCFramework do projektu w sekcji Frameworky, biblioteki i zawartość osadzona. Pamiętaj, aby wybrać Nie umieszczaj:
- GooglePlacesSwift.xcframework
Skopiuj GooglePlaces.bundle z katalogu GooglePlacesResources, który został pobrany do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się odpowiedni komunikat, wybierz opcję Kopiuj elementy do folderu grupy docelowej.

Jeśli instalujesz pakiet Places Swift SDK na iOS (wersja podglądowa), skopiuj GooglePlacesSwift.bundle z katalogu GooglePlacesSwiftResources, który został pobrany do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się odpowiedni komunikat, wybierz opcję Skopiuj elementy do folderu grupy docelowej.
W Nawigatorze projektów wybierz projekt, a potem element docelowy aplikacji.
Otwórz kartę Etapy kompilacji. W sekcji Połącz binarny z bibliotekami dodaj te frameworki i biblioteki:
- CoreGraphics.framework
- CoreLocation.framework
- libc++.tbd
- libz.tbd
- QuartzCore.framework
- UIKit.framework
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, na pasku Ustawienia kompilacji zmień filtr z Podstawowe na Wszystkie.

CocoaPods

Pakiet SDK Miejsc na iOS i pakiet SDK Miejsc Swift na iOS (wersja w wersji próbnej) są dostępne jako CocoaPod GooglePlaces i GooglePlacesSwift.

CocoaPods to menedżer zależności typu open source do projektów Cocoa w Swift i Objective-C. Jeśli nie masz jeszcze zainstalowanego narzędzia CocoaPods, zainstaluj je w systemie macOS, wykonując w terminalu podane niżej polecenie. Więcej informacji znajdziesz w przewodniku CocoaPods dla początkujących.

sudo gem install cocoapods

Utwórz Podfile, aby zainstalować pakiety SDK i ich zależności:

Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS, utwórz nowy projekt i wybierz Szablon aplikacji na iOS.
W katalogu projektu utwórz plik o nazwie Podfile. Ten plik definiuje zależności projektu.
Zmodyfikuj Podfile i dodaj zależności wraz z ich wersjami. Oto przykład, w którym podano nazwę docelową aplikacji oraz nazwy podgrup GooglePlaces i GooglePlacesSwift:
```
source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.0'
end
```
Regularnie uruchamiaj pod outdated, aby wykrywać nowsze wersje i utrzymywać najnowszą.
Zapisz Podfile.
Otwórz terminal i przejdź do katalogu zawierającego Podfile:
```
cd <path-to-project>
```
Uruchom polecenie pod install. Spowoduje to zainstalowanie interfejsów API określonych w Podfile wraz z ich zależnościami.
```
pod install
```
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:

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

Krok 3. Dodaj klucz interfejsu API do aplikacji

W podanych niżej przykładach zastąp YOUR_API_KEY swoim kluczem API.

Swift

Aby dodać klucz interfejsu API do AppDelegate.swift, wykonaj te czynności:

Dodaj tę instrukcję importu:
```
import GooglePlaces
```
Dodaj do metody application(_:didFinishLaunchingWithOptions:) następujący kod, zastępując YOUR_API_KEY swoim kluczem API:
```
GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
```

Objective-C

Aby dodać klucz interfejsu API do AppDelegate.m, wykonaj te czynności:

Dodaj tę instrukcję importu:
```
@import GooglePlaces;
```
Dodaj do metody application:didFinishLaunchingWithOptions: poniższy kod, zastępując YOUR_API_KEY swoim kluczem API:
```
[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
```

GooglePlacesSwift