Name	Name	Last commit message	Last commit date
parent directory ..
example	example
hooks	hooks
ionic-native	ionic-native
src	src
types	types
www	www
LICENSE	LICENSE
README.md	README.md
package.json	package.json
plugin.xml	plugin.xml

Cordova Plugin HMS IAP

Cordova HMS Iap

This plugin enables communication between Huawei Iap SDK and Cordova platform. It exposes all functionality provided by Huawei Iap SDK.

> Learn More

1. Introduction

This plugin enables communication between Huawei IAP SDK and Cordova platform. It exposes all functionality provided by Huawei IAP SDK.

2. Installation Guide

Before you get started, you must register as a HUAWEI Developer and complete identity verification on the HUAWEI Developer website. For details, please refer to Register a HUAWEI ID.

2.1. Creating a Project in AppGallery Connect

Creating an app in AppGallery Connect is required in order to communicate with the Huawei services. To create an app, perform the following steps:

Sign in to AppGallery Connect and select My projects.
Select your project from the project list or create a new one by clicking the Add Project button.
Go to Project Setting > General information, and click Add app.
- If an app exists in the project and you need to add a new one, expand the app selection area on the top of the page and click Add app.
On the Add app page, enter the app information, and click OK.

2.2. Configuring the Signing Certificate Fingerprint and Obtaining agconnect-services.json

A signing certificate fingerprint is used to verify the authenticity of an app when it attempts to access an HMS Core (APK) through the HMS SDK. Before using the HMS Core (APK), you must locally generate a signing certificate fingerprint and configure it in the AppGallery Connect. You can refer to 3rd and 4th steps of Generating a Signing Certificate Codelab tutorial for the certificate generation. Perform the following steps after you have generated the certificate.

Sign in to AppGallery Connect and select your project from My Projects. Then go to Project Setting > General information. In the App information field, click the icon next to SHA-256 certificate fingerprint, and enter the obtained SHA-256 certificate fingerprint.
After completing the configuration, click OK to save the changes. (Check mark icon)
In the same page, click agconnect-services.json button to download the configuration file.

2.3. Enabling Required Services

To use HUAWEI IAP, you first need to enable the IAP service and also set IAP parameters .

NOTE: Please save the public key obtained during the process of enabling the IAP service. It will be used for verifying the signature of data returned by the IAP SDK, ensuring that the data is not tampered with.

2.4. Cordova

Install Cordova CLI if haven't done before.
```
npm install -g cordova
```
Create a new Cordova project or use existing Cordova project.
- To create new Cordova project, you can use cordova create path [id [name [config]]] [options] command. For more details please follow CLI Reference - Apache Cordova .
Update the widget id property which is specified in the config.xml file. It must be same with client > package_name value of the agconnect-services.json file.
Add the Android platform to the project if haven't done before.
```
cordova platform add android
```

Install HMS IAP plugin to the project.

cordova plugin add @hmscore/cordova-plugin-hms-iap

Copy agconnect-services.json file to <project_root>/platforms/android/app directory.

Add keystore(.jks) and build.json files to your project's root directory.

You can refer to 3rd and 4th steps of Generating a Signing Certificate Codelab tutorial page for generating keystore file.
Fill build.json file according to your keystore. For example:

{
  "android": {
    "debug": {
      "keystore": "<keystore_file>.jks",
      "storePassword": "<keystore_password>",
      "alias": "<key_alias>",
      "password": "<key_password>"
    },
    "release": {
      "keystore": "<keystore_file>.jks",
      "storePassword": "<keystore_password>",
      "alias": "<key_alias>",
      "password": "<key_password>"
    }
  }
}

Run the app.
```
cordova run android --device
```

2.5 Ionic

Install Ionic CLI and other required tools if haven't done before.
```
npm install -g @ionic/cli cordova-res native-run
```
Create a new Ionic project or use existing Ionic project.
- To create a new Ionic project, you can use ionic start <name> <template> [options] command. For more details please follow ionic start - Ionic Documentation .

2.5.1. With Cordova Runtime

Enable the Cordova integration if haven't done before.
```
ionic integrations enable cordova
```
Update the widget id property which is specified in the config.xml file. It must be same with client > package_name value of the agconnect-services.json file.
Add the Android platform to the project if haven't done before.
```
ionic cordova platform add android
```

Install HMS IAP plugin to the project.

