Integra Adapty en tu app Flutter con ayuda de IA

Esta guía te lleva paso a paso por la integración de Adapty en tu app de Flutter usando una herramienta de codificación con IA — le proporcionas la documentación correcta de Adapty en el orden correcto.

Antes de empezar: configuración del dashboard

Adapty requiere cierta configuración en el dashboard antes de escribir código con el SDK. Puedes hacerlo con una skill LLM interactiva o manualmente desde el Dashboard.

Enfoque con skill (recomendado)

El skill de Adapty CLI permite que tu LLM configure tu app, productos, niveles de acceso, paywalls y placements directamente, sin necesidad de abrir el Dashboard en cada paso. Solo tienes que conectar tus stores en el Dashboard.

npx skills add adaptyteam/adapty-cli --skill adapty-cli

Una vez añadido el skill, ejecuta /adapty-cli en tu agente. Te guiará por cada paso, incluyendo cuándo abrir el Dashboard para conectar tus stores.

Enfoque desde el dashboard

Si prefieres configurarlo todo manualmente, esto es lo que necesitas antes de escribir código. Tu LLM no puede consultar los valores del dashboard por ti — tendrás que proporcionarlos.

1. Conecta tus app stores: En el Adapty Dashboard, ve a App settings → General. Conecta tanto App Store como Google Play si tu app Flutter apunta a ambas plataformas. Esto es necesario para que las compras funcionen. Conecta los app stores

2. Copia tu clave SDK pública: En el Adapty Dashboard, ve a App settings → General y busca la sección API keys. En el código, es la cadena que pasas a la configuración de Adapty.

3. Crea al menos un producto: En el Adapty Dashboard, ve a la página Products. No necesitas referenciar los productos directamente en el código — Adapty los entrega a través de paywalls. Añadir productos

4. Crea un paywall y un placement: En el Adapty Dashboard, crea un paywall en la página Paywalls y asígnalo a un placement en la página Placements. En el código, el ID del placement es la cadena que pasas a Adapty().getPaywall(). Crear un paywall

5. Configura los niveles de acceso: En el Adapty Dashboard, configúralos por producto en la página Products. En el código, la cadena que se comprueba es profile.accessLevels['premium']?.isActive. El nivel de acceso premium predeterminado funciona para la mayoría de las apps. Si los usuarios de pago acceden a distintas funciones según el producto (por ejemplo, un plan basic frente a un plan pro), crea niveles de acceso adicionales antes de empezar a programar.

Configura cuando estés listo

Esto no es necesario para empezar a programar, pero lo necesitarás a medida que tu integración madure:

• Pruebas A/B: Configúralas en la página Placements. No se requiere ningún cambio de código. Pruebas A/B
• Paywalls y placements adicionales: Añade más llamadas getPaywall con distintos IDs de placement.
• Integraciones de analytics: Configúralas en la página Integrations. La configuración varía según la integración. Consulta integraciones de analytics e integraciones de atribución.

Proporciona la documentación de Adapty a tu LLM

Usa Context7 (recomendado)

Context7 es un servidor MCP que da a tu LLM acceso directo a la documentación actualizada de Adapty. Tu LLM obtiene automáticamente la documentación adecuada según lo que le preguntes, sin necesidad de pegar URLs manualmente.

Context7 funciona con Cursor, Claude Code, Windsurf y otras herramientas compatibles con MCP. Para configurarlo, ejecuta:

npx ctx7 setup

Esto detecta tu editor y configura el servidor de Context7. Para la configuración manual, consulta el repositorio de Context7 en GitHub. Una vez configurado, haz referencia a la librería de Adapty en tus prompts:

Use the adaptyteam/adapty-docs library to look up how to install the Flutter SDK

Usa los docs en texto plano

Puedes acceder a cualquier doc de Adapty en texto plano Markdown. Añade .md al final de su URL o haz clic en Copy for LLM debajo del título del artículo. Por ejemplo: adapty-cursor-flutter.md.

