Configura un proyecto de Xcode

Una vez que habilites la facturación y crees una clave de API, podrás configurar el proyecto de Xcode que usarás para desarrollar tu app.

Las notas de la versión están disponibles para cada versión.

Paso 1: Instala el software requerido

Para compilar un proyecto con el SDK de Places para iOS, necesitas lo siguiente:

  • Xcode versión 26.0 o una posterior

Paso 2: Crea el proyecto de Xcode y, luego, instala el SDK de Places para iOS

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:
  2. Si instalas el SDK de Places Swift para iOS, instala los siguientes archivos:
  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.

Paso 3: Agrega la clave de API a tu app

En los siguientes ejemplos, reemplaza YOUR_API_KEY por tu clave de API.

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

Paso 4 (opcional): Inspecciona el archivo de manifiesto de privacidad de Apple

Apple requiere detalles de privacidad de la app para las apps en App Store. Visita la página Detalles de privacidad de App Store de Apple para obtener actualizaciones y más información.

El archivo de manifiesto de privacidad de Apple se incluye en el paquete de recursos del SDK. Para verificar que se haya incluido el archivo de manifiesto de privacidad y para inspeccionar su contenido, crea un archivo de tu app y genera un informe de privacidad a partir del archivo.

Próximos pasos