Comenzar

1. Instalar el paquete

   npm

   npm i @Capgo/native-market

   pnpm

   pnpm add @Capgo/native-market

   yarn

   yarn add @Capgo/native-market

   bun

   bun add @Capgo/native-market

2. Sincronizar con proyectos nativos

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Uso

Importa el Plugin y usa sus métodos para redirigir usuarios a las tiendas de aplicaciones:

import { NativeMarket } from '@capgo/native-market';

// Abrir listado en la tienda de aplicaciones
const openAppStore = async () => {
  await NativeMarket.openStoreListing({
    appId: 'com.example.app' // El ID de paquete de tu aplicación
  });
};

// Solicitar reseña de la aplicación
const requestReview = async () => {
  await NativeMarket.requestReview();
};

// Abrir búsqueda en la tienda de aplicaciones
const searchInStore = async () => {
  await NativeMarket.search({
    terms: 'fitness app' // Términos de búsqueda
  });
};

Referencia de API

openStoreListing(Opciones)

Abre el listado de la tienda de aplicaciones para la aplicación especificada.

interface OpenStoreListingOptions {
  appId: string; // Bundle ID en iOS, Nombre de paquete en Android
}

requestReview()

Solicita una reseña dentro de la aplicación del usuario. En iOS 10.3+, esto muestra el diálogo de calificación sin salir de la aplicación.

Buscar(Opciones)

Abre la tienda de aplicaciones con resultados de búsqueda.

interface SearchOptions {
  terms: string; // Términos de búsqueda a usar
}

Notas de Plataforma

iOS

• Usa SKStoreReviewController para reseñas dentro de la aplicación en iOS 10.3+
• Vuelve a abrir Aplicación Store para versiones anteriores

Android

• Abre Google Play Store
• Usa la API de reseñas dentro de la aplicación cuando está disponible

Ejemplo

import { NativeMarket } from '@Capgo/native-market';
import { Capacitor } from '@Capacitor/core';

Exportar Clase AppService {
  async rateApp() {
    try {
      // Intentar reseña dentro de la aplicación primero
      await NativeMarket.requestReview();
    } catch (Error) {
      // Alternativa a abrir el listado de la tienda
      const platform = Capacitor.getPlatform();
      const appId = platform === 'ios'
        ? 'id123456789' // Tu ID de aplicación iOS
        : 'com.Ejemplo.Aplicación'; // Tu nombre de paquete Android

      await NativeMarket.openStoreListing({ appId });
    }
  }
}