The official Push Notification adapter for Parse Server. See Parse Server Push Configuration for more details.
npm install --save @parse/push-adapter@<VERSION>Replace <VERSION> with the version you want to install.
import { ParsePushAdapter } from '@parse/push-adapter';
// For CommonJS replace the import statemtent above with the following line:
// const ParsePushAdapter = require('@parse/push-adapter').default;
const parseServerOptions = {
push: {
adapter: new ParsePushAdapter({
ios: {
// Apple push options
},
android: {
// Android push options
},
web: {
// Web push options
},
expo: {
// Expo push options
}
})
}
// Other Parse Server options
};Parse Server Push Adapter currently supports these types of Apple ecosystems:
ios: iPhone, iPad, and iPod touch appsosx: macOS, and macCatalyst appstvos: tvOS apps
Delivering push notifications to Apple devices can be done either via Apple Push Notification Service (APNS), or via Firebase Cloud Messaging (FMC). Note that each category of Apple devices require their own configuration section:
- APNS requires a private key that can be downloaded from the Apple Developer Center at https://developer.apple.com/account under Certificates > Identifiers & Profiles. The adapter options also require the app ID and team ID which can be found there.
- FCM requires a private key that can be downloaded from the Firebase Console at https://console.firebase.google.com in your project under Settings > Cloud Messaging.
Example options:
Both services (APNS, FCM) can be used in combination for different Apple ecosystems.
ios: {
// Deliver push notifications to iOS devices via APNS
token: {
key: __dirname + '/apns.p8',
keyId: '<APNS_KEY_ID>',
teamId: '<APNS_TEAM_ID>'
},
topic: '<BUNDLE_IDENTIFIER>',
production: true
},
osx: {
// Deliver push notifications to macOS devices via FCM
firebaseServiceAccount: __dirname + '/firebase.json'
}Delivering push notifications to Android devices can be done via Firebase Cloud Messaging (FCM):
- FCM requires a private key that can be downloaded from the Firebase Console at https://console.firebase.google.com in your project under Settings > Cloud Messaging.
Example options:
android: {
firebaseServiceAccount: __dirname + '/firebase.json'
}The Firebase console allows to easily create and download a Google Cloud service account key JSON file with the required permissions. Instead of setting firebaseServiceAccount to the path of the JSON file, you can provide an object representing a Google Cloud service account key:
android: {
firebaseServiceAccount: {
projectId: '<PROJECT_ID>',
clientEmail: 'example@<PROJECT_ID>.iam.gserviceaccount.com',
privateKey: '-----BEGIN PRIVATE KEY-----<KEY>-----END PRIVATE KEY-----\n'
}
}This can be helpful if you are already managing credentials to Google Cloud APIs in other parts of your code and you want to reuse these credentials, or if you want to manage credentials on a more granular level directly in Google Cloud. Make sure that the service account has the permission cloudmessaging.messages.create which is for example part of role Firebase Cloud Messaging API Admin.
apiKey with firebaseServiceAccount.
Example options (deprecated):
android: {
// Deliver push notifications via FCM legacy API (deprecated)
apiKey: '<API_KEY>'
}Example options:
expo: {
accessToken: '<EXPO_ACCESS_TOKEN>'
}For more information see the Expo docs.
Parse Server already comes bundled with a specific version of the push adapter. This installation is only necessary when customizing the push adapter version that should be used by Parse Server. When using a customized version of the push adapter, ensure that it's compatible with the version of Parse Server you are using.
When using the bundled version, it is not necessary to initialize the push adapter in code and the push options are configured directly in the push key, without the nested adapter key:
const parseServerOptions = {
push: {
ios: {
// Apple push options
}
// Other push options
}
// Other Parse Server options
};You can enable verbose logging to produce a more detailed output for all push sending attempts with the following environment variables:
VERBOSE=1or
VERBOSE_PARSE_SERVER_PUSH_ADAPTER=1
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent