put everything up to make it work with older version of flutter_apns_only

Author: Christof Kost

example/pubspec.lock

@@ -124,14 +124,14 @@ packages:
       path: "../flutter_apns"
       relative: true
     source: path
-    version: "1.5.1"
+    version: "1.5.2"
   flutter_apns_only:
-    dependency: "direct overridden"
+    dependency: transitive
     description:
-      path: "../flutter_apns_only"
-      relative: true
-    source: path
-    version: "1.5.0-dev.1"
+      name: flutter_apns_only
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "1.5.0"
   flutter_local_notifications:
     dependency: "direct main"
     description:

example/pubspec.yaml

@@ -1,16 +1,16 @@
 name: flutter_apns_example
 description: Demonstrates how to use the flutter_apns plugin.
-publish_to: 'none'
+publish_to: "none"
 version: 1.0.0+1
 
 environment:
-  sdk: '>=2.12.0 <3.0.0'
+  sdk: ">=2.12.0 <3.0.0"
 
 dependencies:
   flutter:
     sdk: flutter
 
-  cupertino_icons: ^1.0.2 
+  cupertino_icons: ^1.0.2
   path_provider: ^2.0.1
 
   flutter_local_notifications: ^5.0.0-nullsafety.1
@@ -24,7 +24,7 @@ flutter:
   uses-material-design: true
 
 dependency_overrides:
-  flutter_apns_only:
-    path: ../flutter_apns_only
+  # flutter_apns_only:
+  # path: ../flutter_apns_only
   flutter_apns:
-    path: ../flutter_apns
+    path: ../flutter_apns

flutter_apns/CHANGELOG.md

@@ -1,7 +1,6 @@
 ### 1.5.2
 * update firebase dependencies
