feat: support to build for windows and add proxy when do http request or download modals

Author: sylar

.gitignore

@@ -78,6 +78,9 @@ iOSInjectionProject/
 # macOS
 .DS_Store
 
+# Git worktrees
+.worktrees/
+
 # IDE - IntelliJ IDEA / Android Studio
 # User-specific stuff
 .idea/workspace.xml

docs/building.md

@@ -142,3 +142,43 @@ cd sdk/runanywhere-kotlin && ./scripts/build-kotlin.sh --setup
 ```bash
 ./gradlew cleanAll && ./gradlew buildAll
 ```
+
+## Windows Voice Validation
+
+For Windows ONNX voice support, build the native backends first, then build the
+Flutter Windows example.
+
+```powershell
+cd sdk\runanywhere-commons
+cmd /c scripts\build-windows.bat all --clean
+
+cd ..\..\examples\flutter\RunAnywhereAI
+New-Item -ItemType Directory -Force -Path build\native_assets\windows | Out-Null
+fvm flutter build windows
+```
+
+Notes:
+
+- `scripts\build-windows.bat onnx` and `scripts\build-windows.bat all` will
+  automatically download Sherpa-ONNX Windows prebuilts into
+  `sdk\runanywhere-commons\third_party\sherpa-onnx-windows`.
+- The final Windows runner directory should contain:
+  - `rac_backend_onnx.dll`
+  - `onnxruntime.dll`
+  - `onnxruntime_providers_shared.dll`
+  - `sherpa-onnx-c-api.dll`
+  - companion runtime DLLs staged by the ONNX plugin
+
+## Flutter Example Windows Vision
+
+The Flutter example Vision page now supports Windows through the `camera_windows`
+plugin while continuing to use the standard `camera` API in the app code.
+
+Notes:
+
+- The project pins `camera_windows` to a Dart 3.3-compatible version because the
+  current repository workflow uses `fvm flutter` on the 3.19 line.
+- Live mode still uses repeated still captures, matching the current Flutter
+  Vision implementation rather than raw frame streaming.
+- Mobile-specific camera controls such as torch, exposure point, and focus point
+  may remain unavailable on Windows camera devices.

examples/flutter/RunAnywhereAI/.gitignore

@@ -55,7 +55,6 @@ ios/Podfile.lock
 # Platforms not supported (mobile-only app)
 linux/
 macos/
-windows/
 web/
 
 # Duplicate Kotlin DSL build files (using Groovy .gradle)

examples/flutter/RunAnywhereAI/android/app/src/main/java/io/flutter/plugins/GeneratedPluginRegistrant.java

