Configura un proyecto de Xcode

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

Hay notas de la versión disponibles para cada versión.

Paso 1: Instala el software requerido

Para compilar un proyecto con el SDK de Maps para iOS, descarga e instala lo siguiente:

• Xcode versión 26.0 o posterior

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

Nota: El SDK de Maps para iOS agrega un tamaño promedio de IPA de 5.7 MB para las apps creadas para dispositivos específicos. El tamaño de descarga de las apps universales puede ser mayor.

El tamaño de instalación del SDK varía. Por ejemplo, el tamaño de instalación del SDK de Maps para iOS versión 9.0 es de aproximadamente 18 MB.

Nota: Con la versión 9.2.0, GoogleMapsCore y GoogleMapsBase se consolidan en el XCFramework de GoogleMaps. No se requiere ninguna configuración adicional.

Actualmente, el SDK de Maps para iOS no admite bibliotecas combinables. Para evitar fallas del vinculador durante las compilaciones de lanzamiento, asegúrate de que el parámetro de configuración Build Mergeable Library de tu proyecto de Xcode esté establecido en No (el valor predeterminado).

Swift Package Manager

El SDK de Maps 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 Maps 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-maps-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". Una vez que completes el proceso, haz clic en "Add Package".
4. En la ventana Choose Package Products, verifica que GoogleMaps (para versiones anteriores a la 9.0.0, verifica que GoogleMaps, GoogleMapsBase, y GoogleMapsCore) se agregará a tu destino main designado. Una vez que completes el proceso, haz clic en "Add Package".
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. Si realizas una actualización desde una versión anterior a la 9.0.0, debes quitar las siguientes dependencias: GoogleMapsBase, GoogleMapsCore y GoogleMapsM4B después de la actualización. No quites la dependencia de GoogleMaps. Para obtener más información, consulta las Notas de la versión 9.0.0.

   En la configuración de tu proyecto de Xcode, busca Frameworks, Libraries, and Embedded Content. Usa el signo menos(-) para quitar el siguiente framework:

   • GoogleMapsBase (solo para actualizaciones de versiones anteriores a la 9.0.0)
   • GoogleMapsCore (solo para actualizaciones de versiones anteriores a la 9.0.0)
   • GoogleMapsM4B (solo para actualizaciones de versiones anteriores a la 9.0.0)
2. En Xcode, ve a File > Packages > Update To Latest Package Versions.
3. Para verificar tu instalación, ve a la sección Package Dependencies de Project Navigator para verificar el paquete y su versión.

Importante: A veces, no se pueden resolver los artefactos o pueden ocurrir errores, en este caso selecciona "File > Packages > Reset Package Cache".

Para quitar las dependencias existentes del SDK de Maps para iOS agregadas con CocoaPods, sigue estos pasos:

1. Cierra tu espacio de trabajo de Xcode. Abre la terminal y ejecuta el siguiente comando:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. Quita el Podfile, el Podfile.resolved y el Xcode workspace si no los usas para nada más que CocoaPods.

Para quitar el SDK de Maps 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 el siguiente framework:
   • GoogleMaps
   • GoogleMapsBase (solo para instalaciones anteriores a la versión 9.2.0)
   • GoogleMapsCore (solo para instalaciones anteriores a la versión 9.2.0)
   • GoogleMapsM4B (solo para instalaciones anteriores a la versión 9.0.0)
2. En el directorio de nivel superior de tu proyecto de Xcode, quita el GoogleMaps paquete.

Instalación manual

En esta guía, se describe cómo agregar manualmente los XCFrameworks que contienen el SDK de Maps para iOS a tu proyecto y configurar los ajustes de compilación en Xcode. Un XCFramework es un paquete binario que usas en varias plataformas, incluidas las máquinas que usan Apple Silicon.

1. Descarga los siguientes archivos binarios y de recursos del SDK:
   • GoogleMaps
   • GoogleMapsResources
