You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/pn-troubleshooting-guide.md
+6-5
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
# Debugging Guide for Acorn App Push Notifications
1
+
# Push Notifications Troubleshooting Guide
2
2
3
-
This guide provides steps to troubleshoot issues with push notifications in the Acorn app using the `hemlock-sendmsg` daemon. Follow these steps to identify and resolve problems with notifications on both iOS and Android devices.
3
+
This guide provides steps to troubleshoot issues with push notifications using the `hemlock-sendmsg` daemon. Follow these steps to identify and resolve problems with notifications on both iOS and Android devices.
4
4
5
5
## Common Issues
6
6
1.**Notifications not received on iOS or Android.**
@@ -12,8 +12,8 @@ This guide provides steps to troubleshoot issues with push notifications in the
12
12
13
13
### 1. Verify Build and Device Registration
14
14
- Ensure that the device has the correct build version of the app:
15
-
-**Android:** Version should be 3.1.0.6. Check via `Play Store >> Profile Icon >> Manage apps & device >> Acorn >> About this app`.
16
-
-**iOS:** Version should be 3.1.0 (2). Check via TestFlight or App Store.
15
+
-**Android:** Version should be at least 3.1.0.x. Check via `Play Store >> Profile Icon >> Manage apps & device >> Acorn >> About this app`.
16
+
-**iOS:** Version should be at least 3.1.0 (x). Check via TestFlight or App Store.
17
17
- Confirm the device is registered to receive push notifications:
18
18
- Only one device can be registered for push notifications per patron account. The last device to log in will be the active one.
19
19
@@ -46,6 +46,7 @@ This guide provides steps to troubleshoot issues with push notifications in the
46
46
~~~bash
47
47
git pull
48
48
make
49
+
sudo make install
49
50
sudo systemctl restart hemlock-sendmsg
50
51
~~~
51
52
-Check the daemon output for correct startup and notification processing:
@@ -98,4 +99,4 @@ This guide provides steps to troubleshoot issues with push notifications in the
98
99
2. Ensure that the `hemlock-sendmsg` daemon is updated and configured properly.
99
100
100
101
## Additional Notes
101
-
- The `hemlock-sendmsg` daemon has a new feature that allows filtering out patrons who do not have accounts in the app (EmptyToken metric). Refer to the [README](https://github.com/kenstir/hemlock-sendmsg/blob/main/README.md#collecting-metrics) for more details.
102
+
- The `hemlock-sendmsg` daemon filters out requests with an empty `token` parameter, so it does not attempt to send a push notification to a patron that does not use the app. The `EmptyToken` metric tracks the number of such requests. Refer to the [README](https://github.com/kenstir/hemlock-sendmsg/blob/main/README.md#collecting-metrics) for more details.
0 commit comments