スタートガイド

インストール

AIアシストによるセットアップでプラグインをインストールできます。以下のコマンドを使用して、お使いのAIツールに Capgo のスキルを追加してください：

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

次に、以下のプロンプトを使用します：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-native-market` plugin in my project.

手動セットアップを希望する場合は、以下のコマンドを実行してプラグインをインストールし、下記のプラットフォーム別の手順に従ってください：

npm install @capgo/capacitor-native-market
npx cap sync

インポート

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

クイックスタート

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

await NativeMarket.openStoreListing({ appId: 'com.example.app' });

例: Play Store での検索 (Android)

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

await NativeMarket.search({ terms: 'fitness tracker' });

よくある落とし穴

• Bundle と package の違い：iOSはApp Storeのbundle idを使用し、Androidはapplication idを使用します。
• Android のみ：guard openDevPage と openCollection を使用して Capacitor.getPlatform().
• 外部UI：ストアUIはWebViewの外で開くため、ディープリンクの戻り先は別途計画してください。

API の概要

openStoreListing

Play Store (Android) または App Store (iOS) のアプリ詳細ページを開きます。

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

// Open app in store
await NativeMarket.openStoreListing({
  appId: 'com.example.app'
});

// Open app in specific country store (iOS only)
await NativeMarket.openStoreListing({
  appId: 'com.example.app',
  country: 'IT'
});

openDevPage

Play Store 内のデベロッパーページへ直接ディープリンクします。 Android のみ。

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

await NativeMarket.openDevPage({
  devId: 'Google+LLC'
});

openCollection

Play Store のコレクションまたはトップチャートへユーザーを誘導します。 Android のみ。

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

await NativeMarket.openCollection({
  name: 'featured'
});

openEditorChoicePage

Play Storeの「編集者のおすすめ」ページへユーザーをリンクします。 Androidのみ対応。

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

await NativeMarket.openEditorChoicePage({
  editorChoice: 'editorial_fitness_apps_us'
});

search

カスタム検索ワードでPlay Storeを検索します。 Androidのみ対応。

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

await NativeMarket.search({
  terms: 'fitness apps'
});

Source of Truth

このページはプラグインの src/definitions.tsから生成されています。upstream で公開 API が変更されたら、再度 sync を実行してください。

Getting Startedの続きを進める

使用している場合 スタートガイド ダッシュボードと API の運用を計画するには、これを次と連携させます @capgo/capacitor-native-market の使用 @capgo/capacitor-native-market を使用する際のネイティブ機能については、 API の概要 「API の概要」の実装の詳細については、 はじめに 「はじめに」における実装の詳細については、 API キー および「API Keys」の実装の詳細については、 デバイス 実装の詳細については Devices を参照してください。