ionic cordova plugin add @hmscore/cordova-plugin-hms-iap

If you want to enable Ionic Native support then run the following command.
```
npm install @ionic-native/core @hmscore/ionic-native-hms-iap
```
Copy agconnect-services.json file to <project_root>/platforms/android/app directory.

Add keystore(.jks) and build.json files to your project's root directory.

You can refer to 3rd and 4th steps of Generating a Signing Certificate Codelab tutorial page for generating keystore file.
Fill build.json file according to your keystore. For example:

{
  "android": {
    "debug": {
      "keystore": "<keystore_file>.jks",
      "storePassword": "<keystore_password>",
      "alias": "<key_alias>",
      "password": "<key_password>"
    },
    "release": {
      "keystore": "<keystore_file>.jks",
      "storePassword": "<keystore_password>",
      "alias": "<key_alias>",
      "password": "<key_password>"
    }
  }
}

Build Ionic app to generate resource files.
```
ionic build
```
Run the app.
```
ionic cordova run android --device
```

2.5.2. With Capacitor Runtime

Enable the Capacitor integration if haven't done before.
```
ionic integrations enable capacitor
```
Initialize Capacitor if haven't done before.
```
npx cap init [appName] [appId]
```
- For more details please follow Initialize Capacitor with your app information .
Update the appId property which is specified in the capacitor.config.json file according to your project. It must be same with client > package_name value of the agconnect-services.json file.

Install HMS IAP plugin to the project.

npm install @hmscore/cordova-plugin-hms-iap

If you want to enable Ionic Native support then run the following command.
```
npm install @ionic-native/core @hmscore/ionic-native-hms-iap
```
Build Ionic app to generate resource files.
```
ionic build
```
Add the Android platform to the project if haven't done before.
```
npx cap add android
```
Copy keystore(.jks) and agconnect-services.json files to <project_root>/android/app directory.
- You can refer to 3rd and 4th steps of Generating a Signing Certificate Codelab tutorial page for generating keystore file.

Open the build.gradle file in the <project_root>/android/app directory.

Add signingConfigs entry to the android section and modify it according to your keystore.
Enable signingConfig configuration for debug and release flavors.

...

android {

    ...

    // Modify signingConfigs according to your keystore
    signingConfigs {
        config {
            storeFile file('<keystore_file>.jks')
            storePassword '<keystore_password>'
            keyAlias '<key_alias>'
            keyPassword '<key_password>'
        }
    }
    buildTypes {
        debug {
            signingConfig signingConfigs.config // Enable signingConfig for debug flavor
        }
        release {
            signingConfig signingConfigs.config // Enable signingConfig for release flavor
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

...

Open the build.gradle file in the <project_root>/android directory. Add Huawei's maven repositories and agconnect classpath to the file.

buildscript {
    repositories {
        /*
            <Other repositories>
        */
        maven { url 'https://developer.huawei.com/repo/' }
    }
    dependencies {
        /*
            <Other dependencies>
        */
        classpath 'com.huawei.agconnect:agcp:1.4.2.301'
    }
}

/*
    <Other build.gradle entries>
*/

allprojects {
    repositories {
        /*
            <Other repositories>
        */
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

Updates dependencies, and copy any web assets to your project.
```
npx cap sync
```
Open the project in Android Studio and run it.
```
npx cap open android
```

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

cordova-plugin-hms-iap

cordova-plugin-hms-iap

README.md

Cordova Plugin HMS IAP

Cordova HMS Iap

1. Introduction

2. Installation Guide

2.1. Creating a Project in AppGallery Connect

2.2. Configuring the Signing Certificate Fingerprint and Obtaining agconnect-services.json

2.3. Enabling Required Services

2.4. Cordova

2.5 Ionic

2.5.1. With Cordova Runtime

2.5.2. With Capacitor Runtime

Files

cordova-plugin-hms-iap

Directory actions

More options

Directory actions

More options

Latest commit

History

cordova-plugin-hms-iap

Folders and files

parent directory

README.md

Cordova Plugin HMS IAP

Cordova HMS Iap

1. Introduction

2. Installation Guide

2.1. Creating a Project in AppGallery Connect

2.2. Configuring the Signing Certificate Fingerprint and Obtaining agconnect-services.json

2.3. Enabling Required Services

2.4. Cordova

2.5 Ionic

2.5.1. With Cordova Runtime

2.5.2. With Capacitor Runtime