Configura un proyecto de Xcode

Swift Package Manager

El SDK de Places para iOS se puede instalar a través de Swift Package Manager. Para agregar el SDK, asegúrate de haber quitado las dependencias existentes del SDK de Places para iOS.

Para agregar el SDK a un proyecto nuevo o existente, sigue estos pasos:

1. Abre tu project o workspace de Xcode y, luego, ve a File > Add Package Dependencies.
2. Ingresa https://github.com/googlemaps/ios-places-sdk como la URL, presiona Intro para extraer el paquete y haz clic en "Add Package".
3. Para instalar un version específico, establece el campo Dependency Rule en una de las opciones basadas en la versión. Para los proyectos nuevos, te recomendamos que especifiques la versión más reciente y uses la opción "Exact Version". Cuando termines, haz clic en "Add Package".
4. En la ventana Choose Package Products , verifica que GooglePlaces, GooglePlacesSwift o ambos se agreguen a tu destino principal designado. Cuando termines, haz clic en Add Package.

   Si actualizas Google Places Swift desde la URL de GitHub obsoleta

   Importante: La URL de GitHub para acceder a Google Places Swift cambió a partir de la versión 0.3.0. Si actualizas una versión de GooglePlacesSwift a la que se accedió a través de la URL anterior, https://github.com/googlemaps/ios-places-swift-sdk, quítala de la sección de dependencias de paquetes de Xcode.

5. Para verificar tu instalación, navega al panel General de tu destino. En Frameworks, Libraries, and Embedded Content, deberías ver los paquetes instalados. También puedes ver la sección Package Dependencies de Project Navigator para verificar el paquete y su versión.

Para actualizar el package de un proyecto existente, sigue estos pasos:

1. En Xcode, ve a File > Packages > Update To Latest Package Versions.

   Si actualizas Google Places Swift desde la URL de GitHub obsoleta

   Importante: La URL de GitHub para acceder a Google Places Swift cambió a partir de la versión 0.3.0. Si actualizas una versión de GooglePlacesSwift a la que se accedió a través de la URL anterior, https://github.com/googlemaps/ios-places-swift-sdk, quítala de la sección de dependencias de paquetes de Xcode.

2. Para verificar tu instalación, ve a la sección Package Dependencies de Project Navigator para verificar el paquete y su versión.

Para quitar el SDK de Places para iOS existente instalado de forma manual, sigue estos pasos:

1. En la configuración de tu proyecto de Xcode, busca Frameworks, Libraries, and Embedded Content. Usa el signo menos(-) para quitar los siguientes frameworks:
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. En el directorio de nivel superior de tu proyecto de Xcode, quita el GooglePlaces paquete.

Instalación manual

En esta guía, se muestra la manera de agregar manualmente los XCFrameworks que contienen el SDK de Places para iOS y el SDK de Places Swift para iOS a tu proyecto y configurar los ajustes de compilación en Xcode. Un XCFramework es un paquete binario que puedes usar en varias plataformas, incluidas las máquinas que usan Apple Silicon. Puedes agregar el SDK de Places para iOS, el SDK de Places Swift para iOS o ambos.

1. Descarga los siguientes archivos binarios y de recursos del SDK:
   • GooglePlaces
   • GooglePlacesResources
2. Si instalas el SDK de Places Swift para iOS, instala los siguientes archivos:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. Extrae los archivos para acceder al XCFramework y a los recursos.
4. Ejecuta Xcode y abre un proyecto existente o crea uno nuevo proyecto. Si eres nuevo en el desarrollo para iOS, crea un proyecto nuevo y selecciona la plantilla de App para iOS.
5. Quita cualquier paquete de Maps de las versiones anteriores de tu proyecto.
6. Abre la pestaña General. Arrastra el siguiente XCFramework a tu proyecto en Frameworks, Libraries, and Embedded Content. Asegúrate de seleccionar Do Not Embed:
   • GooglePlaces.xcframework
   Si instalas el SDK de Places Swift, arrastra el siguiente XCFramework a tu proyecto en Frameworks, Libraries, and Embedded Content. Asegúrate de seleccionar Do Not Embed:
   • GooglePlacesSwift.xcframework
7. Copia el GooglePlaces.bundle de GooglePlacesResources que descargaste en el directorio de nivel superior de tu proyecto de Xcode. Asegúrate de seleccionar Copy items into destination group's folder cuando se te solicite.
   
   Si instalas el SDK de Places Swift, copia el archivo GooglePlacesSwift.bundle de GooglePlacesSwiftResources que descargaste en el directorio de nivel superior de tu proyecto de Xcode. Asegúrate de seleccionar Copy items into destination group's folder cuando se te solicite.
8. Selecciona tu proyecto en el navegador de proyectos y elige el destino para la aplicación.
9. Abre la pestaña Build Phases. En Link Binary with Libraries, agrega los siguientes frameworks y bibliotecas:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. Elige tu proyecto, en lugar de un destino específico, y abre la Build Settings pestaña. En la sección Linking - General -> Other Linker Flags, agrega -ObjC a "Debug" y "Release". Si esta configuración no es visible, cambia el filtro en la barra Build Settings de Basic a All.

GooglePlacesSwift

Agrega tu clave de API a AppDelegate.swift de la siguiente manera:

• Agrega la siguiente instrucción de importación:

  import GooglePlacesSwift

• Agrega lo siguiente a tu método application(_:didFinishLaunchingWithOptions:) . Para ello, reemplaza YOUR_API_KEY por tu clave de API:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

Agrega tu clave de API a AppDelegate.swift de la siguiente manera:

• Agrega la siguiente instrucción de importación:

  import GooglePlaces

• Agrega lo siguiente a tu método application(_:didFinishLaunchingWithOptions:) . Para ello, reemplaza YOUR_API_KEY por tu clave de API:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Agrega tu clave de API a AppDelegate.m de la siguiente manera:

• Agrega la siguiente instrucción de importación:

  @import GooglePlaces;

• Agrega lo siguiente a tu método application:didFinishLaunchingWithOptions: . Para ello, reemplaza YOUR_API_KEY por tu clave de API:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];