Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta sección, se describe cómo verificar que tu sistema cumpla con los requisitos mínimos, configurar tu grupo de Workspace y obtener el SDK de Driver.
Antes de comenzar
El SDK de Driver para iOS requiere que tu app cumpla con los siguientes criterios:
Tener el SDK de Navigation
Habilita el SDK de Maps para iOS en la consola de Google Cloud y obtén una clave de API.
Verifica los requisitos mínimos del sistema
Consulta las notas de la versión para conocer los requisitos mínimos de la versión del SDK de Driver que usas. Consulta las notas de la versión.
El dispositivo móvil debe ejecutar iOS 14 o una versión posterior.
Si eres cliente de Google Workspace, sigue estos pasos:
Crea un grupo de espacios de trabajo. Para obtener más información, consulta Grupo de Workspace.
Por ejemplo, como práctica recomendada, asigna un nombre a tu grupo google-maps-platform-sdk-users@workspacedomain.com durante la capacitación.
Proporciona el nombre a Google para agregar tu grupo de Workspace a una lista de entidades permitidas que otorga acceso a los repositorios de CocoaPods correctos.
Confirma que los correos electrónicos de los usuarios y las cuentas de servicio que necesitan acceso se incluyan en esta lista.
Si tu organización no puede crear grupos de Workspace, envíale a Google una lista de las direcciones de correo electrónico de los usuarios y las cuentas de servicio que necesitan acceso a estos artefactos.
Accede con el SDK de Cloud
Para el desarrollo local, accede con el SDK de Cloud. Para obtener más información, consulta Instala la CLI de gcloud.
En los siguientes ejemplos, se muestra cómo acceder con el SDK de Cloud.
gcloud
gcloud auth login
Debes usar un correo electrónico que sea miembro del grupo de Workspace.
Configura tus hosts de automatización
Para los sistemas de compilación o la integración continua, configura tus hosts de automatización según la lista proporcionada de métodos para usar una cuenta de servicio y autenticarte en las APIs y los servicios de Google. Para obtener más detalles, consulta la sección de cuentas de servicio en la página Métodos de autenticación en Google.
Si tu proceso se ejecuta dentro de un entorno de Google Cloud, usa la detección automática de credenciales. Para obtener más información, consulta detección automática de credenciales.
De lo contrario, almacena el archivo de claves de la cuenta de servicio en una ubicación segura del sistema de archivos del host y configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS de forma adecuada. Para obtener más detalles, consulta GOOGLE_APPLICATION_CREDENTIALS.
La dirección de correo electrónico de la cuenta de servicio asociada con las credenciales debe ser miembro del grupo de Workspace.
Obtén el SDK de Driver
Instala y configura el SDK de Driver.
CocoaPods
Instala la herramienta CocoaPods: Abre una ventana de terminal y ejecuta el siguiente comando.
Crea un Podfile para el SDK de Driver: Usas el Podfile para instalar la API y sus dependencias.
Crea un archivo llamado Podfile en el directorio de tu proyecto.
Este archivo define las dependencias de tu proyecto.
Edita el Podfile y agrega tus dependencias. A continuación, se muestra un ejemplo que incluye las dependencias:
source"https://github.com/CocoaPods/Specs.git"
target'YOUR_APPLICATION_TARGET_NAME_HERE'dopod'GoogleRidesharingDriver'
end
A continuación, se muestra un ejemplo que incluye los Pods alfa y beta del SDK de Driver como dependencias:
source"https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"source"https://github.com/CocoaPods/Specs.git"
target'YOUR_APPLICATION_TARGET_NAME_HERE'dopod'GoogleRidesharingDriver'
end
Guarda el Podfile: Abre una terminal y ve a la carpeta con el Podfile:
cd<path-to-project>
Ejecuta el comando pod install: Este comando instalará las APIs especificadas en el Podfile, junto con las dependencias que puedan tener.
podinstall
Abre tu proyecto en Xcode: Cierra Xcode y, luego, haz doble clic en el archivo .xcworkspace de tu proyecto para iniciar Xcode. Para abrir el proyecto más adelante, usa el archivo .xcworkspace.
Swift Package Manager
El SDK de Driver 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 Driver.
Para agregar el SDK a un proyecto nuevo o existente, sigue estos pasos:
Abre tu project o workspace de Xcode y, luego, ve a File > Add Package Dependencies.
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 "Versión exacta". Cuando termines, haz clic en “Agregar paquete”.
Para actualizar el package de un proyecto existente, sigue estos pasos:
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 Driver existente instalado manualmente, sigue estos pasos:
En la configuración de tu proyecto de Xcode, busca Frameworks, Libraries, and Embedded Content. Usa el signo menos(-) para quitar el siguiente framework:
GoogleRidesharingDriver.xcframework
Desde el directorio de nivel superior de tu proyecto de Xcode, quita el paquete GoogleRidesharingDriver.
Instalación manual
En esta guía, se muestra cómo agregar manualmente el XCFramework que contiene el SDK de Driver a tu proyecto y configurar los ajustes de compilación en Xcode.
Antes de seguir esta guía, haz lo siguiente:
Descarga el XCFramework, un paquete binario que usas para instalar el SDK de Driver. Puedes usar este paquete en varias plataformas, incluidas las máquinas que usan Apple Silicon.
Descomprime los archivos para acceder al XCFramework y los recursos.
Inicia Xcode y abre un proyecto existente o crea uno. Si no tienes experiencia en iOS, crea un proyecto nuevo y selecciona la plantilla de App para iOS.
Si tu grupo de proyectos no contiene un grupo de Frameworks, créalo.
Para instalar el SDK de Driver, arrastra el archivo GoogleRidesharingDriver.xcframework a tu proyecto en Frameworks, Libraries, and Embedded Content. Si se te solicita, selecciona Copiar elementos.
Arrastra el archivo GoogleRidesharingDriver.bundle descargado al directorio de nivel superior de tu proyecto de Xcode. Si se te solicita, selecciona Copiar elementos.
Selecciona tu proyecto en el navegador de proyectos y elige el destino para la aplicación.
Abre la pestaña Build Phases y, en Link Binary with Libraries, agrega los siguientes frameworks y bibliotecas si aún no están presentes:
Accelerate.framework
AudioToolbox.framework
AVFoundation.framework
CoreData.framework
CoreGraphics.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libxml2.tbd
libz.tbd
LocalAuthentication.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
WebKit.framework
Elige tu proyecto, en lugar de un destino específico, y abre la pestaña Build Settings. En la sección Other Linker Flags, agrega -ObjC para la depuración y el lanzamiento.
Si esta configuración no es visible, cambia el filtro en la barra Build Settings de Basic a All.
Inspecciona el archivo de manifiesto de privacidad de Apple
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.
[null,null,["Última actualización: 2025-08-17 (UTC)"],[[["\u003cp\u003eThe Driver SDK for iOS requires the Navigation SDK and the Maps SDK for iOS enabled in your Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eYou need access to your Google Workspace by creating a Workspace Group or providing a list of user and service account emails for allowlisting.\u003c/p\u003e\n"],["\u003cp\u003eFor local development, sign in with the Cloud SDK using an email that is part of your Workspace Group and set up your automation hosts for build systems or continuous integration.\u003c/p\u003e\n"],["\u003cp\u003eThe Driver SDK can be installed via CocoaPods, Swift Package Manager, or manual installation; for best practices, use Cocopods.\u003c/p\u003e\n"],["\u003cp\u003eBefore submitting your app, inspect the Apple Privacy Manifest file included in the resources bundle to ensure compliance with Apple's App Store requirements.\u003c/p\u003e\n"]]],[],null,["This section describes how to verify your system meets the minimum requirements,\nset up your Workspace Group, and get the Driver SDK.\n\nBefore you begin\n\nThe Driver SDK for iOS requires your app to meet the following criteria:\n\n- Have the Navigation SDK.\n- Enable the Maps SDK for iOS in your Google Cloud console and get an API key.\n\nCheck the minimum system requirements\n\nCheck the release notes for the minimum requirements for the version of the\nDriver SDK you are using. See [Release notes](/maps/documentation/mobility/services/resources/relnotes_driver_sdk_ios).\n\n- The mobile device must be running iOS 14 or later.\n- Apple [Xcode](https://developer.apple.com/xcode/) **version 15** or later.\n\nGet access to your Google Workspace\n\n**If you are a Google Workspace customer,** perform the following steps:\n\n1. Create a Workspace Group. For more information, see [Workspace Group](https://support.google.com/a/answer/33329).\n\n For example, as a best practice, name your group\n `google-maps-platform-sdk-users@workspacedomain.com` during onboarding.\n2. Provide the name to Google to add your Workspace Group to an allowlist that\n grants access to the correct CocoaPods repositories.\n\n3. Confirm that the user emails and service account emails that need access are\n included in this list.\n\n**If your organization cannot create Workspace Groups,** send Google a list\nof user and service account emails that need access to these artifacts.\n| **Note:** Workspace Groups are **not** the same as Google Groups, which end in `@googlegroups.com`. Only Workspace Groups are supported.\n\nSign in with the Cloud SDK\n\nFor local development, sign in with the Cloud SDK. For details, see [Install the gcloud CLI](https://cloud.google.com/sdk/docs/install).\n\nThe following examples show how to sign in with the Cloud SDK. \n\ngcloud \n\n gcloud auth login\n\nYou must use an email that is a member of the Workspace Group.\n\nSet up your automation hosts\n\nFor build systems or continuous integration, set up your automation hosts based\non the provided list of methods for using a service account to authenticate to\nGoogle APIs and services. For details, see the [service account section](https://cloud.google.com/docs/authentication/production#best_practices)\nin the Authentication methods at Google page.\n\n- If your process runs inside a Google Cloud environment, use\n automatic credential detection. For more information, see [automatic credential detection](https://cloud.google.com/docs/authentication/production#automatically).\n\n- Otherwise, store the service account key file in a secure location on the\n host's file-system and set the GOOGLE_APPLICATION_CREDENTIALS\n environment variable appropriately. For more details, see [GOOGLE_APPLICATION_CREDENTIALS](https://cloud.google.com/docs/authentication/production#passing_variable).\n\nThe service account email associated with the credentials must be a member of\nthe Workspace Group.\n\nGet the Driver SDK\n\nInstall and configure the Driver SDK. \n\nCocoaPods\n\n1. **Install the CocoaPods tool**: Open a terminal window and run the following\n command.\n\n sudo gem install cocoapods\n\n For more details, refer to the [CocoaPods Get Started guide](https://guides.cocoapods.org/using/getting-started.html).\n2. **Create a Podfile for the Driver SDK**: You use the Podfile to install\n the API and its dependencies.\n\n 1. Create a file named `Podfile` in your project directory.\n This file defines your project's dependencies.\n\n 2. Edit the Podfile and add your dependencies. Here is an example which\n includes the dependencies:\n\n source \"https://github.com/CocoaPods/Specs.git\"\n\n target 'YOUR_APPLICATION_TARGET_NAME_HERE' do\n pod 'GoogleRidesharingDriver'\n end\n\n Here is an example which includes the Alpha and Beta pods for the\n Driver SDK as dependencies: \n\n source \"https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git\"\n source \"https://github.com/CocoaPods/Specs.git\"\n\n target 'YOUR_APPLICATION_TARGET_NAME_HERE' do\n pod 'GoogleRidesharingDriver'\n end\n\n 3. **Save the Podfile**: Open a terminal and go to the folder with the\n Podfile:\n\n cd \u003cpath-to-project\u003e\n\n3. **Run the pod install command**: This command will install the APIs\n specified in the Podfile, along with any dependencies they may have.\n\n pod install\n\n4. **Open your project in Xcode**: Close Xcode, and then open\n (double-click) your project's .xcworkspace file to launch Xcode. To open\n the project later, use the .xcworkspace file.\n\n | **Note:** Periodically run `pod outdated` to detect when there's a newer version of the SDK. For more information, see [Driver SDK for iOS Versions](/maps/documentation/mobility/driver-sdk/on-demand/ios/versions).\n\nSwift Package Manager\n\n\nThe Driver SDK can be installed via [Swift Package Manager](https://developer.apple.com/documentation/xcode/swift-packages). To add the SDK, ensure you have\nremoved any existing Driver SDK dependencies.\n\n| Important: These instructions assume the use of Xcode 15 or later, but should be similar for previous versions of Xcode.\n\n\u003cbr /\u003e\n\n\nTo add the SDK to a new or existing project, follow these steps:\n\n1. Open your Xcode `project` or `workspace`, then go to **File \\\u003e Add Package Dependencies**.\n2. Enter \u003chttps://github.com/googlemaps/ios-driver-sdk\u003e as the URL, press **Enter** to pull in the package, and click \"Add Package\".\n3. To install a specific `version`, set the **Dependency Rule** field to one of the version-based options. For new projects, we recommend specifying the latest version and using the \"Exact Version\" option. Once complete, click \"Add Package\".\n\nTo update the `package` for an existing project, follow these steps:\n\n1. To verify your installation, go to the **Package Dependencies** section of **Project Navigator** to verify the package and its version.\n\n| **Important:** Sometimes, artifacts cannot be resolved or errors can occur, in this case select \"File \\\u003e Packages \\\u003e Reset Package Cache\".\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nTo remove the existing Driver SDK installed\nmanually, follow these steps:\n\n1. From your Xcode project configuration settings, find **Frameworks,\n Libraries, and Embedded Content** . Use the **minus sign`(-)`** to remove\n the following framework:\n\n - `GoogleRidesharingDriver.xcframework`\n2. From the top level directory of your Xcode project, remove the\n `GoogleRidesharingDriver` bundle.\n\nManual installation\n\nThis guide shows how to manually add the XCFramework containing the\nDriver SDK to your project and configure your build settings in Xcode.\n| **Caution**: As a best practice, use Cocoapods to install the Driver SDK whenever possible.\n\nBefore following this guide, do the following:\n\n- Download the XCFramework, a binary package that you use to install the\n Driver SDK. You can use this package on multiple platforms, including\n machines using [Apple silicon](https://support.apple.com/en-us/HT211814)\n\n- Install the [Navigation SDK](/maps/documentation/navigation/ios-sdk/config#install-the-sdk).\n\nPerform the following steps to manually install the Driver SDK:\n\n1. Download the SDK binary and resources:\n\n - [GoogleRidesharingDriver.xcframework](https://dl.google.com/geosdk/swiftpm/3.2.0/GoogleRidesharingDriver_3p.xcframework.zip)\n - [GoogleRidesharingDriver.bundle](https://dl.google.com/geosdk/swiftpm/3.2.0/GoogleRidesharingDriver.zip)\n\n \u003cbr /\u003e\n\n2. Unpack the zipped files to access the XCFramework and resources.\n\n3. Start Xcode and either open an existing or create a project. If you're\n new to iOS, create a new project and select the iOS App template.\n\n4. If your project group does not contain a Frameworks group, create it.\n\n5. To install the Driver SDK, drag the\n `GoogleRidesharingDriver.xcframework` file into your project under\n **Frameworks, Libraries, and Embedded Content** . If prompted, select\n **Copy items**.\n\n6. Drag the downloaded `GoogleRidesharingDriver.bundle` into the top-level\n directory of your Xcode project. If prompted, select **Copy items**.\n\n7. Select your project from the Project Navigator, and choose your\n application's target.\n\n8. Open the **Build Phases** tab, and in **Link Binary with Libraries**, add the\n following frameworks and libraries if they are not already present:\n\n - `Accelerate.framework`\n - `AudioToolbox.framework`\n - `AVFoundation.framework`\n - `CoreData.framework`\n - `CoreGraphics.framework`\n - `CoreLocation.framework`\n - `CoreTelephony.framework`\n - `CoreText.framework`\n - `GLKit.framework`\n - `ImageIO.framework`\n - `libc++.tbd`\n - `libxml2.tbd`\n - `libz.tbd`\n - `LocalAuthentication.framework`\n - `OpenGLES.framework`\n - `QuartzCore.framework`\n - `SystemConfiguration.framework`\n - `UIKit.framework`\n - `WebKit.framework`\n9. Choose your project, rather than a specific target, and open the **Build\n Settings** tab. In the **Other Linker Flags** section, add `-ObjC` for\n both debug and release.\n\n If these settings are not visible, change the\n filter in the **Build Settings** bar from **Basic** to **All**.\n\nInspect Apple Privacy Manifest File\n\nApple requires app privacy details for apps on the App Store. Visit the [Apple App Store Privacy Details page](/maps/documentation/ios-sdk/apple-privacy-policy) for updates and more information.\n\nThe Apple Privacy Manifest file is included in the resources bundle for the SDK. To verify that the Privacy Manifest File has been included, and to inspect its contents, create an archive of your app and [generate a privacy report](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_data_use_in_privacy_manifests#4239187) from the archive.\n\nWhat's next\n\n[Configure a Google Cloud console project](/maps/documentation/mobility/driver-sdk/on-demand/ios/configure-project)"]]
