Integrate setup carousel, enhance diagnostics, and UI refinements

app/build.gradle.kts

@@ -43,6 +43,8 @@ android {
 }
 
 dependencies {
+    implementation("androidx.viewpager2:viewpager2:1.0.0")
+
     // Shizuku API
     implementation("dev.rikka.shizuku:api:13.1.5")
     implementation("dev.rikka.shizuku:provider:13.1.5")

app/src/main/java/com/dhangofa/networktoggle/MainActivity.java

@@ -29,9 +29,16 @@
 import android.os.Bundle;
 import android.view.View;
 import android.widget.ImageView;
+import android.widget.LinearLayout;
 import android.widget.RadioButton;
 import android.widget.RadioGroup;
 import android.widget.TextView;
+import androidx.viewpager2.widget.ViewPager2;
+import com.dhangofa.networktoggle.ui.SetupCarouselAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
 
 import com.dhangofa.networktoggle.config.AppPreferences;
 import com.dhangofa.networktoggle.model.ExecutionMode;
@@ -72,6 +79,10 @@ public class MainActivity extends Activity implements android.content.SharedPref
     private RadioButton radioSim1;
     private RadioButton radioSim2;
     private TextView autoSimWarningText;
+    private ViewPager2 setupCarouselPager;
+    private android.widget.LinearLayout setupCarouselContainer;
+    private LinearLayout carouselIndicators;
+    private ImageView faqLink;
 
 	private View separatorRootShizuku;
     private View separatorAutoSim1;
@@ -166,6 +177,84 @@ protected void onCreate(Bundle savedInstanceState) {
 		updateSeparatorVisibility();
     }
 
+    private void setupCarousel() {
+        List<SetupCarouselAdapter.SetupItem> carouselItems = new ArrayList<>();
+        carouselItems.add(new SetupCarouselAdapter.SetupItem("New to NetToggle?", "Learn how to set up Execution Modes", "Read Guide", "https://github.com/Dhangofa/NetToggle/wiki/1.-Execution-Mode-Configuration", R.drawable.ic_terminal, R.color.first_pg_bg, R.color.exec_accent, R.color.view_guide_button_bg));
+        carouselItems.add(new SetupCarouselAdapter.SetupItem("Target SIM & Cycle", "Learn how to configure your modes", "Read Guide", "https://github.com/Dhangofa/NetToggle/wiki/2.-Target-SIM-Setup-&-Quick-Tile-Cycle-Guide", R.drawable.ic_sim_card, R.color.second_pg_bg, R.color.accent_orange, R.color.view_guide_button_bg));
+        carouselItems.add(new SetupCarouselAdapter.SetupItem("Quick Settings Ready", "Add the tile to your Control Center", "View Guide", "https://github.com/Dhangofa/NetToggle/wiki/3.-Adding-the-Tile-to-Quick-Settings", R.drawable.ic_network_bars, R.color.third_pg_bg, R.color.accent_pink, R.color.view_guide_button_bg));
+
+        if (setupCarouselContainer != null) {
+            setupCarouselContainer.removeAllViews();
+            for (int i = 0; i < carouselItems.size(); i++) {
+                SetupCarouselAdapter.SetupItem item = carouselItems.get(i);
+                View view = getLayoutInflater().inflate(R.layout.item_setup_carousel, setupCarouselContainer, false);
+                android.widget.LinearLayout.LayoutParams params = new android.widget.LinearLayout.LayoutParams(0, android.widget.LinearLayout.LayoutParams.WRAP_CONTENT, 1.0f);
+                if (i > 0) params.setMarginStart(12);
+                if (i < carouselItems.size() - 1) params.setMarginEnd(12);
+                view.setLayoutParams(params);
+
+                ((TextView) view.findViewById(R.id.carouselTitle)).setText(item.title);
+                ((TextView) view.findViewById(R.id.carouselDesc)).setText(item.description);
+                ((TextView) view.findViewById(R.id.carouselButtonText)).setText(item.buttonText);
+                ((TextView) view.findViewById(R.id.carouselButtonText)).setTextColor(getColor(item.accentColorRes));
+
+                ImageView icon = view.findViewById(R.id.carouselIcon);
+                icon.setImageResource(item.iconRes);
+                icon.setColorFilter(getColor(item.accentColorRes));
+
+                ImageView btnIcon = view.findViewById(R.id.carouselButtonIcon);
+                btnIcon.setColorFilter(getColor(item.accentColorRes));
+
+                view.findViewById(R.id.carouselBackground).setBackgroundTintList(android.content.res.ColorStateList.valueOf(getColor(item.bgColorRes)));
+                view.findViewById(R.id.carouselButton).setBackgroundTintList(android.content.res.ColorStateList.valueOf(getColor(item.btnBgColorRes)));
+                view.findViewById(R.id.carouselIconContainer).setBackgroundTintList(android.content.res.ColorStateList.valueOf(getColor(item.btnBgColorRes)));
+
+                view.findViewById(R.id.carouselButton).setOnClickListener(v -> {
+                    try { startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(item.url))); } catch (Exception e) {}
+                });
+
+                setupCarouselContainer.addView(view);
+            }
+        } else if (setupCarouselPager != null) {
+            SetupCarouselAdapter adapter = new SetupCarouselAdapter(this, carouselItems);
+            setupCarouselPager.setAdapter(adapter);
+            setupCarouselIndicators(carouselItems.size());
+            setupCarouselPager.registerOnPageChangeCallback(new ViewPager2.OnPageChangeCallback() {
+                @Override
+                public void onPageSelected(int position) {
+                    super.onPageSelected(position);
+                    updateCarouselIndicators(position);
+                }
+            });
+        }
+    }
+
+
+    private void setupCarouselIndicators(int count) {
+        if (carouselIndicators == null) return;
+        carouselIndicators.removeAllViews();
+        for (int i = 0; i < count; i++) {
+            android.widget.ImageView dot = new android.widget.ImageView(this);
+            dot.setImageDrawable(getDrawable(R.drawable.shape_dot_inactive));
+            android.widget.LinearLayout.LayoutParams params = new android.widget.LinearLayout.LayoutParams(16, 16);
+            params.setMargins(8, 0, 8, 0);
+            dot.setLayoutParams(params);
+            carouselIndicators.addView(dot);
+        }
+    }
+
+    private void updateCarouselIndicators(int position) {
+        if (carouselIndicators == null) return;
+        for (int i = 0; i < carouselIndicators.getChildCount(); i++) {
+            android.widget.ImageView dot = (android.widget.ImageView) carouselIndicators.getChildAt(i);
+            if (i == position) {
+                dot.setImageDrawable(getDrawable(R.drawable.shape_dot_active));
+            } else {
+                dot.setImageDrawable(getDrawable(R.drawable.shape_dot_inactive));
+            }
+        }
+    }
+
     private void configureStatusBar() {
         if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) return;
 
