Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rakutentech/macos-push-tester
Native mac app for easily sending Apple APNs push notifications to iOS apps and FCM push notifications to Android apps.
https://github.com/rakutentech/macos-push-tester
android ios macos swift
Last synced: 13 days ago
JSON representation
Native mac app for easily sending Apple APNs push notifications to iOS apps and FCM push notifications to Android apps.
- Host: GitHub
- URL: https://github.com/rakutentech/macos-push-tester
- Owner: rakutentech
- License: mit
- Created: 2019-10-24T05:58:14.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-07-28T06:44:34.000Z (over 1 year ago)
- Last Synced: 2024-07-03T02:50:48.893Z (4 months ago)
- Topics: android, ios, macos, swift
- Language: Swift
- Homepage:
- Size: 2.94 MB
- Stars: 113
- Watchers: 20
- Forks: 17
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - macos-push-tester
README
# The macOS Push Tester App
The macOS Push Tester App allows you to send push notifications through APNS (Apple Push Notification Service) or FCM (Firebase Cloud Messaging) and receive them on a device or simulator/emulator.
The macOS Push Tester App can also send push notifications to Live Activities on iOS devices (iOS >= 16.1). This feature only works with APNS token.
Android emulators must enable the Google API for Google Play services.
It can also get device tokens from any iPhone on the same wifi network.
**Notice**: This app was created to be used by the Rakuten SDK team internally. Anyone is free to use it but please be aware that it is unsupported.
## How to build/run from source
- 1) Run `pod install` from root folder
- 2) Open pusher.xcworkspace*
- 3) Build and run
## How to build with Fastlane
### Install fastlane
- 1) Using RubyGems `sudo gem install fastlane -NV` (or simply `bundle install`)
- 2) Alternatively using Homebrew `brew cask install fastlane`
### Run fastlane
Run `fastlane ci`
## Make your iOS app discoverable by the macOS Push Tester App
- 1) Add this class to your iOS app
```swift
import Foundation
import MultipeerConnectivity
/// A device token can be generated from APNS or ActivityKit.
public enum DeviceTokenType: String {
case apns = "APNS"
case activityKit = "ActivityKit"
}
public final class DeviceAdvertiser: NSObject {
private var nearbyServiceAdvertiser: MCNearbyServiceAdvertiser?
private let serviceType: String
private enum Keys {
static let deviceToken = "token"
static let applicationIdentifier = "appID"
static let deviceTokenType = "type"
}
public init(serviceType: String) {
self.serviceType = serviceType
super.init()
}
/// Start advertising peer with device token (token), app identifier (appID) and device token type (type).
///
/// - Parameters:
/// - deviceToken: The APNS or ActivityKit device token
/// - type: the device token type (APNS or ActivityKit)
public func setDeviceToken(_ deviceToken: String,
type: DeviceTokenType = .apns) {
if let advertiser = nearbyServiceAdvertiser {
advertiser.stopAdvertisingPeer()
}
let peerID = MCPeerID(displayName: UIDevice.current.name)
nearbyServiceAdvertiser = MCNearbyServiceAdvertiser(
peer: peerID,
discoveryInfo: [Keys.deviceToken: deviceToken,
Keys.applicationIdentifier: Bundle.main.bundleIdentifier ?? "",
Keys.deviceTokenType: type.rawValue],
serviceType: serviceType
)
nearbyServiceAdvertiser?.delegate = self
nearbyServiceAdvertiser?.startAdvertisingPeer()
}
}
extension DeviceAdvertiser: MCNearbyServiceAdvertiserDelegate {
public func advertiser(_ advertiser: MCNearbyServiceAdvertiser,
didReceiveInvitationFromPeer peerID: MCPeerID,
withContext context: Data?,
invitationHandler: @escaping (Bool, MCSession?) -> Void) {
invitationHandler(false, MCSession())
}
public func advertiser(_ advertiser: MCNearbyServiceAdvertiser, didNotStartAdvertisingPeer error: Error) {
}
}
```
- 2) Instantiate `DeviceAdvertiser`
```swift
let deviceAdvertiser = DeviceAdvertiser(serviceType: "pusher")
```
- 3) Set the device token
```swift
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
deviceAdvertiser.setDeviceToken(deviceToken.hexadecimal)
}
```
- 4) Add this `Data` extension to convert deviceToken to `String`
```swift
import Foundation
extension Data {
var hexadecimal: String {
map { String(format: "%02x", $0) }.joined()
}
}
```
- 5) Add the following to your targets info.plist (required for iOS 14 and above)
```xml
NSBonjourServices
_pusher._tcp
_pusher._udp
NSLocalNetworkUsageDescription
To allow Pusher App to discover this device on the network.
```
## UI Preview
