Po włączeniu płatności i utworzeniu klucza interfejsu API możesz skonfigurować projekt Xcode, którego używasz do tworzenia aplikacji.
W przypadku każdej wersji dostępne są informacje o wersji.
Krok 1. Zainstaluj wymagane oprogramowanie
Aby utworzyć projekt za pomocą pakietu Maps SDK na iOS, musisz pobrać i zainstalować:
- Xcode w wersji 14.0 lub nowszej.
Krok 2. Utwórz projekt Xcode i zainstaluj pakiet Maps SDK na iOS
Menedżer pakietów Swift
Pakiet SDK Map Google na iOS można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie istniejące zależności pakietu Maps SDK na iOS.
Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:
-
Otwórz plik Xcode
project
lubworkspace
i kliknij Plik > Dodaj zależności pakietów. - Wpisz adres URL https://github.com/googlemaps/ios-maps-sdk, naciśnij Enter, by pobrać pakiet, a następnie kliknij „Dodaj pakiet”.
-
Aby zainstalować określony
version
, w polu Reguła zależności ustaw 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”. -
W oknie Wybierz produkty w pakiecie sprawdź, czy
GoogleMaps
,GoogleMapsBase
iGoogleMapsCore
zostaną dodane do wyznaczonego miejsca docelowegomain
. Gdy skończysz, kliknij „Dodaj pakiet”. -
Aby sprawdzić instalację, przejdź do panelu
General
środowiska docelowego. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Biblioteki i Umieszczone treści. Możesz też wyświetlić sekcję „Zależności pakietów” w aplikacji „Project Navigator”, aby sprawdzić pakiet i jego wersję.
Aby zaktualizować package
w istniejącym projekcie, wykonaj te czynności:
- W Xcode wybierz kolejno „File” (Plik) > Packages (Pakiety) > Update To Last Package Versions (Aktualizuj do najnowszych wersji pakietów).
- Aby sprawdzić instalację, przejdź do sekcji Zależności pakietów w Project Navigator i sprawdź pakiet i jego wersję.
Aby usunąć zależności pakietu Maps SDK na iOS dodane za pomocą CocoaPods
, wykonaj te czynności:
- Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj to polecenie:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Usuń
Podfile
,Podfile.resolved
i Xcodeworkspace
, jeśli nie używasz ich do niczego innego niż CocoaPods.
-
W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, and Embedded Content. Za pomocą znaku minusa(-) usuń tę platformę:
GoogleMaps.xcframework
GoogleMapsBase.xcframework
GoogleMapsCore.xcframework
-
Z katalogu najwyższego poziomu projektu Xcode usuń pakiet
GoogleMaps
.
CocoaPods
Pakiet SDK Map Google na iOS jest dostępny jako pod CocoaPods. CocoaPods to menedżer zależności typu open source dla projektów Swift i Objective-C Cocoa.
Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w macOS, uruchamiając z terminala to polecenie. Szczegółowe informacje znajdziesz we wprowadzeniu do CocoaPods.
sudo gem install cocoapods
Utwórz obiekt Podfile
dla pakietu SDK Map Google na iOS i użyj go do zainstalowania interfejsu API i jego zależności:
- Jeśli nie masz jeszcze projektu Xcode, utwórz go teraz i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS:
- Utwórz nowy projekt.
- Wybierz szablon iOS > Aplikacja.
- Na ekranie opcji projektu:
- Wypełnij pole Nazwa projektu.
- Zapisz wartość w polu Identyfikator pakietu. Możesz użyć tej wartości, aby ograniczyć swój klucz interfejsu API poniżej.
- Ustaw Interfejs projektu na Scenorys.
- Jako Language ustaw Swift lub Objective-C.
- W katalogu projektu utwórz plik o nazwie
Podfile
. Ten plik określa zależności Twojego projektu. - Edytuj
Podfile
i dodaj zależności wraz z ich versions. Oto przykład, który przedstawia zależność wymaganą w pakiecie 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', '8.4.0' end
Pamiętaj, aby regularnie uruchamiaćpod outdated
, aby wykrywać, kiedy dostępna jest nowsza wersja. Dzięki temu będziesz zawsze mieć najnowszą wersję. W razie potrzeby uaktualnij aplikację do najnowszej wersji. - 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
oraz wszelkich zależności, jakie mogą one mieć.pod install
Zamknij Xcode, a następnie otwórz (dwukrotnie) plik
.xcworkspace
swojego projektu, aby uruchomić Xcode. Od tej pory projekt będzie można otwierać tylko za pomocą pliku.xcworkspace
.
Aby zaktualizować interfejs API w istniejącym projekcie, wykonaj te czynności:
- Otwórz terminal i przejdź do katalogu projektu, w którym znajduje się
Podfile
. - Uruchom polecenie
pod update
. Spowoduje to zaktualizowanie do najnowszej wersji wszystkich interfejsów API określonych w:Podfile
.
Instalacja ręczna
Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu XCFrameworks zawierające pakiet Maps SDK 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 korzystających z Apple Silicon.- Pobierz te pliki binarne i pliki zasobów pakietu SDK:
- Rozpakuj skompresowane pliki, aby uzyskać dostęp do XCFrameworks i zasobów.
- Jeśli nie masz jeszcze projektu Xcode, utwórz go teraz i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS:
- Utwórz nowy projekt.
- Wybierz szablon iOS > Aplikacja.
- Na ekranie opcji projektu:
- Wypełnij pole Nazwa projektu.
- Zapisz wartość w polu Identyfikator pakietu. Możesz użyć tej wartości, aby ograniczyć swój klucz interfejsu API poniżej.
- Ustaw Interfejs projektu na Scenorys.
- Jako Language ustaw Swift lub Objective-C.
-
Otwórz kartę Ogólne. Przeciągnij ten element XCFrameworks do swojego projektu w sekcji Frameworks, Biblioteki i Umieszczone treści. Pamiętaj, aby w przypadku każdego elementu XCFramework wybrać Nie umieszczaj:
GoogleMaps.xcframework
GoogleMapsBase.xcframework
GoogleMapsCore.xcframework
-
Skopiuj pobrany plik
GoogleMaps.bundle
z pliku GoogleMapsResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się prośba, wybierz Skopiuj elementy do folderu grupy docelowej. - Wybierz projekt z Nawigatora projektów i wybierz miejsce docelowe aplikacji.
-
Otwórz kartę Etapy kompilacji dla środowiska docelowego aplikacji.
W sekcji Połącz pliki binarne z bibliotekami dodaj te platformy 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
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
-
Wybierz projekt, a nie konkretny cel, i otwórz kartę Ustawienia kompilacji. W sekcji Łączenie - Ogólne -> Inne flagi łączące dodaj
-ObjC
w polach „Debuguj” i „Opublikuj”. Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie. -
Aby dowiedzieć się, jak zainstalować pakiet Places SDK na iOS XCFramework, przeczytaj, jak zacząć korzystać z pakietu Places SDK na iOS.
Krok 3. Dodaj do projektu klucz interfejsu API
W sekcji Uzyskiwanie klucza interfejsu API udało Ci się wygenerować klucz interfejsu API dla swojej aplikacji. Teraz dodaj ten klucz do projektu Xcode.
W poniższych przykładach zastąp YOUR_API_KEY
swoim kluczem interfejsu API.
for more information.
Swift
Dodaj klucz interfejsu API do urządzenia AppDelegate.swift
, wykonując te czynności:
- Dodaj tę instrukcję importu:
import GoogleMaps
- Za pomocą klucza interfejsu API dodaj ten kod do metody
application(_:didFinishLaunchingWithOptions:)
:GMSServices.provideAPIKey("YOUR_API_KEY")
- Jeśli używasz też interfejsu Places API, ponownie dodaj klucz w podany niżej sposób:
GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
Objective-C
Dodaj klucz interfejsu API do urządzenia AppDelegate.m
, wykonując te czynności:
- Dodaj tę instrukcję importu:
@import GoogleMaps;
- Za pomocą klucza interfejsu API dodaj ten kod do metody
application:didFinishLaunchingWithOptions:
:[GMSServices provideAPIKey:@"YOUR_API_KEY"];
- Jeśli używasz też interfejsu Places API, ponownie dodaj klucz w podany niżej sposób:
[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
Krok 4. Dodaj mapę
Swift
/* * Copyright 2020 Google Inc. All rights reserved. * * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this * file except in compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF * ANY KIND, either express or implied. See the License for the specific language governing * permissions and limitations under the License. */ 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
/* * Copyright 2020 Google Inc. All rights reserved. * * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this * file except in compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF * ANY KIND, either express or implied. See the License for the specific language governing * permissions and limitations under the License. */ #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
Krok 5 (opcjonalny). Zadeklaruj schematy adresów URL używane przez interfejs API
Począwszy od iOS 9 i Xcode 7 aplikacje mogą deklarować schematy adresów URL, które powinny być otwierane, określając schematy w pliku Info.plist
aplikacji. Pakiet SDK Map Google na iOS otwiera aplikację mobilną Mapy Google, gdy użytkownik kliknie logo Google na mapie, dzięki czemu aplikacja może zadeklarować odpowiednie schematy adresów URL.
Aby zadeklarować schematy adresów URL używane przez pakiet SDK Map Google na iOS, dodaj do Info.plist
te wiersze:
Poniższy zrzut ekranu przedstawia konfigurację w interfejsie użytkownika Xcode:
Jeśli nie prześlesz powyższej deklaracji, po kliknięciu logo Google na mapie mogą wystąpić te błędy:
-canOpenURL: niepowodzenie w przypadku adresu URL: "comgooglemaps://" - błąd: "Ta aplikacja nie ma uprawnień do wysyłania zapytań dotyczących schematu comgooglemaps" -canOpenURL: niepowodzenie w przypadku adresu URL: "googlechromes://" - błąd: "Ta aplikacja nie ma uprawnień do wysyłania zapytań dotyczących schematu googlechromes"
Aby wyeliminować te błędy, dodaj deklarację do Info.plist
.
Co dalej
Masz już klucz interfejsu API i projekt Xcode, możesz więc tworzyć i uruchamiać aplikacje. Pakiet Navigation SDK dla iOS zawiera wiele samouczków i przykładowych aplikacji, które pomogą Ci zacząć. Więcej informacji: