8 min de lectura

StoreKit Testing en Xcode: prueba compras in-app con el archivo .storekit

Guía ES-CO de StoreKit Testing en Xcode: crea un StoreKit configuration file local o sincronizado, actívalo en el esquema, usa el administrador de transacciones para reembolsos, Ask to Buy y renovaciones, y aplícalo a tu app Flutter sin cuenta sandbox.

Portada: Prueba StoreKit en Xcode, compras in-app sin App Store Connect, con tarjeta StoreKit Testing que muestra Products.storekit, compra local OK, Ask to Buy aprobada y reembolso simulado

Ya escribiste el código de tus compras dentro de la app, pero todavía no tienes los productos aprobados en App Store Connect, o te cansaste de iniciar sesión con la cuenta sandbox cada vez que quieres repetir una prueba. Para eso existe StoreKit Testing en Xcode: un entorno de pruebas local donde defines tus productos en un archivo de configuración y compras, reembolsas o renuevas suscripciones sin conectarte a los servidores del App Store. En esta guía verás cómo crear el archivo .storekit, cómo activarlo en el esquema, cómo usar el administrador de transacciones y cómo aplicarlo también a una app hecha en Flutter.

Qué es StoreKit Testing en Xcode

Según la documentación de Apple, StoreKit Testing en Xcode es un entorno de prueba local para compras in-app que no necesita conexión con los servidores del App Store. Cuando el archivo de configuración está activo, tu app recibe los productos, precios y transacciones desde ese archivo en lugar de App Store Connect o del sandbox.

Sirve para:

  • Probar sin conexión a internet y antes de crear los productos en App Store Connect.
  • Repetir una compra de un producto no consumible tantas veces como quieras.
  • Forzar errores de StoreKit, compras interrumpidas o Ask to Buy para revisar cómo responde tu interfaz.
  • Acelerar las renovaciones de una suscripción para ver en minutos lo que en la vida real tarda semanas.
  • Automatizar pruebas con el framework StoreKitTest.

Funciona en el simulador y en dispositivos reales. En iPhone con iOS 16 o superior necesitas activar el Modo de desarrollador.

StoreKit Testing o sandbox: cuál usar

Apple recomienda StoreKit Testing para las primeras etapas, la integración continua y la depuración, y el sandbox cuando ya tienes los productos en App Store Connect. La diferencia clave: en StoreKit Testing las transacciones las firma Xcode, no el App Store, así que no sirven para validar contra tu servidor ni para recibir App Store Server Notifications. Para eso necesitas un sandbox tester en App Store Connect y, después, TestFlight.

El orden práctico es: StoreKit Testing mientras construyes, sandbox para probar de punta a punta y TestFlight antes de enviar a revisión.

Cómo configurar StoreKit Testing paso a paso

Paso 1: crea el archivo de configuración de StoreKit

  1. En Xcode, ve a File > New > File from Template.
  2. Escribe storekit en el filtro y elige StoreKit Configuration File.
  3. Ponle un nombre, por ejemplo Products. Si renombras el archivo, conserva la extensión .storekit.
  4. Decide si será local o sincronizado (ver abajo) y guárdalo en el proyecto. No hace falta añadirlo a ningún target.

Local o sincronizado con App Store Connect

Desde Xcode 14 hay dos tipos de archivo:

  • Local: lo llenas a mano en Xcode. Úsalo si aún no configuraste la app en App Store Connect o quieres probar un tipo de producto nuevo antes de crearlo allá. Nada de lo que escribas se sube a App Store Connect.
  • Sincronizado: marca la casilla Sync this file with an app in App Store Connect y elige tu equipo y tu app. Xcode trae los productos que ya creaste. No se edita en Xcode; para traer cambios usa el botón Sync en la esquina inferior izquierda.

Si necesitas modificar un archivo sincronizado, usa Editor > Convert to Local StoreKit Configuration. La conversión es de una sola vía: para volver a sincronizar debes crear un archivo sincronizado nuevo.

Paso 2: agrega tus productos

En un archivo local, haz clic en el botón + de la esquina inferior izquierda y elige el tipo: consumible, no consumible, suscripción con renovación automática o suscripción sin renovación. Para cada producto define:

  • Reference Name: nombre interno.
  • Product ID: debe coincidir exactamente con el ID que pide tu código. Es el error más común; cópialo y pégalo.
  • Precio y, si quieres, localizaciones con nombre y descripción.

Para suscripciones, primero creas el grupo de suscripción y dentro sus niveles (mensual, anual), con ofertas introductorias si las vas a usar. Usa los mismos IDs que tendrás en App Store Connect para no tocar código al pasar al sandbox.

Paso 3: activa el archivo en el esquema

Por defecto StoreKit Testing está desactivado. Para activarlo:

  1. Haz clic en el esquema y elige Edit Scheme.
  2. Selecciona la acción Run y la pestaña Options.
  3. En StoreKit Configuration, elige tu archivo .storekit y cierra.

