Skip to content

πŸ‰ A macOS, Linux, Windows app to test push notifications on iOS and Android

License

Notifications You must be signed in to change notification settings

onmyway133/PushNotifications

Repository files navigation

ℙ𝕦𝕀𝕙 ℕ𝕠π•₯π•šπ•—π•šπ•”π•’π•₯π•šπ• π•Ÿπ•€

Buy Me A Coffee

❀️ Support my apps ❀️

β€οΈβ€οΈπŸ˜‡πŸ˜πŸ€˜β€οΈβ€οΈ

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

How to use

Keep in mind: To connect to APNs you can use either Provider certificate or Authentication Token. They are different ways and Authentication Token is a new one.

Main difference: Provider certificate expires every year and needs to be regenerated (and reuploaded to your server as .p12). Authentication Token is unlimited and you don't have to recreate and reupload it.

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

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

Android Server Key

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

Opening app on macOS Catalina or newer (10.15+)

If you installed the app on macOS Catalina using the .dmg file, you will probably see this window when trying to launch the app:

Just press OK and go to System Settings... -> Security & Privacy -> General tab. There you need to press the button Open Anyway.

If you have macOS Ventura or later:

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:
  • 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.

As a result 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

Author

Khoa Pham, onmyway133@gmail.com

License

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