xindizhiyin2014/pushnotifications

🐉 A macOS, Linux, Windows app to test push notifications on iOS and Android

ℙ𝕦𝕤𝕙 ℕ𝕠𝕥𝕚𝕗𝕚𝕔𝕒𝕥𝕚𝕠𝕟𝕤

❤️ Support my work https://gum.co/rsjU ❤️

Description

• PushNotitication is an app used for testing push notifications on iOS and Android
• Support macOS, Windows, Linux
• Support using certificate and token for authentication with APNS
• Auto save settings

How to install

• Download latest release from https://github.com/onmyway133/PushNotifications/releases

How to use

• iOS Provider Certificate
• iOS Authentication Token
• Android Server Key

iOS Provider Certificate

• Read more Provider Certificates
• Go to Member Center
• Generate Apple Push Notification service SSL (Sandbox & Production), this is now used for both sandbox and production. Download as .cer file
• Double click on .cer file to install into Keychain, then export it as .p12 file

• In PushNotifications, select .p12 file, fill out passphase if needed, fill out bundle id, device token, message, select environment
• message must be in json format, see Creating the Remote Notification Payload

iOS Authentication Token

• Read more Authentication Tokens
• Go to Member Center
• Create a Key for push notification. Download as .p8 file.

• Note your key id

• Note your team id on Account Membership

• In PushNotifications, select .p8 file, fill out key id, team id, bundle id, device token, message, select environment

Android Server Key

• Read about Firebase Cloud Messaging
• Add or select project on Firebase Console

• In PushNotifications, fill out server key, device token, message
• message must be in json format

Manual building

In case of issues with running the app on your version of OS, it's possible to easily build it yourself.

Steps:

1. Download or clone the repository
2. Install node on your computer (https://nodejs.org/en/)
3. Run npm install in the root of downloaded/cloned project
4. Verify that the app can be launched with the command npm start (optional)
5. Build the project to generate installable files (2 options):

• For building with electron-builder you need to run npm run dist. Generated files end up in the folder dist in the root of your project.
• For building with electron-packager you need to run npm run release. Generated files end up in the folder PushNotifications-darwin-x64 in the root of your project (macOS only).

To build for Windows & Linux you need to use electron-builder. Also, this way is preferable because it creates installable files.

electron-builder will generate:

• For macOS: .zip, .dmg (if you build using macOS)
• For Windows: .msi (if you build using Windows)
• For Linux: .deb, .AppImage (if you build using Linux)

Keep in mind: you cannot build for Windows or Linux, if you are using macOS, or vise versa. It creates installable files only for your current OS.

Credit

• Icon http://emojione.com/
• Use node-apn under the hood

Author

Khoa Pham, [email protected]

License

PushNotifications is available under the MIT license. See the LICENSE file for more info.