Un proyecto puede tener varios archivos, pero solo uno activo a la vez. Para volver al sandbox, pon esa opción en None. Truco: duplica el esquema (por ejemplo "MiApp StoreKit") y deja el archivo solo en esa copia; cambias de entorno eligiendo el esquema.

Paso 4: ejecuta y compra

Compila y corre la app. Verás la hoja de pago con los valores de tu archivo, sin cuenta de Apple ni cobro. Si la lista de productos llega vacía, revisa que el esquema activo sea el que tiene el archivo y que los Product ID coincidan.

Usa el administrador de transacciones

Con la app corriendo, abre Debug > StoreKit > Manage Transactions. Ahí ves todas las transacciones del entorno de prueba y puedes:

  • Eliminar una transacción para repetir la compra de un no consumible o volver a probar una oferta introductoria.
  • Reembolsar una compra para comprobar que tu app quita el acceso.
  • Aprobar o rechazar una compra pendiente de Ask to Buy.
  • Resolver una compra interrumpida.
  • Crear una transacción, como si el usuario hubiera comprado en otro dispositivo.
  • Pedir consentimiento de un aumento de precio en una suscripción.

Ajustes del menú Editor

Con el archivo .storekit seleccionado, el menú Editor permite cambiar la tienda y el idioma por defecto, la velocidad de renovación de las suscripciones, activar compras interrumpidas, Ask to Buy, reintento de cobro y período de gracia, desactivar los diálogos para correr pruebas más rápido y simular fallos de StoreKit para revisar tus mensajes de error.

StoreKit Testing en una app Flutter

El plugin in_app_purchase usa StoreKit por debajo (StoreKit 2 por defecto en iOS y macOS), así que el mismo archivo te sirve:

  1. Abre ios/Runner.xcworkspace en Xcode.
  2. Crea el archivo .storekit como en el paso 1 con los mismos IDs que usas en Dart.
  3. En Edit Scheme > Run > Options del esquema Runner, selecciona el archivo.
  4. Ejecuta la app desde Xcode, ya que la opción pertenece a la acción Run del esquema.

Si todavía no tienes el flujo de compra en Dart, empieza por la guía de in app purchase en Flutter. Si prefieres RevenueCat, el archivo local también te sirve para probar el paywall; mira la integración en RevenueCat en Flutter.

Recuerda llamar a completePurchase cuando entregues el contenido. Según la documentación del plugin, en iOS las transacciones sin terminar se quedan en la cola y se vuelven a entregar en cada arranque.

Automatiza con StoreKitTest

Todo lo anterior se puede llevar a pruebas unitarias o de UI con el framework StoreKitTest y su clase SKTestSession, que da acceso a los mismos ajustes que cambias a mano:

import StoreKitTest

let session = try SKTestSession(configurationFileNamed: "Products")
session.disableDialogs = true
session.clearTransactions()

Así compruebas renovaciones, Ask to Buy o compras fallidas en cada build de tu CI.

Errores comunes

  • La lista de productos llega vacía: el esquema activo no tiene el archivo o el Product ID no coincide.
  • El archivo sincronizado no se actualiza: pulsa Sync; si necesitas editar, conviértelo a local.
  • La validación del recibo falla: los recibos de prueba los firma Xcode. Exporta el certificado con Editor > Save Public Certificate y úsalo solo en debug; esos recibos no son válidos en producción.
  • Sigues viendo productos del sandbox: el esquema tiene StoreKit Configuration en None o ejecutaste otro esquema.

Preguntas frecuentes

¿Cómo activo StoreKit Testing en Xcode?

En Edit Scheme > Run > Options > StoreKit Configuration elige tu archivo .storekit. Sin ese paso, el archivo existe pero no se usa.

¿Cómo agrego un StoreKit configuration file?

Con File > New > File from Template > StoreKit Configuration File. También puedes añadir uno existente desde la misma opción del esquema.

¿StoreKit Testing funciona en el simulador?

Sí. Funciona en el simulador y en dispositivos; en iOS 16 o superior el dispositivo necesita el Modo de desarrollador.

¿Necesito una cuenta sandbox para StoreKit Testing?

No. Las compras son locales y no piden cuenta. El sandbox lo necesitas para probar con los productos reales de App Store Connect y tu servidor.

¿Sirve con TestFlight?

No. TestFlight usa el sandbox. El archivo .storekit solo aplica cuando ejecutas desde Xcode.

Lanza tus compras in-app con AppConsol

Probar las compras es solo una parte: antes de enviar a revisión necesitas la ficha lista, capturas y una política de privacidad en regla. Prueba AppConsol: crea tu cuenta gratis y gestiona la publicación de tu app en Google Play y App Store desde un solo lugar.

Sigue aprendiendo