Commencer

1. Installer the package

   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. Synchroniser with Natif projects

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Utilisation

Importer the plugin and use its methods to redirect Utilisateurs to Application stores:

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

// Open app store listing
const openAppStore = async () => {
  await NativeMarket.openStoreListing({
    appId: 'com.example.app' // Your app's bundle ID
  });
};

// Request app review
const requestReview = async () => {
  await NativeMarket.requestReview();
};

// Open app store search
const searchInStore = async () => {
  await NativeMarket.search({
    terms: 'fitness app' // Search terms
  });
};

API Référence

openStoreListing(Options)

Opens the Application Store listing for the specified Application.

interface OpenStoreListingOptions {
  appId: string; // Bundle ID on iOS, Package name on Android
}

requestReview()

Requests an in-Application review from the Utilisateur. On iOS 10.3+, this shows the rating dialog without leaving the Application.

Recherche(Options)

Opens the Application Store with Recherche results.

interface SearchOptions {
  terms: string; // Search terms to use
}

Platform Notes

iOS

• Uses SKStoreReviewController for in-app reviews on iOS 10.3+
• Falls Retour to opening Application Store for older versions

Android

• Opens Google Play Store
• Uses in-Application review API when Disponible

Exemple

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

export class AppService {
  async rateApp() {
    try {
      // Try in-app review first
      await NativeMarket.requestReview();
    } catch (error) {
      // Fallback to opening store listing
      const platform = Capacitor.getPlatform();
      const appId = platform === 'ios'
        ? 'id123456789' // Your iOS app ID
        : 'com.example.app'; // Your Android package name

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