Android integration - tech demo

app/src/main/AndroidManifest.xml

@@ -46,6 +46,23 @@
             </intent-filter>
         </activity>
 
+        <activity
+            android:name=".ui.files.ShareTargetActivity"
+            android:exported="true"
+            android:excludeFromRecents="true"
+            android:theme="@style/Theme.NetBird.NoActionBar">
+            <intent-filter>
+                <action android:name="android.intent.action.SEND" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <data android:mimeType="*/*" />
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.SEND_MULTIPLE" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <data android:mimeType="*/*" />
+            </intent-filter>
+        </activity>
+
         <!-- Persists the in-app language choice on API < 33 (AppCompat per-app locales). -->
         <service
             android:name="androidx.appcompat.app.AppLocalesMetadataHolderService"

app/src/main/java/io/netbird/client/MainActivity.java

@@ -1,15 +1,18 @@
 package io.netbird.client;
 
+import android.Manifest;
 import android.animation.StateListAnimator;
 import android.app.Activity;
 import android.content.ComponentName;
 import android.content.Context;
 import android.content.Intent;
 import android.content.ServiceConnection;
 import android.content.pm.ActivityInfo;
+import android.content.pm.PackageManager;
 import android.content.res.Configuration;
 import android.graphics.drawable.ColorDrawable;
 import android.net.Uri;
+import android.os.Build;
 import android.os.Bundle;
 import android.os.IBinder;
 import android.text.Html;
@@ -53,10 +56,12 @@
 import io.netbird.client.tool.SessionEventListener;
 import io.netbird.client.tool.VPNService;
 import io.netbird.client.ui.PreferenceUI;
+import io.netbird.client.tool.files.FileDropManager;
 import io.netbird.client.ui.ssh.SshSessionManager;
 import io.netbird.gomobile.android.Android;
 import io.netbird.gomobile.android.ConnectionListener;
 import io.netbird.gomobile.android.ErrListener;
+import io.netbird.gomobile.android.FileDrop;
 import io.netbird.gomobile.android.NetworkArray;
 import io.netbird.gomobile.android.PeerInfoArray;
 import io.netbird.gomobile.android.SSHClient;
@@ -78,6 +83,7 @@ private enum ConnectionState {
     private final static String LOGTAG = "NBMainActivity";
     private VPNService.MyLocalBinder mBinder;
     private SshSessionManager.ClientFactory sshClientFactory;
+    private ActivityResultLauncher<String> notificationPermissionLauncher;
 
     private AppBarConfiguration mAppBarConfiguration;
     private ActivityMainBinding binding;
@@ -150,6 +156,10 @@ public void onServiceConnected(ComponentName className, IBinder binder) {
                 pendingExtendRequest = false;
                 extendSession();
             }
+
+            // The transfer list is only readable through the binder, so a
+            // fragment that opened before this point is still showing nothing.
+            FileDropManager.get().refresh();
         }
 
         @Override
@@ -206,11 +216,12 @@ public boolean canConnect() {
         NavigationBarView bottomNav = (NavigationBarView) binding.bottomNav;
 
         // All four bottom-nav destinations are top-level — no Up arrow on those.
+        // BottomNavigationView rejects a sixth item outright, so anything beyond
+        // these lives under Settings and keeps its Up arrow.
         final Set<Integer> topLevelDestinations = new HashSet<>();
         topLevelDestinations.add(R.id.nav_home);
         topLevelDestinations.add(R.id.nav_peers);
-        topLevelDestinations.add(R.id.nav_networks);
-        topLevelDestinations.add(R.id.nav_ssh_sessions);
+        topLevelDestinations.add(R.id.nav_apps);
         topLevelDestinations.add(R.id.nav_settings);
         mAppBarConfiguration = new AppBarConfiguration.Builder(topLevelDestinations).build();
         navController = Navigation.findNavController(this, R.id.nav_host_fragment_content_main);
@@ -245,14 +256,13 @@ public boolean canConnect() {
             }
             bottomNav.setVisibility(View.VISIBLE);
 
-            // Home, Peers and Networks don't need a toolbar — bottom nav already
-            // identifies the screen. Sub-screens keep the toolbar with title + Up
-            // arrow. SSH sessions and Settings are the exceptions among the tabs:
-            // both are lists that run to the top of the screen, and without a title
-            // bar to anchor them the first row reads as cut off rather than as the
-            // start of a list.
+            // Home, Peers and Apps don't need a toolbar — bottom nav already
+            // identifies the screen, and Apps carries its own segmented control at
+            // the top. Sub-screens keep the toolbar with title + Up arrow. Settings
+            // is the exception among the tabs: it is a list that runs to the top of
+            // the screen, and without a title bar to anchor it the first row reads
+            // as cut off rather than as the start of a list.
             boolean hideToolbar = topLevelDestinations.contains(destId)
-                    && destId != R.id.nav_ssh_sessions
                     && destId != R.id.nav_settings;
             setToolbarVisible(!hideToolbar);
 
@@ -324,6 +334,17 @@ public void onLoginSuccess() {
         // opener must be built here, not lazily at tap time.
         extendUrlOpener = buildExtendURLOpener();
 
+        // Asked once, on the first launch that can act on it: without it every
+        // notify() this app makes is dropped silently on API 33+, which takes
+        // the file drop consent prompt and transfer progress with it.
+        notificationPermissionLauncher = registerForActivityResult(
+                new ActivityResultContracts.RequestPermission(),
+                granted -> {
+                    if (!granted) {
+                        Log.i(LOGTAG, "notification permission denied");
+                    }
+                });
+
         // VPN permission result launcher
         vpnActivityResultLauncher = registerForActivityResult(
                 new ActivityResultContracts.StartActivityForResult(),
@@ -358,9 +379,26 @@ public void onLoginSuccess() {
             showFirstInstallFragment();
         }
 
+        requestNotificationPermission();
         handleSessionIntent(getIntent());
     }
 
+    /**
+     * Asks for POST_NOTIFICATIONS when the platform requires it. Everything this
+     * app notifies about — session expiry, incoming files, transfer progress —
+     * is dropped silently without it.
+     */
+    private void requestNotificationPermission() {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
+            return;
+        }
+        if (ContextCompat.checkSelfPermission(this, Manifest.permission.POST_NOTIFICATIONS)
+                == PackageManager.PERMISSION_GRANTED) {
+            return;
+        }
+        notificationPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS);
+    }
+
     @Override
     protected void onNewIntent(Intent intent) {
         super.onNewIntent(intent);
@@ -595,6 +633,20 @@ public SSHClient newSSHClient() {
         return mBinder.newSSHClient();
     }
 
+    @Override
+    public FileDrop fileDrop() {
+        if (mBinder == null) {
+            Log.w(LOGTAG, "VPN binder is null");
+            return null;
+        }
+        try {
+            return mBinder.fileDrop();
+        } catch (Exception e) {
+            Log.e(LOGTAG, "failed to open file drop", e);
+            return null;
+        }
+    }
+
     private boolean isEngineRunning() {
         return mBinder != null && mBinder.isRunning();
     }

app/src/main/java/io/netbird/client/ServiceAccessor.java

@@ -3,6 +3,7 @@
 import androidx.annotation.Nullable;
 
 import io.netbird.client.tool.RouteChangeListener;
+import io.netbird.gomobile.android.FileDrop;
 import io.netbird.gomobile.android.NetworkArray;
 import io.netbird.gomobile.android.PeerInfoArray;
 import io.netbird.gomobile.android.SSHClient;
@@ -38,5 +39,12 @@ public interface ServiceAccessor {
 
     SSHClient newSSHClient();
 
+    /**
+     * File drop handle of the active profile, or null while the VPN service is
+     * not bound. Usable with the engine stopped; only sending needs the tunnel.
+     */
+    @Nullable
+    FileDrop fileDrop();
+
     URLOpener getSSHURLOpener();
 }

app/src/main/java/io/netbird/client/ui/SegmentedSwitch.java

@@ -0,0 +1,126 @@
+package io.netbird.client.ui;
+
+import android.content.Context;
+import android.content.res.ColorStateList;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.animation.PathInterpolator;
+import android.widget.FrameLayout;
+import android.widget.TextView;
+
+import androidx.core.content.ContextCompat;
+
+import io.netbird.client.R;
+
+/**
+ * Two-way segmented control: a track laid out by {@code bg_segmented_track}
+ * holding a thumb and two labels, with the thumb sliding between them.
+ * <p>
+ * The view ids are passed in rather than fixed, so one implementation serves
+ * every segmented control in the app. {@link io.netbird.client.ui.server.ManagementServerSwitch}
+ * predates this and keeps its own copy along with the Cloud logo it draws.
+ */
+public final class SegmentedSwitch {
+
+    public interface OnSelectionChangedListener {
+        void onSelectionChanged(boolean second);
+    }
+
+    private static final long SLIDE_DURATION_MS = 180;
+
+    private final Context context;
+    private final FrameLayout track;
+    private final View thumb;
+    private final TextView firstLabel;
+    private final TextView secondLabel;
+    private final OnSelectionChangedListener listener;
+
+    private boolean second;
+    // True while the slide animation owns translationX, so a layout pass
+    // triggered mid-slide cannot snap the thumb back.
+    private boolean sliding;
+
+    public SegmentedSwitch(View root, int trackId, int thumbId, int firstButtonId,
+                           int firstLabelId, int secondButtonId, int secondLabelId,
+                           OnSelectionChangedListener listener) {
+        this.context = root.getContext();
+        this.listener = listener;
+
+        track = root.findViewById(trackId);
+        thumb = root.findViewById(thumbId);
+        firstLabel = root.findViewById(firstLabelId);
+        secondLabel = root.findViewById(secondLabelId);
+
+        track.addOnLayoutChangeListener((v, l, t, r, b, ol, ot, or, ob) -> {
+            int half = halfWidth();
+            if (half <= 0 || sliding) {
+                return;
+            }
+            ViewGroup.LayoutParams lp = thumb.getLayoutParams();
+            if (lp.width != half) {
+                lp.width = half;
+                thumb.setLayoutParams(lp);
+            }
+            thumb.setTranslationX(restingOffset(half));
+        });
+
+        root.findViewById(firstButtonId).setOnClickListener(v -> select(false, true));
+        root.findViewById(secondButtonId).setOnClickListener(v -> select(true, true));
+        applyLabelColors();
+    }
+
+    public boolean isSecondSelected() {
+        return second;
+    }
+
+    /** Selects a segment without animating or notifying, for initial state. */
+    public void selectSilently(boolean second) {
+        select(second, false);
+    }
+
+    private void select(boolean second, boolean notify) {
+        if (this.second == second) {
+            return;
+        }
+        this.second = second;
+
+        if (notify) {
+            sliding = true;
+            thumb.animate()
+                    .translationX(restingOffset(halfWidth()))
+                    .setDuration(SLIDE_DURATION_MS)
+                    .setInterpolator(new PathInterpolator(0.2f, 0f, 0f, 1f))
+                    .withEndAction(() -> sliding = false)
+                    .start();
+        } else {
+            // No measured width yet at seed time; the layout listener places
+            // the thumb once the track is laid out.
+            thumb.setTranslationX(restingOffset(halfWidth()));
+        }
+
+        applyLabelColors();
+        if (notify && listener != null) {
+            listener.onSelectionChanged(second);
+        }
+    }
+
+    private void applyLabelColors() {
+        ColorStateList active = ContextCompat.getColorStateList(context, R.color.nb_txt);
+        ColorStateList inactive = ContextCompat.getColorStateList(context, R.color.nb_txt_light);
+        firstLabel.setTextColor(second ? inactive : active);
+        secondLabel.setTextColor(second ? active : inactive);
+    }
+
+    private int halfWidth() {
+        return (track.getWidth() - track.getPaddingLeft() - track.getPaddingRight()) / 2;
+    }
+
+    /** Resting X offset of the thumb for the current selection, in pixels. */
+    private float restingOffset(int width) {
+        if (!second) {
+            return 0f;
+        }
+        boolean rtl = track.getLayoutDirection() == View.LAYOUT_DIRECTION_RTL;
+        return rtl ? -width : width;
+    }
+}

app/src/main/java/io/netbird/client/ui/apps/AppsFragment.java

@@ -0,0 +1,70 @@
+package io.netbird.client.ui.apps;
+
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.fragment.app.Fragment;
+
+import io.netbird.client.R;
+import io.netbird.client.databinding.FragmentAppsBinding;
+import io.netbird.client.ui.SegmentedSwitch;
+
+/**
+ * Hosts SSH and Files as two halves of one screen. Both are their own
+ * fragments, unchanged and still reachable on their own; this only decides
+ * which of the two is showing, so the bottom navigation spends a single slot
+ * on them.
+ */
+public class AppsFragment extends Fragment {
+
+    private static final String STATE_SHOWING_FILES = "showing_files";
+
+    private FragmentAppsBinding binding;
+    private boolean showingFiles;
+
+    @Override
+    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
+                             @Nullable Bundle savedInstanceState) {
+        binding = FragmentAppsBinding.inflate(inflater, container, false);
+        return binding.getRoot();
+    }
+
+    @Override
+    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
+        super.onViewCreated(view, savedInstanceState);
+
+        SegmentedSwitch segments = new SegmentedSwitch(view, R.id.toggle_ssh_files,
+                R.id.segment_thumb, R.id.btn_view_ssh, R.id.label_view_ssh,
+                R.id.btn_view_files, R.id.label_view_files, this::showFiles);
+
+        if (savedInstanceState != null && savedInstanceState.getBoolean(STATE_SHOWING_FILES)) {
+            segments.selectSilently(true);
+            showFiles(true);
+        }
+    }
+
+    @Override
+    public void onSaveInstanceState(@NonNull Bundle outState) {
+        super.onSaveInstanceState(outState);
+        outState.putBoolean(STATE_SHOWING_FILES, showingFiles);
+    }
+
+    @Override
+    public void onDestroyView() {
+        binding = null;
+        super.onDestroyView();
+    }
+
+    private void showFiles(boolean files) {
+        if (binding == null) {
+            return;
+        }
+        showingFiles = files;
+        binding.sshContainer.setVisibility(files ? View.GONE : View.VISIBLE);
+        binding.filesContainer.setVisibility(files ? View.VISIBLE : View.GONE);
+    }
+}