@@ -177,6 +266,11 @@ private void configureStatusBar() {
     }
 
     private void bindViews() {
+        setupCarouselPager = findViewById(R.id.setupCarouselPager);
+        setupCarouselContainer = findViewById(R.id.setupCarouselContainer);
+        carouselIndicators = findViewById(R.id.carouselIndicators);
+        faqLink = findViewById(R.id.faqLink);
+        setupCarousel();
         radioGroup = findViewById(R.id.modeRadioGroup);
         radioRoot = findViewById(R.id.radioRoot);
         radioShizuku = findViewById(R.id.radioShizuku);
@@ -202,6 +296,12 @@ private void bindViews() {
     }
 
     private void bindLinks() {
+        if (faqLink != null) {
+            faqLink.setOnClickListener(v -> {
+                Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse("https://github.com/Dhangofa/NetToggle/wiki/Frequently-Asked-Questions-(FAQ)"));
+                try { startActivity(browserIntent); } catch (Exception e) { android.widget.Toast.makeText(MainActivity.this, "No web browser installed to open this link.", android.widget.Toast.LENGTH_SHORT).show(); }
+            });
+        }
         githubLink.setOnClickListener(v -> openUrl("https://github.com/Dhangofa/NetToggle"));
         telegramLink.setOnClickListener(v -> openUrl("https://t.me/dhangofas_projects_chat"));
     }
@@ -551,6 +651,9 @@ private void setStatus(String text, int color) {
 
 	private boolean isUIAuthorized = true;
 	private void updateAuthorizationUI(boolean authorized) {
+        if (setupCarouselPager != null) {
+            setupCarouselPager.setCurrentItem(authorized ? 2 : 0, true);
+        }
 	    if (isUIAuthorized == authorized) return;
 	    isUIAuthorized = authorized;
 
@@ -587,6 +690,7 @@ private void openUrl(String url) {
         try {
             startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(url)));
         } catch (Exception ignored) {
+            android.widget.Toast.makeText(MainActivity.this, "No web browser installed to open this link.", android.widget.Toast.LENGTH_SHORT).show();
         }
     }
 

app/src/main/java/com/dhangofa/networktoggle/NetworkTileService.java

