Home

Awesome

Capacitor Native Market Plugin

Capacitor community plugin for native market for Play Store/App Store.

Note: The plugin doesn't work on iOS Simulator because it doesn't have App Store app installed. It works on Android Virtual Devices if they have Google Play installed with a user logged in.

Maintainers

MaintainerGitHubSocial
Priyank Patelpriyankpat@priyankpat_

Maintenance Status: Actively Maintained

Plugin versions

Capacitor versionPlugin version
6.x6.x
5.x5.x
4.x4.x
< 3.x0.1.x

Installation

To use npm

npm install @capacitor-community/native-market

To use yarn

yarn add @capacitor-community/native-market

Sync native files

npx cap sync

Configuration

No configuration required for this plugin

Supported methods

NameAndroidiOSWeb
openStoreListing
openDevPage
openCollection
openEditorChoicePage
search
<docgen-index> </docgen-index>

Example

import { NativeMarket } from "@capacitor-community/native-market";
import { Capacitor } from "@capacitor/core";

/**
 * This method will launch link in Play/App Store.
 * @param appId - ID of your application.
 * Eg:
 * io.ionic.ioniconf on Android
 * id1622127552 on iOS
 * @returns void
 */
let appId = "id1622127552";
if (Capacitor.getPlatform() === "android") {
  appId = "io.ionic.ioniconf";
}
NativeMarket.openStoreListing({
  appId: appId,
});

/**
 * This method will deep-link directly to an Play/App store listing page.
 * @param devId - ID of developer. Eg. com.example.app
 * @returns void
 */
NativeMarket.openDevPage({
  devId: "5700313618786177705",
});

/**
 * This method will link users to a collection or top charts.
 * @param name - name of the collection. Click [here](https://developer.android.com/distribute/marketing-tools/linking-to-google-play#OpeningCollection) for android options.
 * @returns void
 */
NativeMarket.openCollection({
  name: "featured",
});

/**
 * This method will link users to Editor's choice page.
 * @param editorChoice - ID of your application. Eg. editorial_fitness_apps_us
 * @returns void
 */
NativeMarket.openEditorChoicePage({
  editorChoice: "editorial_fitness_apps_us",
});

/**
 * This method will link users to custom search query.
 * @param editorChoice - terms to be searched in Play/App store.
 * @returns void
 */
NativeMarket.search({
  terms: "capacitor",
});
<docgen-api> <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->

openStoreListing(...)

openStoreListing(options: { appId: string; }) => Promise<void>
ParamType
options<code>{ appId: string; }</code>

openDevPage(...)

openDevPage(options: { devId: string; }) => Promise<void>
ParamType
options<code>{ devId: string; }</code>

openCollection(...)

openCollection(options: { name: string; }) => Promise<void>
ParamType
options<code>{ name: string; }</code>

openEditorChoicePage(...)

openEditorChoicePage(options: { editorChoice: string; }) => Promise<void>
ParamType
options<code>{ editorChoice: string; }</code>

search(...)

search(options: { terms: string; }) => Promise<void>
ParamType
options<code>{ terms: string; }</code>

</docgen-api>