uni-app Tencent Cloud Push Service (Push) currently supports vendor channels such as Mi, Huawei, HONOR, OPPO, Vivo, Meizu, APNs, OnePlus, realme, iQOO, FCM, and Apple.
Android
iOS
Registering Your Application with Vendor Push Platforms
To enable push notifications, you need to register your application with each vendor's push platform to obtain parameters such as AppID and AppKey. Currently, supported domestic mobile vendors include: Mi, Huawei, HONOR, OPPO, Vivo, Meizu, and internationally Google FCM.
3. Enter the application information to register the application
4. Download and add the configuration file to complete the registration
Generating the private key for the certificate
1. Click the application to enter application management
2. In Project Settings, click Service Accounts > Generate new private key .
Step 4. Configuring the push certificate
Log in to the Tencent Cloud Chat console, and add the push certificates for each vendor in the Push Management > Access Settings feature. Configure the vendor's AppId, AppKey, AppSecret, and other parameters for the added push certificates.
1. In the management center, click My Projects to add a new project.
2. In the Project Settings section, click Push Service > Enable Now.
Click Project Settings > API Management to enable push service permissions.
Step 3. Adding an application
Click Project Settings > General to add an application.
Note:
The application package name must be consistent with the plugin package name.
Step 4: Getting application information
Click Project Settings > General to get application information.
Note:
The General page contains the Client ID and Client Secret of the project and application. If the parameters do not match, scroll to the bottom of the page to get the application's Client ID and Client Secret.
You must add the packaged SHA-256 certificate fingerprint. The SHA-256 certificate fingerprint must match your own packaging certificate.
Download the agconnect-services.json file and place it in the project at: nativeResources/android/assets/ path.
If you modify project, application information, or development service settings, you need to re-download and configure the agconnect-services.json file.
Step 5: Adding a push certificate
Log in to the Tencent Cloud Chat console, click Push Management > Access Settings to add the push certificates for each vendor, and configure the vendor's AppId, AppKey, AppSecret, and other parameters for the added push certificates.
Vendor Push Platform
Configuring in the IM console
Note:
Client ID corresponds to AppID, and Client Secret corresponds to AppSecret.
Notification bar push: The application must be published on OPPO AppStore;
Notification bar push test permission: Only 1,000 messages can be pushed per day, limited to testing use. After the application is launched, you must reapply for "Notification Bar Push" permission to obtain the normal number of message pushes.
The platform will return the review results within one business day. Developers can view the review results on the application page, and for other questions, please consult the open platform customer service.
Go to the OPPO open platform, click Application service> App Market to enter the management center and create an application.
Step 3: Activating the PUSH service
1. Go to the OPPO open platform, click Application service > Mobile Services > Push to enter the push homepage, and click Apply to enable the push service.
2. Click to enter the App Management > App List > view details page to apply for push permission for applications not yet enabled.
Note:
Applications that use push services need to be published first.
3. Click Apply to apply for push service.
Step 4: Adding a push certificate
Log in to the Tencent Cloud Chat console, and add the push certificates for each vendor in the Push Management > Access Settings feature. Configure the vendor's AppId, AppKey, AppSecret, and other parameters for the added push certificates.
Vendor Push Platform
Configuring in the IM console
Note:
Note: If the application is not listed on the app market, push permissions are restricted. Official messages cannot be sent via the Web interface and API backend on the vivo official website. You can send test messages to the configured test devices via the API backend for testing.
Note: The package name of the application on the vivo Developer Platform must be consistent with the package name of the plugin application.
Go to the vivo open platform, click Distribution > Application Distribution > App Store > Upload Application to create your application.
Step 3: Enabling push
Go to the management center, click Push Service > Push Application to apply for push service for the newly created application.
Step 4: Getting application information
Go to the push operation platform, click Application Management > Application Information to obtain application information.
Step 5: Adding a push certificate
Log in to the Tencent Cloud Chat console, click Push Management > Access Settings to add the push certificates for each vendor, and configure the vendor's AppId, AppKey, AppSecret, and other parameters for the added push certificates.
2. After entering the application information, create the application
Note:
The application package name must be consistent with the plugin package name.
Step 3: Getting application information
In the application list, click Open app. Enter the configuration management page to get application information.
Step 4: Adding a push certificate
Log in to the Tencent Cloud Chat console, and click Push Management > Access Settings feature to add the push certificates for each vendor. Configure the vendor's AppId, AppKey, AppSecret, and other parameters for the added push certificates.
1. Go to Application Management, click Create Application to create a new application.
2. Go to Application Details, bind the App package name, and download the mcs-services.json file.
Note:
You must add the packaged SHA-256 certificate fingerprint. The SHA-256 certificate fingerprint must match your own packaging certificate.
Download the mcs-services.json file and place it in the project at: nativeResources/android/.
If you modify project, application information, or development service settings, you need to re-download and configure the mcs-services.json file.
Step 4: Activating the push service
1. Click Development Capabilities -> Push Service to enter the push service list page.
2. Click Apply for Push Service to enter the application application page.
3. Select the application type "Mobile Application", fill in the application package name and certificate fingerprint, agree to the Push Service Agreement and Data Processing Addendum, and click Submit.
Note:
You need to add the packaged SHA-256 certificate fingerprint. The SHA-256 certificate fingerprint must match your own packaging certificate.
Step 5: Getting application information
In the Push Service list, click View to get application information.
Step 6: Adding a push certificate
Log in to the Tencent Cloud Chat console, click Push Management > Access Settings to add the push certificates for each vendor, and configure the vendor's AppID, AppKey, AppSecret, and other parameters for the added push certificates.
1. In the management console, click Notification message.
2. Create an application, complete the application information interface, and click Save.
Step 3: Enabling push
Go to the Application List page of the push operation platform, click Enable Push for the corresponding application name, and confirm the enablement.
Viewing application information
Go to the Application Information page of the push operation platform to view the Application Information.
Configuring the push certificate
Log in to the Tencent Cloud Chat console, and add the push certificates for each vendor in the Push Management > Access Settings feature. Configure the vendor's AppId, AppKey, AppSecret, and other parameters for the added push certificates.
Vendor Push Platform
Configuring in the IM console
Before integrating uni-app Tencent Cloud Push Service (Push), you need to apply for an APNs push certificate from Apple, then upload the push certificate to the IM console. After that, follow the Quick Connection steps to connect.
There are currently two mainstream types of certificates for Apple Manufacturer Configuration: p12 certificates and p8 certificates. Each type of certificate has its advantages and drawbacks, and you can choose one according to your needs.
Certificate Type
Validity Period and Management
Security
Dynamic Island
p12 Certificate
A p12 certificate is a binary file containing a public key and a private key, used for certificate-based authentication. It bundles the public key certificate and the private key into one file with the extension .p12 or .pfx.
A p12 certificate typically has a validity period of one year and needs to be regenerated and deployed after expiration. Each application requires a separate p12 certificate to handle push notifications.
A p12 certificate uses certificate-based authentication and requires storing the private key on the server. This may increase security risks as the private key could be accessed by unauthorized users.
Not supported.
p8 Certificate
A p8 certificate is an Auth Key used for token-based authentication. It is a text file containing a private key with the extension .p8.
A p8 certificate does not have an expiration date, so you do not need to worry about certificate expiration. Additionally, using a p8 certificate simplifies certificate management as you can use one p8 certificate to provide push notification services for multiple applications.
A p8 certificate uses token-based authentication, which means your server periodically generates a JSON Web Token (JWT) to establish a connection with APNs. This method is more secure as it does not require storing the private key on the server.
Support Dynamic Island Push
1. Using a p12 certificate (traditional push certificate)
Step 1: Apply for an APNs certificate
Enable remote push for the app
1. log in to Apple Developer Center website, click Certificates, Identifiers & Profiles or the sidebar's Certificates, IDs & Profiles, enter the Certificates, IDS & Profiles page.
2. click the + next to Identifiers.
3. You can follow the steps below to create a new AppID or add a Push NotificationService to your existing AppID.
Note:
Your App's Bundle ID cannot use the wildcard *, otherwise, the remote push service cannot be used.
4. Check the App IDs box, click Continue to proceed to the next step.
5. Select App, click Continue to proceed to the next step.
6. Configure the Bundle ID and other information, click Continue to proceed to the next step.
7. Check the Push Notifications box to enable the remote push service.
Certificate Generation
1. Select your AppID and choose Configure.
2. In the Apple Push Notification service SSL Certificates window, there are two SSL Certificates for the development environment (Development) and the production environment (Production), as shown below:
3.
We
first select the Create Certificate for the Development environment, the system will prompt us that we need a Certificate Signing Request (CSR).
4. On a Mac, open Keychain Access tool, in the menu select Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority (Keychain Access - Certificate Assistant - Request a Certificate From a Certificate Authority).
5. Enter your email address, Common Name (your name or company name), select Save to disk, click continue, the system will generate a *.certSigningRequest file.
6. Go back to the page on the Apple Developer website mentioned in Step 3, click Choose File to upload the generated *.certSigningRequest file.
7. Click Continue to generate the push certificate.
8. click Download to download the Development SSL Certificate to your local environment.
9. Repeat steps 1 - 8 above to download the Production SSL Certificate for the production environment to your local machine.
Note:
The certificate for the production environment is actually a combined certificate of Development (Sandbox) + Production, and it can be used as a certificate for both the development and production environments.
10. Double-click the downloaded SSL Certificate for the development and production environments. The system will import it into the keychain.
11. Open the Keychain App, go to log in to > My Certificates, right-click to export the newly created Apple Development IOS Push Services and Apple Push Services for the development and production environments as p12 files respectively.
2. Enter Access Settings > Manufacturer Configuration > iOS.
3. Click Add Certificate.
4. Select the certificate type, upload the iOS Certificate (.p12), set the certificate password, and click Confirm.
Note:
We recommend naming the uploaded certificate in English (special characters such as brackets are not allowed).
You need to set a password for the uploaded certificate. Without a password, push notifications cannot be received.
For an app published on App Store, the environment of the certificate must be the production environment. Otherwise, push notifications cannot be received.
The uploaded .p12 certificate must be your own authentic and valid certificate.
Second, using a p8 certificate (supports Dynamic Island push notifications)
p8 Certificate: A p8 certificate does not have an expiration date, so you don't have to worry about the certificate expiring. Moreover, using a p8 certificate can simplify certificate management, as you can use a single p8 certificate to provide push notification services for multiple applications. In addition, p8 certificates support Dynamic Island push notifications.
1. Enter Certificates, Identifiers & Profiles: In the top right corner of the page, click Account, then select Certificates, Identifiers & Profiles from the dropdown menu.
2. To create a new App ID: in the left-hand menu, click Identifiers, then click the + on the right to create a new App ID. Fill in the relevant information and click Continue.
3. To create a new key: in the left-hand menu, click Keys, then click the + on the right to create a new key. Enter the name of the key, then check Apple Push Notifications service (APNs) and click Continue.
Confirm and generate the key: On the confirmation page, verify your key information, then click Register. Next, you'll see a page prompting you to download the key. Click Download and save the generated .p8 file to your computer.
Note:
The p8 certificate can only be downloaded once; please save it properly.
Please safeguard the downloaded p8 file, as you will not be able to download it again. You can use this p8 certificate to configure your iOS applications to receive push notifications.
Step 2: Upload the p8 certificate to the IM console
2. Click the target app card to go to the basic configuration page of the app.
3. Click iOS Native Offline Push Settings on the right side and then click Add Certificate.
4. Select the .p8 certificate, upload the iOS Certificate (.p8), set KeyID、TeamID and BundleID, and click Confirm.
Note:
KeyID: This is the unique identifier for your APNs Auth Key. When you create a new APNs Auth Key in the Apple Developer Center, a Key ID will be generated for you. You can find it in the "Certificates, Identifiers & Profiles" section under "Keys".
TeamID: This is the unique identifier for your developer account. You can find it on the account details page of the Apple Developer Center. Click "Membership" in the upper right corner, and you can find your Team ID in the "Membership Details" section.
BundleID: This is the unique identifier for your application, also known as the app ID. You can find it in the "Certificates, Identifiers & Profiles" section of the Apple Developer Center. Select "Identifiers", then find the corresponding Bundle ID in your list of applications.
Yes
No
Was this page helpful?