@@ -188,7 +188,7 @@ public void onClick() {
 
                 if (!isAuthError) {
                     appPreferences.setTileErrorState(AppPreferences.TILE_ERROR_CMD);
-                    appPreferences.setLastError(result.getCommand(), result.getStderr());
+                    appPreferences.setLastError(result.getCommand(), result.getExitCode(), result.getStdout(), result.getStderr(), result.getExceptionMessage());
                 }
 
                 mainHandler.post(() -> {

app/src/main/java/com/dhangofa/networktoggle/config/AppPreferences.java

@@ -87,21 +87,29 @@ public void setAutoSimError(boolean hasError) {
         preferences.edit().putBoolean(KEY_AUTO_SIM_ERROR, hasError).apply();
     }
 
-    public void setLastError(String command, String stderr) {
+    public void setLastError(String command, int exitCode, String stdout, String stderr, String exceptionMsg) {
         preferences.edit()
                 .putString(KEY_LAST_ERROR_CMD, command)
+                .putInt("last_error_exit_code", exitCode)
+                .putString("last_error_stdout", stdout)
+
                 .putString(KEY_LAST_ERROR_STDERR, stderr)
+                .putString("last_error_exception", exceptionMsg)
+
                 .putLong(KEY_LAST_ERROR_TIMESTAMP, System.currentTimeMillis())
                 .apply();
     }
 
     public com.dhangofa.networktoggle.model.DiagnosticError getLastError() {
         String cmd = preferences.getString(KEY_LAST_ERROR_CMD, null);
         String stderr = preferences.getString(KEY_LAST_ERROR_STDERR, null);
+        int exitCode = preferences.getInt("last_error_exit_code", -1);
+        String stdout = preferences.getString("last_error_stdout", "");
+        String exceptionMsg = preferences.getString("last_error_exception", "");
         long time = preferences.getLong(KEY_LAST_ERROR_TIMESTAMP, 0);
 
         if (cmd == null && stderr == null) return null;
-        return new com.dhangofa.networktoggle.model.DiagnosticError(cmd, stderr, time);
+        return new com.dhangofa.networktoggle.model.DiagnosticError(cmd, exitCode, stdout, stderr, exceptionMsg, time);
     }
 
     public void clearLastError() {

app/src/main/java/com/dhangofa/networktoggle/model/DiagnosticError.java

@@ -2,12 +2,18 @@
 
 public class DiagnosticError {
     public final String command;
+    public final int exitCode;
+    public final String stdout;
     public final String stderr;
+    public final String exceptionMessage;
     public final long timestamp;
 
-    public DiagnosticError(String command, String stderr, long timestamp) {
+    public DiagnosticError(String command, int exitCode, String stdout, String stderr, String exceptionMessage, long timestamp) {
         this.command = command;
+        this.exitCode = exitCode;
+        this.stdout = stdout;
         this.stderr = stderr;
+        this.exceptionMessage = exceptionMessage;
         this.timestamp = timestamp;
     }
 }

app/src/main/java/com/dhangofa/networktoggle/ui/SetupCarouselAdapter.java

@@ -0,0 +1,113 @@
+package com.dhangofa.networktoggle.ui;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.res.ColorStateList;
+import android.net.Uri;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+
+import androidx.annotation.NonNull;
+import androidx.recyclerview.widget.RecyclerView;
+import androidx.core.content.ContextCompat;
+
+import com.dhangofa.networktoggle.R;
+
+import java.util.List;
+
+public class SetupCarouselAdapter extends RecyclerView.Adapter<SetupCarouselAdapter.ViewHolder> {
+
+    public static class SetupItem {
+        public String title;
+        public String description;
+        public String buttonText;
+        public String url;
+        public int iconRes;
+        public int bgColorRes;
+        public int accentColorRes;
+        public int btnBgColorRes;
+
+        public SetupItem(String title, String description, String buttonText, String url, int iconRes, int bgColorRes, int accentColorRes, int btnBgColorRes) {
+            this.title = title;
+            this.description = description;
+            this.buttonText = buttonText;
+            this.url = url;
+            this.iconRes = iconRes;
+            this.bgColorRes = bgColorRes;
+            this.accentColorRes = accentColorRes;
+            this.btnBgColorRes = btnBgColorRes;
+        }
+    }
+
+    private List<SetupItem> items;
+    private Context context;
+
+    public SetupCarouselAdapter(Context context, List<SetupItem> items) {
+        this.context = context;
+        this.items = items;
+    }
+
+    @NonNull
+    @Override
+    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        View view = LayoutInflater.from(context).inflate(R.layout.item_setup_carousel, parent, false);
+        // Important: Ensure the item fills the ViewPager2 width
+        view.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
+        return new ViewHolder(view);
+    }
+
+    @Override
+    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
+        SetupItem item = items.get(position);
+        holder.title.setText(item.title);
+        holder.desc.setText(item.description);
+        holder.buttonText.setText(item.buttonText);
+        holder.icon.setImageResource(item.iconRes);
+
+        int bgColor = ContextCompat.getColor(context, item.bgColorRes);
+        int accentColor = ContextCompat.getColor(context, item.accentColorRes);
+
+        holder.background.setBackgroundTintList(ColorStateList.valueOf(bgColor));
+
+        holder.buttonText.setTextColor(accentColor);
+        holder.buttonIcon.setColorFilter(accentColor);
+        holder.icon.setColorFilter(accentColor);
+        int btnBgColor = ContextCompat.getColor(context, item.btnBgColorRes);
+        holder.button.setBackgroundTintList(ColorStateList.valueOf(btnBgColor));
+        holder.iconContainer.setBackgroundTintList(ColorStateList.valueOf(btnBgColor));
+
+        holder.button.setOnClickListener(v -> {
+            Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(item.url));
+            try { context.startActivity(browserIntent); } catch (Exception e) { android.widget.Toast.makeText(context, "No web browser installed to open this link.", android.widget.Toast.LENGTH_SHORT).show(); }
+        });
+    }
+
+    @Override
+    public int getItemCount() {
+        return items.size();
+    }
+
+    static class ViewHolder extends RecyclerView.ViewHolder {
+        View background;
+        TextView title, desc, buttonText;
+        ImageView icon, buttonIcon;
+        LinearLayout button;
+        View iconContainer;
+
+        public ViewHolder(@NonNull View itemView) {
+            super(itemView);
+            background = itemView.findViewById(R.id.carouselBackground);
+            title = itemView.findViewById(R.id.carouselTitle);
+            desc = itemView.findViewById(R.id.carouselDesc);
+            buttonText = itemView.findViewById(R.id.carouselButtonText);
+            icon = itemView.findViewById(R.id.carouselIcon);
+            buttonIcon = itemView.findViewById(R.id.carouselButtonIcon);
+            button = itemView.findViewById(R.id.carouselButton);
+            iconContainer = itemView.findViewById(R.id.carouselIconContainer);
+        }
+    }
+}

app/src/main/java/com/dhangofa/networktoggle/util/DiagnosticReporter.java

@@ -9,7 +9,6 @@
 import java.util.Locale;
 
 public class DiagnosticReporter {
-
     public static String generateReport(AppPreferences prefs, SimResolver simResolver) {
         DiagnosticError error = prefs.getLastError();
         if (error == null) {
@@ -33,16 +32,26 @@ public static String generateReport(AppPreferences prefs, SimResolver simResolve
         sb.append("[APP STATE]\n");
         sb.append("Execution Mode: ").append(prefs.getExecutionMode().name()).append("\n");
         sb.append("Target SIM Setting: ").append(prefs.getTargetSim().name()).append("\n");
-        
+
         int slotIndex = simResolver.resolveTargetSlotIndex(prefs.getExecutionMode());
         sb.append("Resolved Slot Index: ").append(slotIndex).append("\n\n");
 
         sb.append("[ERROR DETAILS]\n");
         sb.append("Command Attempted:\n").append(error.command).append("\n\n");
-        sb.append("Standard Error (stderr):\n").append(error.stderr).append("\n\n");
-
-        sb.append("--- END OF REPORT ---");
 
+        sb.append("Exit Code: ").append(error.exitCode).append("\n\n");
+
+        if (error.exceptionMessage != null && !error.exceptionMessage.isEmpty()) {
+            sb.append("Exception Message:\n").append(error.exceptionMessage).append("\n\n");
+        }
+
+        if (error.stdout != null && !error.stdout.isEmpty()) {
+            sb.append("Standard Output (stdout):\n").append(error.stdout).append("\n\n");
+        }
+
+        sb.append("Standard Error (stderr):\n").append(error.stderr != null && !error.stderr.isEmpty() ? error.stderr : "(empty)").append("\n\n");
+
+        sb.append("--- END OF REPORT ---");
         return sb.toString();
     }
 }

app/src/main/res/drawable/ic_help_outline.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FF000000"
+        android:pathData="M11,18h2v-2h-2v2zM12,2C6.48,2 2,6.48 2,12s4.48,10 10,10 10,-4.48 10,-10S17.52,2 12,2zM12,20c-4.41,0 -8,-3.59 -8,-8s3.59,-8 8,-8 8,3.59 8,8 -3.59,8 -8,8zM12,6c-2.21,0 -4,1.79 -4,4h2c0,-1.1 0.9,-2 2,-2s2,0.9 2,2c0,2 -3,1.75 -3,5h2c0,-2.25 3,-2.5 3,-5 0,-2.21 -1.79,-4 -4,-4z" />
+</vector>