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 posterior

Paso 2: Crea el proyecto de Xcode e 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, configura el campo Regla de dependencia 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 "Agregar paquete".
  4. En la ventana Choose Package Products, verifica que se agreguen GooglePlaces, GooglePlacesSwift o ambos al destino principal designado. Cuando termines, haz clic en Agregar paquete.

    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 la 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 la instalación, ve a la sección Package Dependencies de Project Navigator y verifica el paquete y su versión.

Para quitar el SDK de Places para iOS existente que se instaló de forma manual, sigue estos pasos:

  1. En los ajustes de 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 paquete GooglePlaces.

Instalación manual

En esta guía, se muestra cómo agregar manualmente los XCFrameworks que contienen el SDK de Places para iOS y el SDK de Places para Swift para iOS a tu proyecto y establecer la configuración 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 de recursos y objetos binarios del SDK:
  2. Si vas a instalar el SDK de Places para iOS con Swift, 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. Si eres principiante 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 para 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 archivo GooglePlaces.bundle de GooglePlacesResources que descargaste en el directorio de nivel superior de tu proyecto de Xcode. Asegúrate de seleccionar Copiar elementos en la carpeta del grupo de destino cuando se te solicite.

    Si estás instalando el SDK de Places para 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 Copiar elementos en la carpeta del grupo de destino cuando se te solicite.
  8. Selecciona tu proyecto en el navegador de proyectos y elige el destino de tu 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 pestaña Build Settings. En la sección Linking - General -> Other Linker Flags, agrega -ObjC a "Debug" y "Release". Si no puedes ver estos parámetros de configuración, cambia el filtro de 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.

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

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:), reemplazando 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:) y 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:, reemplazando 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 exige que se proporcionen detalles de privacidad de las apps en la App Store. Visita la página de detalles de privacidad de la 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 de él.

Próximos pasos