Esta página se ha traducido con Cloud Translation API.
Switch to English

Instrumenta apps para iOS

Esta página explica cómo habilitar y personalizar la API de reCAPTCHA Enterprise en tu app para iOS. Para obtener más información sobre reCAPTCHA Enterprise, consulta la descripción general de reCAPTCHA Enterprise.

Antes de comenzar

  • Completa los pasos de la Guía de inicio rápido para obtener acceso a la API.
  • Pídele a tu representante de ventas que te otorgue acceso al repositorio CocoaPods de reCAPTCHA Enterprise y a la página de descarga.

Prepara tu entorno de desarrollo

Descarga el SDK a través de CocoaPods

  1. Genera una cookie git mediante estas instrucciones.
  2. Agrega las siguientes líneas a tu Podfile:

    source "https://cpdc-eap.googlesource.com/RecaptchaEnterprise.git"
    source "https://github.com/CocoaPods/Specs.git"
    
    pod "RecaptchaEnterprise", "16.0.3"
    
  3. Ejecuta pod update. De esta manera, se instalarán todas las dependencias requeridas.

Descarga el SDK sin CocoaPods

Si no usas CocoaPods, puedes obtener el objeto binario del SDK directamente en la página descarga.

Configura tu app

  • Antes de comenzar la integración, debes crear una clave de reCAPTCHA para iOS.

  • Si tu app está escrita en Swift, crea un encabezado de puente de Objective-C y agrega la siguiente importación:

    #import <recaptcha/recaptcha.h>
    
  • Asegúrate de que -ObjC esté en la lista de tus marcas de vinculadores:

Configuración Nombre del parámetro de configuración Valor
Objetivo > Configuración de compilación > Todos > Vinculación Otras marcas de vinculadores -ObjC

Integraciones de la app

Crea una app de muestra

  1. En Xcode, crea una aplicación nueva de vista única para iOS en blanco.
  2. Instrumenta tu proyecto de muestra para integrarlo en CocoaPods y, luego, en reCAPTCHA Enterprise.

Crea la aplicación

Paso #1: Actualiza ViewController.swift
  • Crea una instancia del SDK mediante:

       let recaptchaClient = RecaptchaClient(siteKey: "SomeSiteKey")
    

    Asegúrate de reemplazar SomeSiteKey por la Clave que creaste anteriormente.

  • Crea un método que llame a execute y recupere un token de reCAPTCHA:

    recaptchaClient.execute(RecaptchaAction(action: .login)).then { token in
      print("got token: \(token.recaptchaToken)")
    }.catch { error in
      print("got error: \(error)")
    }
    
Paso #2: Crea un botón para llamar a reCAPTCHA

Para activar el código que acabas de incorporar en ViewController.swift, haz lo siguiente:

  1. En el storyboard crea un botón.
  2. Vincula la acción del botón con el método de ejecución que se creó en el paso anterior.
Paso #3: Prueba

Para probar tu aplicación, haz lo siguiente:

  1. Limpia el entorno de compilación de Xcode. En el menú Producto, haz clic en Limpiar la carpeta de compilación.
  2. Para ejecutar la aplicación, en el menú Producto, haz clic en Ejecutar.
  3. En la aplicación cargada, haz clic en el botón reCAPTCHA que creaste antes.
  4. Observa tu ventana de salida de depuración, debe mostrar un token reCAPTCHA (string alfanumérica) si la integración se realizó correctamente.
Crea una evaluación

A fin de validar el token de respuesta de reCAPTCHA, sigue las instrucciones para crear una evaluación.

Referencia de API de iOS

Consulta la página referencia de la API.