capacitor-google-navigation 0.0.6 → 0.0.8

package/README.md

@@ -490,6 +490,27 @@ The Android Navigation SDK validates the API key from `AndroidManifest.xml`. Ens
 **iOS — "This app has attempted to access privacy-sensitive data"**
 Add both `NSLocationWhenInUseUsageDescription` and `NSLocationAlwaysAndWhenInUseUsageDescription` to `Info.plist` before calling `initialize()`.
 
+**iOS — App crashes with "Invalid parameter not satisfying: CLClientIsBackgroundable"**
+The Navigation SDK requires background location capability to track position during guidance. In Xcode:
+1. Select your app target → **Signing & Capabilities** → **+ Capability** → **Background Modes**
+2. Check **Location updates**
+
+Also ensure all three keys are present in `Info.plist`:
+```xml
+<key>NSLocationWhenInUseUsageDescription</key>
+<string>This app uses your location for navigation.</string>
+<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
+<string>This app uses your location for navigation, including in the background.</string>
+<key>NSLocationAlwaysUsageDescription</key>
+<string>This app uses your location for navigation, including in the background.</string>
+```
+
+**iOS — "This application has been blocked by the Google Navigation SDK"**
+The Navigation SDK requires explicit enrollment — it is not available to all Google Cloud projects by default. Ensure:
+1. The **Navigation SDK for iOS** is enabled under APIs & Services → Library in Google Cloud Console
+2. Your project has been granted access (you may need to request it via the [Navigation SDK get started page](https://developers.google.com/maps/documentation/navigation/ios-sdk/get-started))
+3. Billing is active on the project
+
 **CocoaPods not found / pod install fails**
 Make sure CocoaPods is installed (`sudo gem install cocoapods`) and run `npx cap sync` before `pod install`.
 

package/android/src/main/java/com/attributeai/navigation/NavigationFragment.java

@@ -1,5 +1,6 @@
 package com.attributeai.navigation;
 
+import android.app.Activity;
 import android.graphics.Color;
 import android.graphics.Typeface;
 import android.os.Bundle;
@@ -25,6 +26,7 @@ import com.google.android.libraries.navigation.NavigationView;
 public class NavigationFragment extends Fragment {
 
     private NavigationView navigationView;
+    private Button closeButton;
     private Runnable onCloseListener;
 
     public static NavigationFragment newInstance() {
@@ -44,57 +46,29 @@ public class NavigationFragment extends Fragment {
     ) {
         navigationView = new NavigationView(requireContext());
         navigationView.onCreate(savedInstanceState);
-
-        FrameLayout root = new FrameLayout(requireContext());
-        root.addView(navigationView, new FrameLayout.LayoutParams(
-            FrameLayout.LayoutParams.MATCH_PARENT,
-            FrameLayout.LayoutParams.MATCH_PARENT
-        ));
-
-        Button closeButton = new Button(requireContext());
-        closeButton.setText("✕");
-        closeButton.setTextColor(Color.WHITE);
-        closeButton.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16);
-        closeButton.setTypeface(null, Typeface.BOLD);
-        closeButton.setBackgroundColor(Color.argb(153, 0, 0, 0)); // 60% black
-        closeButton.setOnClickListener(v -> {
-            if (onCloseListener != null) onCloseListener.run();
-        });
-
-        int sizePx = (int) TypedValue.applyDimension(
-            TypedValue.COMPLEX_UNIT_DIP, 40, getResources().getDisplayMetrics()
-        );
-        int marginPx = (int) TypedValue.applyDimension(
-            TypedValue.COMPLEX_UNIT_DIP, 16, getResources().getDisplayMetrics()
-        );
-
-        FrameLayout.LayoutParams btnParams = new FrameLayout.LayoutParams(sizePx, sizePx);
-        btnParams.gravity = Gravity.TOP | Gravity.START;
-        btnParams.topMargin = marginPx;
-        btnParams.leftMargin = marginPx;
-        root.addView(closeButton, btnParams);
-
-        return root;
-    }
-
-    @Override
-    public void onStart() {
-        super.onStart();
-        if (navigationView != null) navigationView.onStart();
+        return navigationView;
     }
 
     @Override
     public void onResume() {
         super.onResume();
         if (navigationView != null) navigationView.onResume();
+        attachCloseButtonToDecorView();
     }
 
     @Override
     public void onPause() {
+        detachCloseButtonFromDecorView();
         if (navigationView != null) navigationView.onPause();
         super.onPause();
     }
 
+    @Override
+    public void onStart() {
+        super.onStart();
+        if (navigationView != null) navigationView.onStart();
+    }
+
     @Override
     public void onStop() {
         if (navigationView != null) navigationView.onStop();
@@ -103,6 +77,7 @@ public class NavigationFragment extends Fragment {
 
     @Override
     public void onDestroyView() {
+        detachCloseButtonFromDecorView();
         if (navigationView != null) navigationView.onDestroy();
         super.onDestroyView();
     }
@@ -112,4 +87,51 @@ public class NavigationFragment extends Fragment {
         super.onSaveInstanceState(outState);
         if (navigationView != null) navigationView.onSaveInstanceState(outState);
     }
+
+    // MARK: - Close button attached to the Activity decor view, above all SDK UI
+
+    private void attachCloseButtonToDecorView() {
+        Activity activity = getActivity();
+        if (activity == null || closeButton != null) return;
+
+        int sizePx = (int) TypedValue.applyDimension(
+            TypedValue.COMPLEX_UNIT_DIP, 40, getResources().getDisplayMetrics()
+        );
+        int marginPx = (int) TypedValue.applyDimension(
+            TypedValue.COMPLEX_UNIT_DIP, 16, getResources().getDisplayMetrics()
+        );
+        int statusBarHeight = getStatusBarHeight(activity);
+
+        Button button = new Button(requireContext());
+        button.setText("✕");
+        button.setTextColor(Color.WHITE);
+        button.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16);
+        button.setTypeface(null, Typeface.BOLD);
+        button.setBackgroundColor(Color.argb(153, 0, 0, 0));
+        button.setOnClickListener(v -> {
+            if (onCloseListener != null) onCloseListener.run();
+        });
+
+        FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(sizePx, sizePx);
+        params.gravity = Gravity.TOP | Gravity.START;
+        params.topMargin = statusBarHeight + marginPx;
+        params.leftMargin = marginPx;
+
+        ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
+        decorView.addView(button, params);
+        this.closeButton = button;
+    }
+
+    private void detachCloseButtonFromDecorView() {
+        Activity activity = getActivity();
+        if (activity == null || closeButton == null) return;
+        ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
+        decorView.removeView(closeButton);
+        closeButton = null;
+    }
+
+    private int getStatusBarHeight(Activity activity) {
+        int resourceId = activity.getResources().getIdentifier("status_bar_height", "dimen", "android");
+        return resourceId > 0 ? activity.getResources().getDimensionPixelSize(resourceId) : 0;
+    }
 }

package/ios/Sources/GoogleNavigationPlugin/NavigationViewController.swift

@@ -5,6 +5,7 @@ import GoogleNavigation
 class NavigationMapViewController: UIViewController {
     private let session: GMSNavigationSession
     private var mapView: GMSMapView?
+    private var overlayWindow: UIWindow?
     var onDismiss: (() -> Void)?
 
     init(session: GMSNavigationSession) {
@@ -17,26 +18,51 @@ class NavigationMapViewController: UIViewController {
     }
 
     override func loadView() {
+        let container = UIView(frame: UIScreen.main.bounds)
+
         let options = GMSMapViewOptions()
-        options.frame = UIScreen.main.bounds
+        options.frame = container.bounds
         let mapView = GMSMapView(options: options)
+        mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        container.addSubview(mapView)
         self.mapView = mapView
-        self.view = mapView
+
+        self.view = container
     }
 
     override func viewDidLoad() {
         super.viewDidLoad()
-
         guard let mapView = mapView else { return }
         let enabled = mapView.enableNavigation(with: session)
         if enabled {
             mapView.cameraMode = .following
         }
+    }
 
-        addCloseButton()
+    override func viewDidAppear(_ animated: Bool) {
+        super.viewDidAppear(animated)
+        addCloseButtonWindow()
     }
 
-    private func addCloseButton() {
+    override func viewDidDisappear(_ animated: Bool) {
+        super.viewDidDisappear(animated)
+        tearDownCloseButtonWindow()
+    }
+
+    // MARK: - Close button in a top-level UIWindow above all SDK UI
+
+    private func addCloseButtonWindow() {
+        guard let scene = view.window?.windowScene else { return }
+
+        let window = UIWindow(windowScene: scene)
+        window.windowLevel = .alert + 1
+        window.backgroundColor = .clear
+        window.isHidden = false
+
+        let overlayVC = UIViewController()
+        overlayVC.view.backgroundColor = .clear
+        window.rootViewController = overlayVC
+
         let button = UIButton(type: .system)
         button.setImage(UIImage(systemName: "xmark"), for: .normal)
         button.tintColor = .white
@@ -44,17 +70,25 @@ class NavigationMapViewController: UIViewController {
         button.layer.cornerRadius = 20
         button.translatesAutoresizingMaskIntoConstraints = false
         button.addTarget(self, action: #selector(closeTapped), for: .touchUpInside)
-        view.addSubview(button)
+        overlayVC.view.addSubview(button)
 
         NSLayoutConstraint.activate([
-            button.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor, constant: 16),
-            button.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 16),
+            button.topAnchor.constraint(equalTo: overlayVC.view.safeAreaLayoutGuide.topAnchor, constant: 16),
+            button.leadingAnchor.constraint(equalTo: overlayVC.view.leadingAnchor, constant: 16),
             button.widthAnchor.constraint(equalToConstant: 40),
-            button.heightAnchor.constraint(equalToConstant: 40)
+            button.heightAnchor.constraint(equalToConstant: 40),
         ])
+
+        self.overlayWindow = window
+    }
+
+    private func tearDownCloseButtonWindow() {
+        overlayWindow?.isHidden = true
+        overlayWindow = nil
     }
 
     @objc private func closeTapped() {
+        tearDownCloseButtonWindow()
         dismiss(animated: true) { [weak self] in
             self?.onDismiss?()
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-google-navigation",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Google maps turn by turn navigation for capcitor",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",