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 26.0 lub nowszej

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

Swift Package Manager

Pakiet SDK Miejsc na iOS można zainstalować za pomocą Swift Package Manager. Aby dodać pakiet SDK, usuń wszystkie zależności od pakietu Places SDK na iOS.

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

1. Otwórz Xcode project lub workspace, a potem kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu).
2. Wpisz https://github.com/googlemaps/ios-places-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, a następnie kliknij „Add Package” (Dodaj pakiet).
3. Aby zainstalować konkretną version, ustaw w polu Reguła zależności 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”.
4. W oknie Wybierz produkty w pakiecie sprawdź, czy do wybranego głównego celu zostaną dodane produkty GooglePlaces, GooglePlacesSwift lub oba. Gdy skończysz, kliknij Dodaj pakiet.

   Jeśli aktualizujesz Google Places Swift z przestarzałego adresu URL GitHub

   Ważne: od wersji 0.3.0 zmienił się adres URL GitHub, za pomocą którego można uzyskać dostęp do Google Places Swift. Jeśli aktualizujesz wersję GooglePlacesSwift, do której dostęp uzyskano za pomocą starego adresu URL https://github.com/googlemaps/ios-places-swift-sdk, usuń ją z sekcji zależności pakietów w Xcode.

5. Aby sprawdzić instalację, otwórz panel Ogólne w przypadku wybranego celu. W sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) powinny być widoczne zainstalowane pakiety. Możesz też sprawdzić pakiet i jego wersję w sekcji Zależności pakietu w Nawigatorze projektu.

Aby zaktualizować package w przypadku istniejącego projektu:

1. W Xcode kliknij „File > Packages > Update To Latest Package Versions” (Plik > Pakiety> Zaktualizuj do najnowszych wersji pakietów).

   Jeśli aktualizujesz Google Places Swift z przestarzałego adresu URL GitHub

   Ważne: od wersji 0.3.0 zmienił się adres URL GitHub, za pomocą którego można uzyskać dostęp do Google Places Swift. Jeśli aktualizujesz wersję GooglePlacesSwift, do której dostęp uzyskano za pomocą starego adresu URL https://github.com/googlemaps/ios-places-swift-sdk, usuń ją z sekcji zależności pakietów w Xcode.

2. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

Ważne: czasami nie można rozwiązać problemów z artefaktami lub mogą wystąpić błędy. W takim przypadku wybierz „Plik > Pakiety > Zresetuj pamięć podręczną pakietów”.

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

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries and Embedded Content (Frameworki, biblioteki i treści osadzone). Użyj znaku minusa(-), aby usunąć te platformy:
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. Z katalogu najwyższego poziomu projektu Xcode usuń pakiet GooglePlaces.

Instalacja ręczna

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

1. Pobierz te pliki binarne i zasobów pakietu SDK:
   • GooglePlaces
   • GooglePlacesResources
2. Jeśli instalujesz pakiet SDK Miejsc na iOS w Swift, zainstaluj te pliki:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. Wyodrębnij pliki, aby uzyskać dostęp do XCFramework i zasobów.
4. 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.
5. Usuń z projektu wszystkie pakiety Map z poprzednich wersji.
6. Otwórz kartę Ogólne. Przeciągnij do projektu ten plik XCFramework w sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Pamiętaj, aby wybrać Nie umieszczaj:
   • GooglePlaces.xcframework
   Jeśli instalujesz pakiet Places SDK na platformę Swift, przeciągnij do projektu ten plik XCFramework w sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Pamiętaj, aby wybrać Nie umieszczaj:
   • GooglePlacesSwift.xcframework
7. Skopiuj plik GooglePlaces.bundle z pobranego folderu GooglePlacesResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się odpowiedni komunikat, wybierz Skopiuj elementy do folderu grupy docelowej.
   
   Jeśli instalujesz pakiet Places Swift SDK, skopiuj GooglePlacesSwift.bundle z pobranego pakietu GooglePlacesSwiftResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się odpowiedni komunikat, wybierz Skopiuj elementy do folderu grupy docelowej.
8. Wybierz projekt w Nawigatorze projektów i określ cel aplikacji.
9. Otwórz kartę Fazy kompilacji. W sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te platformy i biblioteki:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

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

CocoaPods

Wycofano: od 18 sierpnia 2025 r. CocoaPods jest w trybie konserwacji i po II kwartale 2026 r. nie będziemy publikować kolejnych wersji CocoaPods. Zamiast tego użyj menedżera pakietów Swift.

Pakiety SDK Miejsc na iOS i Places Swift SDK na iOS są dostępne jako pakiety CocoaPod: GooglePlaces i GooglePlacesSwift.

CocoaPods to menedżer zależności open source dla projektów Cocoa w językach Swift i Objective-C. Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w systemie macOS, uruchamiając w terminalu to polecenie: Więcej informacji znajdziesz w przewodniku dla początkujących dotyczącym CocoaPods.

sudo gem install cocoapods

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

1. 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.
2. Utwórz w katalogu projektu plik o nazwie Podfile. Ten plik określa zależności projektu.
3. Edytuj plik Podfile i dodaj zależności wraz z ich wersjami. Oto przykład, w którym określono nazwę docelową aplikacji oraz nazwy podów GooglePlaces i GooglePlacesSwift:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '10.8.0'
     pod 'GooglePlacesSwift', '10.8.0'
   end

   Regularnie uruchamiaj pod outdated, aby wykrywać nowsze wersje i mieć pewność, że zawsze korzystasz z najnowszej.
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 interfejsów API określonych w pliku Podfile wraz z wszelkimi 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 przypadku istniejącego projektu:

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.

Krok 3. Dodaj klucz interfejsu API do aplikacji

W przykładach poniżej zastąp YOUR_API_KEY swoim kluczem interfejsu API.

GooglePlacesSwift

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

• Dodaj tę instrukcję importu:

  import GooglePlacesSwift

• Dodaj do metody application(_:didFinishLaunchingWithOptions:) poniższy kod, zastępując YOUR_API_KEY swoim kluczem API:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

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

• 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")

Objective-C

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

• 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"];

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

Uwaga: poniższe informacje są istotne, gdy wdrażasz aplikację w sklepie internetowym.

Firma Apple wymaga podawania szczegółowych informacji o ochronie prywatności w przypadku aplikacji w App Store. Aktualne informacje znajdziesz na stronie Apple App Store poświęconej szczegółom dotyczącym prywatności.

Plik manifestu prywatności Apple jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu dotyczący prywatności został dołączony, i przejrzeć jego zawartość, utwórz archiwum aplikacji i wygeneruj z niego raport o prywatności.

Dalsze kroki

• Zacznij pisać kod. Zalecany punkt wyjścia to wdrożenie aplikacji startowej, która pobiera bieżące miejsce użytkownika.
• Po skonfigurowaniu projektu możesz zapoznać się z przykładowymi aplikacjami.
• Używaj Sprawdzania aplikacji, aby zabezpieczyć klucz interfejsu API.