Add ability to add custom buttons to application navigation bar (#266)

* initial implementation

added config KEY_CONFIG_CUSTOM_APP_NAV_BAR(android) and PTCustomAppNavBarKey(iOS)

dart implementation as well

* dart implementation

changed to customTopToolbar in dart for clarity of what's being implemented

* updated config.dart

no more needed customTopToolbar
(there is topAppRightNavBar)

* added android partial implementation

added rightbaritems and plugin utils, initial implementation of custom item added to android app bar

removed some ios classes due to having available api

* iOS implementation of customToolbarItems in topnavbarrightbar

* Updating package version

* fixed some naming conventions in applyViewerSettings

fixed some naming conventions in applyViewerSettings

* Updating pubspec.yaml

* Updating package version

* removed random blank lines and removed empty class button

also removed commented code and fixed return on getter of getAppNavBarRightBarItems()

* Updating pubspec.yaml

* Updating package version

* hygen generated appBarButtonPressed eventlistener

* Updating pubspec.yaml

* Updating package version

* handleAppBarButtonItemPressed w/ event sink

android side of handling app bar button event pressed

* Updating pubspec.yaml

* Updating package version

* iOS

appbarbutton event sink changes

* Updating pubspec.yaml

* Updating package version

* update config.dart

* Updating package version

* handle orientation bug

* Updating package version

* Updating pubspec.yaml

* Updating package version

* ios naming to seperate barButtonItems and appBarButtonItems

* Updating pubspec.yaml

* Updating package version

* unified function for handling custom app bar button

unified function for handling custom app bar button

* Updating pubspec.yaml

* Updating package version

* update handleCustomAppBarButton visibility

change to private

* Updating pubspec.yaml

* Updating package version

* Set tag on bar button item

* Updating package version

* Updating pubspec.yaml

* Updating package version

* formatting fix

blank spaces

* Updating pubspec.yaml

* Updating package version

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: dluco <[email protected]>

Author: 3 people

.dart_tool/version

@@ -1 +1 @@
-3.0.5
+3.3.2

android/src/main/java/com/pdftron/pdftronflutter/FlutterDocumentActivity.java

@@ -2,6 +2,7 @@
 
 import android.content.Context;
 import android.content.Intent;
+import android.content.res.Configuration;
 import android.net.Uri;
 import android.os.Bundle;
 import android.view.MenuItem;
@@ -38,6 +39,7 @@
 import io.flutter.plugin.common.MethodChannel.Result;
 
 import static com.pdftron.pdftronflutter.helpers.PluginUtils.handleAnnotationCustomToolbarItemPressed;
+import static com.pdftron.pdftronflutter.helpers.PluginUtils.handleAppBarButtonPressed;
 import static com.pdftron.pdftronflutter.helpers.PluginUtils.handleLeadingNavButtonPressed;
 
 public class FlutterDocumentActivity extends DocumentActivity implements ViewerComponent {
@@ -86,6 +88,7 @@ public class FlutterDocumentActivity extends DocumentActivity implements ViewerC
     private static AtomicReference<EventSink> sScrollChangedEventEmitter = new AtomicReference<>();
 
     // Hygen Generated Event Listeners (1)
+    private static AtomicReference<EventSink> sAppBarButtonPressedEventEmitter = new AtomicReference<>();
 
     private static HashMap<Annot, Integer> mSelectedAnnots;
 
@@ -259,6 +262,10 @@ public static void setScrollChangedEventEmitter(EventSink emitter) {
     }
 
     // Hygen Generated Event Listeners (2)
+    public static void setAppBarButtonPressedEventEmitter(EventSink emitter) {
+        sAppBarButtonPressedEventEmitter.set(emitter);
+    }
+
 
     public static void setFlutterLoadResult(Result result) {
         sFlutterLoadResult.set(result);
@@ -346,6 +353,11 @@ public EventSink getAnnotationToolbarItemPressedEventEmitter() {
     public EventSink getScrollChangedEventEmitter() { return sScrollChangedEventEmitter.get(); }
 
     // Hygen Generated Event Listeners (3)
+    @Override
+    public EventSink getAppBarButtonPressedEventEmitter() {
+        return sAppBarButtonPressedEventEmitter.get();
+    }
+
 
     @Override
     public Result getFlutterLoadResult() {
@@ -387,13 +399,24 @@ public ArrayList<String> getAnnotationMenuOverrideItems() {
         return mAnnotationMenuOverrideItems;
     }
 
+    @Override
+    public ArrayList<String> getAppNavRightBarItems() {
+        return new ArrayList<>();
+    }
+
     @Override
     protected void onCreate(@Nullable Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
 
         attachActivity();
     }
 
+    @Override
+    public void onConfigurationChanged(@NonNull Configuration newConfig) {
+        PluginUtils.handleOnConfigurationChanged(this);
+        super.onConfigurationChanged(newConfig);
+    }
+
     @Override
     protected void onDestroy() {
         PluginUtils.handleOnDetach(this);
@@ -417,6 +440,7 @@ protected void onDestroy() {
         sScrollChangedEventEmitter.set(null);
 
         // Hygen Generated Event Listeners (4)
+        sAppBarButtonPressedEventEmitter.set(null);
 
         detachActivity();
     }
@@ -468,6 +492,7 @@ public void onNavButtonPressed() {
     @Override
     public boolean onToolbarOptionsItemSelected(MenuItem item) {
         handleAnnotationCustomToolbarItemPressed(this, item);
+        handleAppBarButtonPressed(this, item);
         return super.onToolbarOptionsItemSelected(item);
     }
 

android/src/main/java/com/pdftron/pdftronflutter/FlutterDocumentView.java

@@ -33,6 +33,7 @@
 import static com.pdftron.pdftronflutter.helpers.PluginUtils.EVENT_ANNOTATION_TOOLBAR_ITEM_PRESSED;
 
 // Hygen Generated Event Listeners (1)
+import static com.pdftron.pdftronflutter.helpers.PluginUtils.EVENT_APP_BAR_BUTTON_PRESSED;
 
 import static com.pdftron.pdftronflutter.helpers.PluginUtils.FUNCTION_OPEN_DOCUMENT;
 import static com.pdftron.pdftronflutter.helpers.PluginUtils.FUNCTION_SET_LEADING_NAV_BUTTON_ICON;
@@ -272,6 +273,18 @@ public void onCancel(Object arguments) {
         });
 
         // Hygen Generated Event Listeners (2)
+        final EventChannel appBarButtonPressedEventChannel = new EventChannel(messenger, EVENT_APP_BAR_BUTTON_PRESSED);
+        appBarButtonPressedEventChannel.setStreamHandler(new EventChannel.StreamHandler() {
+            @Override
+            public void onListen(Object arguments, EventChannel.EventSink emitter) {
+                documentView.setAppBarButtonPressedEventEmitter(emitter);
+            }
+
+            @Override
+            public void onCancel(Object arguments) {
+                documentView.setAppBarButtonPressedEventEmitter(null);
+            }
+        });
     }
 
     @Override

android/src/main/java/com/pdftron/pdftronflutter/helpers/PluginMethodCallHandler.java

@@ -12,6 +12,7 @@
 import io.flutter.plugin.common.MethodChannel.MethodCallHandler;
 import io.flutter.plugin.common.MethodChannel.Result;
 
+import static com.pdftron.pdftronflutter.helpers.PluginUtils.EVENT_APP_BAR_BUTTON_PRESSED;
 import static com.pdftron.pdftronflutter.helpers.PluginUtils.EVENT_SCROLL_CHANGED;
 import static com.pdftron.pdftronflutter.helpers.PluginUtils.FUNCTION_GET_PLATFORM_VERSION;
 import static com.pdftron.pdftronflutter.helpers.PluginUtils.FUNCTION_GET_VERSION;
@@ -257,6 +258,20 @@ public void onCancel(Object arguments) {
                 FlutterDocumentActivity.setScrollChangedEventEmitter(null);
             }
         });
+
+        final EventChannel appBarButtonPressedPressedEventChannel = new EventChannel(messenger,
+                EVENT_APP_BAR_BUTTON_PRESSED);
+        appBarButtonPressedPressedEventChannel.setStreamHandler(new EventChannel.StreamHandler() {
+            @Override
+            public void onListen(Object arguments, EventChannel.EventSink emitter) {
+                FlutterDocumentActivity.setAppBarButtonPressedEventEmitter(emitter);
+            }
+
+            @Override
+            public void onCancel(Object arguments) {
+                FlutterDocumentActivity.setAppBarButtonPressedEventEmitter(null);
+            }
+        });
     }
 
     @Override