Saltar al contenido

Primeros pasos

GitHub

Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:

Ventana de terminal
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego usa el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-android-inline-install` plugin in my project.

Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:

Ventana de terminal
npm install @capgo/capacitor-android-inline-install
npx cap sync
import { AndroidInlineInstall } from '@capgo/capacitor-android-inline-install';
import { AndroidInlineInstall } from '@capgo/capacitor-android-inline-install';
await AndroidInlineInstall.startInlineInstall({
id: 'com.example.companion',
overlay: true,
fallback: true,
});
  • Solo en Play: los APK sideloaded no admiten inline install.
  • versionCode: debe ser superior a la build instalada.
  • Cerrar: gestiona la cancelación sin bucles de reintento infinitos.

Inicia un flujo de inline install usando el overlay de Google Play.

Nota: Solo las apps elegibles pueden usar Inline Install. Ver: https://play.google.com/console/about/guides/premium-growth-tools/

import { AndroidInlineInstall } from '@capgo/capacitor-android-inline-install';
const result = await AndroidInlineInstall.startInlineInstall({
id: 'com.example.app',
referrer: 'my-referrer',
overlay: true,
fallback: true
});
if (result.started) {
console.log('Install flow started');
if (result.fallbackUsed) {
console.log('Using fallback Play Store link');
}
}

Opciones para iniciar un flujo de instalación inline.

export interface StartInlineInstallOptions {
/** Package name of the app to be installed (target app). */
id: string;
/** Referrer string to pass to Play. Optional but recommended. */
referrer?: string;
/**
* Package name of your app (caller). Defaults to the current app package
* if omitted.
*/
callerId?: string;
/** Optional Custom Store Listing ID. */
csl_id?: string;
/** Whether to request the Play overlay. Defaults to true. */
overlay?: boolean;
/** If true, falls back to full Play Store deep link when overlay unavailable. Defaults to true. */
fallback?: boolean;
}

Resultado de iniciar un flujo de instalación inline.

export interface StartInlineInstallResult {
/** True when the inline install intent has been started. */
started: boolean;
/** True if a fallback deep link was used instead of inline overlay. */
fallbackUsed?: boolean;
}

Esta página se genera a partir del plugin src/definitions.ts. Vuelve a ejecutar el sync cuando el API público cambie en upstream.

Si estás usando Primeros pasos para planificar las operaciones del dashboard y de API, conéctalo con Usando @capgo/capacitor-android-inline-install para la capacidad nativa en el uso de @capgo/capacitor-android-inline-install, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en la Introducción, Claves de API para los detalles de implementación en las claves de API, y Dispositivos para el detalle de implementación en Devices.