-* (#78) Do not hide push notification when opening app
-* Add readme: how to run example app
+* Add readme: how to run example app in iOS
 ### 1.5.1
 * (#58) fix unable to build android (update firebase dependencies)
 ### 1.5.0-dev.1

flutter_apns/README.md

@@ -1,14 +1,15 @@
 # apns
 
-Plugin to implement APNS push notifications on iOS and Firebase on Android. 
+Plugin to implement APNS push notifications on iOS and Firebase on Android.
 
 ## Why this plugin was made?
 
 Currently, the only available push notification plugin is `firebase_messaging`. This means that, even on iOS, you will need to setup firebase and communicate with Google to send push notification. This plugin solves the problem by providing native APNS implementation while leaving configured Firebase for Android.
 
 ## Usage
 1. Configure firebase on Android according to instructions: https://pub.dartlang.org/packages/firebase_messaging.
-2. On iOS, make sure you have correctly configured your app to support push notifications, and that you have generated certificate/token for sending pushes.
+2. On iOS, make sure you have correctly configured your app to support push notifications, and that you have generated certificate/token for sending pushes. For more infos see section [How to run example app on iOS](#how-to-run-example-app-on-ios)
+
 3. Add the following lines to the `didFinishLaunchingWithOptions` method in the AppDelegate.m/AppDelegate.swift file of your iOS project
 
 Objective-C:
@@ -38,7 +39,7 @@ connector.configure(
 );
 connector.requestNotificationPermissions()
 ```
-6. Build on device and test your solution using Firebase Console and NWPusher app.
+6. Build on device and test your solution using Firebase Console (Android) and CURL (iOS, see [How to run example app on iOS](#how-to-run-example-app-on-ios)).
 
 ## Additional APNS features:
 ### Displaying notification while in foreground
@@ -103,7 +104,7 @@ If you want to use firebase, but not firebase messaging, add this configuration
 <false/>
 ```
 
-## flutter_apns_only - APNS without firebase 
+## flutter_apns_only - APNS without firebase
 If only care about apns - use flutter_apns_only plugin. It does not depend on firebase. To ensure no swizzling (which is needed by original plugin to disable firebase) takes place, add this configuration entry in your Info.plist:
 
 ```plist
@@ -159,3 +160,50 @@ import Flutter
 
 @end
 ```
+## How to run example app on iOS
+Setting up push notifications on iOS can be tricky since there is no way to permit Apple Push Notification Service (APNS) which requires a complicated certificate setup. The following guide describes a step by step approach to send push notifications from your Mac to an iPhone utilizing the example app of this package. This guide only describes debug environment setup.
+
+1. Open example ios folder with Xcode
+2. Select Runner -> Signing & Capabilities
+3. Select your development team and add a globally unique bundle identifier. The one on the picture is already occupied:
+   ![](example/assets/Xcode_setup.png?raw=true)
+4. Go to https://developer.apple.com/account/resources/identifiers/list/bundleId and press on the plus button
+5. Select "App IDs" and press continue
+   ![](example/assets/register_app.png?raw=true)
+6. Select type "App"
+7. Select "App ID Prefix" which should be same as "Team ID"
+8. Enter description and bundle ID. The latter one needs to be the same as the bundle ID specified in 3.
+9. Select push notification capability
+   ![](example/assets/select_capability.png?raw=true)
+11. Press on "Continue" and then on "Register"
+12. Go to https://developer.apple.com/account/resources/certificates and add a new certificate by pressing on the plus-button.
+13. Select 'Apple Push Notification service SSL (Sandbox & Production)'
+    ![](example/assets/push_notification_setup.png?raw=true)
+14. Select the app ID that you hav defined in point 4.-10.
+15. Select a Certificate Signing Request (CSR) file. See https://help.apple.com/developer-account/#/devbfa00fef7 on how to create this certificate
+16. When having finished, download the newly created Apple Push Services certificate
+17. Add certificate to your local keychain by opening the newly downloaded file
+18. Press on "login" on the upper left corner of your keychain window and select the tab "My Certificates"
+    ![](example/assets/keychain.png?raw=true)
+19. Right click on the Apple-Push-Services-certificate and export it as .p12-file
+20. Convert p12-file to pem-file by following command. Please consider that "flutterApns" needs to be replaced by your respective certificate name.<br>
+    [More info](https://stackoverflow.com/questions/1762555/creating-pem-file-for-apns)
+    ```
+    openssl pkcs12 -in flutterApns.p12 -out flutterApns.pem -nodes -clcerts
+    ```
+21. Start example app on physical iPhone device from Xcode or your favorite IDE.
+22. Device token gets automatically printed when application was able to retrieve push token from APNS. This happens after accepting notification permission prompt.
+23. Send the following CURL from you development Mac. You can execute CURLs by copy-pasting them into Terminal and hit enter.<br>
+    [More info](https://gist.github.com/greencoder/16d1f8d7b0fed5b49cf64312ce2b72cc)
+    ```curl
+    curl -v \
+    -d '{"aps":{"alert":"<your_message>","badge":2}}' \
+    -H "apns-topic: <bundle_identifier_of_registered_app>" \
+    -H "apns-priority: 10" \
+    --http2 \
+    --cert <file_path_to_downloaded_sigxwned_and_converted_certificate>.pem \
+    https://api.development.push.apple.com/3/device/<device_token>
+    ```
+24. A push notification does appear if the example app is in background.
+
+When not utilizing the example app, you need to additionally [setup push notification capability inside Xcode](https://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns) and add the code mentioned in [usage](#usage).

flutter_apns/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_apns
 description: APNS push notification plugin. Uses firebase_messaging on Android, but replaces it on iOS with custom implementation.
-version: 1.5.2
+version: 1.5.3
 homepage: https://github.com/mwaylabs/flutter-apns
 
 environment:
@@ -12,7 +12,7 @@ dependencies:
     sdk: flutter
   firebase_core: ^1.11.0
   firebase_messaging: ^11.2.5
-  flutter_apns_only: ^1.5.2
+  flutter_apns_only: ^1.5.0
 
 dev_dependencies:
   flutter_test:

flutter_apns_only/CHANGELOG.md

@@ -1,6 +1,7 @@
 ## 1.5.2
 
 * upgraded together with flutter_apns
+* (#78) Do not hide push notification when opening app
 
 ## 1.5.0-dev.1