2. Extrae los archivos para acceder a los XCFrameworks y los recursos.
3. Si aún no tienes un proyecto de Xcode, créalo y guárdalo en tu máquina local. Si eres nuevo en el desarrollo para iOS, haz lo siguiente:
   1. Crea un proyecto nuevo
   2. Selecciona la plantilla iOS > App.
   3. En la pantalla de opciones del proyecto, haz lo siguiente:
      1. Ingresa el nombre del proyecto.
      2. Registra el valor del campo identificador de paquete. Puedes usar ese valor para restringir tu clave de API a continuación.
      3. Establece la interfaz del proyecto en Storyboard.
      4. Establece el lenguaje en Swift o Objective-C.
4. Abre la pestaña General. Arrastra los siguientes XCFrameworks a tu proyecto en Frameworks, Libraries, and Embedded Content. Asegúrate de seleccionar Do Not Embed:
   • GoogleMaps.xcframework
5. Copia el GoogleMaps.bundle de GoogleMapsResources 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.
6. Selecciona tu proyecto en el navegador de proyectos y elige el destino para la aplicación.
7. Abre la pestaña Build Phases para el destino de tu aplicación. En Link Binary with Libraries, agrega los siguientes frameworks y bibliotecas:
   • 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
   • MetricKit.framework
   • OpenGLES.framework (solo si usas OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. 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 esta configuración no es visible, cambia el filtro en la Build Settings barra de Basic a All.

9. Para instalar el XCFramework del SDK de Places para iOS, consulta Cómo comenzar a utilizar el SDK de Places para iOS.

Paso 3: Agrega tu clave de API al proyecto

En Obtén una clave de API, generaste una clave de API para tu app. Ahora, agrega esa clave a tu proyecto de Xcode.

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

Nota: Si registraste el identificador de paquete de tu proyecto o lo obtuviste de las propiedades del proyecto, úsalo para restringir tu clave de API para que solo se use con aplicaciones para iOS con ese identificador de paquete específico. Consulta Cómo restringir las claves de API para obtener más información.

Swift

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

1. Agrega la siguiente instrucción de importación:

   import GoogleMaps

2. Agrega lo siguiente a tu application(_:didFinishLaunchingWithOptions:) método con tu clave de API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Si también usas la API de Places, vuelve a agregar tu clave como se muestra a continuación:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

1. Agrega la siguiente instrucción de importación:

   @import GoogleMaps;

2. Agrega lo siguiente a tu application:didFinishLaunchingWithOptions: método con tu clave de API:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Si también usas la API de Places, vuelve a agregar tu clave como se muestra a continuación:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

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

Nota: Lo siguiente es pertinente cuando implementas tu app en la tienda web.

Apple requiere detalles de privacidad de la app para las apps en App Store. Visita la página de 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.

Paso 5 (opcional): Declara los esquemas de URL que usa la API

A partir de iOS 9 y Xcode 7, las apps declaran los esquemas de URL que pretenden abrir especificando los esquemas en el archivo Info.plist de la app. El SDK de Maps para iOS abre la app para dispositivos móviles de Google Maps cuando el usuario hace clic en el logotipo de Google en el mapa, por lo que tu app puede declarar los esquemas de URL pertinentes.

Para declarar los esquemas de URL que usa el SDK de Maps para iOS, agrega las siguientes líneas a tu Info.plist:

 <key>LSApplicationQueriesSchemes</key>
 <array>
        <string>googlechromes</string>
        <string>comgooglemaps</string>
    </array>

En la siguiente imagen, se muestra la configuración en la interfaz de usuario de Xcode:

Sin la declaración anterior, pueden ocurrir los siguientes errores cuando el usuario presiona el logotipo de Google en el mapa:

• -canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
• -canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

Para eliminar estos errores, agrega la declaración a tu Info.plist.

¿Qué sigue?

Ahora que tienes una clave de API y un proyecto de Xcode, crea y ejecuta apps. El SDK de Navigation para iOS proporciona muchos instructivos y apps de ejemplo que te ayudan a comenzar. Para obtener más información, consulta los siguientes recursos:

• Agrega un mapa con un marcador.
• Selecciona el lugar actual y muestra los detalles en un mapa.
• Geocodificación inversa.
• Consulta las muestras de código y los codelabs disponibles.
• Para obtener soluciones de extremo a extremo, revisa las soluciones de Maps disponibles.