Erste Schritte

1. Installieren Sie das Paket

   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. Synchronisieren Sie mit nativen Projekten

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Verwendung

Importieren Sie das Plugin und verwenden Sie seine Methoden, um Benutzer zu App Stores weiterzuleiten:

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

// App Store-Eintrag öffnen
const openAppStore = async () => {
  await NativeMarket.openStoreListing({
    appId: 'com.example.app' // Ihre App-Bundle-ID
  });
};

// App-Bewertung anfordern
const requestReview = async () => {
  await NativeMarket.requestReview();
};

// App Store-Suche öffnen
const searchInStore = async () => {
  await NativeMarket.search({
    terms: 'fitness app' // Suchbegriffe
  });
};

API-Referenz

openStoreListing(options)

Öffnet den App Store-Eintrag für die angegebene App.

interface OpenStoreListingOptions {
  appId: string; // Bundle-ID auf iOS, Paketname auf Android
}

requestReview()

Fordert eine In-App-Bewertung vom Benutzer an. Auf iOS 10.3+ wird der Bewertungsdialog angezeigt, ohne die App zu verlassen.

search(options)

Öffnet den App Store mit Suchergebnissen.

interface SearchOptions {
  terms: string; // Zu verwendende Suchbegriffe
}

Plattform-Hinweise

iOS

• Verwendet SKStoreReviewController für In-App-Bewertungen auf iOS 10.3+
• Fällt auf das Öffnen des App Store für ältere Versionen zurück

Android

• Öffnet Google Play Store
• Verwendet In-App-Review-API, wenn verfügbar

Beispiel

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

export class AppService {
  async rateApp() {
    try {
      // Versuchen Sie zuerst In-App-Bewertung
      await NativeMarket.requestReview();
    } catch (error) {
      // Fallback zum Öffnen des Store-Eintrags
      const platform = Capacitor.getPlatform();
      const appId = platform === 'ios'
        ? 'id123456789' // Ihre iOS-App-ID
        : 'com.example.app'; // Ihr Android-Paketname

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