@@ -103,7 +103,7 @@ public static void registerWith(@NonNull FlutterEngine flutterEngine) {
     try {
       flutterEngine.getPlugins().add(new com.tekartik.sqflite.SqflitePlugin());
     } catch (Exception e) {
-      Log.e(TAG, "Error registering plugin sqflite_android, com.tekartik.sqflite.SqflitePlugin", e);
+      Log.e(TAG, "Error registering plugin sqflite, com.tekartik.sqflite.SqflitePlugin", e);
     }
     try {
       flutterEngine.getPlugins().add(new io.flutter.plugins.urllauncher.UrlLauncherPlugin());

examples/flutter/RunAnywhereAI/ios/Runner/GeneratedPluginRegistrant.m

@@ -66,10 +66,10 @@
 @import permission_handler_apple;
 #endif
 
-#if __has_include(<record_ios/RecordIosPlugin.h>)
-#import <record_ios/RecordIosPlugin.h>
+#if __has_include(<record_darwin/RecordPlugin.h>)
+#import <record_darwin/RecordPlugin.h>
 #else
-@import record_ios;
+@import record_darwin;
 #endif
 
 #if __has_include(<runanywhere/RunAnywherePlugin.h>)
@@ -102,10 +102,10 @@
 @import shared_preferences_foundation;
 #endif
 
-#if __has_include(<sqflite_darwin/SqflitePlugin.h>)
-#import <sqflite_darwin/SqflitePlugin.h>
+#if __has_include(<sqflite/SqflitePlugin.h>)
+#import <sqflite/SqflitePlugin.h>
 #else
-@import sqflite_darwin;
+@import sqflite;
 #endif
 
 #if __has_include(<url_launcher_ios/URLLauncherPlugin.h>)
@@ -127,7 +127,7 @@ + (void)registerWithRegistry:(NSObject<FlutterPluginRegistry>*)registry {
   [FPPPackageInfoPlusPlugin registerWithRegistrar:[registry registrarForPlugin:@"FPPPackageInfoPlusPlugin"]];
   [PathProviderPlugin registerWithRegistrar:[registry registrarForPlugin:@"PathProviderPlugin"]];
   [PermissionHandlerPlugin registerWithRegistrar:[registry registrarForPlugin:@"PermissionHandlerPlugin"]];
-  [RecordIosPlugin registerWithRegistrar:[registry registrarForPlugin:@"RecordIosPlugin"]];
+  [RecordPlugin registerWithRegistrar:[registry registrarForPlugin:@"RecordPlugin"]];
   [RunAnywherePlugin registerWithRegistrar:[registry registrarForPlugin:@"RunAnywherePlugin"]];
   [GeniePlugin registerWithRegistrar:[registry registrarForPlugin:@"GeniePlugin"]];
   [LlamaCppPlugin registerWithRegistrar:[registry registrarForPlugin:@"LlamaCppPlugin"]];

examples/flutter/RunAnywhereAI/lib/app/runanywhere_ai_app.dart

@@ -2,11 +2,15 @@ import 'dart:async';
 
 import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
+import 'package:runanywhere/core/types/npu_chip.dart';
+import 'package:runanywhere/public/extensions/runanywhere_device.dart';
 import 'package:runanywhere/public/extensions/rag_module.dart';
 import 'package:runanywhere/runanywhere.dart';
 import 'package:runanywhere_ai/app/content_view.dart';
 import 'package:runanywhere_ai/core/design_system/app_colors.dart';
 import 'package:runanywhere_ai/core/design_system/app_spacing.dart';
+import 'package:runanywhere_ai/core/models/proxy_settings.dart';
+import 'package:runanywhere_ai/core/services/example_http_service.dart';
 import 'package:runanywhere_ai/core/services/model_manager.dart';
 import 'package:runanywhere_ai/core/utilities/constants.dart';
 import 'package:runanywhere_ai/core/utilities/keychain_helper.dart';
@@ -116,6 +120,13 @@ class _RunAnywhereAIAppState extends State<RunAnywhereAIApp> {
           '🔧 Environment: ${RunAnywhere.getCurrentEnvironment()?.description ?? "Unknown"}');
       debugPrint('📱 Services will initialize on first API call');
 
+      RunAnywhere.configureDownloadHttpClientFactory((uri) async {
+        return ExampleHttpService.shared.createScopedHttpPackageClient(
+          ProxyScope.download,
+          uri,
+        );
+      });
+
       // Refresh model manager state (runs model discovery)
       await ModelManager.shared.refresh();
 
@@ -213,13 +224,37 @@ class _RunAnywhereAIAppState extends State<RunAnywhereAIApp> {
         // Models with per-chip availability
         const genieModels = [
           // Qwen3 4B — Gen 5 only
-          (slug: 'qwen3-4b', name: 'Qwen3 4B', mem: 2800000000, quant: 'w4a16', chips: {NPUChip.snapdragon8EliteGen5}),
+          (
+            slug: 'qwen3-4b',
+            name: 'Qwen3 4B',
+            mem: 2800000000,
+            quant: 'w4a16',
+            chips: {NPUChip.snapdragon8EliteGen5}
+          ),
           // Llama 3.2 1B Instruct — both chips
-          (slug: 'llama3.2-1b-instruct', name: 'Llama 3.2 1B Instruct', mem: 1200000000, quant: 'w4a16', chips: {NPUChip.snapdragon8Elite, NPUChip.snapdragon8EliteGen5}),
+          (
+            slug: 'llama3.2-1b-instruct',
+            name: 'Llama 3.2 1B Instruct',
+            mem: 1200000000,
+            quant: 'w4a16',
+            chips: {NPUChip.snapdragon8Elite, NPUChip.snapdragon8EliteGen5}
+          ),
           // SEA-LION v3.5 8B Instruct — both chips
-          (slug: 'sea-lion3.5-8b-instruct', name: 'SEA-LION v3.5 8B Instruct', mem: 4800000000, quant: 'w4a16', chips: {NPUChip.snapdragon8Elite, NPUChip.snapdragon8EliteGen5}),
+          (
+            slug: 'sea-lion3.5-8b-instruct',
+            name: 'SEA-LION v3.5 8B Instruct',
+            mem: 4800000000,
+            quant: 'w4a16',
+            chips: {NPUChip.snapdragon8Elite, NPUChip.snapdragon8EliteGen5}
+          ),
           // Qwen 2.5 7B Instruct — 8elite only, w8a16 quant
-          (slug: 'qwen2.5-7b-instruct', name: 'Qwen 2.5 7B Instruct', mem: 4200000000, quant: 'w8a16', chips: {NPUChip.snapdragon8Elite}),
+          (
+            slug: 'qwen2.5-7b-instruct',
+            name: 'Qwen 2.5 7B Instruct',
+            mem: 4200000000,
+            quant: 'w8a16',
+            chips: {NPUChip.snapdragon8Elite}
+          ),
         ];
         for (final m in genieModels) {
           if (m.chips.contains(chip)) {
@@ -261,7 +296,8 @@ class _RunAnywhereAIAppState extends State<RunAnywhereAIApp> {
     RunAnywhere.registerModel(
       id: 'sherpa-onnx-whisper-tiny.en',
       name: 'Sherpa Whisper Tiny (ONNX)',
-      url: Uri.parse('https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/sherpa-onnx-whisper-tiny.en.tar.gz'),
+      url: Uri.parse(
+          'https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/sherpa-onnx-whisper-tiny.en.tar.gz'),
       framework: InferenceFramework.onnx,
       modality: ModelCategory.speechRecognition,
       memoryRequirement: 75000000,
@@ -270,7 +306,8 @@ class _RunAnywhereAIAppState extends State<RunAnywhereAIApp> {
     RunAnywhere.registerModel(
       id: 'sherpa-onnx-whisper-small.en',
       name: 'Sherpa Whisper Small (ONNX)',
-      url: Uri.parse('https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/sherpa-onnx-whisper-small.en.tar.gz'),
+      url: Uri.parse(
+          'https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/sherpa-onnx-whisper-small.en.tar.gz'),
       framework: InferenceFramework.onnx,
       modality: ModelCategory.speechRecognition,
       memoryRequirement: 250000000,
@@ -280,7 +317,8 @@ class _RunAnywhereAIAppState extends State<RunAnywhereAIApp> {
     RunAnywhere.registerModel(
       id: 'vits-piper-en_US-lessac-medium',
       name: 'Piper TTS (US English - Medium)',
-      url: Uri.parse('https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/vits-piper-en_US-lessac-medium.tar.gz'),
+      url: Uri.parse(
+          'https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/vits-piper-en_US-lessac-medium.tar.gz'),
       framework: InferenceFramework.onnx,
       modality: ModelCategory.speechSynthesis,
       memoryRequirement: 65000000,
@@ -289,7 +327,8 @@ class _RunAnywhereAIAppState extends State<RunAnywhereAIApp> {
     RunAnywhere.registerModel(
       id: 'vits-piper-en_GB-alba-medium',
       name: 'Piper TTS (British English)',
-      url: Uri.parse('https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/vits-piper-en_GB-alba-medium.tar.gz'),
+      url: Uri.parse(
+          'https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/vits-piper-en_GB-alba-medium.tar.gz'),
       framework: InferenceFramework.onnx,
       modality: ModelCategory.speechSynthesis,
       memoryRequirement: 65000000,
@@ -325,17 +364,17 @@ class _RunAnywhereAIAppState extends State<RunAnywhereAIApp> {
     // --- ONNX BACKEND (required for embeddings used by RAG) ---
     try {
       await Onnx.register();
-      debugPrint('✅ ONNX backend registered (STT + TTS + VAD + Embeddings)');
+      debugPrint('✅ ONNX backend registered (Windows optional)');
     } catch (e) {
-      debugPrint('⚠️ ONNX backend not available: $e');
+      debugPrint('⚠️ ONNX backend not available on this Windows build: $e');
     }
 
     // --- RAG BACKEND ---
     try {
       await RAGModule.register();
       debugPrint('✅ RAG backend registered');
     } catch (e) {
-      debugPrint('⚠️ RAG backend not available (RAG features disabled): $e');
+      debugPrint('⚠️ RAG backend not available on this Windows build: $e');
     }
 
     debugPrint('🎉 All modules and models registered');

examples/flutter/RunAnywhereAI/lib/core/design_system/app_colors.dart

@@ -1,5 +1,14 @@
 import 'package:flutter/material.dart';
 
+extension ColorCompatibility on Color {
+  Color withValues({double? alpha}) {
+    if (alpha != null) {
+      return withOpacity(alpha.clamp(0.0, 1.0));
+    }
+    return this;
+  }
+}
+
 /// App Colors (mirroring iOS AppColors.swift)
 class AppColors {
   // MARK: - Semantic Colors
@@ -26,7 +35,7 @@ class AppColors {
   static Color backgroundTertiary(BuildContext context) =>
       Theme.of(context).colorScheme.surface;
   static Color backgroundGrouped(BuildContext context) =>
-      Theme.of(context).colorScheme.surfaceContainerHighest;
+      Theme.of(context).colorScheme.surfaceVariant;
   static Color backgroundGray5(BuildContext context) =>
       Theme.of(context).brightness == Brightness.dark
           ? Colors.grey.shade800

examples/flutter/RunAnywhereAI/lib/core/design_system/unsupported_feature_view.dart

@@ -0,0 +1,32 @@
+import 'package:flutter/material.dart';
+import 'package:runanywhere_ai/core/design_system/app_spacing.dart';
+
+class UnsupportedFeatureView extends StatelessWidget {
+  final String title;
+  final String message;
+
+  const UnsupportedFeatureView({
+    super.key,
+    required this.title,
+    required this.message,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return Center(
+      child: Padding(
+        padding: const EdgeInsets.all(AppSpacing.large),
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            const Icon(Icons.info_outline, size: 40),
+            const SizedBox(height: AppSpacing.mediumLarge),
+            Text(title, style: Theme.of(context).textTheme.titleLarge),
+            const SizedBox(height: AppSpacing.smallMedium),
+            Text(message, textAlign: TextAlign.center),
+          ],
+        ),
+      ),
+    );
+  }
+}

examples/flutter/RunAnywhereAI/lib/core/models/proxy_settings.dart

@@ -0,0 +1,71 @@
+enum ProxyScope {
+  general('Network Proxy'),
+  download('Download Proxy');
+
+  final String displayName;
+
+  const ProxyScope(this.displayName);
+}
+
+enum ProxyScheme {
+  http('HTTP'),
+  https('HTTPS'),
+  socks5('SOCKS5');
+
+  final String displayName;
+
+  const ProxyScheme(this.displayName);
+
+  String get wireValue => name;
+
+  static ProxyScheme fromWireValue(String? value) {
+    return ProxyScheme.values.firstWhere(
+      (scheme) => scheme.wireValue == value,
+      orElse: () => ProxyScheme.http,
+    );
+  }
+}
+
+class ProxySettings {
+  final bool enabled;
+  final ProxyScheme scheme;
+  final String host;
+  final int? port;
+  final String username;
+  final String password;
+  final bool bypassLocal;
+
+  const ProxySettings({
+    this.enabled = false,
+    this.scheme = ProxyScheme.http,
+    this.host = '',
+    this.port,
+    this.username = '',
+    this.password = '',
+    this.bypassLocal = true,
+  });
+
+  bool get hasCredentials => username.isNotEmpty || password.isNotEmpty;
+
+  bool get isComplete => !enabled || (host.trim().isNotEmpty && port != null);
+
+  ProxySettings copyWith({
+    bool? enabled,
+    ProxyScheme? scheme,
+    String? host,
+    int? port,
+    String? username,
+    String? password,
+    bool? bypassLocal,
+  }) {
+    return ProxySettings(
+      enabled: enabled ?? this.enabled,
+      scheme: scheme ?? this.scheme,
+      host: host ?? this.host,
+      port: port ?? this.port,
+      username: username ?? this.username,
+      password: password ?? this.password,
+      bypassLocal: bypassLocal ?? this.bypassLocal,
+    );
+  }
+}