Inizia

1. Installa il pacchetto

   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. Sincronizza con i progetti nativi

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Utilizzo

Importa il plugin e usa i suoi metodi per reindirizzare gli utenti agli app store:

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

// Apri la scheda dell'app nello store
const openAppStore = async () => {
  await NativeMarket.openStoreListing({
    appId: 'com.example.app' // Il bundle ID della tua app
  });
};

// Richiedi una recensione dell'app
const requestReview = async () => {
  await NativeMarket.requestReview();
};

// Apri la ricerca nell'app store
const searchInStore = async () => {
  await NativeMarket.search({
    terms: 'fitness app' // Termini di ricerca
  });
};

Riferimento API

openStoreListing(options)

Apre la scheda dell’app store per l’app specificata.

interface OpenStoreListingOptions {
  appId: string; // Bundle ID su iOS, nome pacchetto su Android
}

requestReview()

Richiede una recensione in-app all’utente. Su iOS 10.3+, questo mostra il dialogo di valutazione senza uscire dall’app.

search(options)

Apre l’app store con i risultati di ricerca.

interface SearchOptions {
  terms: string; // Termini di ricerca da utilizzare
}

Note sulla piattaforma

iOS

• Usa SKStoreReviewController per recensioni in-app su iOS 10.3+
• Torna all’apertura dell’App Store per versioni precedenti

Android

• Apre Google Play Store
• Usa l’API di recensione in-app quando disponibile

Esempio

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

export class AppService {
  async rateApp() {
    try {
      // Prova prima la recensione in-app
      await NativeMarket.requestReview();
    } catch (error) {
      // Fallback all'apertura della scheda dello store
      const platform = Capacitor.getPlatform();
      const appId = platform === 'ios'
        ? 'id123456789' // Il tuo ID app iOS
        : 'com.example.app'; // Il tuo nome pacchetto Android

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