はじめに

1. パッケージをインストール

   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. ネイティブプロジェクトと同期

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

使用方法

プラグインをインポートし、そのメソッドを使用してユーザーをアプリストアにリダイレクトします：

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

// アプリストアのリストを開く
const openAppStore = async () => {
  await NativeMarket.openStoreListing({
    appId: 'com.example.app' // アプリのバンドルID
  });
};

// アプリレビューをリクエスト
const requestReview = async () => {
  await NativeMarket.requestReview();
};

// アプリストア検索を開く
const searchInStore = async () => {
  await NativeMarket.search({
    terms: 'fitness app' // 検索語句
  });
};

APIリファレンス

openStoreListing(options)

指定されたアプリのアプリストアリストを開きます。

interface OpenStoreListingOptions {
  appId: string; // iOSのバンドルID、Androidのパッケージ名
}

requestReview()

ユーザーからアプリ内レビューをリクエストします。iOS 10.3以降では、アプリを離れることなく評価ダイアログを表示します。

search(options)

検索結果とともにアプリストアを開きます。

interface SearchOptions {
  terms: string; // 使用する検索語句
}

プラットフォームノート

iOS

• iOS 10.3以降でアプリ内レビューにSKStoreReviewControllerを使用
• 古いバージョンではApp Storeを開くようにフォールバック

Android

• Google Play Storeを開く
• 利用可能な場合はアプリ内レビューAPIを使用

例

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

export class AppService {
  async rateApp() {
    try {
      // 最初にアプリ内レビューを試みる
      await NativeMarket.requestReview();
    } catch (error) {
      // ストアリストを開くことにフォールバック
      const platform = Capacitor.getPlatform();
      const appId = platform === 'ios'
        ? 'id123456789' // iOSアプリID
        : 'com.example.app'; // Androidパッケージ名

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