Cada paso del recorrido de implementación incluye un bloque “Send this to your LLM” con enlaces .md para pegar.

Para acceder a más documentación a la vez, consulta los archivos de índice y subconjuntos por plataforma.

Guía de implementación paso a paso

El resto de esta guía recorre la integración de Adapty en el orden de implementación. Cada etapa incluye la documentación que debes enviar a tu LLM, lo que deberías ver al terminar y los problemas más frecuentes.

Planifica tu integración

Antes de escribir código, pídele a tu LLM que analice tu proyecto y cree un plan de implementación. Si tu herramienta de IA tiene un modo de planificación (como el modo plan de Cursor o Claude Code), úsalo para que el LLM pueda leer tanto la estructura de tu proyecto como la documentación de Adapty antes de generar cualquier código.

Indícale a tu LLM qué enfoque usas para las compras — esto determina qué guías debe seguir:

• Adapty Paywall Builder: Creas paywalls en el editor visual de Adapty y el SDK los renderiza automáticamente.
• Paywalls creados manualmente: Construyes tu propia interfaz de paywall en código, pero sigues usando Adapty para obtener productos y gestionar compras.
• Modo observador: Mantienes tu infraestructura de compras existente y usas Adapty únicamente para analíticas e integraciones.

¿No sabes cuál elegir? Consulta la tabla comparativa en la guía de inicio rápido.

Instalar y configurar el SDK

Añade la dependencia del SDK de Adapty con flutter pub add y actívalo con tu clave pública de SDK. Es la base — sin esto, nada más funciona.

Guía: Instalar y configurar el SDK de Adapty

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/sdk-installation-flutter.md

Mostrar paywalls y gestionar compras

Obtén un paywall por ID de placement, muéstralo y gestiona los eventos de compra. Las guías que necesitas dependen de cómo gestiones las compras.

Prueba cada compra en el sandbox a medida que avanzas — no esperes hasta el final. Consulta Probar compras en sandbox para ver las instrucciones de configuración.

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/flutter-quickstart-paywalls.md
- https://adapty.io/docs/es/flutter-get-pb-paywalls.md
- https://adapty.io/docs/es/flutter-present-paywalls.md
- https://adapty.io/docs/es/flutter-handling-events.md
- https://adapty.io/docs/es/flutter-handle-paywall-actions.md

Verificar el estado de la suscripción

Tras una compra, consulta el perfil de usuario para ver si hay un nivel de acceso activo y así controlar el acceso al contenido premium.

Guía: Verificar el estado de la suscripción

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/flutter-check-subscription-status.md

Identificar usuarios

Vincula las cuentas de usuario de tu app con los perfiles de Adapty para que las compras persistan en todos los dispositivos.

Guía: Identificar usuarios

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/flutter-quickstart-identify.md

Preparativos para el lanzamiento

Una vez que tu integración funcione en el sandbox, repasa la lista de verificación de lanzamiento para asegurarte de que todo esté listo para producción.

Guía: Lista de verificación de lanzamiento

Envía esto a tu LLM:

Read these Adapty docs before releasing:
- https://adapty.io/docs/es/release-checklist.md

Archivos de índice de documentación en texto plano

Si necesitas darle a tu LLM un contexto más amplio que el de páginas individuales, ofrecemos archivos de índice que listan o combinan toda la documentación de Adapty:

• llms.txt: Lista todas las páginas con enlaces .md. Un estándar emergente para hacer sitios web accesibles a los LLMs. Ten en cuenta que algunos agentes de IA (por ejemplo, ChatGPT) requieren descargar llms.txt y subirlo al chat como archivo.
• llms-full.txt: Toda la documentación de Adapty combinada en un único archivo. Muy extenso — úsalo solo cuando necesites una visión completa.
• flutter-llms.txt y flutter-llms-full.txt específicos de Flutter: Subconjuntos por plataforma que ahorran tokens en comparación con el sitio completo.