diff --git a/doc/plan.md b/doc/plan.md new file mode 100644 index 0000000..d16bdd1 --- /dev/null +++ b/doc/plan.md @@ -0,0 +1,125 @@ +# Role & Context + +你是一个精通 Flutter 混合架构（Hybrid App）与移动端 APM（应用性能监控）的资深架构师。 + +当前任务：为一款基于“单工程多风味（Flavors）”架构的教育平板应用（包含“劝学”和“点智学”两个 Flavor）生成核心 MVP 代码框架与监控埋点方案。 + +底层环境约定：兼容 Android 14（量产基线）并向下兼容处理 Android 15 的 WindowInsets（Edge-to-Edge）特性。 + + + +# Product Architecture (Flutter 壳与 H5 的边界界定) + +本 MVP 采用“瘦壳重网页”模式： + +1. **Flutter 壳职责：** 仅负责生命周期管理、沉浸式/Kiosk 模式控制、设备硬件能力桥接（相机/录音/持久化存储）、全局骨架屏（Loading）、以及高可用 WebView 容器的维护。 + +2. **H5 职责：** 承载所有教学业务逻辑（题库、视频播放、个人中心）。 + +3. **通信机制：** 统一通过注入的 `JSBridge` 进行双向通信。 + + + +# MVP Core Modules (核心功能模块需求) + + + +## 1. 动态环境与配置引擎 (Config Engine) + +- **需求：** 读取 `--dart-define=APP_FLAVOR`。 + +- **功能：** 根据 Flavor 动态下发不同的 `baseUrl`（H5 首页地址）、主题色、以及持久化缓存策略。 + + + +## 2. 高可用 WebView 容器 (Core Web Container) + +- **核心依赖：** 使用 `webview_flutter` 或 `flutter_inappwebview`。 + +- **Android 15 兼容性（关键）：** WebView Widget 必须包裹在自定义的 `SafeArea` 或响应 `WindowInsets` 的布局中，将顶部的 `statusBarHeight` 和底部的 `navigationBarHeight` 动态获取，并作为 URL 参数或注入的 JS 变量传给 H5，供前端写 CSS 避让区。 + +- **Cookie 策略：** 必须显式开启 `Third-Party Cookies` 和 `DOM Storage`，确保跨域 SSO 单点登录不掉线。 + + + +## 3. 标准化 JSBridge 协议层 + +要求实现一个健壮的 JSBridge 类，至少包含以下基础方法，供 H5 调用： + +- `getDeviceInfo()`: 返回系统版本、电量、当前网络状态（WiFi/4G）。 + +- `setImmersiveMode(boolean)`: 控制隐藏/显示系统状态栏和底部导航栏。 + +- `openCamera(config)`: 唤起原生相机并返回 Base64 或文件路径。 + +- `reportEvent(eventName, params)`: H5 将核心业务埋点转发给 Flutter 壳进行统一上报。 + + + +## 4. Kiosk Mode (专注模式/设备管控) + +- 预留 `MethodChannel` 接口，命名为 `DeviceControlChannel`。 + +- 包含方法 `enableKioskMode()` 和 `disableKioskMode()`（具体 Android 原生端 `startLockTask` 逻辑暂用 TODO 占位，需定义好 Dart 侧的调用规范）。 + + + +--- + + + +# APM & Observability Metrics (应用性能与稳定性指标体系) + + + +请在代码中创建一个 `AppMonitor` 单例类，负责拦截并上报以下三大类核心指标（目前先在控制台打印日志，预留后续接入 Firebase / Sentry / 自研后端的接口）： + + + +## 1. 容器加载性能指标 (Performance) + +- `Shell_Launch_Time`: Flutter 引擎初始化到原生首屏（Splash 结束）的耗时。 + +- `WebView_Init_Time`: 从触发加载到 WebView 实例创建完成的耗时。 + +- `H5_TTFB (Time to First Byte)`: Web 页面发出请求到收到第一个字节的耗时（需注入 JS 获取）。 + +- `H5_FCP (First Contentful Paint)`: 白屏时间（从 `onPageStarted` 到 `onPageFinished`，结合 JS 注入获取真实渲染时间）。 + + + +## 2. 稳定性指标 (Stability) + +- `WebView_Crash_Rate`: 捕获 `onWebResourceError`，特别是 `OOM`（内存溢出）导致的白屏终止。 + +- `JSBridge_Fail_Count`: 统计 H5 调用原生能力失败的次数与错误码（如权限被拒、参数格式错误）。 + +- `Http_Error_Rate`: 拦截并统计 WebView 内发生的 404/500 等静态资源或接口请求错误。 + + + +## 3. 业务与设备指标 (Business & Device) + +- `Session_Duration`: 从应用 `resumed` 到 `paused` 的有效停留时间。 + +- `Network_Switch_Count`: 监听网络状态，记录用户在弱网/断网环境下的掉线频次。 + + + +--- + + + +# Execution Steps for Code X (执行步骤) + + + +请一步步为我生成上述方案的代码骨架： + +1. **Step 1:** 生成目录结构建议（基于 feature 驱动或分层架构）。 + +2. **Step 2:** 生成 `Config Engine` 与 `AppMonitor` 的单例类代码，实现核心指标的日志打印结构。 + +3. **Step 3:** 编写核心的 `HybridWebView` Widget，包含 Insets 处理、Cookie 策略配置和首屏加载时间计算。 + +4. **Step 4:** 编写 `JSBridge` 核心处理类，实现拦截 H5 消息并路由到对应原生方法的逻辑。 \ No newline at end of file diff --git a/packages/web_android_shell/.gitignore b/packages/web_android_shell/.gitignore new file mode 100644 index 0000000..6f0d006 --- /dev/null +++ b/packages/web_android_shell/.gitignore @@ -0,0 +1,45 @@ +# Miscellaneous +*.class +*.log +*.pyc +*.swp +.DS_Store +.atom/ +.build/ +.buildlog/ +.history +.svn/ +.swiftpm/ +migrate_working_dir/ + +# IntelliJ related +*.iml +*.ipr +*.iws +.idea/ + +# The .vscode folder contains launch configuration and tasks you configure in +# VS Code which you may wish to be included in version control, so this line +# is commented out by default. +#.vscode/ + +# Flutter/Dart/Pub related +**/doc/api/ +**/ios/Flutter/.last_build_id +.dart_tool/ +.flutter-plugins-dependencies +.pub-cache/ +.pub/ +/build/ +/coverage/ + +# Symbolication related +app.*.symbols + +# Obfuscation related +app.*.map.json + +# Android Studio will place build artifacts here +/android/app/debug +/android/app/profile +/android/app/release diff --git a/packages/web_android_shell/.metadata b/packages/web_android_shell/.metadata new file mode 100644 index 0000000..c0fe018 --- /dev/null +++ b/packages/web_android_shell/.metadata @@ -0,0 +1,45 @@ +# This file tracks properties of this Flutter project. +# Used by Flutter tool to assess capabilities and perform upgrades etc. +# +# This file should be version controlled and should not be manually edited. + +version: + revision: "90673a4eef275d1a6692c26ac80d6d746d41a73a" + channel: "stable" + +project_type: app + +# Tracks metadata for the flutter migrate command +migration: + platforms: + - platform: root + create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + - platform: android + create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + - platform: ios + create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + - platform: linux + create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + - platform: macos + create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + - platform: web + create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + - platform: windows + create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a + + # User provided section + + # List of Local paths (relative to this file) that should be + # ignored by the migrate tool. + # + # Files that are not part of the templates will be ignored by default. + unmanaged_files: + - 'lib/main.dart' + - 'ios/Runner.xcodeproj/project.pbxproj' diff --git a/packages/web_android_shell/README.md b/packages/web_android_shell/README.md new file mode 100644 index 0000000..191f589 --- /dev/null +++ b/packages/web_android_shell/README.md @@ -0,0 +1,28 @@ +# web_android_shell + +H5 壳子项目。 + +## 调试说明 + +这个项目在部分设备上，如果直接用 `Ctrl+C` 结束 `flutter run`，设备里的上一次 App 进程可能还留在后台，下一次运行时会影响内嵌 WebView 启动。 + +更稳的做法： + +- 调试结束时优先在 `flutter run` 里按 `q` +- 或者使用项目自带脚本，先自动杀掉旧进程再启动 + +```powershell +.\tool\flutter_run_fresh.ps1 +``` + +如果要指定设备，也可以继续透传给 `flutter run`： + +```powershell +.\tool\flutter_run_fresh.ps1 -d F136A +``` + +脚本会自动： + +- 读取 `android/local.properties` 中的 `sdk.dir` +- 调用 `adb shell am force-stop com.yuanxuan.webshell.web_android_shell` +- 然后执行 `flutter run` diff --git a/packages/web_android_shell/analysis_options.yaml b/packages/web_android_shell/analysis_options.yaml new file mode 100644 index 0000000..d4e0f0c --- /dev/null +++ b/packages/web_android_shell/analysis_options.yaml @@ -0,0 +1,28 @@ +# This file configures the analyzer, which statically analyzes Dart code to +# check for errors, warnings, and lints. +# +# The issues identified by the analyzer are surfaced in the UI of Dart-enabled +# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be +# invoked from the command line by running `flutter analyze`. + +# The following line activates a set of recommended lints for Flutter apps, +# packages, and plugins designed to encourage good coding practices. +include: package:flutter_lints/flutter.yaml + +linter: + # The lint rules applied to this project can be customized in the + # section below to disable rules from the `package:flutter_lints/flutter.yaml` + # included above or to enable additional rules. A list of all available lints + # and their documentation is published at https://dart.dev/lints. + # + # Instead of disabling a lint rule for the entire project in the + # section below, it can also be suppressed for a single line of code + # or a specific dart file by using the `// ignore: name_of_lint` and + # `// ignore_for_file: name_of_lint` syntax on the line or in the file + # producing the lint. + rules: + # avoid_print: false # Uncomment to disable the `avoid_print` rule + # prefer_single_quotes: true # Uncomment to enable the `prefer_single_quotes` rule + +# Additional information about this file can be found at +# https://dart.dev/guides/language/analysis-options diff --git a/packages/web_android_shell/android/.gitignore b/packages/web_android_shell/android/.gitignore new file mode 100644 index 0000000..c908258 --- /dev/null +++ b/packages/web_android_shell/android/.gitignore @@ -0,0 +1,14 @@ +gradle-wrapper.jar +/.gradle +/captures/ +/gradlew +/gradlew.bat +/local.properties +GeneratedPluginRegistrant.java +.cxx/ + +# Remember to never publicly share your keystore. +# See https://flutter.dev/to/reference-keystore +key.properties +**/*.keystore +**/*.jks diff --git a/packages/web_android_shell/android/app/build.gradle.kts b/packages/web_android_shell/android/app/build.gradle.kts new file mode 100644 index 0000000..7868f7c --- /dev/null +++ b/packages/web_android_shell/android/app/build.gradle.kts @@ -0,0 +1,45 @@ +plugins { + id("com.android.application") + id("kotlin-android") + // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins. + id("dev.flutter.flutter-gradle-plugin") +} + +android { + namespace = "com.yuanxuan.webshell.web_android_shell" + compileSdk = flutter.compileSdkVersion + ndkVersion = flutter.ndkVersion + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 + } + + kotlinOptions { + jvmTarget = JavaVersion.VERSION_17.toString() + } + + defaultConfig { + // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html). + applicationId = "com.yuanxuan.webshell.web_android_shell" + // You can update the following values to match your application needs. + // For more information, see: https://flutter.dev/to/review-gradle-config. + minSdk = flutter.minSdkVersion + // Keep a stable targetSdk for better compatibility with older system WebView builds. + targetSdk = 34 + versionCode = flutter.versionCode + versionName = flutter.versionName + } + + buildTypes { + release { + // TODO: Add your own signing config for the release build. + // Signing with the debug keys for now, so `flutter run --release` works. + signingConfig = signingConfigs.getByName("debug") + } + } +} + +flutter { + source = "../.." +} diff --git a/packages/web_android_shell/android/app/src/debug/AndroidManifest.xml b/packages/web_android_shell/android/app/src/debug/AndroidManifest.xml new file mode 100644 index 0000000..8ffe024 --- /dev/null +++ b/packages/web_android_shell/android/app/src/debug/AndroidManifest.xml @@ -0,0 +1,7 @@ + + + + diff --git a/packages/web_android_shell/android/app/src/main/AndroidManifest.xml b/packages/web_android_shell/android/app/src/main/AndroidManifest.xml new file mode 100644 index 0000000..fe3afb2 --- /dev/null +++ b/packages/web_android_shell/android/app/src/main/AndroidManifest.xml @@ -0,0 +1,129 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/web_android_shell/android/app/src/main/java/com/yuanxuan/webshell/web_android_shell/MainActivity.java b/packages/web_android_shell/android/app/src/main/java/com/yuanxuan/webshell/web_android_shell/MainActivity.java new file mode 100644 index 0000000..53cf90a --- /dev/null +++ b/packages/web_android_shell/android/app/src/main/java/com/yuanxuan/webshell/web_android_shell/MainActivity.java @@ -0,0 +1,241 @@ +package com.yuanxuan.webshell.web_android_shell; + +import android.app.ActivityManager; +import android.content.SharedPreferences; +import android.content.pm.PackageInfo; +import android.os.Build; +import android.os.Bundle; +import android.os.Process; +import android.os.SystemClock; +import android.webkit.CookieManager; +import android.webkit.WebStorage; +import android.webkit.WebView; + +import androidx.annotation.NonNull; + +import java.io.File; +import java.util.HashMap; +import java.util.Map; + +import io.flutter.embedding.android.FlutterActivity; +import io.flutter.embedding.engine.FlutterEngine; +import io.flutter.plugin.common.MethodChannel; + +public class MainActivity extends FlutterActivity { + private static final String DEVICE_CHANNEL = "app_shell/device"; + private static final String DEBUG_PROCESS_PREFS = "app_shell_debug_process"; + private static final String DEBUG_PROCESS_PID_KEY = "pid"; + private String webViewDataDirectorySuffix; + + @Override + protected void onCreate(Bundle savedInstanceState) { + terminatePreviousDebugProcessIfNeeded(); + prepareWebViewDataDirectory(); + super.onCreate(savedInstanceState); + registerCurrentDebugProcess(); + } + + @Override + protected void onDestroy() { + clearCurrentDebugProcessRegistration(); + super.onDestroy(); + } + + @Override + public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) { + super.configureFlutterEngine(flutterEngine); + new MethodChannel( + flutterEngine.getDartExecutor().getBinaryMessenger(), + DEVICE_CHANNEL + ).setMethodCallHandler((call, result) -> { + switch (call.method) { + case "getAndroidWebViewInfo": + result.success(buildAndroidWebViewInfo()); + break; + case "resetAndroidWebViewState": + resetAndroidWebViewState(result); + break; + default: + result.notImplemented(); + break; + } + }); + } + + private Map buildAndroidWebViewInfo() { + final Map info = new HashMap<>(); + info.put("sdkInt", Build.VERSION.SDK_INT); + info.put("manufacturer", Build.MANUFACTURER); + info.put("brand", Build.BRAND); + info.put("model", Build.MODEL); + if (webViewDataDirectorySuffix != null) { + info.put("webViewDataDirectorySuffix", webViewDataDirectorySuffix); + } + + final PackageInfo currentWebViewPackage = getCurrentWebViewPackageCompat(); + if (currentWebViewPackage != null) { + info.put("webViewPackageName", currentWebViewPackage.packageName); + if (currentWebViewPackage.versionName != null) { + info.put("webViewVersionName", currentWebViewPackage.versionName); + } + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) { + info.put( + "webViewLongVersionCode", + currentWebViewPackage.getLongVersionCode() + ); + } else { + info.put( + "webViewLongVersionCode", + (long) currentWebViewPackage.versionCode + ); + } + } + return info; + } + + private void prepareWebViewDataDirectory() { + webViewDataDirectorySuffix = null; + if (!isDebuggableBuild() || Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) { + return; + } + + clearLegacyDebugWebViewData(); + } + + private void terminatePreviousDebugProcessIfNeeded() { + if (!isDebuggableBuild()) { + return; + } + + final SharedPreferences preferences = getSharedPreferences( + DEBUG_PROCESS_PREFS, + MODE_PRIVATE + ); + final int currentPid = Process.myPid(); + final int previousPid = preferences.getInt(DEBUG_PROCESS_PID_KEY, -1); + if (previousPid <= 0 || previousPid == currentPid) { + return; + } + + if (!isSamePackageProcessRunning(previousPid)) { + preferences.edit().remove(DEBUG_PROCESS_PID_KEY).apply(); + return; + } + + try { + Process.killProcess(previousPid); + SystemClock.sleep(180); + } catch (RuntimeException ignored) { + // Ignore kill failures and continue startup with the current process. + } + } + + private void registerCurrentDebugProcess() { + if (!isDebuggableBuild()) { + return; + } + + getSharedPreferences(DEBUG_PROCESS_PREFS, MODE_PRIVATE) + .edit() + .putInt(DEBUG_PROCESS_PID_KEY, Process.myPid()) + .apply(); + } + + private void clearCurrentDebugProcessRegistration() { + if (!isDebuggableBuild()) { + return; + } + + final SharedPreferences preferences = getSharedPreferences( + DEBUG_PROCESS_PREFS, + MODE_PRIVATE + ); + if (preferences.getInt(DEBUG_PROCESS_PID_KEY, -1) != Process.myPid()) { + return; + } + preferences.edit().remove(DEBUG_PROCESS_PID_KEY).apply(); + } + + private boolean isSamePackageProcessRunning(int pid) { + final ActivityManager activityManager = + (ActivityManager) getSystemService(ACTIVITY_SERVICE); + if (activityManager == null) { + return false; + } + + for (final ActivityManager.RunningAppProcessInfo processInfo + : activityManager.getRunningAppProcesses()) { + if (processInfo.pid == pid) { + return getPackageName().equals(processInfo.processName); + } + } + return false; + } + + private void clearLegacyDebugWebViewData() { + try { + final File appWebViewDir = new File(getApplicationInfo().dataDir, "app_webview"); + deleteRecursively(appWebViewDir); + deleteDatabase("webview.db"); + deleteDatabase("webviewCache.db"); + } catch (RuntimeException ignored) { + // Ignore cleanup failures on legacy devices and continue with startup. + } + } + + private boolean isDebuggableBuild() { + return (getApplicationInfo().flags & android.content.pm.ApplicationInfo.FLAG_DEBUGGABLE) != 0; + } + + private void deleteRecursively(File target) { + if (target == null || !target.exists()) { + return; + } + + if (target.isDirectory()) { + final File[] children = target.listFiles(); + if (children != null) { + for (final File child : children) { + deleteRecursively(child); + } + } + } + + //noinspection ResultOfMethodCallIgnored + target.delete(); + } + + private PackageInfo getCurrentWebViewPackageCompat() { + try { + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { + return WebView.getCurrentWebViewPackage(); + } + } catch (RuntimeException ignored) { + return null; + } + return null; + } + + private void resetAndroidWebViewState(@NonNull MethodChannel.Result result) { + try { + WebStorage.getInstance().deleteAllData(); + + final CookieManager cookieManager = CookieManager.getInstance(); + cookieManager.removeSessionCookies(null); + cookieManager.removeAllCookies(value -> { + try { + cookieManager.flush(); + WebView.clearClientCertPreferences(() -> result.success(true)); + } catch (RuntimeException error) { + result.error( + "webview_reset_failed", + error.toString(), + null + ); + } + }); + } catch (RuntimeException error) { + result.error("webview_reset_failed", error.toString(), null); + } + } +} diff --git a/packages/web_android_shell/android/app/src/main/res/drawable-v21/launch_background.xml b/packages/web_android_shell/android/app/src/main/res/drawable-v21/launch_background.xml new file mode 100644 index 0000000..1cb7aa2 --- /dev/null +++ b/packages/web_android_shell/android/app/src/main/res/drawable-v21/launch_background.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/packages/web_android_shell/android/app/src/main/res/drawable/launch_background.xml b/packages/web_android_shell/android/app/src/main/res/drawable/launch_background.xml new file mode 100644 index 0000000..8403758 --- /dev/null +++ b/packages/web_android_shell/android/app/src/main/res/drawable/launch_background.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/packages/web_android_shell/android/app/src/main/res/mipmap-hdpi/ic_launcher.png b/packages/web_android_shell/android/app/src/main/res/mipmap-hdpi/ic_launcher.png new file mode 100644 index 0000000..db77bb4 Binary files /dev/null and b/packages/web_android_shell/android/app/src/main/res/mipmap-hdpi/ic_launcher.png differ diff --git a/packages/web_android_shell/android/app/src/main/res/mipmap-mdpi/ic_launcher.png b/packages/web_android_shell/android/app/src/main/res/mipmap-mdpi/ic_launcher.png new file mode 100644 index 0000000..17987b7 Binary files /dev/null and b/packages/web_android_shell/android/app/src/main/res/mipmap-mdpi/ic_launcher.png differ diff --git a/packages/web_android_shell/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png b/packages/web_android_shell/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png new file mode 100644 index 0000000..09d4391 Binary files /dev/null and b/packages/web_android_shell/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png differ diff --git a/packages/web_android_shell/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png b/packages/web_android_shell/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png new file mode 100644 index 0000000..d5f1c8d Binary files /dev/null and b/packages/web_android_shell/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png differ diff --git a/packages/web_android_shell/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/packages/web_android_shell/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png new file mode 100644 index 0000000..4d6372e Binary files /dev/null and b/packages/web_android_shell/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ diff --git a/packages/web_android_shell/android/app/src/main/res/values-night/styles.xml b/packages/web_android_shell/android/app/src/main/res/values-night/styles.xml new file mode 100644 index 0000000..360a160 --- /dev/null +++ b/packages/web_android_shell/android/app/src/main/res/values-night/styles.xml @@ -0,0 +1,18 @@ + + + + + + + diff --git a/packages/web_android_shell/android/app/src/main/res/values/styles.xml b/packages/web_android_shell/android/app/src/main/res/values/styles.xml new file mode 100644 index 0000000..5fac679 --- /dev/null +++ b/packages/web_android_shell/android/app/src/main/res/values/styles.xml @@ -0,0 +1,18 @@ + + + + + + + diff --git a/packages/web_android_shell/android/app/src/profile/AndroidManifest.xml b/packages/web_android_shell/android/app/src/profile/AndroidManifest.xml new file mode 100644 index 0000000..8ffe024 --- /dev/null +++ b/packages/web_android_shell/android/app/src/profile/AndroidManifest.xml @@ -0,0 +1,7 @@ + + + + diff --git a/packages/web_android_shell/android/build.gradle.kts b/packages/web_android_shell/android/build.gradle.kts new file mode 100644 index 0000000..1f88145 --- /dev/null +++ b/packages/web_android_shell/android/build.gradle.kts @@ -0,0 +1,24 @@ +allprojects { + repositories { + google() + mavenCentral() + } +} + +val newBuildDir: Directory = + rootProject.layout.buildDirectory + .dir("../../build") + .get() +rootProject.layout.buildDirectory.value(newBuildDir) + +subprojects { + val newSubprojectBuildDir: Directory = newBuildDir.dir(project.name) + project.layout.buildDirectory.value(newSubprojectBuildDir) +} +subprojects { + project.evaluationDependsOn(":app") +} + +tasks.register("clean") { + delete(rootProject.layout.buildDirectory) +} diff --git a/packages/web_android_shell/android/gradle.properties b/packages/web_android_shell/android/gradle.properties new file mode 100644 index 0000000..4623a70 --- /dev/null +++ b/packages/web_android_shell/android/gradle.properties @@ -0,0 +1,6 @@ +org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError +org.gradle.parallel=false +org.gradle.caching=false +org.gradle.vfs.watch=false +org.gradle.workers.max=1 +android.useAndroidX=true diff --git a/packages/web_android_shell/android/gradle/wrapper/gradle-wrapper.properties b/packages/web_android_shell/android/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..568dedc --- /dev/null +++ b/packages/web_android_shell/android/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,5 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists +distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.14-bin.zip diff --git a/packages/web_android_shell/android/settings.gradle.kts b/packages/web_android_shell/android/settings.gradle.kts new file mode 100644 index 0000000..4dcef4b --- /dev/null +++ b/packages/web_android_shell/android/settings.gradle.kts @@ -0,0 +1,26 @@ +pluginManagement { + val flutterSdkPath = + run { + val properties = java.util.Properties() + file("local.properties").inputStream().use { properties.load(it) } + val flutterSdkPath = properties.getProperty("flutter.sdk") + require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" } + flutterSdkPath + } + + includeBuild("$flutterSdkPath/packages/flutter_tools/gradle") + + repositories { + google() + mavenCentral() + gradlePluginPortal() + } +} + +plugins { + id("dev.flutter.flutter-plugin-loader") version "1.0.0" + id("com.android.application") version "8.11.1" apply false + id("org.jetbrains.kotlin.android") version "2.2.20" apply false +} + +include(":app") diff --git a/packages/web_android_shell/ios/.gitignore b/packages/web_android_shell/ios/.gitignore new file mode 100644 index 0000000..ad322bc --- /dev/null +++ b/packages/web_android_shell/ios/.gitignore @@ -0,0 +1,34 @@ +**/dgph +*.mode1v3 +*.mode2v3 +*.moved-aside +*.pbxuser +*.perspectivev3 +**/*sync/ +.sconsign.dblite +.tags* +**/.vagrant/ +**/DerivedData/ +Icon? +**/Pods/ +**/.symlinks/ +profile +xcuserdata +**/.generated/ +Flutter/App.framework +Flutter/Flutter.framework +Flutter/Flutter.podspec +Flutter/Generated.xcconfig +Flutter/ephemeral/ +Flutter/app.flx +Flutter/app.zip +Flutter/flutter_assets/ +Flutter/flutter_export_environment.sh +ServiceDefinitions.json +Runner/GeneratedPluginRegistrant.* + +# Exceptions to above rules. +!default.mode1v3 +!default.mode2v3 +!default.pbxuser +!default.perspectivev3 diff --git a/packages/web_android_shell/ios/Flutter/AppFrameworkInfo.plist b/packages/web_android_shell/ios/Flutter/AppFrameworkInfo.plist new file mode 100644 index 0000000..256cf28 --- /dev/null +++ b/packages/web_android_shell/ios/Flutter/AppFrameworkInfo.plist @@ -0,0 +1,24 @@ + + + + + CFBundleDevelopmentRegion + en + CFBundleExecutable + App + CFBundleIdentifier + io.flutter.flutter.app + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + App + CFBundlePackageType + FMWK + CFBundleShortVersionString + 1.0 + CFBundleSignature + ???? + CFBundleVersion + 1.0 + + diff --git a/packages/web_android_shell/ios/Flutter/Debug.xcconfig b/packages/web_android_shell/ios/Flutter/Debug.xcconfig new file mode 100644 index 0000000..dfd2626 --- /dev/null +++ b/packages/web_android_shell/ios/Flutter/Debug.xcconfig @@ -0,0 +1,2 @@ +#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.debug.xcconfig" +#include "Generated.xcconfig" diff --git a/packages/web_android_shell/ios/Flutter/Release.xcconfig b/packages/web_android_shell/ios/Flutter/Release.xcconfig new file mode 100644 index 0000000..a97381a --- /dev/null +++ b/packages/web_android_shell/ios/Flutter/Release.xcconfig @@ -0,0 +1,2 @@ +#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.release.xcconfig" +#include "Generated.xcconfig" diff --git a/packages/web_android_shell/ios/Podfile b/packages/web_android_shell/ios/Podfile new file mode 100644 index 0000000..620e46e --- /dev/null +++ b/packages/web_android_shell/ios/Podfile @@ -0,0 +1,43 @@ +# Uncomment this line to define a global platform for your project +# platform :ios, '13.0' + +# CocoaPods analytics sends network stats synchronously affecting flutter build latency. +ENV['COCOAPODS_DISABLE_STATS'] = 'true' + +project 'Runner', { + 'Debug' => :debug, + 'Profile' => :release, + 'Release' => :release, +} + +def flutter_root + generated_xcode_build_settings_path = File.expand_path(File.join('..', 'Flutter', 'Generated.xcconfig'), __FILE__) + unless File.exist?(generated_xcode_build_settings_path) + raise "#{generated_xcode_build_settings_path} must exist. If you're running pod install manually, make sure flutter pub get is executed first" + end + + File.foreach(generated_xcode_build_settings_path) do |line| + matches = line.match(/FLUTTER_ROOT\=(.*)/) + return matches[1].strip if matches + end + raise "FLUTTER_ROOT not found in #{generated_xcode_build_settings_path}. Try deleting Generated.xcconfig, then run flutter pub get" +end + +require File.expand_path(File.join('packages', 'flutter_tools', 'bin', 'podhelper'), flutter_root) + +flutter_ios_podfile_setup + +target 'Runner' do + use_frameworks! + + flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__)) + target 'RunnerTests' do + inherit! :search_paths + end +end + +post_install do |installer| + installer.pods_project.targets.each do |target| + flutter_additional_ios_build_settings(target) + end +end diff --git a/packages/web_android_shell/ios/Runner.xcodeproj/project.pbxproj b/packages/web_android_shell/ios/Runner.xcodeproj/project.pbxproj new file mode 100644 index 0000000..338afe6 --- /dev/null +++ b/packages/web_android_shell/ios/Runner.xcodeproj/project.pbxproj @@ -0,0 +1,620 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 54; + objects = { + +/* Begin PBXBuildFile section */ + 1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */ = {isa = PBXBuildFile; fileRef = 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */; }; + 331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C807B294A618700263BE5 /* RunnerTests.swift */; }; + 3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */ = {isa = PBXBuildFile; fileRef = 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */; }; + 74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 74858FAE1ED2DC5600515810 /* AppDelegate.swift */; }; + 7884E8682EC3CC0700C636F2 /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */; }; + 97C146FC1CF9000F007C117D /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FA1CF9000F007C117D /* Main.storyboard */; }; + 97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FD1CF9000F007C117D /* Assets.xcassets */; }; + 97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */; }; +/* End PBXBuildFile section */ + +/* Begin PBXContainerItemProxy section */ + 331C8085294A63A400263BE5 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 97C146E61CF9000F007C117D /* Project object */; + proxyType = 1; + remoteGlobalIDString = 97C146ED1CF9000F007C117D; + remoteInfo = Runner; + }; +/* End PBXContainerItemProxy section */ + +/* Begin PBXCopyFilesBuildPhase section */ + 9705A1C41CF9048500538489 /* Embed Frameworks */ = { + isa = PBXCopyFilesBuildPhase; + buildActionMask = 2147483647; + dstPath = ""; + dstSubfolderSpec = 10; + files = ( + ); + name = "Embed Frameworks"; + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXCopyFilesBuildPhase section */ + +/* Begin PBXFileReference section */ + 1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = GeneratedPluginRegistrant.h; sourceTree = ""; }; + 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = GeneratedPluginRegistrant.m; sourceTree = ""; }; + 331C807B294A618700263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = ""; }; + 331C8081294A63A400263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; + 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; name = AppFrameworkInfo.plist; path = Flutter/AppFrameworkInfo.plist; sourceTree = ""; }; + 74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "Runner-Bridging-Header.h"; sourceTree = ""; }; + 74858FAE1ED2DC5600515810 /* AppDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; + 7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SceneDelegate.swift; sourceTree = ""; }; + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = Release.xcconfig; path = Flutter/Release.xcconfig; sourceTree = ""; }; + 9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Debug.xcconfig; path = Flutter/Debug.xcconfig; sourceTree = ""; }; + 9740EEB31CF90195004384FC /* Generated.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Generated.xcconfig; path = Flutter/Generated.xcconfig; sourceTree = ""; }; + 97C146EE1CF9000F007C117D /* Runner.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Runner.app; sourceTree = BUILT_PRODUCTS_DIR; }; + 97C146FB1CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = ""; }; + 97C146FD1CF9000F007C117D /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = ""; }; + 97C147001CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = ""; }; + 97C147021CF9000F007C117D /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 97C146EB1CF9000F007C117D /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 331C8082294A63A400263BE5 /* RunnerTests */ = { + isa = PBXGroup; + children = ( + 331C807B294A618700263BE5 /* RunnerTests.swift */, + ); + path = RunnerTests; + sourceTree = ""; + }; + 9740EEB11CF90186004384FC /* Flutter */ = { + isa = PBXGroup; + children = ( + 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */, + 9740EEB21CF90195004384FC /* Debug.xcconfig */, + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */, + 9740EEB31CF90195004384FC /* Generated.xcconfig */, + ); + name = Flutter; + sourceTree = ""; + }; + 97C146E51CF9000F007C117D = { + isa = PBXGroup; + children = ( + 9740EEB11CF90186004384FC /* Flutter */, + 97C146F01CF9000F007C117D /* Runner */, + 97C146EF1CF9000F007C117D /* Products */, + 331C8082294A63A400263BE5 /* RunnerTests */, + ); + sourceTree = ""; + }; + 97C146EF1CF9000F007C117D /* Products */ = { + isa = PBXGroup; + children = ( + 97C146EE1CF9000F007C117D /* Runner.app */, + 331C8081294A63A400263BE5 /* RunnerTests.xctest */, + ); + name = Products; + sourceTree = ""; + }; + 97C146F01CF9000F007C117D /* Runner */ = { + isa = PBXGroup; + children = ( + 97C146FA1CF9000F007C117D /* Main.storyboard */, + 97C146FD1CF9000F007C117D /* Assets.xcassets */, + 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */, + 97C147021CF9000F007C117D /* Info.plist */, + 1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */, + 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */, + 74858FAE1ED2DC5600515810 /* AppDelegate.swift */, + 7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */, + 74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */, + ); + path = Runner; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 331C8080294A63A400263BE5 /* RunnerTests */ = { + isa = PBXNativeTarget; + buildConfigurationList = 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */; + buildPhases = ( + 331C807D294A63A400263BE5 /* Sources */, + 331C807F294A63A400263BE5 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 331C8086294A63A400263BE5 /* PBXTargetDependency */, + ); + name = RunnerTests; + productName = RunnerTests; + productReference = 331C8081294A63A400263BE5 /* RunnerTests.xctest */; + productType = "com.apple.product-type.bundle.unit-test"; + }; + 97C146ED1CF9000F007C117D /* Runner */ = { + isa = PBXNativeTarget; + buildConfigurationList = 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */; + buildPhases = ( + 9740EEB61CF901F6004384FC /* Run Script */, + 97C146EA1CF9000F007C117D /* Sources */, + 97C146EB1CF9000F007C117D /* Frameworks */, + 97C146EC1CF9000F007C117D /* Resources */, + 9705A1C41CF9048500538489 /* Embed Frameworks */, + 3B06AD1E1E4923F5004D2608 /* Thin Binary */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = Runner; + productName = Runner; + productReference = 97C146EE1CF9000F007C117D /* Runner.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 97C146E61CF9000F007C117D /* Project object */ = { + isa = PBXProject; + attributes = { + BuildIndependentTargetsInParallel = YES; + LastUpgradeCheck = 1510; + ORGANIZATIONNAME = ""; + TargetAttributes = { + 331C8080294A63A400263BE5 = { + CreatedOnToolsVersion = 14.0; + TestTargetID = 97C146ED1CF9000F007C117D; + }; + 97C146ED1CF9000F007C117D = { + CreatedOnToolsVersion = 7.3.1; + LastSwiftMigration = 1100; + }; + }; + }; + buildConfigurationList = 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */; + compatibilityVersion = "Xcode 9.3"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 97C146E51CF9000F007C117D; + productRefGroup = 97C146EF1CF9000F007C117D /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 97C146ED1CF9000F007C117D /* Runner */, + 331C8080294A63A400263BE5 /* RunnerTests */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 331C807F294A63A400263BE5 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 97C146EC1CF9000F007C117D /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */, + 3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */, + 97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */, + 97C146FC1CF9000F007C117D /* Main.storyboard in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXShellScriptBuildPhase section */ + 3B06AD1E1E4923F5004D2608 /* Thin Binary */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputPaths = ( + "${TARGET_BUILD_DIR}/${INFOPLIST_PATH}", + ); + name = "Thin Binary"; + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" embed_and_thin"; + }; + 9740EEB61CF901F6004384FC /* Run Script */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputPaths = ( + ); + name = "Run Script"; + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build"; + }; +/* End PBXShellScriptBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 331C807D294A63A400263BE5 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 97C146EA1CF9000F007C117D /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */, + 1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */, + 7884E8682EC3CC0700C636F2 /* SceneDelegate.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXTargetDependency section */ + 331C8086294A63A400263BE5 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 97C146ED1CF9000F007C117D /* Runner */; + targetProxy = 331C8085294A63A400263BE5 /* PBXContainerItemProxy */; + }; +/* End PBXTargetDependency section */ + +/* Begin PBXVariantGroup section */ + 97C146FA1CF9000F007C117D /* Main.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 97C146FB1CF9000F007C117D /* Base */, + ); + name = Main.storyboard; + sourceTree = ""; + }; + 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 97C147001CF9000F007C117D /* Base */, + ); + name = LaunchScreen.storyboard; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 249021D3217E4FDB00AE95B9 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = iphoneos; + SUPPORTED_PLATFORMS = iphoneos; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + }; + name = Profile; + }; + 249021D4217E4FDB00AE95B9 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.yuanxuan.webshell.webAndroidShell; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Profile; + }; + 331C8088294A63A400263BE5 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.yuanxuan.webshell.webAndroidShell.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Debug; + }; + 331C8089294A63A400263BE5 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.yuanxuan.webshell.webAndroidShell.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Release; + }; + 331C808A294A63A400263BE5 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.yuanxuan.webshell.webAndroidShell.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Profile; + }; + 97C147031CF9000F007C117D /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = YES; + ONLY_ACTIVE_ARCH = YES; + SDKROOT = iphoneos; + TARGETED_DEVICE_FAMILY = "1,2"; + }; + name = Debug; + }; + 97C147041CF9000F007C117D /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = iphoneos; + SUPPORTED_PLATFORMS = iphoneos; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + }; + name = Release; + }; + 97C147061CF9000F007C117D /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.yuanxuan.webshell.webAndroidShell; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Debug; + }; + 97C147071CF9000F007C117D /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.yuanxuan.webshell.webAndroidShell; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 331C8088294A63A400263BE5 /* Debug */, + 331C8089294A63A400263BE5 /* Release */, + 331C808A294A63A400263BE5 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 97C147031CF9000F007C117D /* Debug */, + 97C147041CF9000F007C117D /* Release */, + 249021D3217E4FDB00AE95B9 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 97C147061CF9000F007C117D /* Debug */, + 97C147071CF9000F007C117D /* Release */, + 249021D4217E4FDB00AE95B9 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 97C146E61CF9000F007C117D /* Project object */; +} diff --git a/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..c4b79bd --- /dev/null +++ b/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..fc6bf80 --- /dev/null +++ b/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings new file mode 100644 index 0000000..af0309c --- /dev/null +++ b/packages/web_android_shell/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings @@ -0,0 +1,8 @@ + + + + + PreviewsEnabled + + + diff --git a/packages/web_android_shell/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/packages/web_android_shell/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme new file mode 100644 index 0000000..bbabc4e --- /dev/null +++ b/packages/web_android_shell/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme @@ -0,0 +1,101 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/web_android_shell/ios/Runner.xcworkspace/contents.xcworkspacedata b/packages/web_android_shell/ios/Runner.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..59c6d39 --- /dev/null +++ b/packages/web_android_shell/ios/Runner.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/packages/web_android_shell/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/web_android_shell/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..fc6bf80 --- /dev/null +++ b/packages/web_android_shell/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/packages/web_android_shell/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/packages/web_android_shell/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings new file mode 100644 index 0000000..af0309c --- /dev/null +++ b/packages/web_android_shell/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings @@ -0,0 +1,8 @@ + + + + + PreviewsEnabled + + + diff --git a/packages/web_android_shell/ios/Runner/AppDelegate.swift b/packages/web_android_shell/ios/Runner/AppDelegate.swift new file mode 100644 index 0000000..ed1c097 --- /dev/null +++ b/packages/web_android_shell/ios/Runner/AppDelegate.swift @@ -0,0 +1,16 @@ +import Flutter +import UIKit + +@main +@objc class AppDelegate: FlutterAppDelegate, FlutterImplicitEngineDelegate { + override func application( + _ application: UIApplication, + didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? + ) -> Bool { + return super.application(application, didFinishLaunchingWithOptions: launchOptions) + } + + func didInitializeImplicitFlutterEngine(_ engineBridge: FlutterImplicitEngineBridge) { + GeneratedPluginRegistrant.register(with: engineBridge.pluginRegistry) + } +} diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 0000000..1950fd8 --- /dev/null +++ b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,122 @@ +{ + "images" : [ + { + "size" : "20x20", + "idiom" : "iphone", + "filename" : "Icon-App-20x20@2x.png", + "scale" : "2x" + }, + { + "size" : "20x20", + "idiom" : "iphone", + "filename" : "Icon-App-20x20@3x.png", + "scale" : "3x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@1x.png", + "scale" : "1x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@2x.png", + "scale" : "2x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@3x.png", + "scale" : "3x" + }, + { + "size" : "40x40", + "idiom" : "iphone", + "filename" : "Icon-App-40x40@2x.png", + "scale" : "2x" + }, + { + "size" : "40x40", + "idiom" : "iphone", + "filename" : "Icon-App-40x40@3x.png", + "scale" : "3x" + }, + { + "size" : "60x60", + "idiom" : "iphone", + "filename" : "Icon-App-60x60@2x.png", + "scale" : "2x" + }, + { + "size" : "60x60", + "idiom" : "iphone", + "filename" : "Icon-App-60x60@3x.png", + "scale" : "3x" + }, + { + "size" : "20x20", + "idiom" : "ipad", + "filename" : "Icon-App-20x20@1x.png", + "scale" : "1x" + }, + { + "size" : "20x20", + "idiom" : "ipad", + "filename" : "Icon-App-20x20@2x.png", + "scale" : "2x" + }, + { + "size" : "29x29", + "idiom" : "ipad", + "filename" : "Icon-App-29x29@1x.png", + "scale" : "1x" + }, + { + "size" : "29x29", + "idiom" : "ipad", + "filename" : "Icon-App-29x29@2x.png", + "scale" : "2x" + }, + { + "size" : "40x40", + "idiom" : "ipad", + "filename" : "Icon-App-40x40@1x.png", + "scale" : "1x" + }, + { + "size" : "40x40", + "idiom" : "ipad", + "filename" : "Icon-App-40x40@2x.png", + "scale" : "2x" + }, + { + "size" : "76x76", + "idiom" : "ipad", + "filename" : "Icon-App-76x76@1x.png", + "scale" : "1x" + }, + { + "size" : "76x76", + "idiom" : "ipad", + "filename" : "Icon-App-76x76@2x.png", + "scale" : "2x" + }, + { + "size" : "83.5x83.5", + "idiom" : "ipad", + "filename" : "Icon-App-83.5x83.5@2x.png", + "scale" : "2x" + }, + { + "size" : "1024x1024", + "idiom" : "ios-marketing", + "filename" : "Icon-App-1024x1024@1x.png", + "scale" : "1x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png new file mode 100644 index 0000000..dc9ada4 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png new file mode 100644 index 0000000..7353c41 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png new file mode 100644 index 0000000..797d452 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png new file mode 100644 index 0000000..6ed2d93 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png new file mode 100644 index 0000000..4cd7b00 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png new file mode 100644 index 0000000..fe73094 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png new file mode 100644 index 0000000..321773c Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png new file mode 100644 index 0000000..797d452 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png new file mode 100644 index 0000000..502f463 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png new file mode 100644 index 0000000..0ec3034 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png new file mode 100644 index 0000000..0ec3034 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png new file mode 100644 index 0000000..e9f5fea Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png new file mode 100644 index 0000000..84ac32a Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png new file mode 100644 index 0000000..8953cba Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png new file mode 100644 index 0000000..0467bf1 Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json new file mode 100644 index 0000000..d08a4de --- /dev/null +++ b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "idiom" : "universal", + "filename" : "LaunchImage.png", + "scale" : "1x" + }, + { + "idiom" : "universal", + "filename" : "LaunchImage@2x.png", + "scale" : "2x" + }, + { + "idiom" : "universal", + "filename" : "LaunchImage@3x.png", + "scale" : "3x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png new file mode 100644 index 0000000..9da19ea Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png new file mode 100644 index 0000000..9da19ea Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png new file mode 100644 index 0000000..9da19ea Binary files /dev/null and b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png differ diff --git a/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md new file mode 100644 index 0000000..65a94b5 --- /dev/null +++ b/packages/web_android_shell/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md @@ -0,0 +1,5 @@ +# Launch Screen Assets + +You can customize the launch screen with your own desired assets by replacing the image files in this directory. + +You can also do it by opening your Flutter project's Xcode project with `open ios/Runner.xcworkspace`, selecting `Runner/Assets.xcassets` in the Project Navigator and dropping in the desired images. \ No newline at end of file diff --git a/packages/web_android_shell/ios/Runner/Base.lproj/LaunchScreen.storyboard b/packages/web_android_shell/ios/Runner/Base.lproj/LaunchScreen.storyboard new file mode 100644 index 0000000..497371e --- /dev/null +++ b/packages/web_android_shell/ios/Runner/Base.lproj/LaunchScreen.storyboard @@ -0,0 +1,37 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/web_android_shell/ios/Runner/Base.lproj/Main.storyboard b/packages/web_android_shell/ios/Runner/Base.lproj/Main.storyboard new file mode 100644 index 0000000..bbb83ca --- /dev/null +++ b/packages/web_android_shell/ios/Runner/Base.lproj/Main.storyboard @@ -0,0 +1,26 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/web_android_shell/ios/Runner/Info.plist b/packages/web_android_shell/ios/Runner/Info.plist new file mode 100644 index 0000000..77f90b9 --- /dev/null +++ b/packages/web_android_shell/ios/Runner/Info.plist @@ -0,0 +1,70 @@ + + + + + CADisableMinimumFrameDurationOnPhone + + CFBundleDevelopmentRegion + $(DEVELOPMENT_LANGUAGE) + CFBundleDisplayName + web_android_shell + CFBundleExecutable + $(EXECUTABLE_NAME) + CFBundleIdentifier + $(PRODUCT_BUNDLE_IDENTIFIER) + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + web_android_shell + CFBundlePackageType + APPL + CFBundleShortVersionString + $(FLUTTER_BUILD_NAME) + CFBundleSignature + ???? + CFBundleVersion + $(FLUTTER_BUILD_NUMBER) + LSRequiresIPhoneOS + + UIApplicationSceneManifest + + UIApplicationSupportsMultipleScenes + + UISceneConfigurations + + UIWindowSceneSessionRoleApplication + + + UISceneClassName + UIWindowScene + UISceneConfigurationName + flutter + UISceneDelegateClassName + $(PRODUCT_MODULE_NAME).SceneDelegate + UISceneStoryboardFile + Main + + + + + UIApplicationSupportsIndirectInputEvents + + UILaunchStoryboardName + LaunchScreen + UIMainStoryboardFile + Main + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + UISupportedInterfaceOrientations~ipad + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + + diff --git a/packages/web_android_shell/ios/Runner/Runner-Bridging-Header.h b/packages/web_android_shell/ios/Runner/Runner-Bridging-Header.h new file mode 100644 index 0000000..fae207f --- /dev/null +++ b/packages/web_android_shell/ios/Runner/Runner-Bridging-Header.h @@ -0,0 +1 @@ +#import "GeneratedPluginRegistrant.h" diff --git a/packages/web_android_shell/ios/Runner/SceneDelegate.swift b/packages/web_android_shell/ios/Runner/SceneDelegate.swift new file mode 100644 index 0000000..b79be9b --- /dev/null +++ b/packages/web_android_shell/ios/Runner/SceneDelegate.swift @@ -0,0 +1,6 @@ +import Flutter +import UIKit + +class SceneDelegate: FlutterSceneDelegate { + +} diff --git a/packages/web_android_shell/ios/RunnerTests/RunnerTests.swift b/packages/web_android_shell/ios/RunnerTests/RunnerTests.swift new file mode 100644 index 0000000..4d206de --- /dev/null +++ b/packages/web_android_shell/ios/RunnerTests/RunnerTests.swift @@ -0,0 +1,12 @@ +import Flutter +import UIKit +import XCTest + +class RunnerTests: XCTestCase { + + func testExample() { + // If you add code to the Runner application, consider adding tests here. + // See https://developer.apple.com/documentation/xctest for more information about using XCTest. + } + +} diff --git a/packages/web_android_shell/lib/main.dart b/packages/web_android_shell/lib/main.dart new file mode 100644 index 0000000..f12a3fc --- /dev/null +++ b/packages/web_android_shell/lib/main.dart @@ -0,0 +1,2080 @@ +import 'dart:async'; +import 'dart:convert'; + +import 'package:file_picker/file_picker.dart'; +import 'package:flutter/foundation.dart'; +import 'package:flutter/material.dart'; +import 'package:flutter/scheduler.dart'; +import 'package:flutter/services.dart'; +import 'package:image_picker/image_picker.dart'; +import 'package:permission_handler/permission_handler.dart'; +import 'package:url_launcher/url_launcher.dart'; +import 'package:webview_flutter/webview_flutter.dart'; +import 'package:webview_flutter_android/webview_flutter_android.dart'; + +const String _defaultInitialUrl = 'http://xszy.lzzneng.com/login.html'; +const String _configuredInitialUrl = String.fromEnvironment( + 'APP_INITIAL_URL', + defaultValue: _defaultInitialUrl, +); +const String _appShellBridgeChannel = 'AppShellBridge'; +const String _appShellBridgeVersion = '1.0.0'; +const Duration _releaseStartupWatchdogDuration = Duration(seconds: 15); +const Duration _debugStartupWatchdogDuration = Duration(seconds: 15); +const double _pickedImageMaxWidth = 1600; +const double _pickedImageMaxHeight = 1600; +const int _pickedImageQuality = 85; +const MethodChannel _appShellDeviceChannel = MethodChannel('app_shell/device'); +const int _legacyWebViewMajorVersionThreshold = 110; +const Color _shellAccentColor = Color(0xFF3ED37B); +const Color _shellBackgroundColor = Color(0xFFFFFFFF); +const Color _shellTextColor = Color(0xFF1F2937); +const Color _shellMutedTextColor = Color(0xFF6B7280); + +final Uri _initialUri = _resolveInitialUri(); +final String _initialUrl = _initialUri.toString(); + +Uri _resolveInitialUri() { + final String candidate = _configuredInitialUrl.trim(); + if (candidate.isEmpty) { + return Uri.parse(_defaultInitialUrl); + } + + final Uri? directUri = Uri.tryParse(candidate); + if (directUri != null && directUri.hasScheme) { + return directUri; + } + + if (candidate.startsWith('//')) { + final Uri? protocolRelativeUri = Uri.tryParse('https:$candidate'); + if (protocolRelativeUri != null && protocolRelativeUri.hasScheme) { + return protocolRelativeUri; + } + } + + final Uri? httpsUri = Uri.tryParse('https://$candidate'); + if (httpsUri != null && httpsUri.hasScheme && httpsUri.host.isNotEmpty) { + return httpsUri; + } + return Uri.parse(_defaultInitialUrl); +} + +bool _supportsEmbeddedWebView({bool isWeb = kIsWeb, TargetPlatform? platform}) { + if (isWeb) { + return false; + } + + final TargetPlatform target = platform ?? defaultTargetPlatform; + return target == TargetPlatform.android || + target == TargetPlatform.iOS || + target == TargetPlatform.macOS; +} + +Future main() async { + WidgetsFlutterBinding.ensureInitialized(); + await SystemChrome.setPreferredOrientations(const [ + DeviceOrientation.portraitUp, + DeviceOrientation.portraitDown, + ]); + await _enterImmersiveMode(); + runApp(const WebShellApp()); +} + +Future _enterImmersiveMode() async { + await SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky); + SystemChrome.setSystemUIOverlayStyle( + const SystemUiOverlayStyle( + statusBarColor: Colors.transparent, + statusBarIconBrightness: Brightness.light, + statusBarBrightness: Brightness.dark, + systemNavigationBarColor: Colors.black, + systemNavigationBarDividerColor: Colors.black, + systemNavigationBarIconBrightness: Brightness.light, + ), + ); +} + +enum _AndroidRenderMode { + texture, + hybrid; + + bool get usesHybridComposition => this == _AndroidRenderMode.hybrid; + + String get logName => switch (this) { + _AndroidRenderMode.texture => 'texture-layer', + _AndroidRenderMode.hybrid => 'hybrid-composition', + }; + + String get displayName => switch (this) { + _AndroidRenderMode.texture => '标准模式', + _AndroidRenderMode.hybrid => '兼容模式', + }; +} + +class _AndroidWebViewInfo { + _AndroidWebViewInfo({ + required this.sdkInt, + required this.manufacturer, + required this.brand, + required this.model, + this.webViewDataDirectorySuffix, + this.webViewPackageName, + this.webViewVersionName, + this.webViewLongVersionCode, + }) : webViewMajorVersion = _parseWebViewMajorVersion(webViewVersionName); + + factory _AndroidWebViewInfo.fromMap(Map raw) { + return _AndroidWebViewInfo( + sdkInt: _readInt(raw['sdkInt']), + manufacturer: _readString(raw['manufacturer']), + brand: _readString(raw['brand']), + model: _readString(raw['model']), + webViewDataDirectorySuffix: _readNullableString( + raw['webViewDataDirectorySuffix'], + ), + webViewPackageName: _readNullableString(raw['webViewPackageName']), + webViewVersionName: _readNullableString(raw['webViewVersionName']), + webViewLongVersionCode: _readNullableInt(raw['webViewLongVersionCode']), + ); + } + + final int sdkInt; + final String manufacturer; + final String brand; + final String model; + final String? webViewDataDirectorySuffix; + final String? webViewPackageName; + final String? webViewVersionName; + final int? webViewLongVersionCode; + final int? webViewMajorVersion; + + bool get isLegacyWebView => + webViewMajorVersion != null && + webViewMajorVersion! <= _legacyWebViewMajorVersionThreshold; + + bool get isF136A => model.toUpperCase() == 'F136A'; + + String get summary { + final List parts = [ + 'sdk=$sdkInt', + if (manufacturer.isNotEmpty || model.isNotEmpty) + 'device=${[manufacturer, model].where((part) => part.isNotEmpty).join(' ')}', + if (webViewPackageName case final String packageName + when packageName.isNotEmpty) + 'webViewPackage=$packageName', + if (webViewVersionName case final String versionName + when versionName.isNotEmpty) + 'webViewVersion=$versionName', + if (webViewDataDirectorySuffix case final String suffix + when suffix.isNotEmpty) + 'webViewSuffix=$suffix', + ]; + return parts.join(', '); + } + + static int _readInt(Object? value, {int fallback = 0}) { + if (value is int) { + return value; + } + return int.tryParse((value ?? '').toString()) ?? fallback; + } + + static int? _readNullableInt(Object? value) { + if (value == null) { + return null; + } + if (value is int) { + return value; + } + return int.tryParse(value.toString()); + } + + static String _readString(Object? value) { + return (value ?? '').toString().trim(); + } + + static String? _readNullableString(Object? value) { + final String normalized = _readString(value); + return normalized.isEmpty ? null : normalized; + } +} + +class _AndroidCompatibilityPlan { + const _AndroidCompatibilityPlan({ + required this.renderModes, + required this.useWideViewPort, + required this.suggestWebViewUpdate, + required this.prefersAggressiveRecovery, + }); + + factory _AndroidCompatibilityPlan.fallback() { + return _AndroidCompatibilityPlan( + renderModes: kDebugMode + ? const <_AndroidRenderMode>[ + _AndroidRenderMode.texture, + _AndroidRenderMode.hybrid, + ] + : const <_AndroidRenderMode>[ + _AndroidRenderMode.hybrid, + _AndroidRenderMode.texture, + ], + useWideViewPort: true, + suggestWebViewUpdate: false, + prefersAggressiveRecovery: true, + ); + } + + factory _AndroidCompatibilityPlan.fromInfo(_AndroidWebViewInfo? info) { + if (info == null) { + return _AndroidCompatibilityPlan.fallback(); + } + + final bool legacyAndroid = info.sdkInt <= 28; + final bool legacyWebView = info.isLegacyWebView; + final bool preferHybridFirst = + info.isF136A || legacyAndroid || legacyWebView; + + return _AndroidCompatibilityPlan( + renderModes: preferHybridFirst + ? const <_AndroidRenderMode>[ + _AndroidRenderMode.hybrid, + _AndroidRenderMode.texture, + ] + : const <_AndroidRenderMode>[ + _AndroidRenderMode.texture, + _AndroidRenderMode.hybrid, + ], + useWideViewPort: true, + suggestWebViewUpdate: info.isF136A || legacyWebView || info.sdkInt <= 26, + prefersAggressiveRecovery: info.isF136A || legacyAndroid || legacyWebView, + ); + } + + final List<_AndroidRenderMode> renderModes; + final bool useWideViewPort; + final bool suggestWebViewUpdate; + final bool prefersAggressiveRecovery; + + String describe() { + return [ + 'modes=${renderModes.map((mode) => mode.logName).join(' -> ')}', + 'wideViewport=$useWideViewPort', + 'aggressiveRecovery=$prefersAggressiveRecovery', + ].join(', '); + } +} + +int? _parseWebViewMajorVersion(String? versionName) { + if (versionName == null || versionName.isEmpty) { + return null; + } + final String candidate = versionName.split('.').first.trim(); + return int.tryParse(candidate); +} + +class WebShellApp extends StatelessWidget { + const WebShellApp({super.key}); + + @override + Widget build(BuildContext context) { + return MaterialApp( + debugShowCheckedModeBanner: false, + home: _supportsEmbeddedWebView() + ? const WebShellPage() + : const UnsupportedPlatformPage(), + ); + } +} + +class WebShellPage extends StatefulWidget { + const WebShellPage({super.key}); + + @override + State createState() => _WebShellPageState(); +} + +class _WebShellPageState extends State + with WidgetsBindingObserver { + final ImagePicker _imagePicker = ImagePicker(); + final WebViewCookieManager _cookieManager = WebViewCookieManager(); + + late WebViewController _controller; + late WebViewWidget _webViewWidget; + late Future _controllerSetupFuture; + late final Future _androidCompatibilityFuture; + _AndroidWebViewInfo? _androidWebViewInfo; + _AndroidCompatibilityPlan _androidCompatibilityPlan = + _AndroidCompatibilityPlan.fallback(); + _AndroidRenderMode? _configuredRenderMode; + int _webViewGeneration = 0; + int _renderModeIndex = 0; + + bool _hasTriggeredInitialLoad = false; + bool _hasAppliedCompatibilityPlan = false; + bool _isLoadingPage = false; + bool _hasBootstrapped = false; + bool _hasStartedRemoteMainFrame = false; + bool _hasMainFrameError = false; + bool _hasMeasuredProgress = false; + Timer? _startupWatchdogTimer; + int _progress = 0; + int _startupRetryCount = 0; + String _currentUrl = _initialUrl; + String _errorTitle = '页面加载失败'; + String _errorMessage = '请检查网络后重试。'; + String _lastWebViewEvent = '应用启动'; + + @override + void initState() { + super.initState(); + debugPrint('WebShell initState, initialUrl=$_initialUrl'); + WidgetsBinding.instance.addObserver(this); + _androidCompatibilityFuture = _prepareAndroidCompatibility(); + _recreateWebView(); + + WidgetsBinding.instance.addPostFrameCallback((_) { + if (!mounted || _hasTriggeredInitialLoad) { + return; + } + _hasTriggeredInitialLoad = true; + unawaited(_loadInitialPage()); + }); + } + + int get _safeRenderModeIndex { + if (_renderModeIndex < 0) { + return 0; + } + final int maxIndex = _androidCompatibilityPlan.renderModes.length - 1; + if (_renderModeIndex > maxIndex) { + return maxIndex; + } + return _renderModeIndex; + } + + _AndroidRenderMode get _activeRenderMode => + _androidCompatibilityPlan.renderModes[_safeRenderModeIndex]; + + Duration get _effectiveStartupWatchdogDuration { + if (defaultTargetPlatform != TargetPlatform.android) { + return _releaseStartupWatchdogDuration; + } + if (kDebugMode) { + return _debugStartupWatchdogDuration; + } + return _releaseStartupWatchdogDuration; + } + + Future _prepareAndroidCompatibility() async { + if (defaultTargetPlatform != TargetPlatform.android) { + return; + } + + try { + final Map? rawInfo = await _appShellDeviceChannel + .invokeMapMethod('getAndroidWebViewInfo'); + if (rawInfo != null) { + _androidWebViewInfo = _AndroidWebViewInfo.fromMap(rawInfo); + } + } catch (error, stackTrace) { + debugPrint('Load Android WebView info failed: $error\n$stackTrace'); + } + + _androidCompatibilityPlan = _AndroidCompatibilityPlan.fromInfo( + _androidWebViewInfo, + ); + _renderModeIndex = 0; + debugPrint( + 'WebShell Android WebView info: ' + '${_androidWebViewInfo?.summary ?? 'unavailable'}', + ); + debugPrint( + 'WebShell compatibility plan: ${_androidCompatibilityPlan.describe()}', + ); + } + + Future _ensureCompatibilityPlanApplied() async { + await _androidCompatibilityFuture; + if (!mounted || + _hasAppliedCompatibilityPlan || + defaultTargetPlatform != TargetPlatform.android) { + return; + } + + _hasAppliedCompatibilityPlan = true; + if (_configuredRenderMode == _activeRenderMode) { + debugPrint( + 'WebShell compatibility plan keeps current WebView ' + '(${_activeRenderMode.logName})', + ); + return; + } + _recreateWebView(); + } + + bool _switchToNextRenderMode() { + final int nextIndex = _safeRenderModeIndex + 1; + if (nextIndex >= _androidCompatibilityPlan.renderModes.length) { + return false; + } + + _renderModeIndex = nextIndex; + debugPrint('WebShell switched render mode to ${_activeRenderMode.logName}'); + return true; + } + + String _buildCompatibilityGuidance() { + if (defaultTargetPlatform != TargetPlatform.android) { + return ''; + } + + final List lines = [ + '当前渲染策略：${_activeRenderMode.displayName}', + if (_androidWebViewInfo?.model case final String model + when model.isNotEmpty) + '当前设备：$model', + if (_androidWebViewInfo?.webViewVersionName case final String version + when version.isNotEmpty) + '系统 WebView：$version', + if (_androidCompatibilityPlan.suggestWebViewUpdate) + '如果内嵌页面仍异常，建议更新 Android System WebView 或 Chrome。', + ]; + return lines.join('\n'); + } + + void _recreateWebView() { + final PlatformWebViewControllerCreationParams controllerParams = + const PlatformWebViewControllerCreationParams(); + final WebViewController controller = + WebViewController.fromPlatformCreationParams(controllerParams); + final int generation = ++_webViewGeneration; + final _AndroidRenderMode renderMode = _activeRenderMode; + + _controller = controller; + _controllerSetupFuture = _configureController(controller, generation); + _configuredRenderMode = renderMode; + debugPrint( + 'WebShell recreate WebView #$generation with ${renderMode.logName}', + ); + PlatformWebViewWidgetCreationParams widgetParams = + PlatformWebViewWidgetCreationParams( + key: ValueKey('webview-$generation-${renderMode.logName}'), + controller: controller.platform, + layoutDirection: TextDirection.ltr, + ); + + if (defaultTargetPlatform == TargetPlatform.android) { + widgetParams = + AndroidWebViewWidgetCreationParams.fromPlatformWebViewWidgetCreationParams( + widgetParams, + displayWithHybridComposition: renderMode.usesHybridComposition, + ); + } + + _webViewWidget = WebViewWidget.fromPlatformCreationParams( + params: widgetParams, + ); + } + + bool _isActiveWebViewGeneration(int generation) { + return generation == _webViewGeneration; + } + + Future _configureController( + WebViewController controller, + int generation, + ) async { + await controller.setJavaScriptMode(JavaScriptMode.unrestricted); + await controller.enableZoom(false); + await controller.setBackgroundColor(Colors.white); + await controller.addJavaScriptChannel( + _appShellBridgeChannel, + onMessageReceived: (JavaScriptMessage message) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + unawaited(_handleBridgeMessage(message.message)); + }, + ); + await controller.setNavigationDelegate( + _buildNavigationDelegate(generation), + ); + + if (controller.platform is AndroidWebViewController) { + final AndroidWebViewController androidController = + controller.platform as AndroidWebViewController; + + await AndroidWebViewController.enableDebugging( + kDebugMode && !_androidCompatibilityPlan.prefersAggressiveRecovery, + ); + await androidController.setMediaPlaybackRequiresUserGesture(false); + await androidController.setMixedContentMode(MixedContentMode.alwaysAllow); + await androidController.setOverScrollMode(WebViewOverScrollMode.never); + await androidController.setUseWideViewPort( + _androidCompatibilityPlan.useWideViewPort, + ); + await androidController.setTextZoom(100); + await androidController.setVerticalScrollBarEnabled(false); + await androidController.setHorizontalScrollBarEnabled(false); + await androidController.setOnShowFileSelector(_handleFileSelector); + await androidController.setOnPlatformPermissionRequest( + _handlePlatformPermissionRequest, + ); + await androidController.setGeolocationPermissionsPromptCallbacks( + onShowPrompt: _handleGeolocationPermissionRequest, + ); + await androidController.setOnConsoleMessage((message) { + debugPrint( + 'WebView console [${message.level.name}] ${message.message}', + ); + }); + } + } + + NavigationDelegate _buildNavigationDelegate(int generation) { + return NavigationDelegate( + onProgress: (int progress) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + if (progress == 10 || + progress == 30 || + progress == 60 || + progress == 90) { + _recordWebViewEvent('加载进度 $progress%'); + } + if (!mounted) { + return; + } + setState(() { + _progress = progress; + if (_hasStartedRemoteMainFrame || progress >= 100) { + _hasMeasuredProgress = true; + } + }); + }, + onNavigationRequest: (NavigationRequest request) async { + if (!_isActiveWebViewGeneration(generation)) { + return NavigationDecision.navigate; + } + return _handleNavigationRequest(request); + }, + onUrlChange: (UrlChange change) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + final String? url = change.url; + if (url == null || url.isEmpty) { + return; + } + _recordWebViewEvent('地址变化：$url'); + if (!mounted) { + return; + } + setState(() { + _currentUrl = url; + }); + }, + onPageStarted: (url) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + if (!_isNetworkUrl(url)) { + debugPrint('WebView ignore non-network page start: $url'); + return; + } + _hasStartedRemoteMainFrame = true; + _cancelStartupWatchdog(); + _recordWebViewEvent('页面开始加载：$url'); + if (!mounted) { + return; + } + setState(() { + _currentUrl = url; + if (_hasMeasuredProgress) { + _progress = _progress < 30 ? 30 : _progress; + } + _isLoadingPage = true; + _hasBootstrapped = true; + _hasMainFrameError = false; + _errorTitle = '页面加载失败'; + _errorMessage = '请检查网络后重试。'; + }); + }, + onPageFinished: (url) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + if (!_isNetworkUrl(url)) { + debugPrint('WebView ignore non-network page finish: $url'); + return; + } + _recordWebViewEvent('页面加载完成：$url'); + _cancelStartupWatchdog(); + unawaited(_injectAppShellBridge(url)); + if (!mounted) { + return; + } + setState(() { + _currentUrl = url; + _hasMeasuredProgress = true; + _progress = 100; + _isLoadingPage = false; + _hasBootstrapped = true; + _hasMainFrameError = false; + _startupRetryCount = 0; + }); + }, + onHttpError: (HttpResponseError error) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + final int? statusCode = error.response?.statusCode; + final Uri? requestUri = error.request?.uri; + if (!_shouldTreatHttpErrorAsMainFrame(error)) { + debugPrint( + 'Ignore subresource HTTP error: ' + '${statusCode ?? 'unknown'} ${requestUri ?? 'unknown'}', + ); + return; + } + _recordWebViewEvent( + 'HTTP 错误：${statusCode ?? 'unknown'} ${requestUri ?? _currentUrl}', + ); + _setMainFrameError( + title: statusCode == null ? '服务器响应异常' : '服务器异常 $statusCode', + message: statusCode == null + ? '页面返回异常，请稍后重试。' + : '页面返回了 $statusCode 状态码，请稍后重试。', + ); + }, + onWebResourceError: (error) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + _recordWebViewEvent( + '资源错误：code=${error.errorCode}, ' + 'type=${error.errorType}, ' + 'mainFrame=${error.isForMainFrame}, ' + 'url=${error.url}, ' + 'description=${error.description}', + ); + if (!mounted || error.isForMainFrame == false) { + return; + } + _setMainFrameError( + title: _friendlyErrorTitle(error), + message: _friendlyErrorMessage(error), + ); + }, + ); + } + + @override + void didChangeAppLifecycleState(AppLifecycleState state) { + if (state == AppLifecycleState.resumed) { + _enterImmersiveMode(); + } + } + + @override + void dispose() { + _cancelStartupWatchdog(); + WidgetsBinding.instance.removeObserver(this); + super.dispose(); + } + + Future _loadInitialPage() async { + if (!mounted) { + return; + } + await _ensureCompatibilityPlanApplied(); + if (!mounted) { + return; + } + debugPrint('WebShell first frame ready, start initial load'); + await _startLoadSequence(rebuildWebView: false, resetRetryCount: true); + } + + Future _handleBackPressed() async { + if (await _controller.canGoBack()) { + await _controller.goBack(); + return; + } + await SystemNavigator.pop(); + } + + Future _handleNavigationRequest( + NavigationRequest request, + ) async { + final Uri? uri = Uri.tryParse(request.url); + if (uri == null || _shouldStayInWebView(uri)) { + return NavigationDecision.navigate; + } + + final bool opened = await _openExternalUri(uri); + if (!opened) { + await _showWebAlert('无法打开外部应用：${uri.scheme}'); + } + return NavigationDecision.prevent; + } + + bool _isNetworkUrl(String? url) { + final Uri? uri = Uri.tryParse(url ?? ''); + if (uri == null) { + return false; + } + return uri.scheme == 'http' || uri.scheme == 'https'; + } + + bool _shouldStayInWebView(Uri uri) { + return { + 'http', + 'https', + 'about', + 'data', + 'javascript', + 'file', + 'blob', + }.contains(uri.scheme.toLowerCase()); + } + + void _recordWebViewEvent(String event) { + _lastWebViewEvent = event; + debugPrint('WebView $event'); + } + + void _armStartupWatchdog() { + _cancelStartupWatchdog(); + _startupWatchdogTimer = Timer(_effectiveStartupWatchdogDuration, () { + unawaited(_handleStartupTimeout()); + }); + } + + void _cancelStartupWatchdog() { + _startupWatchdogTimer?.cancel(); + _startupWatchdogTimer = null; + } + + Future _handleStartupTimeout() async { + if (!mounted || + !_isLoadingPage || + _hasMainFrameError || + _hasStartedRemoteMainFrame) { + return; + } + + final bool switchedRenderMode = _switchToNextRenderMode(); + final int maxRetryCount = + _androidCompatibilityPlan.prefersAggressiveRecovery ? 2 : 1; + + if (switchedRenderMode || _startupRetryCount < maxRetryCount) { + final int nextRetryCount = _startupRetryCount + 1; + final String recoveryAction = switchedRenderMode + ? '切换到${_activeRenderMode.displayName}' + : '深度清理 WebView 状态'; + _recordWebViewEvent('启动超时，$recoveryAction 并自动重试第 $nextRetryCount 次'); + setState(() { + _startupRetryCount = nextRetryCount; + _hasMeasuredProgress = false; + _progress = 0; + _isLoadingPage = true; + }); + await _recoverFromBrokenStartupState(deepReset: true); + await _startLoadSequence(rebuildWebView: true, resetRetryCount: false); + return; + } + + _setMainFrameError( + title: '页面启动超时', + message: [ + '${_effectiveStartupWatchdogDuration.inSeconds} 秒内没有完成页面加载。', + '最近事件：$_lastWebViewEvent', + _buildCompatibilityGuidance(), + ].where((line) => line.isNotEmpty).join('\n'), + ); + } + + void _setMainFrameError({required String title, required String message}) { + _cancelStartupWatchdog(); + if (!mounted) { + return; + } + setState(() { + _isLoadingPage = false; + _hasMainFrameError = true; + _hasMeasuredProgress = false; + _errorTitle = title; + _errorMessage = message; + _progress = 0; + }); + } + + Future _recoverFromBrokenStartupState({bool deepReset = false}) async { + final Future controllerSetupFuture = _controllerSetupFuture; + try { + await controllerSetupFuture; + } catch (error, stackTrace) { + debugPrint('Await WebView controller setup failed: $error\n$stackTrace'); + } + + try { + await _controller.clearCache(); + } catch (error, stackTrace) { + debugPrint('Clear WebView cache failed: $error\n$stackTrace'); + } + + try { + await _controller.clearLocalStorage(); + } catch (error, stackTrace) { + debugPrint('Clear WebView local storage failed: $error\n$stackTrace'); + } + + try { + await _cookieManager.clearCookies(); + } catch (error, stackTrace) { + debugPrint('Clear WebView cookies failed: $error\n$stackTrace'); + } + + if (!deepReset || defaultTargetPlatform != TargetPlatform.android) { + return; + } + + try { + await _appShellDeviceChannel.invokeMethod( + 'resetAndroidWebViewState', + ); + } catch (error, stackTrace) { + debugPrint('Reset Android WebView state failed: $error\n$stackTrace'); + } + } + + String _friendlyErrorTitle(WebResourceError error) { + switch (error.errorType) { + case WebResourceErrorType.timeout: + return '请求超时'; + case WebResourceErrorType.hostLookup: + case WebResourceErrorType.connect: + case WebResourceErrorType.io: + return '网络连接失败'; + case WebResourceErrorType.failedSslHandshake: + return '安全连接失败'; + default: + return '页面加载失败'; + } + } + + String _friendlyErrorMessage(WebResourceError error) { + switch (error.errorType) { + case WebResourceErrorType.timeout: + return '当前网络较慢，请稍后重新加载。'; + case WebResourceErrorType.hostLookup: + case WebResourceErrorType.connect: + case WebResourceErrorType.io: + return '没有成功连接到服务器，请检查网络后重试。'; + case WebResourceErrorType.failedSslHandshake: + return '当前站点证书校验失败，请稍后再试。'; + default: + final String description = error.description.trim(); + return description.isEmpty ? '请稍后重新加载页面。' : description; + } + } + + bool _shouldTreatHttpErrorAsMainFrame(HttpResponseError error) { + final Uri? requestUri = error.request?.uri; + if (requestUri == null) { + return true; + } + + if (!_isNetworkUrl(requestUri.toString())) { + return false; + } + + final Uri? currentUri = Uri.tryParse(_currentUrl); + if (_isSameDocumentRequest(requestUri, currentUri)) { + return true; + } + + if (!_hasBootstrapped && _isSameDocumentRequest(requestUri, _initialUri)) { + return true; + } + + return false; + } + + bool _isSameDocumentRequest(Uri left, Uri? right) { + if (right == null) { + return false; + } + + return _normalizeComparableUri(left) == _normalizeComparableUri(right); + } + + String _normalizeComparableUri(Uri uri) { + final String scheme = uri.scheme.toLowerCase(); + final String host = uri.host.toLowerCase(); + final int port = uri.hasPort ? uri.port : _defaultPortForScheme(scheme); + final String path = _normalizeComparablePath(uri.path); + final String query = uri.query; + return '$scheme://$host:$port$path?$query'; + } + + int _defaultPortForScheme(String scheme) { + return switch (scheme) { + 'https' => 443, + 'http' => 80, + _ => -1, + }; + } + + String _normalizeComparablePath(String path) { + if (path.isEmpty) { + return '/'; + } + if (path.length > 1 && path.endsWith('/')) { + return path.substring(0, path.length - 1); + } + return path; + } + + Future _injectAppShellBridge(String url) async { + try { + await _controller.runJavaScript(_buildAppShellBridgeScript()); + debugPrint('Injected AppShell bridge for $url'); + } catch (error, stackTrace) { + debugPrint('Inject AppShell bridge failed: $error\n$stackTrace'); + } + } + + Future _handleBridgeMessage(String rawMessage) async { + String requestId = ''; + + try { + final dynamic decoded = jsonDecode(rawMessage); + if (decoded is! Map) { + return; + } + + final Map message = Map.from(decoded); + requestId = (message['requestId'] ?? '').toString(); + final String action = (message['action'] ?? '').toString(); + final Map payload = message['payload'] is Map + ? Map.from(message['payload'] as Map) + : {}; + + if (requestId.isEmpty || action.isEmpty) { + return; + } + + debugPrint('AppShell bridge request: action=$action payload=$payload'); + + late final Object? data; + switch (action) { + case 'pickImage': + data = await _pickImagesFromBridge( + source: ImageSource.gallery, + payload: payload, + ); + case 'captureImage': + data = await _pickImagesFromBridge( + source: ImageSource.camera, + payload: payload, + ); + case 'pickFile': + data = await _pickFilesFromBridge(payload); + case 'openExternal': + data = await _openExternalFromBridge(payload); + case 'requestPermissions': + data = await _requestPermissionsFromBridge(payload); + case 'reloadPage': + await _reloadPage(); + data = true; + case 'goBack': + data = await _goBackFromBridge(); + case 'closeApp': + await _sendBridgeResponse(requestId: requestId, success: true); + await SystemNavigator.pop(); + return; + default: + throw UnsupportedError('Unsupported AppShell action: $action'); + } + + await _sendBridgeResponse( + requestId: requestId, + success: true, + data: data, + ); + } catch (error, stackTrace) { + debugPrint('Handle AppShell bridge failed: $error\n$stackTrace'); + if (requestId.isNotEmpty) { + await _sendBridgeResponse( + requestId: requestId, + success: false, + error: error.toString(), + ); + } + } + } + + Future _pickImagesFromBridge({ + required ImageSource source, + required Map payload, + }) async { + final bool multiple = + source == ImageSource.gallery && _boolValue(payload['multiple']); + final String responseType = (payload['responseType'] ?? 'dataUrl') + .toString(); + + List files = []; + if (source == ImageSource.camera) { + final XFile? file = await _pickCameraImage(showPermissionAlert: true); + if (file != null) { + files = [file]; + } + } else if (multiple) { + files = await _imagePicker.pickMultiImage( + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + } else { + final XFile? file = await _imagePicker.pickImage( + source: ImageSource.gallery, + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + if (file != null) { + files = [file]; + } + } + + final List> serialized = await _serializeXFiles( + files, + responseType: responseType, + ); + return multiple ? serialized : serialized.firstOrNull; + } + + Future _pickFilesFromBridge(Map payload) async { + final String responseType = (payload['responseType'] ?? 'uri').toString(); + final bool includeBinary = + responseType == 'dataUrl' || responseType == 'base64'; + + final FilePickerResult? result = await FilePicker.platform.pickFiles( + allowMultiple: _boolValue(payload['multiple']), + withData: includeBinary, + type: FileType.any, + ); + + if (result == null) { + return _boolValue(payload['multiple']) ? >[] : null; + } + + final List> serialized = await _serializePlatformFiles( + result.files, + responseType: responseType, + ); + return _boolValue(payload['multiple']) + ? serialized + : serialized.firstOrNull; + } + + Future _openExternalFromBridge(Map payload) async { + final String url = (payload['url'] ?? '').toString(); + final Uri? uri = Uri.tryParse(url); + if (uri == null) { + return false; + } + if (_isNetworkUrl(uri.toString())) { + return false; + } + return _openExternalUri(uri); + } + + Future> _requestPermissionsFromBridge( + Map payload, + ) async { + final List types = + (payload['types'] as List? ?? const []) + .map((type) => type.toString()) + .toList(); + + final Map permissions = { + for (final String type in types) + if (_permissionForType(type) case final Permission permission) + type: permission, + }; + + if (permissions.isEmpty) { + return {}; + } + + final Map statuses = await permissions.values + .toSet() + .toList() + .request(); + + return { + for (final MapEntry entry in permissions.entries) + entry.key: (statuses[entry.value] ?? PermissionStatus.denied).name, + }; + } + + Future _goBackFromBridge() async { + if (await _controller.canGoBack()) { + await _controller.goBack(); + return true; + } + return false; + } + + Future _sendBridgeResponse({ + required String requestId, + required bool success, + Object? data, + String? error, + }) async { + final Map response = { + 'requestId': requestId, + 'success': success, + 'data': data, + 'error': error, + }; + + try { + await _controller.runJavaScript( + 'window.__appShellReceiveResponse(${jsonEncode(response)});', + ); + } catch (bridgeError, stackTrace) { + debugPrint( + 'Send AppShell bridge response failed: $bridgeError\n$stackTrace', + ); + } + } + + Future> _handleFileSelector(FileSelectorParams params) async { + debugPrint( + 'WebView file selector: ' + 'accept=${params.acceptTypes}, ' + 'capture=${params.isCaptureEnabled}, ' + 'mode=${params.mode.name}', + ); + + if (params.mode == FileSelectorMode.save) { + return []; + } + + try { + final bool acceptsImages = _acceptsImages(params.acceptTypes); + final bool imagesOnly = _acceptsOnlyImages(params.acceptTypes); + + if (params.isCaptureEnabled && acceptsImages) { + final XFile? capturedImage = await _pickCameraImage(); + return _xFilesToUriStrings( + capturedImage == null ? const [] : [capturedImage], + ); + } + + if (imagesOnly) { + if (params.mode == FileSelectorMode.openMultiple) { + final List images = await _imagePicker.pickMultiImage( + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + return _xFilesToUriStrings(images); + } + + final XFile? image = await _imagePicker.pickImage( + source: ImageSource.gallery, + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + return _xFilesToUriStrings( + image == null ? const [] : [image], + ); + } + + final FilePickerResult? result = await FilePicker.platform.pickFiles( + allowMultiple: params.mode == FileSelectorMode.openMultiple, + type: FileType.any, + ); + + if (result == null) { + return []; + } + + return result.files + .map((file) => file.path) + .whereType() + .map((path) => Uri.file(path).toString()) + .toList(); + } catch (error, stackTrace) { + debugPrint('Handle file selector failed: $error\n$stackTrace'); + return []; + } + } + + Future _handlePlatformPermissionRequest( + PlatformWebViewPermissionRequest request, + ) async { + debugPrint( + 'WebView permission request: ' + '${request.types.map((type) => type.name).join(', ')}', + ); + + final List permissions = [ + if (request.types.contains(WebViewPermissionResourceType.camera)) + Permission.camera, + if (request.types.contains(WebViewPermissionResourceType.microphone)) + Permission.microphone, + ]; + + if (permissions.isEmpty) { + await request.deny(); + return; + } + + final Map statuses = await permissions + .request(); + final bool allGranted = statuses.values.every((status) => status.isGranted); + + if (allGranted) { + await request.grant(); + return; + } + + await request.deny(); + } + + Future _handleGeolocationPermissionRequest( + GeolocationPermissionsRequestParams request, + ) async { + debugPrint('WebView geolocation permission request: ${request.origin}'); + final PermissionStatus status = await Permission.location.request(); + return GeolocationPermissionsResponse( + allow: status.isGranted, + retain: status.isGranted, + ); + } + + Future _pickCameraImage({bool showPermissionAlert = false}) async { + final PermissionStatus cameraStatus = await Permission.camera.request(); + if (!cameraStatus.isGranted) { + if (showPermissionAlert) { + await _showWebAlert('请先在系统设置中允许相机权限'); + } + return null; + } + + try { + return await _imagePicker.pickImage( + source: ImageSource.camera, + preferredCameraDevice: CameraDevice.rear, + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + } catch (error, stackTrace) { + debugPrint('Pick camera image failed: $error\n$stackTrace'); + if (showPermissionAlert) { + await _showWebAlert('无法打开系统相机，请稍后重试'); + } + return null; + } + } + + Future>> _serializeXFiles( + List files, { + required String responseType, + }) async { + final bool includeBase64 = + responseType == 'base64' || responseType == 'dataUrl'; + final bool includeDataUrl = responseType == 'dataUrl'; + + final List> serialized = >[]; + for (final XFile file in files) { + String? base64Value; + final String mimeType = _guessMimeType(file.name); + + if (includeBase64 || includeDataUrl) { + base64Value = base64Encode(await file.readAsBytes()); + } + + serialized.add({ + 'name': file.name, + 'uri': Uri.file(file.path).toString(), + 'mimeType': mimeType, + 'size': await file.length(), + if (responseType == 'base64') 'base64': base64Value, + if (includeDataUrl && base64Value != null) + 'dataUrl': 'data:$mimeType;base64,$base64Value', + }); + } + return serialized; + } + + Future>> _serializePlatformFiles( + List files, { + required String responseType, + }) async { + final bool includeBase64 = + responseType == 'base64' || responseType == 'dataUrl'; + final bool includeDataUrl = responseType == 'dataUrl'; + + final List> serialized = >[]; + for (final PlatformFile file in files) { + final String mimeType = _guessMimeType(file.name); + String? base64Value; + + if (includeBase64 || includeDataUrl) { + final List? bytes = + file.bytes ?? + (file.path == null ? null : await XFile(file.path!).readAsBytes()); + if (bytes != null) { + base64Value = base64Encode(bytes); + } + } + + serialized.add({ + 'name': file.name, + 'uri': file.path == null ? null : Uri.file(file.path!).toString(), + 'mimeType': mimeType, + 'size': file.size, + if (responseType == 'base64') 'base64': base64Value, + if (includeDataUrl && base64Value != null) + 'dataUrl': 'data:$mimeType;base64,$base64Value', + }); + } + return serialized; + } + + Future _openExternalUri(Uri uri) async { + try { + return await launchUrl(uri, mode: LaunchMode.externalApplication); + } catch (error, stackTrace) { + debugPrint('Open external uri failed: $error\n$stackTrace'); + return false; + } + } + + Permission? _permissionForType(String type) { + return switch (type.toLowerCase()) { + 'camera' => Permission.camera, + 'microphone' || 'audio' => Permission.microphone, + 'location' => Permission.location, + 'photos' || 'images' => Permission.photos, + 'videos' => Permission.videos, + 'storage' => Permission.storage, + _ => null, + }; + } + + bool _boolValue(Object? value, {bool defaultValue = false}) { + return switch (value) { + bool boolValue => boolValue, + String stringValue => stringValue.toLowerCase() == 'true', + int intValue => intValue != 0, + _ => defaultValue, + }; + } + + Future _showWebAlert(String message) async { + try { + await _controller.runJavaScript('window.alert(${jsonEncode(message)});'); + } catch (error, stackTrace) { + debugPrint('Show web alert failed: $error\n$stackTrace'); + } + } + + List _xFilesToUriStrings(List files) { + return files.map((file) => Uri.file(file.path).toString()).toList(); + } + + bool _acceptsImages(List acceptTypes) { + return acceptTypes + .map((type) => type.trim()) + .where((type) => type.isNotEmpty) + .any(_isImageAcceptType); + } + + bool _acceptsOnlyImages(List acceptTypes) { + final List normalizedTypes = acceptTypes + .map((type) => type.trim()) + .where((type) => type.isNotEmpty) + .toList(); + if (normalizedTypes.isEmpty) { + return false; + } + return normalizedTypes.every(_isImageAcceptType); + } + + bool _isImageAcceptType(String acceptType) { + final String value = acceptType.toLowerCase(); + return value.startsWith('image/') || + const { + '.png', + '.jpg', + '.jpeg', + '.webp', + '.gif', + '.bmp', + '.heic', + '.heif', + }.contains(value); + } + + String _guessMimeType(String fileName) { + final String lower = fileName.toLowerCase(); + if (lower.endsWith('.png')) { + return 'image/png'; + } + if (lower.endsWith('.jpg') || lower.endsWith('.jpeg')) { + return 'image/jpeg'; + } + if (lower.endsWith('.webp')) { + return 'image/webp'; + } + if (lower.endsWith('.gif')) { + return 'image/gif'; + } + if (lower.endsWith('.bmp')) { + return 'image/bmp'; + } + if (lower.endsWith('.heic')) { + return 'image/heic'; + } + if (lower.endsWith('.heif')) { + return 'image/heif'; + } + if (lower.endsWith('.pdf')) { + return 'application/pdf'; + } + if (lower.endsWith('.txt')) { + return 'text/plain'; + } + if (lower.endsWith('.apk')) { + return 'application/vnd.android.package-archive'; + } + return 'application/octet-stream'; + } + + String _buildAppShellBridgeScript() { + return ''' +(() => { + const channel = window.$_appShellBridgeChannel; + if (!channel || typeof channel.postMessage !== 'function') { + return; + } + + if (window.AppShell && window.AppShell.__nativeShellVersion === '$_appShellBridgeVersion') { + return; + } + + const pending = new Map(); + + window.__appShellReceiveResponse = function(response) { + if (!response || !response.requestId) { + return; + } + + const task = pending.get(response.requestId); + if (!task) { + return; + } + + pending.delete(response.requestId); + + if (response.success) { + task.resolve(response.data ?? null); + return; + } + + task.reject(new Error(response.error || 'Native request failed')); + }; + + const send = (action, payload = {}) => new Promise((resolve, reject) => { + const requestId = + Date.now().toString(36) + Math.random().toString(36).slice(2); + pending.set(requestId, { resolve, reject }); + channel.postMessage(JSON.stringify({ requestId, action, payload })); + }); + + window.AppShell = { + __nativeShellVersion: '$_appShellBridgeVersion', + isNativeShell: true, + version: '$_appShellBridgeVersion', + pickImage: (options = {}) => send('pickImage', options), + captureImage: (options = {}) => send('captureImage', options), + pickFile: (options = {}) => send('pickFile', options), + openExternal: (url) => send('openExternal', { url }), + requestPermissions: (types = []) => send('requestPermissions', { types }), + reloadPage: () => send('reloadPage'), + goBack: () => send('goBack'), + closeApp: () => send('closeApp'), + }; + + window.dispatchEvent(new CustomEvent('app-shell-ready', { + detail: { + version: '$_appShellBridgeVersion', + isNativeShell: true, + }, + })); + + if (!window.__appShellLegacyCameraCompatInstalled) { + window.__appShellLegacyCameraCompatInstalled = true; + + const installLegacyCameraCompat = () => { + if (typeof window.openCamera !== 'function') { + return false; + } + if (window.openCamera.__appShellCompatWrapped) { + return true; + } + + const originalOpenCamera = window.openCamera.bind(window); + const originalCapturePhoto = + typeof window.capturePhoto === 'function' + ? window.capturePhoto.bind(window) + : null; + + const deliverCaptureResult = (args, result) => { + const detail = { + args: Array.from(args), + result, + }; + + if (typeof window.handleNativeCapture === 'function') { + window.handleNativeCapture(detail); + return true; + } + + const targetId = + detail.args[0] ?? + window.currentUploadId ?? + null; + + if ( + targetId != null && + result && + result.dataUrl && + typeof window.addPreview === 'function' + ) { + window.currentUploadId = targetId; + window.addPreview(targetId, result.dataUrl); + return true; + } + + window.dispatchEvent( + new CustomEvent('app-shell-image-captured', { + detail, + }), + ); + return false; + }; + + const closeLegacyCameraModal = () => { + if (typeof window.closeCamera === 'function') { + try { + window.closeCamera(); + } catch (_) {} + } + }; + + const wrappedOpenCamera = async function(...args) { + try { + const result = await window.AppShell.captureImage({ + responseType: 'dataUrl', + }); + const delivered = deliverCaptureResult(args, result); + if (!delivered) { + return result; + } + closeLegacyCameraModal(); + return result; + } catch (error) { + console.warn( + '[AppShell] legacy openCamera fallback to page implementation', + error, + ); + return originalOpenCamera(...args); + } + }; + + wrappedOpenCamera.__appShellCompatWrapped = true; + window.openCamera = wrappedOpenCamera; + + if (originalCapturePhoto) { + const wrappedCapturePhoto = function(...args) { + if ( + window.currentUploadId != null && + window.__lastAppShellCaptureResult && + window.__lastAppShellCaptureResult.dataUrl && + typeof window.addPreview === 'function' + ) { + window.addPreview( + window.currentUploadId, + window.__lastAppShellCaptureResult.dataUrl, + ); + closeLegacyCameraModal(); + return; + } + return originalCapturePhoto(...args); + }; + wrappedCapturePhoto.__appShellCompatWrapped = true; + window.capturePhoto = wrappedCapturePhoto; + } + + return true; + }; + + const originalCaptureImage = window.AppShell.captureImage; + window.AppShell.captureImage = async function(options = {}) { + const result = await originalCaptureImage(options); + window.__lastAppShellCaptureResult = result; + return result; + }; + + installLegacyCameraCompat(); + + let attempts = 0; + const compatTimer = setInterval(() => { + attempts += 1; + const installed = installLegacyCameraCompat(); + if (installed || attempts >= 20) { + clearInterval(compatTimer); + } + }, 500); + } +})(); +'''; + } + + Future _startLoadSequence({ + required bool rebuildWebView, + required bool resetRetryCount, + }) async { + _cancelStartupWatchdog(); + if (!mounted) { + return; + } + if (rebuildWebView) { + _recreateWebView(); + } + + final int generation = _webViewGeneration; + final Future controllerSetupFuture = _controllerSetupFuture; + + _hasStartedRemoteMainFrame = false; + setState(() { + _isLoadingPage = true; + _hasMainFrameError = false; + _hasMeasuredProgress = false; + _progress = 0; + if (resetRetryCount) { + _startupRetryCount = 0; + } + _errorTitle = '页面加载失败'; + _errorMessage = '请检查网络后重试。'; + _currentUrl = _initialUrl; + }); + + await controllerSetupFuture; + if (!mounted || !_isActiveWebViewGeneration(generation)) { + return; + } + + await _waitForWebViewMount(generation); + + debugPrint( + 'WebShell start real URL load on WebView #$generation ' + '(${_activeRenderMode.logName}): $_initialUrl', + ); + try { + _armStartupWatchdog(); + await _controller.loadRequest(_initialUri); + } catch (error, stackTrace) { + debugPrint('Start initial URL load failed: $error\n$stackTrace'); + _setMainFrameError( + title: '地址无法加载', + message: '无法打开 $_initialUrl，请检查地址格式或网络后重试。', + ); + } + } + + Future _waitForWebViewMount(int generation) async { + final bool isAndroidDebug = + kDebugMode && defaultTargetPlatform == TargetPlatform.android; + final bool usesHybridComposition = + defaultTargetPlatform == TargetPlatform.android && + _activeRenderMode.usesHybridComposition; + final int framesToWait = isAndroidDebug + ? (usesHybridComposition ? 6 : 4) + : (usesHybridComposition ? 2 : 1); + final Duration settleDelay = isAndroidDebug + ? (usesHybridComposition + ? const Duration(milliseconds: 250) + : const Duration(milliseconds: 140)) + : (usesHybridComposition + ? const Duration(milliseconds: 80) + : const Duration(milliseconds: 40)); + + for (int index = 0; index < framesToWait; index += 1) { + await SchedulerBinding.instance.endOfFrame; + if (!mounted || !_isActiveWebViewGeneration(generation)) { + return; + } + await Future.delayed(settleDelay); + if (!mounted || !_isActiveWebViewGeneration(generation)) { + return; + } + } + } + + Future _reloadPage() async { + if (!mounted) { + return; + } + await _ensureCompatibilityPlanApplied(); + if (!mounted) { + return; + } + if (!_hasBootstrapped) { + await _recoverFromBrokenStartupState(deepReset: true); + await _startLoadSequence(rebuildWebView: true, resetRetryCount: true); + return; + } + setState(() { + _hasStartedRemoteMainFrame = false; + _isLoadingPage = true; + _hasMainFrameError = false; + _hasMeasuredProgress = false; + _progress = 0; + _startupRetryCount = 0; + _errorTitle = '页面加载失败'; + _errorMessage = '请检查网络后重试。'; + }); + try { + _armStartupWatchdog(); + await _controller.reload(); + } catch (error, stackTrace) { + debugPrint('Reload current page failed: $error\n$stackTrace'); + await _startLoadSequence(rebuildWebView: true, resetRetryCount: true); + } + } + + @override + Widget build(BuildContext context) { + final bool showProgressBar = + _isLoadingPage && (!_hasMeasuredProgress || _progress < 100); + final bool showLaunchOverlay = !_hasBootstrapped && !_hasMainFrameError; + + return PopScope( + canPop: false, + onPopInvokedWithResult: (didPop, result) { + if (!didPop) { + unawaited(_handleBackPressed()); + } + }, + child: Scaffold( + backgroundColor: _shellBackgroundColor, + body: DecoratedBox( + decoration: const BoxDecoration( + gradient: LinearGradient( + colors: [_shellBackgroundColor, Color(0xFFF4FBF7)], + begin: Alignment.topCenter, + end: Alignment.bottomCenter, + ), + ), + child: SafeArea( + top: false, + bottom: false, + child: Stack( + children: [ + Positioned.fill( + child: ColoredBox( + color: _shellBackgroundColor, + child: _webViewWidget, + ), + ), + if (showProgressBar) + Positioned( + top: 0, + left: 0, + right: 0, + child: _TopProgressBar( + progress: _progress, + hasMeasuredProgress: _hasMeasuredProgress, + ), + ), + if (showLaunchOverlay) + Positioned.fill( + child: _LaunchOverlay( + progress: _progress, + hasMeasuredProgress: _hasMeasuredProgress, + ), + ), + if (_hasMainFrameError) + Positioned.fill( + child: _ErrorOverlay( + title: _errorTitle, + message: _errorMessage, + currentUrl: _currentUrl, + onRetry: _reloadPage, + ), + ), + ], + ), + ), + ), + ), + ); + } +} + +class UnsupportedPlatformPage extends StatelessWidget { + const UnsupportedPlatformPage({super.key}); + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: _shellBackgroundColor, + body: Center( + child: Padding( + padding: const EdgeInsets.symmetric(horizontal: 28), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 84, + height: 84, + decoration: BoxDecoration( + color: _shellAccentColor.withValues(alpha: 0.12), + borderRadius: BorderRadius.circular(24), + ), + alignment: Alignment.center, + child: const Icon( + Icons.language_rounded, + size: 42, + color: _shellAccentColor, + ), + ), + const SizedBox(height: 20), + const Text( + '当前平台不支持内嵌 WebView', + style: TextStyle( + fontSize: 22, + fontWeight: FontWeight.w700, + color: _shellTextColor, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 12), + Text( + '请在 Android、iOS 或 macOS 上运行当前项目。\n$_initialUrl', + textAlign: TextAlign.center, + style: const TextStyle( + height: 1.6, + color: _shellMutedTextColor, + ), + ), + ], + ), + ), + ), + ); + } +} + +class _TopProgressBar extends StatelessWidget { + const _TopProgressBar({ + required this.progress, + required this.hasMeasuredProgress, + }); + + final int progress; + final bool hasMeasuredProgress; + + @override + Widget build(BuildContext context) { + return LinearProgressIndicator( + minHeight: 3, + value: hasMeasuredProgress ? progress / 100 : null, + backgroundColor: Colors.white.withValues(alpha: 0.8), + valueColor: const AlwaysStoppedAnimation(_shellAccentColor), + ); + } +} + +class _LaunchOverlay extends StatelessWidget { + const _LaunchOverlay({ + required this.progress, + required this.hasMeasuredProgress, + }); + + final int progress; + final bool hasMeasuredProgress; + + @override + Widget build(BuildContext context) { + return ColoredBox( + color: _shellBackgroundColor, + child: Center( + child: Padding( + padding: const EdgeInsets.symmetric(horizontal: 32), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 88, + height: 88, + decoration: BoxDecoration( + gradient: const LinearGradient( + colors: [Color(0xFF66E59A), _shellAccentColor], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(28), + boxShadow: const [ + BoxShadow( + color: Color(0x263ED37B), + blurRadius: 24, + offset: Offset(0, 14), + ), + ], + ), + alignment: Alignment.center, + child: const Icon( + Icons.public_rounded, + size: 40, + color: Colors.white, + ), + ), + const SizedBox(height: 24), + const Text( + '页面加载中', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.w800, + color: _shellTextColor, + ), + ), + const SizedBox(height: 10), + const Text( + '正在为你启动 H5 页面', + style: TextStyle(color: _shellMutedTextColor, fontSize: 14), + ), + const SizedBox(height: 24), + ClipRRect( + borderRadius: BorderRadius.circular(999), + child: SizedBox( + width: 220, + child: LinearProgressIndicator( + minHeight: 6, + value: hasMeasuredProgress ? progress / 100 : null, + backgroundColor: const Color(0xFFE7F3EB), + valueColor: const AlwaysStoppedAnimation( + _shellAccentColor, + ), + ), + ), + ), + const SizedBox(height: 10), + Text( + hasMeasuredProgress ? '$progress%' : '连接中...', + style: const TextStyle( + color: Color(0xFF94A3B8), + fontSize: 12, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + ), + ), + ); + } +} + +class _ErrorOverlay extends StatelessWidget { + const _ErrorOverlay({ + required this.title, + required this.message, + required this.currentUrl, + required this.onRetry, + }); + + final String title; + final String message; + final String currentUrl; + final Future Function() onRetry; + + @override + Widget build(BuildContext context) { + return ColoredBox( + color: _shellBackgroundColor, + child: Center( + child: Padding( + padding: const EdgeInsets.symmetric(horizontal: 28), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 92, + height: 92, + decoration: BoxDecoration( + color: const Color(0xFFFEF2F2), + borderRadius: BorderRadius.circular(28), + ), + alignment: Alignment.center, + child: const Icon( + Icons.wifi_off_rounded, + size: 44, + color: Color(0xFFEF4444), + ), + ), + const SizedBox(height: 22), + Text( + title, + style: const TextStyle( + fontSize: 22, + fontWeight: FontWeight.w800, + color: _shellTextColor, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 10), + Text( + message, + style: const TextStyle( + fontSize: 14, + height: 1.6, + color: _shellMutedTextColor, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 12), + Text( + currentUrl, + style: const TextStyle(fontSize: 12, color: Color(0xFF94A3B8)), + textAlign: TextAlign.center, + ), + const SizedBox(height: 24), + FilledButton.icon( + onPressed: onRetry, + style: FilledButton.styleFrom( + backgroundColor: _shellAccentColor, + foregroundColor: Colors.black, + ), + icon: const Icon(Icons.refresh_rounded), + label: const Text('重新加载'), + ), + ], + ), + ), + ), + ); + } +} diff --git a/packages/web_android_shell/pubspec.lock b/packages/web_android_shell/pubspec.lock new file mode 100644 index 0000000..1997430 --- /dev/null +++ b/packages/web_android_shell/pubspec.lock @@ -0,0 +1,578 @@ +# Generated by pub +# See https://dart.dev/tools/pub/glossary#lockfile +packages: + args: + dependency: transitive + description: + name: args + sha256: d0481093c50b1da8910eb0bb301626d4d8eb7284aa739614d2b394ee09e3ea04 + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.7.0" + async: + dependency: transitive + description: + name: async + sha256: "758e6d74e971c3e5aceb4110bfd6698efc7f501675bcfe0c775459a8140750eb" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.13.0" + boolean_selector: + dependency: transitive + description: + name: boolean_selector + sha256: "8aab1771e1243a5063b8b0ff68042d67334e3feab9e95b9490f9a6ebf73b42ea" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.1.2" + characters: + dependency: transitive + description: + name: characters + sha256: faf38497bda5ead2a8c7615f4f7939df04333478bf32e4173fcb06d428b5716b + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.4.1" + clock: + dependency: transitive + description: + name: clock + sha256: fddb70d9b5277016c77a80201021d40a2247104d9f4aa7bab7157b7e3f05b84b + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.1.2" + collection: + dependency: transitive + description: + name: collection + sha256: "2f5709ae4d3d59dd8f7cd309b4e023046b57d8a6c82130785d2b0e5868084e76" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.19.1" + cross_file: + dependency: transitive + description: + name: cross_file + sha256: "28bb3ae56f117b5aec029d702a90f57d285cd975c3c5c281eaca38dbc47c5937" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.3.5+2" + cupertino_icons: + dependency: "direct main" + description: + name: cupertino_icons + sha256: ba631d1c7f7bef6b729a622b7b752645a2d076dba9976925b8f25725a30e1ee6 + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.0.8" + dbus: + dependency: transitive + description: + name: dbus + sha256: d0c98dcd4f5169878b6cf8f6e0a52403a9dff371a3e2f019697accbf6f44a270 + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.7.12" + fake_async: + dependency: transitive + description: + name: fake_async + sha256: "5368f224a74523e8d2e7399ea1638b37aecfca824a3cc4dfdf77bf1fa905ac44" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.3.3" + ffi: + dependency: transitive + description: + name: ffi + sha256: "6d7fd89431262d8f3125e81b50d3847a091d846eafcd4fdb88dd06f36d705a45" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.2.0" + file_picker: + dependency: "direct main" + description: + name: file_picker + sha256: "57d9a1dd5063f85fa3107fb42d1faffda52fdc948cefd5fe5ea85267a5fc7343" + url: "https://pub.flutter-io.cn" + source: hosted + version: "10.3.10" + file_selector_linux: + dependency: transitive + description: + name: file_selector_linux + sha256: "2567f398e06ac72dcf2e98a0c95df2a9edd03c2c2e0cacd4780f20cdf56263a0" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.9.4" + file_selector_macos: + dependency: transitive + description: + name: file_selector_macos + sha256: "5e0bbe9c312416f1787a68259ea1505b52f258c587f12920422671807c4d618a" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.9.5" + file_selector_platform_interface: + dependency: transitive + description: + name: file_selector_platform_interface + sha256: "35e0bd61ebcdb91a3505813b055b09b79dfdc7d0aee9c09a7ba59ae4bb13dc85" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.7.0" + file_selector_windows: + dependency: transitive + description: + name: file_selector_windows + sha256: "62197474ae75893a62df75939c777763d39c2bc5f73ce5b88497208bc269abfd" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.9.3+5" + flutter: + dependency: "direct main" + description: flutter + source: sdk + version: "0.0.0" + flutter_lints: + dependency: "direct dev" + description: + name: flutter_lints + sha256: "3105dc8492f6183fb076ccf1f351ac3d60564bff92e20bfc4af9cc1651f4e7e1" + url: "https://pub.flutter-io.cn" + source: hosted + version: "6.0.0" + flutter_plugin_android_lifecycle: + dependency: transitive + description: + name: flutter_plugin_android_lifecycle + sha256: ee8068e0e1cd16c4a82714119918efdeed33b3ba7772c54b5d094ab53f9b7fd1 + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.0.33" + flutter_test: + dependency: "direct dev" + description: flutter + source: sdk + version: "0.0.0" + flutter_web_plugins: + dependency: transitive + description: flutter + source: sdk + version: "0.0.0" + http: + dependency: transitive + description: + name: http + sha256: "87721a4a50b19c7f1d49001e51409bddc46303966ce89a65af4f4e6004896412" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.6.0" + http_parser: + dependency: transitive + description: + name: http_parser + sha256: "178d74305e7866013777bab2c3d8726205dc5a4dd935297175b19a23a2e66571" + url: "https://pub.flutter-io.cn" + source: hosted + version: "4.1.2" + image_picker: + dependency: "direct main" + description: + name: image_picker + sha256: "784210112be18ea55f69d7076e2c656a4e24949fa9e76429fe53af0c0f4fa320" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.2.1" + image_picker_android: + dependency: transitive + description: + name: image_picker_android + sha256: eda9b91b7e266d9041084a42d605a74937d996b87083395c5e47835916a86156 + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.8.13+14" + image_picker_for_web: + dependency: transitive + description: + name: image_picker_for_web + sha256: "66257a3191ab360d23a55c8241c91a6e329d31e94efa7be9cf7a212e65850214" + url: "https://pub.flutter-io.cn" + source: hosted + version: "3.1.1" + image_picker_ios: + dependency: transitive + description: + name: image_picker_ios + sha256: b9c4a438a9ff4f60808c9cf0039b93a42bb6c2211ef6ebb647394b2b3fa84588 + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.8.13+6" + image_picker_linux: + dependency: transitive + description: + name: image_picker_linux + sha256: "1f81c5f2046b9ab724f85523e4af65be1d47b038160a8c8deed909762c308ed4" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.2.2" + image_picker_macos: + dependency: transitive + description: + name: image_picker_macos + sha256: "86f0f15a309de7e1a552c12df9ce5b59fe927e71385329355aec4776c6a8ec91" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.2.2+1" + image_picker_platform_interface: + dependency: transitive + description: + name: image_picker_platform_interface + sha256: "567e056716333a1647c64bb6bd873cff7622233a5c3f694be28a583d4715690c" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.11.1" + image_picker_windows: + dependency: transitive + description: + name: image_picker_windows + sha256: d248c86554a72b5495a31c56f060cf73a41c7ff541689327b1a7dbccc33adfae + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.2.2" + leak_tracker: + dependency: transitive + description: + name: leak_tracker + sha256: "33e2e26bdd85a0112ec15400c8cbffea70d0f9c3407491f672a2fad47915e2de" + url: "https://pub.flutter-io.cn" + source: hosted + version: "11.0.2" + leak_tracker_flutter_testing: + dependency: transitive + description: + name: leak_tracker_flutter_testing + sha256: "1dbc140bb5a23c75ea9c4811222756104fbcd1a27173f0c34ca01e16bea473c1" + url: "https://pub.flutter-io.cn" + source: hosted + version: "3.0.10" + leak_tracker_testing: + dependency: transitive + description: + name: leak_tracker_testing + sha256: "8d5a2d49f4a66b49744b23b018848400d23e54caf9463f4eb20df3eb8acb2eb1" + url: "https://pub.flutter-io.cn" + source: hosted + version: "3.0.2" + lints: + dependency: transitive + description: + name: lints + sha256: "12f842a479589fea194fe5c5a3095abc7be0c1f2ddfa9a0e76aed1dbd26a87df" + url: "https://pub.flutter-io.cn" + source: hosted + version: "6.1.0" + matcher: + dependency: transitive + description: + name: matcher + sha256: "12956d0ad8390bbcc63ca2e1469c0619946ccb52809807067a7020d57e647aa6" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.12.18" + material_color_utilities: + dependency: transitive + description: + name: material_color_utilities + sha256: "9c337007e82b1889149c82ed242ed1cb24a66044e30979c44912381e9be4c48b" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.13.0" + meta: + dependency: transitive + description: + name: meta + sha256: "23f08335362185a5ea2ad3a4e597f1375e78bce8a040df5c600c8d3552ef2394" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.17.0" + mime: + dependency: transitive + description: + name: mime + sha256: "41a20518f0cb1256669420fdba0cd90d21561e560ac240f26ef8322e45bb7ed6" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.0.0" + path: + dependency: transitive + description: + name: path + sha256: "75cca69d1490965be98c73ceaea117e8a04dd21217b37b292c9ddbec0d955bc5" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.9.1" + permission_handler: + dependency: "direct main" + description: + name: permission_handler + sha256: bc917da36261b00137bbc8896bf1482169cd76f866282368948f032c8c1caae1 + url: "https://pub.flutter-io.cn" + source: hosted + version: "12.0.1" + permission_handler_android: + dependency: transitive + description: + name: permission_handler_android + sha256: "1e3bc410ca1bf84662104b100eb126e066cb55791b7451307f9708d4007350e6" + url: "https://pub.flutter-io.cn" + source: hosted + version: "13.0.1" + permission_handler_apple: + dependency: transitive + description: + name: permission_handler_apple + sha256: f000131e755c54cf4d84a5d8bd6e4149e262cc31c5a8b1d698de1ac85fa41023 + url: "https://pub.flutter-io.cn" + source: hosted + version: "9.4.7" + permission_handler_html: + dependency: transitive + description: + name: permission_handler_html + sha256: "38f000e83355abb3392140f6bc3030660cfaef189e1f87824facb76300b4ff24" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.1.3+5" + permission_handler_platform_interface: + dependency: transitive + description: + name: permission_handler_platform_interface + sha256: eb99b295153abce5d683cac8c02e22faab63e50679b937fa1bf67d58bb282878 + url: "https://pub.flutter-io.cn" + source: hosted + version: "4.3.0" + permission_handler_windows: + dependency: transitive + description: + name: permission_handler_windows + sha256: "1a790728016f79a41216d88672dbc5df30e686e811ad4e698bfc51f76ad91f1e" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.2.1" + petitparser: + dependency: transitive + description: + name: petitparser + sha256: "91bd59303e9f769f108f8df05e371341b15d59e995e6806aefab827b58336675" + url: "https://pub.flutter-io.cn" + source: hosted + version: "7.0.2" + plugin_platform_interface: + dependency: transitive + description: + name: plugin_platform_interface + sha256: "4820fbfdb9478b1ebae27888254d445073732dae3d6ea81f0b7e06d5dedc3f02" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.1.8" + sky_engine: + dependency: transitive + description: flutter + source: sdk + version: "0.0.0" + source_span: + dependency: transitive + description: + name: source_span + sha256: "56a02f1f4cd1a2d96303c0144c93bd6d909eea6bee6bf5a0e0b685edbd4c47ab" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.10.2" + stack_trace: + dependency: transitive + description: + name: stack_trace + sha256: "8b27215b45d22309b5cddda1aa2b19bdfec9df0e765f2de506401c071d38d1b1" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.12.1" + stream_channel: + dependency: transitive + description: + name: stream_channel + sha256: "969e04c80b8bcdf826f8f16579c7b14d780458bd97f56d107d3950fdbeef059d" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.1.4" + string_scanner: + dependency: transitive + description: + name: string_scanner + sha256: "921cd31725b72fe181906c6a94d987c78e3b98c2e205b397ea399d4054872b43" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.4.1" + term_glyph: + dependency: transitive + description: + name: term_glyph + sha256: "7f554798625ea768a7518313e58f83891c7f5024f88e46e7182a4558850a4b8e" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.2.2" + test_api: + dependency: transitive + description: + name: test_api + sha256: "93167629bfc610f71560ab9312acdda4959de4df6fac7492c89ff0d3886f6636" + url: "https://pub.flutter-io.cn" + source: hosted + version: "0.7.9" + typed_data: + dependency: transitive + description: + name: typed_data + sha256: f9049c039ebfeb4cf7a7104a675823cd72dba8297f264b6637062516699fa006 + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.4.0" + url_launcher: + dependency: "direct main" + description: + name: url_launcher + sha256: f6a7e5c4835bb4e3026a04793a4199ca2d14c739ec378fdfe23fc8075d0439f8 + url: "https://pub.flutter-io.cn" + source: hosted + version: "6.3.2" + url_launcher_android: + dependency: transitive + description: + name: url_launcher_android + sha256: "767344bf3063897b5cf0db830e94f904528e6dd50a6dfaf839f0abf509009611" + url: "https://pub.flutter-io.cn" + source: hosted + version: "6.3.28" + url_launcher_ios: + dependency: transitive + description: + name: url_launcher_ios + sha256: "580fe5dfb51671ae38191d316e027f6b76272b026370708c2d898799750a02b0" + url: "https://pub.flutter-io.cn" + source: hosted + version: "6.4.1" + url_launcher_linux: + dependency: transitive + description: + name: url_launcher_linux + sha256: d5e14138b3bc193a0f63c10a53c94b91d399df0512b1f29b94a043db7482384a + url: "https://pub.flutter-io.cn" + source: hosted + version: "3.2.2" + url_launcher_macos: + dependency: transitive + description: + name: url_launcher_macos + sha256: "368adf46f71ad3c21b8f06614adb38346f193f3a59ba8fe9a2fd74133070ba18" + url: "https://pub.flutter-io.cn" + source: hosted + version: "3.2.5" + url_launcher_platform_interface: + dependency: transitive + description: + name: url_launcher_platform_interface + sha256: "552f8a1e663569be95a8190206a38187b531910283c3e982193e4f2733f01029" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.3.2" + url_launcher_web: + dependency: transitive + description: + name: url_launcher_web + sha256: d0412fcf4c6b31ecfdb7762359b7206ffba3bbffd396c6d9f9c4616ece476c1f + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.4.2" + url_launcher_windows: + dependency: transitive + description: + name: url_launcher_windows + sha256: "712c70ab1b99744ff066053cbe3e80c73332b38d46e5e945c98689b2e66fc15f" + url: "https://pub.flutter-io.cn" + source: hosted + version: "3.1.5" + vector_math: + dependency: transitive + description: + name: vector_math + sha256: d530bd74fea330e6e364cda7a85019c434070188383e1cd8d9777ee586914c5b + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.2.0" + vm_service: + dependency: transitive + description: + name: vm_service + sha256: "45caa6c5917fa127b5dbcfbd1fa60b14e583afdc08bfc96dda38886ca252eb60" + url: "https://pub.flutter-io.cn" + source: hosted + version: "15.0.2" + web: + dependency: transitive + description: + name: web + sha256: "868d88a33d8a87b18ffc05f9f030ba328ffefba92d6c127917a2ba740f9cfe4a" + url: "https://pub.flutter-io.cn" + source: hosted + version: "1.1.1" + webview_flutter: + dependency: "direct main" + description: + name: webview_flutter + sha256: a3da219916aba44947d3a5478b1927876a09781174b5a2b67fa5be0555154bf9 + url: "https://pub.flutter-io.cn" + source: hosted + version: "4.13.1" + webview_flutter_android: + dependency: "direct main" + description: + name: webview_flutter_android + sha256: "2a03df01df2fd30b075d1e7f24c28aee593f2e5d5ac4c3c4283c5eda63717b24" + url: "https://pub.flutter-io.cn" + source: hosted + version: "4.10.13" + webview_flutter_platform_interface: + dependency: transitive + description: + name: webview_flutter_platform_interface + sha256: "63d26ee3aca7256a83ccb576a50272edd7cfc80573a4305caa98985feb493ee0" + url: "https://pub.flutter-io.cn" + source: hosted + version: "2.14.0" + webview_flutter_wkwebview: + dependency: transitive + description: + name: webview_flutter_wkwebview + sha256: "2df8fd9ada04d699b9db8e79aa783a16e5d89b69e5b74009b87e16b59912cf98" + url: "https://pub.flutter-io.cn" + source: hosted + version: "3.24.0" + win32: + dependency: transitive + description: + name: win32 + sha256: d7cb55e04cd34096cd3a79b3330245f54cb96a370a1c27adb3c84b917de8b08e + url: "https://pub.flutter-io.cn" + source: hosted + version: "5.15.0" + xml: + dependency: transitive + description: + name: xml + sha256: "971043b3a0d3da28727e40ed3e0b5d18b742fa5a68665cca88e74b7876d5e025" + url: "https://pub.flutter-io.cn" + source: hosted + version: "6.6.1" +sdks: + dart: ">=3.11.0 <4.0.0" + flutter: ">=3.38.0" diff --git a/packages/web_android_shell/pubspec.yaml b/packages/web_android_shell/pubspec.yaml new file mode 100644 index 0000000..f258bdf --- /dev/null +++ b/packages/web_android_shell/pubspec.yaml @@ -0,0 +1,95 @@ +name: web_android_shell +description: "H5壳子项目" +# The following line prevents the package from being accidentally published to +# pub.dev using `flutter pub publish`. This is preferred for private packages. +publish_to: 'none' # Remove this line if you wish to publish to pub.dev + +# The following defines the version and build number for your application. +# A version number is three numbers separated by dots, like 1.2.43 +# followed by an optional build number separated by a +. +# Both the version and the builder number may be overridden in flutter +# build by specifying --build-name and --build-number, respectively. +# In Android, build-name is used as versionName while build-number used as versionCode. +# Read more about Android versioning at https://developer.android.com/studio/publish/versioning +# In iOS, build-name is used as CFBundleShortVersionString while build-number is used as CFBundleVersion. +# Read more about iOS versioning at +# https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html +# In Windows, build-name is used as the major, minor, and patch parts +# of the product and file versions while build-number is used as the build suffix. +version: 1.0.0+1 + +environment: + sdk: ^3.11.0 + +# Dependencies specify other packages that your package needs in order to work. +# To automatically upgrade your package dependencies to the latest versions +# consider running `flutter pub upgrade --major-versions`. Alternatively, +# dependencies can be manually updated by changing the version numbers below to +# the latest version available on pub.dev. To see which dependencies have newer +# versions available, run `flutter pub outdated`. +dependencies: + flutter: + sdk: flutter + + # The following adds the Cupertino Icons font to your application. + # Use with the CupertinoIcons class for iOS style icons. + cupertino_icons: ^1.0.8 + webview_flutter: ^4.13.1 + webview_flutter_android: ^4.10.13 + image_picker: ^1.2.1 + file_picker: ^10.3.10 + permission_handler: ^12.0.1 + url_launcher: ^6.3.2 + +dev_dependencies: + flutter_test: + sdk: flutter + + # The "flutter_lints" package below contains a set of recommended lints to + # encourage good coding practices. The lint set provided by the package is + # activated in the `analysis_options.yaml` file located at the root of your + # package. See that file for information about deactivating specific lint + # rules and activating additional ones. + flutter_lints: ^6.0.0 + +# For information on the generic Dart part of this file, see the +# following page: https://dart.dev/tools/pub/pubspec + +# The following section is specific to Flutter packages. +flutter: + + # The following line ensures that the Material Icons font is + # included with your application, so that you can use the icons in + # the material Icons class. + uses-material-design: true + + # To add assets to your application, add an assets section, like this: + # assets: + # - images/a_dot_burr.jpeg + # - images/a_dot_ham.jpeg + + # An image asset can refer to one or more resolution-specific "variants", see + # https://flutter.dev/to/resolution-aware-images + + # For details regarding adding assets from package dependencies, see + # https://flutter.dev/to/asset-from-package + + # To add custom fonts to your application, add a fonts section here, + # in this "flutter" section. Each entry in this list should have a + # "family" key with the font family name, and a "fonts" key with a + # list giving the asset and other descriptors for the font. For + # example: + # fonts: + # - family: Schyler + # fonts: + # - asset: fonts/Schyler-Regular.ttf + # - asset: fonts/Schyler-Italic.ttf + # style: italic + # - family: Trajan Pro + # fonts: + # - asset: fonts/TrajanPro.ttf + # - asset: fonts/TrajanPro_Bold.ttf + # weight: 700 + # + # For details regarding fonts from package dependencies, + # see https://flutter.dev/to/font-from-package diff --git a/packages/web_android_shell/test/widget_test.dart b/packages/web_android_shell/test/widget_test.dart new file mode 100644 index 0000000..8e61bf6 --- /dev/null +++ b/packages/web_android_shell/test/widget_test.dart @@ -0,0 +1,10 @@ +import 'package:flutter/widgets.dart'; +import 'package:flutter_test/flutter_test.dart'; + +import 'package:web_android_shell/main.dart'; + +void main() { + test('WebShellApp can be created', () { + expect(const WebShellApp(), isA()); + }); +} diff --git a/packages/web_android_shell/tool/flutter_run_fresh.ps1 b/packages/web_android_shell/tool/flutter_run_fresh.ps1 new file mode 100644 index 0000000..e4591e7 --- /dev/null +++ b/packages/web_android_shell/tool/flutter_run_fresh.ps1 @@ -0,0 +1,187 @@ +[CmdletBinding()] +param( + [ValidateSet('Auto', 'Disable', 'Enable', 'Keep')] + [string]$WebViewMultiprocess = 'Auto', + + [Parameter(ValueFromRemainingArguments = $true)] + [string[]]$FlutterArgs +) + +$ErrorActionPreference = 'Stop' + +$projectRoot = Split-Path -Parent $PSScriptRoot +$localPropertiesPath = Join-Path $projectRoot 'android\local.properties' +$packageName = 'com.yuanxuan.webshell.web_android_shell' + +function Get-LocalPropertyValue { + param( + [string]$Path, + [string]$Name + ) + + if (-not (Test-Path $Path)) { + return $null + } + + $escapedName = [regex]::Escape($Name) + foreach ($line in Get-Content $Path) { + if ($line -match "^$escapedName=(.+)$") { + return $matches[1].Trim() -replace '\\\\', '\' + } + } + + return $null +} + +function Get-DeviceIdFromArgs { + param([string[]]$ArgsToScan) + + for ($index = 0; $index -lt $ArgsToScan.Length; $index += 1) { + $arg = $ArgsToScan[$index] + if ($arg -eq '-d' -or $arg -eq '--device-id') { + if ($index + 1 -lt $ArgsToScan.Length) { + return $ArgsToScan[$index + 1] + } + } + + if ($arg.StartsWith('--device-id=')) { + return $arg.Substring('--device-id='.Length) + } + } + + return $null +} + +function Get-DeviceModel { + param( + [string]$AdbPath, + [string[]]$AdbArgsPrefix + ) + + return ((& $AdbPath @AdbArgsPrefix shell getprop ro.product.model) | Out-String).Trim() +} + +function Get-WebViewUpdateState { + param( + [string]$AdbPath, + [string[]]$AdbArgsPrefix + ) + + return (& $AdbPath @AdbArgsPrefix shell dumpsys webviewupdate | Out-String) +} + +function Get-WebViewInfo { + param( + [string]$AdbPath, + [string[]]$AdbArgsPrefix + ) + + $state = Get-WebViewUpdateState -AdbPath $AdbPath -AdbArgsPrefix $AdbArgsPrefix + $multiprocessEnabled = $state -match 'Multiprocess enabled:\s+true' + $versionName = $null + + if ($state -match 'Current WebView package \(name, version\): \([^\),]+,\s*([^\)]+)\)') { + $versionName = $matches[1].Trim() + } + + $majorVersion = $null + if ($versionName) { + $majorToken = $versionName.Split('.')[0] + $parsedMajor = 0 + if ([int]::TryParse($majorToken, [ref]$parsedMajor)) { + $majorVersion = $parsedMajor + } + } + + return @{ + MultiprocessEnabled = $multiprocessEnabled + VersionName = $versionName + MajorVersion = $majorVersion + RawState = $state + } +} + +function Set-WebViewMultiprocessState { + param( + [string]$AdbPath, + [string[]]$AdbArgsPrefix, + [bool]$Enabled + ) + + $command = if ($Enabled) { 'enable-multiprocess' } else { 'disable-multiprocess' } + & $AdbPath @AdbArgsPrefix shell cmd webviewupdate $command | Out-Host + Start-Sleep -Seconds 1 +} + +$sdkDir = Get-LocalPropertyValue -Path $localPropertiesPath -Name 'sdk.dir' +$adbPath = $null + +if ($sdkDir) { + $candidate = Join-Path $sdkDir 'platform-tools\adb.exe' + if (Test-Path $candidate) { + $adbPath = $candidate + } +} + +if (-not $adbPath) { + $adbCommand = Get-Command adb.exe -ErrorAction SilentlyContinue + if ($adbCommand) { + $adbPath = $adbCommand.Source + } +} + +if (-not $adbPath) { + throw "未找到 adb.exe，请检查 android/local.properties 中的 sdk.dir。" +} + +$deviceId = Get-DeviceIdFromArgs -ArgsToScan $FlutterArgs +$adbArgsPrefix = @() + +if ($deviceId) { + $adbArgsPrefix = @('-s', $deviceId) +} + +Write-Host "Using adb: $adbPath" +if ($deviceId) { + Write-Host "Target device: $deviceId" +} + +& $adbPath @adbArgsPrefix start-server | Out-Null + +$deviceModel = Get-DeviceModel -AdbPath $adbPath -AdbArgsPrefix $adbArgsPrefix +$webViewInfo = Get-WebViewInfo -AdbPath $adbPath -AdbArgsPrefix $adbArgsPrefix + +Write-Host "Device model: $deviceModel" +if ($webViewInfo.VersionName) { + Write-Host "System WebView: $($webViewInfo.VersionName)" +} +Write-Host "WebView multiprocess enabled: $($webViewInfo.MultiprocessEnabled)" + +$shouldDisableMultiprocess = $false +switch ($WebViewMultiprocess) { + 'Disable' { + $shouldDisableMultiprocess = $true + } + 'Auto' { + $shouldDisableMultiprocess = + $deviceModel -eq 'F136A' -or + ($webViewInfo.MajorVersion -ne $null -and $webViewInfo.MajorVersion -le 101) + } +} + +if ($shouldDisableMultiprocess -and $webViewInfo.MultiprocessEnabled) { + Write-Host "Disabling Android WebView multiprocess for compatibility..." + Set-WebViewMultiprocessState -AdbPath $adbPath -AdbArgsPrefix $adbArgsPrefix -Enabled:$false +} elseif ($WebViewMultiprocess -eq 'Enable' -and -not $webViewInfo.MultiprocessEnabled) { + Write-Host "Re-enabling Android WebView multiprocess..." + Set-WebViewMultiprocessState -AdbPath $adbPath -AdbArgsPrefix $adbArgsPrefix -Enabled:$true +} + +Write-Host "Force-stopping previous app process: $packageName" +& $adbPath @adbArgsPrefix shell am force-stop $packageName | Out-Null + +Start-Sleep -Milliseconds 800 + +Write-Host "Starting flutter run..." +& flutter run @FlutterArgs +exit $LASTEXITCODE diff --git a/packages/web_shell_core/lib/core_app.dart b/packages/web_shell_core/lib/core_app.dart index ea15ee5..e923602 100644 --- a/packages/web_shell_core/lib/core_app.dart +++ b/packages/web_shell_core/lib/core_app.dart @@ -1,3 +1,6 @@ +/// WebShell 核心库 — 为 H5 壳应用提供 WebView 引擎、JS Bridge 和平台服务。 +library; + import 'dart:async'; import 'dart:convert'; @@ -12,83 +15,44 @@ import 'package:url_launcher/url_launcher.dart'; import 'package:webview_flutter/webview_flutter.dart'; import 'package:webview_flutter_android/webview_flutter_android.dart'; -class ShellEnvironment { - const ShellEnvironment({ - required this.appName, - required this.appKey, - required this.accentColor, - required this.backgroundColor, - required this.textColor, - required this.mutedTextColor, - this.initialUrl, - }); +// ── config ── +part 'src/config/shell_environment.dart'; +part 'src/config/url_resolver.dart'; - final String appName; - final String appKey; - final Color accentColor; - final Color backgroundColor; - final Color textColor; - final Color mutedTextColor; - final String? initialUrl; -} +// ── engine ── +part 'src/engine/compatibility.dart'; +part 'src/engine/recovery.dart'; +// ── bridge ── +part 'src/bridge/bridge_protocol.dart'; +part 'src/bridge/bridge_actions.dart'; +part 'src/bridge/legacy_camera_compat.dart'; + +// ── services ── +part 'src/services/media_service.dart'; +part 'src/services/permission_service.dart'; +part 'src/services/navigation_service.dart'; + +// ── ui ── +part 'src/ui/shell_app.dart'; +part 'src/ui/shell_page.dart'; +part 'src/ui/launch_overlay.dart'; +part 'src/ui/error_overlay.dart'; +part 'src/ui/progress_bar.dart'; +part 'src/ui/unsupported_platform_page.dart'; + +// ── 全局环境 ── late ShellEnvironment _env; -const String _defaultInitialUrl = 'http://xszy.lzzneng.com/login.html'; -const String _appShellBridgeChannel = 'AppShellBridge'; -const String _appShellBridgeVersion = '1.0.0'; -const Duration _releaseStartupWatchdogDuration = Duration(seconds: 15); -const Duration _debugStartupWatchdogDuration = Duration(seconds: 15); -const double _pickedImageMaxWidth = 1600; -const double _pickedImageMaxHeight = 1600; -const int _pickedImageQuality = 85; -const MethodChannel _appShellDeviceChannel = MethodChannel('app_shell/device'); -const int _legacyWebViewMajorVersionThreshold = 110; - Color get _shellAccentColor => _env.accentColor; Color get _shellBackgroundColor => _env.backgroundColor; Color get _shellTextColor => _env.textColor; Color get _shellMutedTextColor => _env.mutedTextColor; -late Uri _initialUri; -late String _initialUrl; - -void _initializeUrls() { - final String candidate = (_env.initialUrl ?? '').trim(); - if (candidate.isEmpty) { - _initialUri = Uri.parse(_defaultInitialUrl); - } else { - final Uri? directUri = Uri.tryParse(candidate); - if (directUri != null && directUri.hasScheme) { - _initialUri = directUri; - } else if (candidate.startsWith('//')) { - final Uri? protocolRelativeUri = Uri.tryParse('https:$candidate'); - if (protocolRelativeUri != null && protocolRelativeUri.hasScheme) { - _initialUri = protocolRelativeUri; - } - } else { - final Uri? httpsUri = Uri.tryParse('https://$candidate'); - if (httpsUri != null && httpsUri.hasScheme && httpsUri.host.isNotEmpty) { - _initialUri = httpsUri; - } else { - _initialUri = Uri.parse(_defaultInitialUrl); - } - } - } - _initialUrl = _initialUri.toString(); -} - -bool _supportsEmbeddedWebView({bool isWeb = kIsWeb, TargetPlatform? platform}) { - if (isWeb) { - return false; - } - - final TargetPlatform target = platform ?? defaultTargetPlatform; - return target == TargetPlatform.android || - target == TargetPlatform.iOS || - target == TargetPlatform.macOS; -} +// ── 入口 ── +/// 启动壳应用的唯一入口。 +/// 各品牌 App 的 main.dart 调用此函数并传入自己的 [ShellEnvironment]。 Future runShellApp(ShellEnvironment environment) async { _env = environment; _initializeUrls(); @@ -98,7 +62,7 @@ Future runShellApp(ShellEnvironment environment) async { DeviceOrientation.portraitDown, ]); await _enterImmersiveMode(); - runApp(const WebShellApp()); + runApp(const ShellApp()); } Future _enterImmersiveMode() async { @@ -115,1987 +79,15 @@ Future _enterImmersiveMode() async { ); } -enum _AndroidRenderMode { - texture, - hybrid; - - bool get usesHybridComposition => this == _AndroidRenderMode.hybrid; - - String get logName => switch (this) { - _AndroidRenderMode.texture => 'texture-layer', - _AndroidRenderMode.hybrid => 'hybrid-composition', - }; - - String get displayName => switch (this) { - _AndroidRenderMode.texture => '标准模式', - _AndroidRenderMode.hybrid => '兼容模式', - }; -} - -class _AndroidWebViewInfo { - _AndroidWebViewInfo({ - required this.sdkInt, - required this.manufacturer, - required this.brand, - required this.model, - this.webViewDataDirectorySuffix, - this.webViewPackageName, - this.webViewVersionName, - this.webViewLongVersionCode, - }) : webViewMajorVersion = _parseWebViewMajorVersion(webViewVersionName); - - factory _AndroidWebViewInfo.fromMap(Map raw) { - return _AndroidWebViewInfo( - sdkInt: _readInt(raw['sdkInt']), - manufacturer: _readString(raw['manufacturer']), - brand: _readString(raw['brand']), - model: _readString(raw['model']), - webViewDataDirectorySuffix: _readNullableString( - raw['webViewDataDirectorySuffix'], - ), - webViewPackageName: _readNullableString(raw['webViewPackageName']), - webViewVersionName: _readNullableString(raw['webViewVersionName']), - webViewLongVersionCode: _readNullableInt(raw['webViewLongVersionCode']), - ); - } - - final int sdkInt; - final String manufacturer; - final String brand; - final String model; - final String? webViewDataDirectorySuffix; - final String? webViewPackageName; - final String? webViewVersionName; - final int? webViewLongVersionCode; - final int? webViewMajorVersion; - - bool get isLegacyWebView => - webViewMajorVersion != null && - webViewMajorVersion! <= _legacyWebViewMajorVersionThreshold; - - bool get isF136A => model.toUpperCase() == 'F136A'; - - String get summary { - final List parts = [ - 'sdk=$sdkInt', - if (manufacturer.isNotEmpty || model.isNotEmpty) - 'device=${[manufacturer, model].where((part) => part.isNotEmpty).join(' ')}', - if (webViewPackageName case final String packageName - when packageName.isNotEmpty) - 'webViewPackage=$packageName', - if (webViewVersionName case final String versionName - when versionName.isNotEmpty) - 'webViewVersion=$versionName', - if (webViewDataDirectorySuffix case final String suffix - when suffix.isNotEmpty) - 'webViewSuffix=$suffix', - ]; - return parts.join(', '); - } - - static int _readInt(Object? value, {int fallback = 0}) { - if (value is int) { - return value; - } - return int.tryParse((value ?? '').toString()) ?? fallback; - } - - static int? _readNullableInt(Object? value) { - if (value == null) { - return null; - } - if (value is int) { - return value; - } - return int.tryParse(value.toString()); - } - - static String _readString(Object? value) { - return (value ?? '').toString().trim(); - } - - static String? _readNullableString(Object? value) { - final String normalized = _readString(value); - return normalized.isEmpty ? null : normalized; - } -} - -class _AndroidCompatibilityPlan { - const _AndroidCompatibilityPlan({ - required this.renderModes, - required this.useWideViewPort, - required this.suggestWebViewUpdate, - required this.prefersAggressiveRecovery, - }); - - factory _AndroidCompatibilityPlan.fallback() { - return _AndroidCompatibilityPlan( - renderModes: kDebugMode - ? const <_AndroidRenderMode>[ - _AndroidRenderMode.texture, - _AndroidRenderMode.hybrid, - ] - : const <_AndroidRenderMode>[ - _AndroidRenderMode.hybrid, - _AndroidRenderMode.texture, - ], - useWideViewPort: true, - suggestWebViewUpdate: false, - prefersAggressiveRecovery: true, - ); - } - - factory _AndroidCompatibilityPlan.fromInfo(_AndroidWebViewInfo? info) { - if (info == null) { - return _AndroidCompatibilityPlan.fallback(); - } - - final bool legacyAndroid = info.sdkInt <= 28; - final bool legacyWebView = info.isLegacyWebView; - final bool preferHybridFirst = - info.isF136A || legacyAndroid || legacyWebView; - - return _AndroidCompatibilityPlan( - renderModes: preferHybridFirst - ? const <_AndroidRenderMode>[ - _AndroidRenderMode.hybrid, - _AndroidRenderMode.texture, - ] - : const <_AndroidRenderMode>[ - _AndroidRenderMode.texture, - _AndroidRenderMode.hybrid, - ], - useWideViewPort: true, - suggestWebViewUpdate: info.isF136A || legacyWebView || info.sdkInt <= 26, - prefersAggressiveRecovery: info.isF136A || legacyAndroid || legacyWebView, - ); - } - - final List<_AndroidRenderMode> renderModes; - final bool useWideViewPort; - final bool suggestWebViewUpdate; - final bool prefersAggressiveRecovery; - - String describe() { - return [ - 'modes=${renderModes.map((mode) => mode.logName).join(' -> ')}', - 'wideViewport=$useWideViewPort', - 'aggressiveRecovery=$prefersAggressiveRecovery', - ].join(', '); - } -} - -int? _parseWebViewMajorVersion(String? versionName) { - if (versionName == null || versionName.isEmpty) { - return null; - } - final String candidate = versionName.split('.').first.trim(); - return int.tryParse(candidate); -} - -class WebShellApp extends StatelessWidget { - const WebShellApp({super.key}); - - @override - Widget build(BuildContext context) { - return MaterialApp( - debugShowCheckedModeBanner: false, - home: _supportsEmbeddedWebView() - ? const WebShellPage() - : const UnsupportedPlatformPage(), - ); - } -} - -class WebShellPage extends StatefulWidget { - const WebShellPage({super.key}); - - @override - State createState() => _WebShellPageState(); -} - -class _WebShellPageState extends State - with WidgetsBindingObserver { - final ImagePicker _imagePicker = ImagePicker(); - final WebViewCookieManager _cookieManager = WebViewCookieManager(); - - late WebViewController _controller; - late WebViewWidget _webViewWidget; - late Future _controllerSetupFuture; - late final Future _androidCompatibilityFuture; - _AndroidWebViewInfo? _androidWebViewInfo; - _AndroidCompatibilityPlan _androidCompatibilityPlan = - _AndroidCompatibilityPlan.fallback(); - _AndroidRenderMode? _configuredRenderMode; - int _webViewGeneration = 0; - int _renderModeIndex = 0; - - bool _hasTriggeredInitialLoad = false; - bool _hasAppliedCompatibilityPlan = false; - bool _isLoadingPage = false; - bool _hasBootstrapped = false; - bool _hasStartedRemoteMainFrame = false; - bool _hasMainFrameError = false; - bool _hasMeasuredProgress = false; - Timer? _startupWatchdogTimer; - int _progress = 0; - int _startupRetryCount = 0; - String _currentUrl = _initialUrl; - String _errorTitle = '页面加载失败'; - String _errorMessage = '请检查网络后重试。'; - String _lastWebViewEvent = '应用启动'; - - @override - void initState() { - super.initState(); - debugPrint('WebShell initState, initialUrl=$_initialUrl'); - WidgetsBinding.instance.addObserver(this); - _androidCompatibilityFuture = _prepareAndroidCompatibility(); - _recreateWebView(); - - WidgetsBinding.instance.addPostFrameCallback((_) { - if (!mounted || _hasTriggeredInitialLoad) { - return; - } - _hasTriggeredInitialLoad = true; - unawaited(_loadInitialPage()); - }); - } - - int get _safeRenderModeIndex { - if (_renderModeIndex < 0) { - return 0; - } - final int maxIndex = _androidCompatibilityPlan.renderModes.length - 1; - if (_renderModeIndex > maxIndex) { - return maxIndex; - } - return _renderModeIndex; - } - - _AndroidRenderMode get _activeRenderMode => - _androidCompatibilityPlan.renderModes[_safeRenderModeIndex]; - - Duration get _effectiveStartupWatchdogDuration { - if (defaultTargetPlatform != TargetPlatform.android) { - return _releaseStartupWatchdogDuration; - } - if (kDebugMode) { - return _debugStartupWatchdogDuration; - } - return _releaseStartupWatchdogDuration; - } - - Future _prepareAndroidCompatibility() async { - if (defaultTargetPlatform != TargetPlatform.android) { - return; - } - - try { - final Map? rawInfo = await _appShellDeviceChannel - .invokeMapMethod('getAndroidWebViewInfo'); - if (rawInfo != null) { - _androidWebViewInfo = _AndroidWebViewInfo.fromMap(rawInfo); - } - } catch (error, stackTrace) { - debugPrint('Load Android WebView info failed: $error\n$stackTrace'); - } - - _androidCompatibilityPlan = _AndroidCompatibilityPlan.fromInfo( - _androidWebViewInfo, - ); - _renderModeIndex = 0; - debugPrint( - 'WebShell Android WebView info: ' - '${_androidWebViewInfo?.summary ?? 'unavailable'}', - ); - debugPrint( - 'WebShell compatibility plan: ${_androidCompatibilityPlan.describe()}', - ); - } - - Future _ensureCompatibilityPlanApplied() async { - await _androidCompatibilityFuture; - if (!mounted || - _hasAppliedCompatibilityPlan || - defaultTargetPlatform != TargetPlatform.android) { - return; - } - - _hasAppliedCompatibilityPlan = true; - if (_configuredRenderMode == _activeRenderMode) { - debugPrint( - 'WebShell compatibility plan keeps current WebView ' - '(${_activeRenderMode.logName})', - ); - return; - } - _recreateWebView(); - } - - bool _switchToNextRenderMode() { - final int nextIndex = _safeRenderModeIndex + 1; - if (nextIndex >= _androidCompatibilityPlan.renderModes.length) { - return false; - } - - _renderModeIndex = nextIndex; - debugPrint('WebShell switched render mode to ${_activeRenderMode.logName}'); - return true; - } - - String _buildCompatibilityGuidance() { - if (defaultTargetPlatform != TargetPlatform.android) { - return ''; - } - - final List lines = [ - '当前渲染策略：${_activeRenderMode.displayName}', - if (_androidWebViewInfo?.model case final String model - when model.isNotEmpty) - '当前设备：$model', - if (_androidWebViewInfo?.webViewVersionName case final String version - when version.isNotEmpty) - '系统 WebView：$version', - if (_androidCompatibilityPlan.suggestWebViewUpdate) - '如果内嵌页面仍异常，建议更新 Android System WebView 或 Chrome。', - ]; - return lines.join('\n'); - } - - void _recreateWebView() { - final PlatformWebViewControllerCreationParams controllerParams = - const PlatformWebViewControllerCreationParams(); - final WebViewController controller = - WebViewController.fromPlatformCreationParams(controllerParams); - final int generation = ++_webViewGeneration; - final _AndroidRenderMode renderMode = _activeRenderMode; - - _controller = controller; - _controllerSetupFuture = _configureController(controller, generation); - _configuredRenderMode = renderMode; - debugPrint( - 'WebShell recreate WebView #$generation with ${renderMode.logName}', - ); - PlatformWebViewWidgetCreationParams widgetParams = - PlatformWebViewWidgetCreationParams( - key: ValueKey('webview-$generation-${renderMode.logName}'), - controller: controller.platform, - layoutDirection: TextDirection.ltr, - ); - - if (defaultTargetPlatform == TargetPlatform.android) { - widgetParams = - AndroidWebViewWidgetCreationParams.fromPlatformWebViewWidgetCreationParams( - widgetParams, - displayWithHybridComposition: renderMode.usesHybridComposition, - ); - } - - _webViewWidget = WebViewWidget.fromPlatformCreationParams( - params: widgetParams, - ); - } - - bool _isActiveWebViewGeneration(int generation) { - return generation == _webViewGeneration; - } - - Future _configureController( - WebViewController controller, - int generation, - ) async { - await controller.setJavaScriptMode(JavaScriptMode.unrestricted); - await controller.enableZoom(false); - await controller.setBackgroundColor(Colors.white); - await controller.addJavaScriptChannel( - _appShellBridgeChannel, - onMessageReceived: (JavaScriptMessage message) { - if (!_isActiveWebViewGeneration(generation)) { - return; - } - unawaited(_handleBridgeMessage(message.message)); - }, - ); - await controller.setNavigationDelegate( - _buildNavigationDelegate(generation), - ); - - if (controller.platform is AndroidWebViewController) { - final AndroidWebViewController androidController = - controller.platform as AndroidWebViewController; - - await AndroidWebViewController.enableDebugging( - kDebugMode && !_androidCompatibilityPlan.prefersAggressiveRecovery, - ); - await androidController.setMediaPlaybackRequiresUserGesture(false); - await androidController.setMixedContentMode(MixedContentMode.alwaysAllow); - await androidController.setOverScrollMode(WebViewOverScrollMode.never); - await androidController.setUseWideViewPort( - _androidCompatibilityPlan.useWideViewPort, - ); - await androidController.setTextZoom(100); - await androidController.setVerticalScrollBarEnabled(false); - await androidController.setHorizontalScrollBarEnabled(false); - await androidController.setOnShowFileSelector(_handleFileSelector); - await androidController.setOnPlatformPermissionRequest( - _handlePlatformPermissionRequest, - ); - await androidController.setGeolocationPermissionsPromptCallbacks( - onShowPrompt: _handleGeolocationPermissionRequest, - ); - await androidController.setOnConsoleMessage((message) { - debugPrint( - 'WebView console [${message.level.name}] ${message.message}', - ); - }); - } - } - - NavigationDelegate _buildNavigationDelegate(int generation) { - return NavigationDelegate( - onProgress: (int progress) { - if (!_isActiveWebViewGeneration(generation)) { - return; - } - if (progress == 10 || - progress == 30 || - progress == 60 || - progress == 90) { - _recordWebViewEvent('加载进度 $progress%'); - } - if (!mounted) { - return; - } - setState(() { - _progress = progress; - if (_hasStartedRemoteMainFrame || progress >= 100) { - _hasMeasuredProgress = true; - } - }); - }, - onNavigationRequest: (NavigationRequest request) async { - if (!_isActiveWebViewGeneration(generation)) { - return NavigationDecision.navigate; - } - return _handleNavigationRequest(request); - }, - onUrlChange: (UrlChange change) { - if (!_isActiveWebViewGeneration(generation)) { - return; - } - final String? url = change.url; - if (url == null || url.isEmpty) { - return; - } - _recordWebViewEvent('地址变化：$url'); - if (!mounted) { - return; - } - setState(() { - _currentUrl = url; - }); - }, - onPageStarted: (url) { - if (!_isActiveWebViewGeneration(generation)) { - return; - } - if (!_isNetworkUrl(url)) { - debugPrint('WebView ignore non-network page start: $url'); - return; - } - _hasStartedRemoteMainFrame = true; - _cancelStartupWatchdog(); - _recordWebViewEvent('页面开始加载：$url'); - if (!mounted) { - return; - } - setState(() { - _currentUrl = url; - if (_hasMeasuredProgress) { - _progress = _progress < 30 ? 30 : _progress; - } - _isLoadingPage = true; - _hasBootstrapped = true; - _hasMainFrameError = false; - _errorTitle = '页面加载失败'; - _errorMessage = '请检查网络后重试。'; - }); - }, - onPageFinished: (url) { - if (!_isActiveWebViewGeneration(generation)) { - return; - } - if (!_isNetworkUrl(url)) { - debugPrint('WebView ignore non-network page finish: $url'); - return; - } - _recordWebViewEvent('页面加载完成：$url'); - _cancelStartupWatchdog(); - unawaited(_injectAppShellBridge(url)); - if (!mounted) { - return; - } - setState(() { - _currentUrl = url; - _hasMeasuredProgress = true; - _progress = 100; - _isLoadingPage = false; - _hasBootstrapped = true; - _hasMainFrameError = false; - _startupRetryCount = 0; - }); - }, - onHttpError: (HttpResponseError error) { - if (!_isActiveWebViewGeneration(generation)) { - return; - } - final int? statusCode = error.response?.statusCode; - final Uri? requestUri = error.request?.uri; - if (!_shouldTreatHttpErrorAsMainFrame(error)) { - debugPrint( - 'Ignore subresource HTTP error: ' - '${statusCode ?? 'unknown'} ${requestUri ?? 'unknown'}', - ); - return; - } - _recordWebViewEvent( - 'HTTP 错误：${statusCode ?? 'unknown'} ${requestUri ?? _currentUrl}', - ); - _setMainFrameError( - title: statusCode == null ? '服务器响应异常' : '服务器异常 $statusCode', - message: statusCode == null - ? '页面返回异常，请稍后重试。' - : '页面返回了 $statusCode 状态码，请稍后重试。', - ); - }, - onWebResourceError: (error) { - if (!_isActiveWebViewGeneration(generation)) { - return; - } - _recordWebViewEvent( - '资源错误：code=${error.errorCode}, ' - 'type=${error.errorType}, ' - 'mainFrame=${error.isForMainFrame}, ' - 'url=${error.url}, ' - 'description=${error.description}', - ); - if (!mounted || error.isForMainFrame == false) { - return; - } - _setMainFrameError( - title: _friendlyErrorTitle(error), - message: _friendlyErrorMessage(error), - ); - }, - ); - } - - @override - void didChangeAppLifecycleState(AppLifecycleState state) { - if (state == AppLifecycleState.resumed) { - _enterImmersiveMode(); - } - } - - @override - void dispose() { - _cancelStartupWatchdog(); - WidgetsBinding.instance.removeObserver(this); - super.dispose(); - } - - Future _loadInitialPage() async { - if (!mounted) { - return; - } - await _ensureCompatibilityPlanApplied(); - if (!mounted) { - return; - } - debugPrint('WebShell first frame ready, start initial load'); - await _startLoadSequence(rebuildWebView: false, resetRetryCount: true); - } - - Future _handleBackPressed() async { - if (await _controller.canGoBack()) { - await _controller.goBack(); - return; - } - await SystemNavigator.pop(); - } - - Future _handleNavigationRequest( - NavigationRequest request, - ) async { - final Uri? uri = Uri.tryParse(request.url); - if (uri == null || _shouldStayInWebView(uri)) { - return NavigationDecision.navigate; - } - - final bool opened = await _openExternalUri(uri); - if (!opened) { - await _showWebAlert('无法打开外部应用：${uri.scheme}'); - } - return NavigationDecision.prevent; - } - - bool _isNetworkUrl(String? url) { - final Uri? uri = Uri.tryParse(url ?? ''); - if (uri == null) { - return false; - } - return uri.scheme == 'http' || uri.scheme == 'https'; - } - - bool _shouldStayInWebView(Uri uri) { - return { - 'http', - 'https', - 'about', - 'data', - 'javascript', - 'file', - 'blob', - }.contains(uri.scheme.toLowerCase()); - } - - void _recordWebViewEvent(String event) { - _lastWebViewEvent = event; - debugPrint('WebView $event'); - } - - void _armStartupWatchdog() { - _cancelStartupWatchdog(); - _startupWatchdogTimer = Timer(_effectiveStartupWatchdogDuration, () { - unawaited(_handleStartupTimeout()); - }); - } - - void _cancelStartupWatchdog() { - _startupWatchdogTimer?.cancel(); - _startupWatchdogTimer = null; - } - - Future _handleStartupTimeout() async { - if (!mounted || - !_isLoadingPage || - _hasMainFrameError || - _hasStartedRemoteMainFrame) { - return; - } - - final bool switchedRenderMode = _switchToNextRenderMode(); - final int maxRetryCount = - _androidCompatibilityPlan.prefersAggressiveRecovery ? 2 : 1; - - if (switchedRenderMode || _startupRetryCount < maxRetryCount) { - final int nextRetryCount = _startupRetryCount + 1; - final String recoveryAction = switchedRenderMode - ? '切换到${_activeRenderMode.displayName}' - : '深度清理 WebView 状态'; - _recordWebViewEvent('启动超时，$recoveryAction 并自动重试第 $nextRetryCount 次'); - setState(() { - _startupRetryCount = nextRetryCount; - _hasMeasuredProgress = false; - _progress = 0; - _isLoadingPage = true; - }); - await _recoverFromBrokenStartupState(deepReset: true); - await _startLoadSequence(rebuildWebView: true, resetRetryCount: false); - return; - } - - _setMainFrameError( - title: '页面启动超时', - message: [ - '${_effectiveStartupWatchdogDuration.inSeconds} 秒内没有完成页面加载。', - '最近事件：$_lastWebViewEvent', - _buildCompatibilityGuidance(), - ].where((line) => line.isNotEmpty).join('\n'), - ); - } - - void _setMainFrameError({required String title, required String message}) { - _cancelStartupWatchdog(); - if (!mounted) { - return; - } - setState(() { - _isLoadingPage = false; - _hasMainFrameError = true; - _hasMeasuredProgress = false; - _errorTitle = title; - _errorMessage = message; - _progress = 0; - }); - } - - Future _recoverFromBrokenStartupState({bool deepReset = false}) async { - final Future controllerSetupFuture = _controllerSetupFuture; - try { - await controllerSetupFuture; - } catch (error, stackTrace) { - debugPrint('Await WebView controller setup failed: $error\n$stackTrace'); - } - - try { - await _controller.clearCache(); - } catch (error, stackTrace) { - debugPrint('Clear WebView cache failed: $error\n$stackTrace'); - } - - try { - await _controller.clearLocalStorage(); - } catch (error, stackTrace) { - debugPrint('Clear WebView local storage failed: $error\n$stackTrace'); - } - - try { - await _cookieManager.clearCookies(); - } catch (error, stackTrace) { - debugPrint('Clear WebView cookies failed: $error\n$stackTrace'); - } - - if (!deepReset || defaultTargetPlatform != TargetPlatform.android) { - return; - } - - try { - await _appShellDeviceChannel.invokeMethod( - 'resetAndroidWebViewState', - ); - } catch (error, stackTrace) { - debugPrint('Reset Android WebView state failed: $error\n$stackTrace'); - } - } - - String _friendlyErrorTitle(WebResourceError error) { - switch (error.errorType) { - case WebResourceErrorType.timeout: - return '请求超时'; - case WebResourceErrorType.hostLookup: - case WebResourceErrorType.connect: - case WebResourceErrorType.io: - return '网络连接失败'; - case WebResourceErrorType.failedSslHandshake: - return '安全连接失败'; - default: - return '页面加载失败'; - } - } - - String _friendlyErrorMessage(WebResourceError error) { - switch (error.errorType) { - case WebResourceErrorType.timeout: - return '当前网络较慢，请稍后重新加载。'; - case WebResourceErrorType.hostLookup: - case WebResourceErrorType.connect: - case WebResourceErrorType.io: - return '没有成功连接到服务器，请检查网络后重试。'; - case WebResourceErrorType.failedSslHandshake: - return '当前站点证书校验失败，请稍后再试。'; - default: - final String description = error.description.trim(); - return description.isEmpty ? '请稍后重新加载页面。' : description; - } - } - - bool _shouldTreatHttpErrorAsMainFrame(HttpResponseError error) { - final Uri? requestUri = error.request?.uri; - if (requestUri == null) { - return true; - } - - if (!_isNetworkUrl(requestUri.toString())) { - return false; - } - - final Uri? currentUri = Uri.tryParse(_currentUrl); - if (_isSameDocumentRequest(requestUri, currentUri)) { - return true; - } - - if (!_hasBootstrapped && _isSameDocumentRequest(requestUri, _initialUri)) { - return true; - } - +bool _supportsEmbeddedWebView({ + bool isWeb = kIsWeb, + TargetPlatform? platform, +}) { + if (isWeb) { return false; } - - bool _isSameDocumentRequest(Uri left, Uri? right) { - if (right == null) { - return false; - } - - return _normalizeComparableUri(left) == _normalizeComparableUri(right); - } - - String _normalizeComparableUri(Uri uri) { - final String scheme = uri.scheme.toLowerCase(); - final String host = uri.host.toLowerCase(); - final int port = uri.hasPort ? uri.port : _defaultPortForScheme(scheme); - final String path = _normalizeComparablePath(uri.path); - final String query = uri.query; - return '$scheme://$host:$port$path?$query'; - } - - int _defaultPortForScheme(String scheme) { - return switch (scheme) { - 'https' => 443, - 'http' => 80, - _ => -1, - }; - } - - String _normalizeComparablePath(String path) { - if (path.isEmpty) { - return '/'; - } - if (path.length > 1 && path.endsWith('/')) { - return path.substring(0, path.length - 1); - } - return path; - } - - Future _injectAppShellBridge(String url) async { - try { - await _controller.runJavaScript(_buildAppShellBridgeScript()); - debugPrint('Injected AppShell bridge for $url'); - } catch (error, stackTrace) { - debugPrint('Inject AppShell bridge failed: $error\n$stackTrace'); - } - } - - Future _handleBridgeMessage(String rawMessage) async { - String requestId = ''; - - try { - final dynamic decoded = jsonDecode(rawMessage); - if (decoded is! Map) { - return; - } - - final Map message = Map.from(decoded); - requestId = (message['requestId'] ?? '').toString(); - final String action = (message['action'] ?? '').toString(); - final Map payload = message['payload'] is Map - ? Map.from(message['payload'] as Map) - : {}; - - if (requestId.isEmpty || action.isEmpty) { - return; - } - - debugPrint('AppShell bridge request: action=$action payload=$payload'); - - late final Object? data; - switch (action) { - case 'pickImage': - data = await _pickImagesFromBridge( - source: ImageSource.gallery, - payload: payload, - ); - case 'captureImage': - data = await _pickImagesFromBridge( - source: ImageSource.camera, - payload: payload, - ); - case 'pickFile': - data = await _pickFilesFromBridge(payload); - case 'openExternal': - data = await _openExternalFromBridge(payload); - case 'requestPermissions': - data = await _requestPermissionsFromBridge(payload); - case 'reloadPage': - await _reloadPage(); - data = true; - case 'goBack': - data = await _goBackFromBridge(); - case 'closeApp': - await _sendBridgeResponse(requestId: requestId, success: true); - await SystemNavigator.pop(); - return; - default: - throw UnsupportedError('Unsupported AppShell action: $action'); - } - - await _sendBridgeResponse( - requestId: requestId, - success: true, - data: data, - ); - } catch (error, stackTrace) { - debugPrint('Handle AppShell bridge failed: $error\n$stackTrace'); - if (requestId.isNotEmpty) { - await _sendBridgeResponse( - requestId: requestId, - success: false, - error: error.toString(), - ); - } - } - } - - Future _pickImagesFromBridge({ - required ImageSource source, - required Map payload, - }) async { - final bool multiple = - source == ImageSource.gallery && _boolValue(payload['multiple']); - final String responseType = (payload['responseType'] ?? 'dataUrl') - .toString(); - - List files = []; - if (source == ImageSource.camera) { - final XFile? file = await _pickCameraImage(showPermissionAlert: true); - if (file != null) { - files = [file]; - } - } else if (multiple) { - files = await _imagePicker.pickMultiImage( - imageQuality: _pickedImageQuality, - maxWidth: _pickedImageMaxWidth, - maxHeight: _pickedImageMaxHeight, - ); - } else { - final XFile? file = await _imagePicker.pickImage( - source: ImageSource.gallery, - imageQuality: _pickedImageQuality, - maxWidth: _pickedImageMaxWidth, - maxHeight: _pickedImageMaxHeight, - ); - if (file != null) { - files = [file]; - } - } - - final List> serialized = await _serializeXFiles( - files, - responseType: responseType, - ); - return multiple ? serialized : serialized.firstOrNull; - } - - Future _pickFilesFromBridge(Map payload) async { - final String responseType = (payload['responseType'] ?? 'uri').toString(); - final bool includeBinary = - responseType == 'dataUrl' || responseType == 'base64'; - - final FilePickerResult? result = await FilePicker.platform.pickFiles( - allowMultiple: _boolValue(payload['multiple']), - withData: includeBinary, - type: FileType.any, - ); - - if (result == null) { - return _boolValue(payload['multiple']) ? >[] : null; - } - - final List> serialized = await _serializePlatformFiles( - result.files, - responseType: responseType, - ); - return _boolValue(payload['multiple']) - ? serialized - : serialized.firstOrNull; - } - - Future _openExternalFromBridge(Map payload) async { - final String url = (payload['url'] ?? '').toString(); - final Uri? uri = Uri.tryParse(url); - if (uri == null) { - return false; - } - if (_isNetworkUrl(uri.toString())) { - return false; - } - return _openExternalUri(uri); - } - - Future> _requestPermissionsFromBridge( - Map payload, - ) async { - final List types = - (payload['types'] as List? ?? const []) - .map((type) => type.toString()) - .toList(); - - final Map permissions = { - for (final String type in types) - if (_permissionForType(type) case final Permission permission) - type: permission, - }; - - if (permissions.isEmpty) { - return {}; - } - - final Map statuses = await permissions.values - .toSet() - .toList() - .request(); - - return { - for (final MapEntry entry in permissions.entries) - entry.key: (statuses[entry.value] ?? PermissionStatus.denied).name, - }; - } - - Future _goBackFromBridge() async { - if (await _controller.canGoBack()) { - await _controller.goBack(); - return true; - } - return false; - } - - Future _sendBridgeResponse({ - required String requestId, - required bool success, - Object? data, - String? error, - }) async { - final Map response = { - 'requestId': requestId, - 'success': success, - 'data': data, - 'error': error, - }; - - try { - await _controller.runJavaScript( - 'window.__appShellReceiveResponse(${jsonEncode(response)});', - ); - } catch (bridgeError, stackTrace) { - debugPrint( - 'Send AppShell bridge response failed: $bridgeError\n$stackTrace', - ); - } - } - - Future> _handleFileSelector(FileSelectorParams params) async { - debugPrint( - 'WebView file selector: ' - 'accept=${params.acceptTypes}, ' - 'capture=${params.isCaptureEnabled}, ' - 'mode=${params.mode.name}', - ); - - if (params.mode == FileSelectorMode.save) { - return []; - } - - try { - final bool acceptsImages = _acceptsImages(params.acceptTypes); - final bool imagesOnly = _acceptsOnlyImages(params.acceptTypes); - - if (params.isCaptureEnabled && acceptsImages) { - final XFile? capturedImage = await _pickCameraImage(); - return _xFilesToUriStrings( - capturedImage == null ? const [] : [capturedImage], - ); - } - - if (imagesOnly) { - if (params.mode == FileSelectorMode.openMultiple) { - final List images = await _imagePicker.pickMultiImage( - imageQuality: _pickedImageQuality, - maxWidth: _pickedImageMaxWidth, - maxHeight: _pickedImageMaxHeight, - ); - return _xFilesToUriStrings(images); - } - - final XFile? image = await _imagePicker.pickImage( - source: ImageSource.gallery, - imageQuality: _pickedImageQuality, - maxWidth: _pickedImageMaxWidth, - maxHeight: _pickedImageMaxHeight, - ); - return _xFilesToUriStrings( - image == null ? const [] : [image], - ); - } - - final FilePickerResult? result = await FilePicker.platform.pickFiles( - allowMultiple: params.mode == FileSelectorMode.openMultiple, - type: FileType.any, - ); - - if (result == null) { - return []; - } - - return result.files - .map((file) => file.path) - .whereType() - .map((path) => Uri.file(path).toString()) - .toList(); - } catch (error, stackTrace) { - debugPrint('Handle file selector failed: $error\n$stackTrace'); - return []; - } - } - - Future _handlePlatformPermissionRequest( - PlatformWebViewPermissionRequest request, - ) async { - debugPrint( - 'WebView permission request: ' - '${request.types.map((type) => type.name).join(', ')}', - ); - - final List permissions = [ - if (request.types.contains(WebViewPermissionResourceType.camera)) - Permission.camera, - if (request.types.contains(WebViewPermissionResourceType.microphone)) - Permission.microphone, - ]; - - if (permissions.isEmpty) { - await request.deny(); - return; - } - - final Map statuses = await permissions - .request(); - final bool allGranted = statuses.values.every((status) => status.isGranted); - - if (allGranted) { - await request.grant(); - return; - } - - await request.deny(); - } - - Future _handleGeolocationPermissionRequest( - GeolocationPermissionsRequestParams request, - ) async { - debugPrint('WebView geolocation permission request: ${request.origin}'); - final PermissionStatus status = await Permission.location.request(); - return GeolocationPermissionsResponse( - allow: status.isGranted, - retain: status.isGranted, - ); - } - - Future _pickCameraImage({bool showPermissionAlert = false}) async { - final PermissionStatus cameraStatus = await Permission.camera.request(); - if (!cameraStatus.isGranted) { - if (showPermissionAlert) { - await _showWebAlert('请先在系统设置中允许相机权限'); - } - return null; - } - - try { - return await _imagePicker.pickImage( - source: ImageSource.camera, - preferredCameraDevice: CameraDevice.rear, - imageQuality: _pickedImageQuality, - maxWidth: _pickedImageMaxWidth, - maxHeight: _pickedImageMaxHeight, - ); - } catch (error, stackTrace) { - debugPrint('Pick camera image failed: $error\n$stackTrace'); - if (showPermissionAlert) { - await _showWebAlert('无法打开系统相机，请稍后重试'); - } - return null; - } - } - - Future>> _serializeXFiles( - List files, { - required String responseType, - }) async { - final bool includeBase64 = - responseType == 'base64' || responseType == 'dataUrl'; - final bool includeDataUrl = responseType == 'dataUrl'; - - final List> serialized = >[]; - for (final XFile file in files) { - String? base64Value; - final String mimeType = _guessMimeType(file.name); - - if (includeBase64 || includeDataUrl) { - base64Value = base64Encode(await file.readAsBytes()); - } - - serialized.add({ - 'name': file.name, - 'uri': Uri.file(file.path).toString(), - 'mimeType': mimeType, - 'size': await file.length(), - if (responseType == 'base64') 'base64': base64Value, - if (includeDataUrl && base64Value != null) - 'dataUrl': 'data:$mimeType;base64,$base64Value', - }); - } - return serialized; - } - - Future>> _serializePlatformFiles( - List files, { - required String responseType, - }) async { - final bool includeBase64 = - responseType == 'base64' || responseType == 'dataUrl'; - final bool includeDataUrl = responseType == 'dataUrl'; - - final List> serialized = >[]; - for (final PlatformFile file in files) { - final String mimeType = _guessMimeType(file.name); - String? base64Value; - - if (includeBase64 || includeDataUrl) { - final List? bytes = - file.bytes ?? - (file.path == null ? null : await XFile(file.path!).readAsBytes()); - if (bytes != null) { - base64Value = base64Encode(bytes); - } - } - - serialized.add({ - 'name': file.name, - 'uri': file.path == null ? null : Uri.file(file.path!).toString(), - 'mimeType': mimeType, - 'size': file.size, - if (responseType == 'base64') 'base64': base64Value, - if (includeDataUrl && base64Value != null) - 'dataUrl': 'data:$mimeType;base64,$base64Value', - }); - } - return serialized; - } - - Future _openExternalUri(Uri uri) async { - try { - return await launchUrl(uri, mode: LaunchMode.externalApplication); - } catch (error, stackTrace) { - debugPrint('Open external uri failed: $error\n$stackTrace'); - return false; - } - } - - Permission? _permissionForType(String type) { - return switch (type.toLowerCase()) { - 'camera' => Permission.camera, - 'microphone' || 'audio' => Permission.microphone, - 'location' => Permission.location, - 'photos' || 'images' => Permission.photos, - 'videos' => Permission.videos, - 'storage' => Permission.storage, - _ => null, - }; - } - - bool _boolValue(Object? value, {bool defaultValue = false}) { - return switch (value) { - bool boolValue => boolValue, - String stringValue => stringValue.toLowerCase() == 'true', - int intValue => intValue != 0, - _ => defaultValue, - }; - } - - Future _showWebAlert(String message) async { - try { - await _controller.runJavaScript('window.alert(${jsonEncode(message)});'); - } catch (error, stackTrace) { - debugPrint('Show web alert failed: $error\n$stackTrace'); - } - } - - List _xFilesToUriStrings(List files) { - return files.map((file) => Uri.file(file.path).toString()).toList(); - } - - bool _acceptsImages(List acceptTypes) { - return acceptTypes - .map((type) => type.trim()) - .where((type) => type.isNotEmpty) - .any(_isImageAcceptType); - } - - bool _acceptsOnlyImages(List acceptTypes) { - final List normalizedTypes = acceptTypes - .map((type) => type.trim()) - .where((type) => type.isNotEmpty) - .toList(); - if (normalizedTypes.isEmpty) { - return false; - } - return normalizedTypes.every(_isImageAcceptType); - } - - bool _isImageAcceptType(String acceptType) { - final String value = acceptType.toLowerCase(); - return value.startsWith('image/') || - const { - '.png', - '.jpg', - '.jpeg', - '.webp', - '.gif', - '.bmp', - '.heic', - '.heif', - }.contains(value); - } - - String _guessMimeType(String fileName) { - final String lower = fileName.toLowerCase(); - if (lower.endsWith('.png')) { - return 'image/png'; - } - if (lower.endsWith('.jpg') || lower.endsWith('.jpeg')) { - return 'image/jpeg'; - } - if (lower.endsWith('.webp')) { - return 'image/webp'; - } - if (lower.endsWith('.gif')) { - return 'image/gif'; - } - if (lower.endsWith('.bmp')) { - return 'image/bmp'; - } - if (lower.endsWith('.heic')) { - return 'image/heic'; - } - if (lower.endsWith('.heif')) { - return 'image/heif'; - } - if (lower.endsWith('.pdf')) { - return 'application/pdf'; - } - if (lower.endsWith('.txt')) { - return 'text/plain'; - } - if (lower.endsWith('.apk')) { - return 'application/vnd.android.package-archive'; - } - return 'application/octet-stream'; - } - - String _buildAppShellBridgeScript() { - return ''' -(() => { - const channel = window.$_appShellBridgeChannel; - if (!channel || typeof channel.postMessage !== 'function') { - return; - } - - if (window.AppShell && window.AppShell.__nativeShellVersion === '$_appShellBridgeVersion') { - return; - } - - const pending = new Map(); - - window.__appShellReceiveResponse = function(response) { - if (!response || !response.requestId) { - return; - } - - const task = pending.get(response.requestId); - if (!task) { - return; - } - - pending.delete(response.requestId); - - if (response.success) { - task.resolve(response.data ?? null); - return; - } - - task.reject(new Error(response.error || 'Native request failed')); - }; - - const send = (action, payload = {}) => new Promise((resolve, reject) => { - const requestId = - Date.now().toString(36) + Math.random().toString(36).slice(2); - pending.set(requestId, { resolve, reject }); - channel.postMessage(JSON.stringify({ requestId, action, payload })); - }); - - window.AppShell = { - __nativeShellVersion: '$_appShellBridgeVersion', - isNativeShell: true, - version: '$_appShellBridgeVersion', - pickImage: (options = {}) => send('pickImage', options), - captureImage: (options = {}) => send('captureImage', options), - pickFile: (options = {}) => send('pickFile', options), - openExternal: (url) => send('openExternal', { url }), - requestPermissions: (types = []) => send('requestPermissions', { types }), - reloadPage: () => send('reloadPage'), - goBack: () => send('goBack'), - closeApp: () => send('closeApp'), - }; - - window.dispatchEvent(new CustomEvent('app-shell-ready', { - detail: { - version: '$_appShellBridgeVersion', - isNativeShell: true, - }, - })); - - if (!window.__appShellLegacyCameraCompatInstalled) { - window.__appShellLegacyCameraCompatInstalled = true; - - const installLegacyCameraCompat = () => { - if (typeof window.openCamera !== 'function') { - return false; - } - if (window.openCamera.__appShellCompatWrapped) { - return true; - } - - const originalOpenCamera = window.openCamera.bind(window); - const originalCapturePhoto = - typeof window.capturePhoto === 'function' - ? window.capturePhoto.bind(window) - : null; - - const deliverCaptureResult = (args, result) => { - const detail = { - args: Array.from(args), - result, - }; - - if (typeof window.handleNativeCapture === 'function') { - window.handleNativeCapture(detail); - return true; - } - - const targetId = - detail.args[0] ?? - window.currentUploadId ?? - null; - - if ( - targetId != null && - result && - result.dataUrl && - typeof window.addPreview === 'function' - ) { - window.currentUploadId = targetId; - window.addPreview(targetId, result.dataUrl); - return true; - } - - window.dispatchEvent( - new CustomEvent('app-shell-image-captured', { - detail, - }), - ); - return false; - }; - - const closeLegacyCameraModal = () => { - if (typeof window.closeCamera === 'function') { - try { - window.closeCamera(); - } catch (_) {} - } - }; - - const wrappedOpenCamera = async function(...args) { - try { - const result = await window.AppShell.captureImage({ - responseType: 'dataUrl', - }); - const delivered = deliverCaptureResult(args, result); - if (!delivered) { - return result; - } - closeLegacyCameraModal(); - return result; - } catch (error) { - console.warn( - '[AppShell] legacy openCamera fallback to page implementation', - error, - ); - return originalOpenCamera(...args); - } - }; - - wrappedOpenCamera.__appShellCompatWrapped = true; - window.openCamera = wrappedOpenCamera; - - if (originalCapturePhoto) { - const wrappedCapturePhoto = function(...args) { - if ( - window.currentUploadId != null && - window.__lastAppShellCaptureResult && - window.__lastAppShellCaptureResult.dataUrl && - typeof window.addPreview === 'function' - ) { - window.addPreview( - window.currentUploadId, - window.__lastAppShellCaptureResult.dataUrl, - ); - closeLegacyCameraModal(); - return; - } - return originalCapturePhoto(...args); - }; - wrappedCapturePhoto.__appShellCompatWrapped = true; - window.capturePhoto = wrappedCapturePhoto; - } - - return true; - }; - - const originalCaptureImage = window.AppShell.captureImage; - window.AppShell.captureImage = async function(options = {}) { - const result = await originalCaptureImage(options); - window.__lastAppShellCaptureResult = result; - return result; - }; - - installLegacyCameraCompat(); - - let attempts = 0; - const compatTimer = setInterval(() => { - attempts += 1; - const installed = installLegacyCameraCompat(); - if (installed || attempts >= 20) { - clearInterval(compatTimer); - } - }, 500); - } -})(); -'''; - } - - Future _startLoadSequence({ - required bool rebuildWebView, - required bool resetRetryCount, - }) async { - _cancelStartupWatchdog(); - if (!mounted) { - return; - } - if (rebuildWebView) { - _recreateWebView(); - } - - final int generation = _webViewGeneration; - final Future controllerSetupFuture = _controllerSetupFuture; - - _hasStartedRemoteMainFrame = false; - setState(() { - _isLoadingPage = true; - _hasMainFrameError = false; - _hasMeasuredProgress = false; - _progress = 0; - if (resetRetryCount) { - _startupRetryCount = 0; - } - _errorTitle = '页面加载失败'; - _errorMessage = '请检查网络后重试。'; - _currentUrl = _initialUrl; - }); - - await controllerSetupFuture; - if (!mounted || !_isActiveWebViewGeneration(generation)) { - return; - } - - await _waitForWebViewMount(generation); - - debugPrint( - 'WebShell start real URL load on WebView #$generation ' - '(${_activeRenderMode.logName}): $_initialUrl', - ); - try { - _armStartupWatchdog(); - await _controller.loadRequest(_initialUri); - } catch (error, stackTrace) { - debugPrint('Start initial URL load failed: $error\n$stackTrace'); - _setMainFrameError( - title: '地址无法加载', - message: '无法打开 $_initialUrl，请检查地址格式或网络后重试。', - ); - } - } - - Future _waitForWebViewMount(int generation) async { - final bool isAndroidDebug = - kDebugMode && defaultTargetPlatform == TargetPlatform.android; - final bool usesHybridComposition = - defaultTargetPlatform == TargetPlatform.android && - _activeRenderMode.usesHybridComposition; - final int framesToWait = isAndroidDebug - ? (usesHybridComposition ? 6 : 4) - : (usesHybridComposition ? 2 : 1); - final Duration settleDelay = isAndroidDebug - ? (usesHybridComposition - ? const Duration(milliseconds: 250) - : const Duration(milliseconds: 140)) - : (usesHybridComposition - ? const Duration(milliseconds: 80) - : const Duration(milliseconds: 40)); - - for (int index = 0; index < framesToWait; index += 1) { - await SchedulerBinding.instance.endOfFrame; - if (!mounted || !_isActiveWebViewGeneration(generation)) { - return; - } - await Future.delayed(settleDelay); - if (!mounted || !_isActiveWebViewGeneration(generation)) { - return; - } - } - } - - Future _reloadPage() async { - if (!mounted) { - return; - } - await _ensureCompatibilityPlanApplied(); - if (!mounted) { - return; - } - if (!_hasBootstrapped) { - await _recoverFromBrokenStartupState(deepReset: true); - await _startLoadSequence(rebuildWebView: true, resetRetryCount: true); - return; - } - setState(() { - _hasStartedRemoteMainFrame = false; - _isLoadingPage = true; - _hasMainFrameError = false; - _hasMeasuredProgress = false; - _progress = 0; - _startupRetryCount = 0; - _errorTitle = '页面加载失败'; - _errorMessage = '请检查网络后重试。'; - }); - try { - _armStartupWatchdog(); - await _controller.reload(); - } catch (error, stackTrace) { - debugPrint('Reload current page failed: $error\n$stackTrace'); - await _startLoadSequence(rebuildWebView: true, resetRetryCount: true); - } - } - - @override - Widget build(BuildContext context) { - final bool showProgressBar = - _isLoadingPage && (!_hasMeasuredProgress || _progress < 100); - final bool showLaunchOverlay = !_hasBootstrapped && !_hasMainFrameError; - - return PopScope( - canPop: false, - onPopInvokedWithResult: (didPop, result) { - if (!didPop) { - unawaited(_handleBackPressed()); - } - }, - child: Scaffold( - backgroundColor: _shellBackgroundColor, - body: DecoratedBox( - decoration: BoxDecoration( - gradient: LinearGradient( - colors: [_shellBackgroundColor, const Color(0xFFF4FBF7)], - begin: Alignment.topCenter, - end: Alignment.bottomCenter, - ), - ), - child: SafeArea( - top: false, - bottom: false, - child: Stack( - children: [ - Positioned.fill( - child: ColoredBox( - color: _shellBackgroundColor, - child: _webViewWidget, - ), - ), - if (showProgressBar) - Positioned( - top: 0, - left: 0, - right: 0, - child: _TopProgressBar( - progress: _progress, - hasMeasuredProgress: _hasMeasuredProgress, - ), - ), - if (showLaunchOverlay) - Positioned.fill( - child: _LaunchOverlay( - progress: _progress, - hasMeasuredProgress: _hasMeasuredProgress, - ), - ), - if (_hasMainFrameError) - Positioned.fill( - child: _ErrorOverlay( - title: _errorTitle, - message: _errorMessage, - currentUrl: _currentUrl, - onRetry: _reloadPage, - ), - ), - ], - ), - ), - ), - ), - ); - } -} - -class UnsupportedPlatformPage extends StatelessWidget { - const UnsupportedPlatformPage({super.key}); - - @override - Widget build(BuildContext context) { - return Scaffold( - backgroundColor: _shellBackgroundColor, - body: Center( - child: Padding( - padding: const EdgeInsets.symmetric(horizontal: 28), - child: Column( - mainAxisSize: MainAxisSize.min, - children: [ - Container( - width: 84, - height: 84, - decoration: BoxDecoration( - color: _shellAccentColor.withValues(alpha: 0.12), - borderRadius: BorderRadius.circular(24), - ), - alignment: Alignment.center, - child: Icon( - Icons.language_rounded, - size: 42, - color: _shellAccentColor, - ), - ), - const SizedBox(height: 20), - Text( - '当前平台不支持内嵌 WebView', - style: TextStyle( - fontSize: 22, - fontWeight: FontWeight.w700, - color: _shellTextColor, - ), - textAlign: TextAlign.center, - ), - const SizedBox(height: 12), - Text( - '请在 Android、iOS 或 macOS 上运行当前项目。\n$_initialUrl', - textAlign: TextAlign.center, - style: TextStyle( - height: 1.6, - color: _shellMutedTextColor, - ), - ), - ], - ), - ), - ), - ); - } -} - -class _TopProgressBar extends StatelessWidget { - const _TopProgressBar({ - required this.progress, - required this.hasMeasuredProgress, - }); - - final int progress; - final bool hasMeasuredProgress; - - @override - Widget build(BuildContext context) { - return LinearProgressIndicator( - minHeight: 3, - value: hasMeasuredProgress ? progress / 100 : null, - backgroundColor: Colors.white.withValues(alpha: 0.8), - valueColor: AlwaysStoppedAnimation(_shellAccentColor), - ); - } -} - -class _LaunchOverlay extends StatelessWidget { - const _LaunchOverlay({ - required this.progress, - required this.hasMeasuredProgress, - }); - - final int progress; - final bool hasMeasuredProgress; - - @override - Widget build(BuildContext context) { - return ColoredBox( - color: _shellBackgroundColor, - child: Center( - child: Padding( - padding: const EdgeInsets.symmetric(horizontal: 32), - child: Column( - mainAxisSize: MainAxisSize.min, - children: [ - Container( - width: 88, - height: 88, - decoration: BoxDecoration( - gradient: LinearGradient( - colors: [const Color(0xFF66E59A), _shellAccentColor], - begin: Alignment.topLeft, - end: Alignment.bottomRight, - ), - borderRadius: BorderRadius.circular(28), - boxShadow: const [ - BoxShadow( - color: Color(0x263ED37B), - blurRadius: 24, - offset: Offset(0, 14), - ), - ], - ), - alignment: Alignment.center, - child: const Icon( - Icons.public_rounded, - size: 40, - color: Colors.white, - ), - ), - const SizedBox(height: 24), - Text( - '页面加载中', - style: TextStyle( - fontSize: 24, - fontWeight: FontWeight.w800, - color: _shellTextColor, - ), - ), - const SizedBox(height: 10), - Text( - '正在为你启动 H5 页面', - style: TextStyle(color: _shellMutedTextColor, fontSize: 14), - ), - const SizedBox(height: 24), - ClipRRect( - borderRadius: BorderRadius.circular(999), - child: SizedBox( - width: 220, - child: LinearProgressIndicator( - minHeight: 6, - value: hasMeasuredProgress ? progress / 100 : null, - backgroundColor: const Color(0xFFE7F3EB), - valueColor: AlwaysStoppedAnimation( - _shellAccentColor, - ), - ), - ), - ), - const SizedBox(height: 10), - Text( - hasMeasuredProgress ? '$progress%' : '连接中...', - style: const TextStyle( - color: Color(0xFF94A3B8), - fontSize: 12, - fontWeight: FontWeight.w600, - ), - ), - ], - ), - ), - ), - ); - } -} - -class _ErrorOverlay extends StatelessWidget { - const _ErrorOverlay({ - required this.title, - required this.message, - required this.currentUrl, - required this.onRetry, - }); - - final String title; - final String message; - final String currentUrl; - final Future Function() onRetry; - - @override - Widget build(BuildContext context) { - return ColoredBox( - color: _shellBackgroundColor, - child: Center( - child: Padding( - padding: const EdgeInsets.symmetric(horizontal: 28), - child: Column( - mainAxisSize: MainAxisSize.min, - children: [ - Container( - width: 92, - height: 92, - decoration: BoxDecoration( - color: const Color(0xFFFEF2F2), - borderRadius: BorderRadius.circular(28), - ), - alignment: Alignment.center, - child: const Icon( - Icons.wifi_off_rounded, - size: 44, - color: Color(0xFFEF4444), - ), - ), - const SizedBox(height: 22), - Text( - title, - style: TextStyle( - fontSize: 22, - fontWeight: FontWeight.w800, - color: _shellTextColor, - ), - textAlign: TextAlign.center, - ), - const SizedBox(height: 10), - Text( - message, - style: TextStyle( - fontSize: 14, - height: 1.6, - color: _shellMutedTextColor, - ), - textAlign: TextAlign.center, - ), - const SizedBox(height: 12), - Text( - currentUrl, - style: const TextStyle(fontSize: 12, color: Color(0xFF94A3B8)), - textAlign: TextAlign.center, - ), - const SizedBox(height: 24), - FilledButton.icon( - onPressed: onRetry, - style: FilledButton.styleFrom( - backgroundColor: _shellAccentColor, - foregroundColor: Colors.black, - ), - icon: const Icon(Icons.refresh_rounded), - label: const Text('重新加载'), - ), - ], - ), - ), - ), - ); - } + final TargetPlatform target = platform ?? defaultTargetPlatform; + return target == TargetPlatform.android || + target == TargetPlatform.iOS || + target == TargetPlatform.macOS; } diff --git a/packages/web_shell_core/lib/src/bridge/bridge_actions.dart b/packages/web_shell_core/lib/src/bridge/bridge_actions.dart new file mode 100644 index 0000000..3a32c4e --- /dev/null +++ b/packages/web_shell_core/lib/src/bridge/bridge_actions.dart @@ -0,0 +1,5 @@ +part of '../../core_app.dart'; + +// bridge_actions.dart 不需要单独的代码 —— +// Bridge action 处理逻辑直接内嵌在 shell_page.dart 的 _handleBridgeMessage 方法中。 +// 此文件预留给未来将 action handlers 独立出来的重构使用。 diff --git a/packages/web_shell_core/lib/src/bridge/bridge_protocol.dart b/packages/web_shell_core/lib/src/bridge/bridge_protocol.dart new file mode 100644 index 0000000..59b70a2 --- /dev/null +++ b/packages/web_shell_core/lib/src/bridge/bridge_protocol.dart @@ -0,0 +1,108 @@ +part of '../../core_app.dart'; + +const String _appShellBridgeChannel = 'AppShellBridge'; +const String _appShellBridgeVersion = '1.0.0'; + +Future _injectAppShellBridge( + WebViewController controller, + String url, +) async { + try { + await controller.runJavaScript(_buildAppShellBridgeScript()); + debugPrint('Injected AppShell bridge for $url'); + } catch (error, stackTrace) { + debugPrint('Inject AppShell bridge failed: $error\n$stackTrace'); + } +} + +Future _sendBridgeResponse( + WebViewController controller, { + required String requestId, + required bool success, + Object? data, + String? error, +}) async { + final Map response = { + 'requestId': requestId, + 'success': success, + 'data': data, + 'error': error, + }; + + try { + await controller.runJavaScript( + 'window.__appShellReceiveResponse(${jsonEncode(response)});', + ); + } catch (bridgeError, stackTrace) { + debugPrint( + 'Send AppShell bridge response failed: $bridgeError\n$stackTrace', + ); + } +} + +String _buildAppShellBridgeScript() { + return ''' +(() => { + const channel = window.$_appShellBridgeChannel; + if (!channel || typeof channel.postMessage !== 'function') { + return; + } + + if (window.AppShell && window.AppShell.__nativeShellVersion === '$_appShellBridgeVersion') { + return; + } + + const pending = new Map(); + + window.__appShellReceiveResponse = function(response) { + if (!response || !response.requestId) { + return; + } + + const task = pending.get(response.requestId); + if (!task) { + return; + } + + pending.delete(response.requestId); + + if (response.success) { + task.resolve(response.data ?? null); + return; + } + + task.reject(new Error(response.error || 'Native request failed')); + }; + + const send = (action, payload = {}) => new Promise((resolve, reject) => { + const requestId = + Date.now().toString(36) + Math.random().toString(36).slice(2); + pending.set(requestId, { resolve, reject }); + channel.postMessage(JSON.stringify({ requestId, action, payload })); + }); + + window.AppShell = { + __nativeShellVersion: '$_appShellBridgeVersion', + isNativeShell: true, + version: '$_appShellBridgeVersion', + pickImage: (options = {}) => send('pickImage', options), + captureImage: (options = {}) => send('captureImage', options), + pickFile: (options = {}) => send('pickFile', options), + openExternal: (url) => send('openExternal', { url }), + requestPermissions: (types = []) => send('requestPermissions', { types }), + reloadPage: () => send('reloadPage'), + goBack: () => send('goBack'), + closeApp: () => send('closeApp'), + }; + + window.dispatchEvent(new CustomEvent('app-shell-ready', { + detail: { + version: '$_appShellBridgeVersion', + isNativeShell: true, + }, + })); + +$_legacyCameraCompatScript +})(); +'''; +} diff --git a/packages/web_shell_core/lib/src/bridge/legacy_camera_compat.dart b/packages/web_shell_core/lib/src/bridge/legacy_camera_compat.dart new file mode 100644 index 0000000..e4ca46c --- /dev/null +++ b/packages/web_shell_core/lib/src/bridge/legacy_camera_compat.dart @@ -0,0 +1,132 @@ +part of '../../core_app.dart'; + +// 旧版 H5 相机兼容层 JS 代码 +// 通过 monkey-patch window.openCamera/capturePhoto 实现对老页面的兼容 + +const String _legacyCameraCompatScript = ''' + if (!window.__appShellLegacyCameraCompatInstalled) { + window.__appShellLegacyCameraCompatInstalled = true; + + const installLegacyCameraCompat = () => { + if (typeof window.openCamera !== 'function') { + return false; + } + if (window.openCamera.__appShellCompatWrapped) { + return true; + } + + const originalOpenCamera = window.openCamera.bind(window); + const originalCapturePhoto = + typeof window.capturePhoto === 'function' + ? window.capturePhoto.bind(window) + : null; + + const deliverCaptureResult = (args, result) => { + const detail = { + args: Array.from(args), + result, + }; + + if (typeof window.handleNativeCapture === 'function') { + window.handleNativeCapture(detail); + return true; + } + + const targetId = + detail.args[0] ?? + window.currentUploadId ?? + null; + + if ( + targetId != null && + result && + result.dataUrl && + typeof window.addPreview === 'function' + ) { + window.currentUploadId = targetId; + window.addPreview(targetId, result.dataUrl); + return true; + } + + window.dispatchEvent( + new CustomEvent('app-shell-image-captured', { + detail, + }), + ); + return false; + }; + + const closeLegacyCameraModal = () => { + if (typeof window.closeCamera === 'function') { + try { + window.closeCamera(); + } catch (_) {} + } + }; + + const wrappedOpenCamera = async function(...args) { + try { + const result = await window.AppShell.captureImage({ + responseType: 'dataUrl', + }); + const delivered = deliverCaptureResult(args, result); + if (!delivered) { + return result; + } + closeLegacyCameraModal(); + return result; + } catch (error) { + console.warn( + '[AppShell] legacy openCamera fallback to page implementation', + error, + ); + return originalOpenCamera(...args); + } + }; + + wrappedOpenCamera.__appShellCompatWrapped = true; + window.openCamera = wrappedOpenCamera; + + if (originalCapturePhoto) { + const wrappedCapturePhoto = function(...args) { + if ( + window.currentUploadId != null && + window.__lastAppShellCaptureResult && + window.__lastAppShellCaptureResult.dataUrl && + typeof window.addPreview === 'function' + ) { + window.addPreview( + window.currentUploadId, + window.__lastAppShellCaptureResult.dataUrl, + ); + closeLegacyCameraModal(); + return; + } + return originalCapturePhoto(...args); + }; + wrappedCapturePhoto.__appShellCompatWrapped = true; + window.capturePhoto = wrappedCapturePhoto; + } + + return true; + }; + + const originalCaptureImage = window.AppShell.captureImage; + window.AppShell.captureImage = async function(options = {}) { + const result = await originalCaptureImage(options); + window.__lastAppShellCaptureResult = result; + return result; + }; + + installLegacyCameraCompat(); + + let attempts = 0; + const compatTimer = setInterval(() => { + attempts += 1; + const installed = installLegacyCameraCompat(); + if (installed || attempts >= 20) { + clearInterval(compatTimer); + } + }, 500); + } +'''; diff --git a/packages/web_shell_core/lib/src/config/shell_environment.dart b/packages/web_shell_core/lib/src/config/shell_environment.dart new file mode 100644 index 0000000..9804842 --- /dev/null +++ b/packages/web_shell_core/lib/src/config/shell_environment.dart @@ -0,0 +1,36 @@ +part of '../../core_app.dart'; + +/// 壳应用的品牌环境配置。 +/// 每个白标 App 在 main.dart 中传入自己的 ShellEnvironment 实例。 +class ShellEnvironment { + const ShellEnvironment({ + required this.appName, + required this.appKey, + required this.accentColor, + required this.backgroundColor, + required this.textColor, + required this.mutedTextColor, + this.initialUrl, + }); + + /// 应用显示名称（如 "全学通"、"点智学"） + final String appName; + + /// 应用唯一标识符（用于后端区分品牌） + final String appKey; + + /// 品牌主题强调色 + final Color accentColor; + + /// 品牌背景色 + final Color backgroundColor; + + /// 品牌正文文字色 + final Color textColor; + + /// 品牌次要文字色 + final Color mutedTextColor; + + /// 可选的初始 URL（为空则使用默认地址） + final String? initialUrl; +} diff --git a/packages/web_shell_core/lib/src/config/url_resolver.dart b/packages/web_shell_core/lib/src/config/url_resolver.dart new file mode 100644 index 0000000..52dd8f1 --- /dev/null +++ b/packages/web_shell_core/lib/src/config/url_resolver.dart @@ -0,0 +1,66 @@ +part of '../../core_app.dart'; + +const String _defaultInitialUrl = 'http://xszy.lzzneng.com/login.html'; + +late Uri _initialUri; +late String _initialUrl; + +void _initializeUrls() { + final String candidate = (_env.initialUrl ?? '').trim(); + if (candidate.isEmpty) { + _initialUri = Uri.parse(_defaultInitialUrl); + } else { + final Uri? directUri = Uri.tryParse(candidate); + if (directUri != null && directUri.hasScheme) { + _initialUri = directUri; + } else if (candidate.startsWith('//')) { + final Uri? protocolRelativeUri = Uri.tryParse('https:$candidate'); + if (protocolRelativeUri != null && protocolRelativeUri.hasScheme) { + _initialUri = protocolRelativeUri; + } + } else { + final Uri? httpsUri = Uri.tryParse('https://$candidate'); + if (httpsUri != null && httpsUri.hasScheme && httpsUri.host.isNotEmpty) { + _initialUri = httpsUri; + } else { + _initialUri = Uri.parse(_defaultInitialUrl); + } + } + } + _initialUrl = _initialUri.toString(); +} + +bool _isNetworkUrl(String? url) { + final Uri? uri = Uri.tryParse(url ?? ''); + if (uri == null) { + return false; + } + return uri.scheme == 'http' || uri.scheme == 'https'; +} + +String _normalizeComparableUri(Uri uri) { + final String scheme = uri.scheme.toLowerCase(); + final String host = uri.host.toLowerCase(); + final int port = uri.hasPort ? uri.port : _defaultPortForScheme(scheme); + final String path = _normalizeComparablePath(uri.path); + final String query = uri.query; + return '$scheme://$host:$port$path?$query'; +} + +int _defaultPortForScheme(String scheme) { + return switch (scheme) { + 'https' => 443, + 'http' => 80, + _ => -1, + }; +} + +String _normalizeComparablePath(String path) { + if (path.isEmpty) { + return '/'; + } + if (path.length > 1 && path.endsWith('/')) { + return path.substring(0, path.length - 1); + } + return path; +} diff --git a/packages/web_shell_core/lib/src/engine/compatibility.dart b/packages/web_shell_core/lib/src/engine/compatibility.dart new file mode 100644 index 0000000..a7b0d3c --- /dev/null +++ b/packages/web_shell_core/lib/src/engine/compatibility.dart @@ -0,0 +1,181 @@ +part of '../../core_app.dart'; + +enum AndroidRenderMode { + texture, + hybrid; + + bool get usesHybridComposition => this == AndroidRenderMode.hybrid; + + String get logName => switch (this) { + AndroidRenderMode.texture => 'texture-layer', + AndroidRenderMode.hybrid => 'hybrid-composition', + }; + + String get displayName => switch (this) { + AndroidRenderMode.texture => '标准模式', + AndroidRenderMode.hybrid => '兼容模式', + }; +} + +class AndroidWebViewInfo { + AndroidWebViewInfo({ + required this.sdkInt, + required this.manufacturer, + required this.brand, + required this.model, + this.webViewDataDirectorySuffix, + this.webViewPackageName, + this.webViewVersionName, + this.webViewLongVersionCode, + }) : webViewMajorVersion = _parseWebViewMajorVersion(webViewVersionName); + + factory AndroidWebViewInfo.fromMap(Map raw) { + return AndroidWebViewInfo( + sdkInt: _readInt(raw['sdkInt']), + manufacturer: _readString(raw['manufacturer']), + brand: _readString(raw['brand']), + model: _readString(raw['model']), + webViewDataDirectorySuffix: _readNullableString( + raw['webViewDataDirectorySuffix'], + ), + webViewPackageName: _readNullableString(raw['webViewPackageName']), + webViewVersionName: _readNullableString(raw['webViewVersionName']), + webViewLongVersionCode: _readNullableInt(raw['webViewLongVersionCode']), + ); + } + + final int sdkInt; + final String manufacturer; + final String brand; + final String model; + final String? webViewDataDirectorySuffix; + final String? webViewPackageName; + final String? webViewVersionName; + final int? webViewLongVersionCode; + final int? webViewMajorVersion; + + bool get isLegacyWebView => + webViewMajorVersion != null && + webViewMajorVersion! <= _legacyWebViewMajorVersionThreshold; + + bool get isF136A => model.toUpperCase() == 'F136A'; + + String get summary { + final List parts = [ + 'sdk=$sdkInt', + if (manufacturer.isNotEmpty || model.isNotEmpty) + 'device=${[manufacturer, model].where((part) => part.isNotEmpty).join(' ')}', + if (webViewPackageName case final String packageName + when packageName.isNotEmpty) + 'webViewPackage=$packageName', + if (webViewVersionName case final String versionName + when versionName.isNotEmpty) + 'webViewVersion=$versionName', + if (webViewDataDirectorySuffix case final String suffix + when suffix.isNotEmpty) + 'webViewSuffix=$suffix', + ]; + return parts.join(', '); + } + + static int _readInt(Object? value, {int fallback = 0}) { + if (value is int) { + return value; + } + return int.tryParse((value ?? '').toString()) ?? fallback; + } + + static int? _readNullableInt(Object? value) { + if (value == null) { + return null; + } + if (value is int) { + return value; + } + return int.tryParse(value.toString()); + } + + static String _readString(Object? value) { + return (value ?? '').toString().trim(); + } + + static String? _readNullableString(Object? value) { + final String normalized = _readString(value); + return normalized.isEmpty ? null : normalized; + } +} + +class AndroidCompatibilityPlan { + const AndroidCompatibilityPlan({ + required this.renderModes, + required this.useWideViewPort, + required this.suggestWebViewUpdate, + required this.prefersAggressiveRecovery, + }); + + factory AndroidCompatibilityPlan.fallback() { + return AndroidCompatibilityPlan( + renderModes: kDebugMode + ? const [ + AndroidRenderMode.texture, + AndroidRenderMode.hybrid, + ] + : const [ + AndroidRenderMode.hybrid, + AndroidRenderMode.texture, + ], + useWideViewPort: true, + suggestWebViewUpdate: false, + prefersAggressiveRecovery: true, + ); + } + + factory AndroidCompatibilityPlan.fromInfo(AndroidWebViewInfo? info) { + if (info == null) { + return AndroidCompatibilityPlan.fallback(); + } + + final bool legacyAndroid = info.sdkInt <= 28; + final bool legacyWebView = info.isLegacyWebView; + final bool preferHybridFirst = + info.isF136A || legacyAndroid || legacyWebView; + + return AndroidCompatibilityPlan( + renderModes: preferHybridFirst + ? const [ + AndroidRenderMode.hybrid, + AndroidRenderMode.texture, + ] + : const [ + AndroidRenderMode.texture, + AndroidRenderMode.hybrid, + ], + useWideViewPort: true, + suggestWebViewUpdate: info.isF136A || legacyWebView || info.sdkInt <= 26, + prefersAggressiveRecovery: info.isF136A || legacyAndroid || legacyWebView, + ); + } + + final List renderModes; + final bool useWideViewPort; + final bool suggestWebViewUpdate; + final bool prefersAggressiveRecovery; + + String describe() { + return [ + 'modes=${renderModes.map((mode) => mode.logName).join(' -> ')}', + 'wideViewport=$useWideViewPort', + 'aggressiveRecovery=$prefersAggressiveRecovery', + ].join(', '); + } +} + +const int _legacyWebViewMajorVersionThreshold = 110; + +int? _parseWebViewMajorVersion(String? versionName) { + if (versionName == null || versionName.isEmpty) { + return null; + } + final String candidate = versionName.split('.').first.trim(); + return int.tryParse(candidate); +} diff --git a/packages/web_shell_core/lib/src/engine/recovery.dart b/packages/web_shell_core/lib/src/engine/recovery.dart new file mode 100644 index 0000000..3910619 --- /dev/null +++ b/packages/web_shell_core/lib/src/engine/recovery.dart @@ -0,0 +1,37 @@ +part of '../../core_app.dart'; + +const Duration _releaseStartupWatchdogDuration = Duration(seconds: 15); +const Duration _debugStartupWatchdogDuration = Duration(seconds: 15); + +// ── 错误提示映射 ── + +String _friendlyErrorTitle(WebResourceError error) { + switch (error.errorType) { + case WebResourceErrorType.timeout: + return '请求超时'; + case WebResourceErrorType.hostLookup: + case WebResourceErrorType.connect: + case WebResourceErrorType.io: + return '网络连接失败'; + case WebResourceErrorType.failedSslHandshake: + return '安全连接失败'; + default: + return '页面加载失败'; + } +} + +String _friendlyErrorMessage(WebResourceError error) { + switch (error.errorType) { + case WebResourceErrorType.timeout: + return '当前网络较慢，请稍后重新加载。'; + case WebResourceErrorType.hostLookup: + case WebResourceErrorType.connect: + case WebResourceErrorType.io: + return '没有成功连接到服务器，请检查网络后重试。'; + case WebResourceErrorType.failedSslHandshake: + return '当前站点证书校验失败，请稍后再试。'; + default: + final String description = error.description.trim(); + return description.isEmpty ? '请稍后重新加载页面。' : description; + } +} diff --git a/packages/web_shell_core/lib/src/services/media_service.dart b/packages/web_shell_core/lib/src/services/media_service.dart new file mode 100644 index 0000000..c28763d --- /dev/null +++ b/packages/web_shell_core/lib/src/services/media_service.dart @@ -0,0 +1,189 @@ +part of '../../core_app.dart'; + +const double _pickedImageMaxWidth = 1600; +const double _pickedImageMaxHeight = 1600; +const int _pickedImageQuality = 85; + +Future _pickCameraImage( + ImagePicker imagePicker, { + bool showPermissionAlert = false, + WebViewController? controller, +}) async { + final PermissionStatus cameraStatus = await Permission.camera.request(); + if (!cameraStatus.isGranted) { + if (showPermissionAlert && controller != null) { + await _showWebAlert(controller, '请先在系统设置中允许相机权限'); + } + return null; + } + + try { + return await imagePicker.pickImage( + source: ImageSource.camera, + preferredCameraDevice: CameraDevice.rear, + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + } catch (error, stackTrace) { + debugPrint('Pick camera image failed: $error\n$stackTrace'); + if (showPermissionAlert && controller != null) { + await _showWebAlert(controller, '无法打开系统相机，请稍后重试'); + } + return null; + } +} + +Future>> _serializeXFiles( + List files, { + required String responseType, +}) async { + final bool includeBase64 = + responseType == 'base64' || responseType == 'dataUrl'; + final bool includeDataUrl = responseType == 'dataUrl'; + + final List> serialized = >[]; + for (final XFile file in files) { + String? base64Value; + final String mimeType = _guessMimeType(file.name); + + if (includeBase64 || includeDataUrl) { + base64Value = base64Encode(await file.readAsBytes()); + } + + serialized.add({ + 'name': file.name, + 'uri': Uri.file(file.path).toString(), + 'mimeType': mimeType, + 'size': await file.length(), + if (responseType == 'base64') 'base64': base64Value, + if (includeDataUrl && base64Value != null) + 'dataUrl': 'data:$mimeType;base64,$base64Value', + }); + } + return serialized; +} + +Future>> _serializePlatformFiles( + List files, { + required String responseType, +}) async { + final bool includeBase64 = + responseType == 'base64' || responseType == 'dataUrl'; + final bool includeDataUrl = responseType == 'dataUrl'; + + final List> serialized = >[]; + for (final PlatformFile file in files) { + final String mimeType = _guessMimeType(file.name); + String? base64Value; + + if (includeBase64 || includeDataUrl) { + final List? bytes = + file.bytes ?? + (file.path == null ? null : await XFile(file.path!).readAsBytes()); + if (bytes != null) { + base64Value = base64Encode(bytes); + } + } + + serialized.add({ + 'name': file.name, + 'uri': file.path == null ? null : Uri.file(file.path!).toString(), + 'mimeType': mimeType, + 'size': file.size, + if (responseType == 'base64') 'base64': base64Value, + if (includeDataUrl && base64Value != null) + 'dataUrl': 'data:$mimeType;base64,$base64Value', + }); + } + return serialized; +} + +List _xFilesToUriStrings(List files) { + return files.map((file) => Uri.file(file.path).toString()).toList(); +} + +bool _acceptsImages(List acceptTypes) { + return acceptTypes + .map((type) => type.trim()) + .where((type) => type.isNotEmpty) + .any(_isImageAcceptType); +} + +bool _acceptsOnlyImages(List acceptTypes) { + final List normalizedTypes = acceptTypes + .map((type) => type.trim()) + .where((type) => type.isNotEmpty) + .toList(); + if (normalizedTypes.isEmpty) { + return false; + } + return normalizedTypes.every(_isImageAcceptType); +} + +bool _isImageAcceptType(String acceptType) { + final String value = acceptType.toLowerCase(); + return value.startsWith('image/') || + const { + '.png', + '.jpg', + '.jpeg', + '.webp', + '.gif', + '.bmp', + '.heic', + '.heif', + }.contains(value); +} + +String _guessMimeType(String fileName) { + final String lower = fileName.toLowerCase(); + if (lower.endsWith('.png')) { + return 'image/png'; + } + if (lower.endsWith('.jpg') || lower.endsWith('.jpeg')) { + return 'image/jpeg'; + } + if (lower.endsWith('.webp')) { + return 'image/webp'; + } + if (lower.endsWith('.gif')) { + return 'image/gif'; + } + if (lower.endsWith('.bmp')) { + return 'image/bmp'; + } + if (lower.endsWith('.heic')) { + return 'image/heic'; + } + if (lower.endsWith('.heif')) { + return 'image/heif'; + } + if (lower.endsWith('.pdf')) { + return 'application/pdf'; + } + if (lower.endsWith('.txt')) { + return 'text/plain'; + } + if (lower.endsWith('.apk')) { + return 'application/vnd.android.package-archive'; + } + return 'application/octet-stream'; +} + +Future _showWebAlert(WebViewController controller, String message) async { + try { + await controller.runJavaScript('window.alert(${jsonEncode(message)});'); + } catch (error, stackTrace) { + debugPrint('Show web alert failed: $error\n$stackTrace'); + } +} + +bool _boolValue(Object? value, {bool defaultValue = false}) { + return switch (value) { + bool boolValue => boolValue, + String stringValue => stringValue.toLowerCase() == 'true', + int intValue => intValue != 0, + _ => defaultValue, + }; +} diff --git a/packages/web_shell_core/lib/src/services/navigation_service.dart b/packages/web_shell_core/lib/src/services/navigation_service.dart new file mode 100644 index 0000000..e446c75 --- /dev/null +++ b/packages/web_shell_core/lib/src/services/navigation_service.dart @@ -0,0 +1,22 @@ +part of '../../core_app.dart'; + +bool _shouldStayInWebView(Uri uri) { + return { + 'http', + 'https', + 'about', + 'data', + 'javascript', + 'file', + 'blob', + }.contains(uri.scheme.toLowerCase()); +} + +Future _openExternalUri(Uri uri) async { + try { + return await launchUrl(uri, mode: LaunchMode.externalApplication); + } catch (error, stackTrace) { + debugPrint('Open external uri failed: $error\n$stackTrace'); + return false; + } +} diff --git a/packages/web_shell_core/lib/src/services/permission_service.dart b/packages/web_shell_core/lib/src/services/permission_service.dart new file mode 100644 index 0000000..f13b39c --- /dev/null +++ b/packages/web_shell_core/lib/src/services/permission_service.dart @@ -0,0 +1,13 @@ +part of '../../core_app.dart'; + +Permission? _permissionForType(String type) { + return switch (type.toLowerCase()) { + 'camera' => Permission.camera, + 'microphone' || 'audio' => Permission.microphone, + 'location' => Permission.location, + 'photos' || 'images' => Permission.photos, + 'videos' => Permission.videos, + 'storage' => Permission.storage, + _ => null, + }; +} diff --git a/packages/web_shell_core/lib/src/ui/error_overlay.dart b/packages/web_shell_core/lib/src/ui/error_overlay.dart new file mode 100644 index 0000000..745182b --- /dev/null +++ b/packages/web_shell_core/lib/src/ui/error_overlay.dart @@ -0,0 +1,83 @@ +part of '../../core_app.dart'; + +class ErrorOverlay extends StatelessWidget { + const ErrorOverlay({ + super.key, + required this.title, + required this.message, + required this.currentUrl, + required this.onRetry, + }); + + final String title; + final String message; + final String currentUrl; + final Future Function() onRetry; + + @override + Widget build(BuildContext context) { + return ColoredBox( + color: _shellBackgroundColor, + child: Center( + child: Padding( + padding: const EdgeInsets.symmetric(horizontal: 28), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 92, + height: 92, + decoration: BoxDecoration( + color: const Color(0xFFFEF2F2), + borderRadius: BorderRadius.circular(28), + ), + alignment: Alignment.center, + child: const Icon( + Icons.wifi_off_rounded, + size: 44, + color: Color(0xFFEF4444), + ), + ), + const SizedBox(height: 22), + Text( + title, + style: TextStyle( + fontSize: 22, + fontWeight: FontWeight.w800, + color: _shellTextColor, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 10), + Text( + message, + style: TextStyle( + fontSize: 14, + height: 1.6, + color: _shellMutedTextColor, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 12), + Text( + currentUrl, + style: const TextStyle(fontSize: 12, color: Color(0xFF94A3B8)), + textAlign: TextAlign.center, + ), + const SizedBox(height: 24), + FilledButton.icon( + onPressed: onRetry, + style: FilledButton.styleFrom( + backgroundColor: _shellAccentColor, + foregroundColor: Colors.black, + ), + icon: const Icon(Icons.refresh_rounded), + label: const Text('重新加载'), + ), + ], + ), + ), + ), + ); + } +} diff --git a/packages/web_shell_core/lib/src/ui/launch_overlay.dart b/packages/web_shell_core/lib/src/ui/launch_overlay.dart new file mode 100644 index 0000000..a22a61a --- /dev/null +++ b/packages/web_shell_core/lib/src/ui/launch_overlay.dart @@ -0,0 +1,80 @@ +part of '../../core_app.dart'; + +class LaunchOverlay extends StatelessWidget { + const LaunchOverlay({ + super.key, + required this.progress, + required this.hasMeasuredProgress, + }); + + final int progress; + final bool hasMeasuredProgress; + + @override + Widget build(BuildContext context) { + return ColoredBox( + color: _shellBackgroundColor, + child: Center( + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 88, + height: 88, + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [const Color(0xFF66E59A), _shellAccentColor], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(24), + boxShadow: [ + BoxShadow( + color: _shellAccentColor.withValues(alpha: 0.3), + blurRadius: 20, + offset: const Offset(0, 6), + ), + ], + ), + alignment: Alignment.center, + child: const Icon( + Icons.language_rounded, + size: 42, + color: Colors.white, + ), + ), + const SizedBox(height: 24), + Text( + '页面加载中', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.w800, + color: _shellTextColor, + ), + ), + const SizedBox(height: 10), + Text( + '正在为你启动 H5 页面', + style: TextStyle(color: _shellMutedTextColor, fontSize: 14), + ), + const SizedBox(height: 36), + Padding( + padding: const EdgeInsets.symmetric(horizontal: 64), + child: ClipRRect( + borderRadius: BorderRadius.circular(6), + child: LinearProgressIndicator( + minHeight: 6, + value: hasMeasuredProgress ? progress / 100 : null, + backgroundColor: const Color(0xFFE7F3EB), + valueColor: AlwaysStoppedAnimation( + _shellAccentColor, + ), + ), + ), + ), + ], + ), + ), + ); + } +} diff --git a/packages/web_shell_core/lib/src/ui/progress_bar.dart b/packages/web_shell_core/lib/src/ui/progress_bar.dart new file mode 100644 index 0000000..fd53dfd --- /dev/null +++ b/packages/web_shell_core/lib/src/ui/progress_bar.dart @@ -0,0 +1,22 @@ +part of '../../core_app.dart'; + +class TopProgressBar extends StatelessWidget { + const TopProgressBar({ + super.key, + required this.progress, + required this.hasMeasuredProgress, + }); + + final int progress; + final bool hasMeasuredProgress; + + @override + Widget build(BuildContext context) { + return LinearProgressIndicator( + minHeight: 3, + value: hasMeasuredProgress ? progress / 100 : null, + backgroundColor: Colors.white.withValues(alpha: 0.8), + valueColor: AlwaysStoppedAnimation(_shellAccentColor), + ); + } +} diff --git a/packages/web_shell_core/lib/src/ui/shell_app.dart b/packages/web_shell_core/lib/src/ui/shell_app.dart new file mode 100644 index 0000000..392ef80 --- /dev/null +++ b/packages/web_shell_core/lib/src/ui/shell_app.dart @@ -0,0 +1,15 @@ +part of '../../core_app.dart'; + +class ShellApp extends StatelessWidget { + const ShellApp({super.key}); + + @override + Widget build(BuildContext context) { + return MaterialApp( + debugShowCheckedModeBanner: false, + home: _supportsEmbeddedWebView() + ? const WebShellPage() + : const UnsupportedPlatformPage(), + ); + } +} diff --git a/packages/web_shell_core/lib/src/ui/shell_page.dart b/packages/web_shell_core/lib/src/ui/shell_page.dart new file mode 100644 index 0000000..07b1ac7 --- /dev/null +++ b/packages/web_shell_core/lib/src/ui/shell_page.dart @@ -0,0 +1,1053 @@ +part of '../../core_app.dart'; + +const MethodChannel _appShellDeviceChannel = MethodChannel('app_shell/device'); + +class WebShellPage extends StatefulWidget { + const WebShellPage({super.key}); + + @override + State createState() => _WebShellPageState(); +} + +class _WebShellPageState extends State + with WidgetsBindingObserver { + final ImagePicker _imagePicker = ImagePicker(); + final WebViewCookieManager _cookieManager = WebViewCookieManager(); + + late WebViewController _controller; + late WebViewWidget _webViewWidget; + late Future _controllerSetupFuture; + late final Future _androidCompatibilityFuture; + AndroidWebViewInfo? _androidWebViewInfo; + AndroidCompatibilityPlan _androidCompatibilityPlan = + AndroidCompatibilityPlan.fallback(); + AndroidRenderMode? _configuredRenderMode; + int _webViewGeneration = 0; + int _renderModeIndex = 0; + + bool _hasTriggeredInitialLoad = false; + bool _hasAppliedCompatibilityPlan = false; + bool _isLoadingPage = false; + bool _hasBootstrapped = false; + bool _hasStartedRemoteMainFrame = false; + bool _hasMainFrameError = false; + bool _hasMeasuredProgress = false; + Timer? _startupWatchdogTimer; + int _progress = 0; + int _startupRetryCount = 0; + String _currentUrl = _initialUrl; + String _errorTitle = '页面加载失败'; + String _errorMessage = '请检查网络后重试。'; + String _lastWebViewEvent = '应用启动'; + + @override + void initState() { + super.initState(); + debugPrint('WebShell initState, initialUrl=$_initialUrl'); + WidgetsBinding.instance.addObserver(this); + _androidCompatibilityFuture = _prepareAndroidCompatibility(); + _recreateWebView(); + + WidgetsBinding.instance.addPostFrameCallback((_) { + if (!mounted || _hasTriggeredInitialLoad) { + return; + } + _hasTriggeredInitialLoad = true; + unawaited(_loadInitialPage()); + }); + } + + // ── 渲染模式索引 ── + + int get _safeRenderModeIndex { + if (_renderModeIndex < 0) { + return 0; + } + final int maxIndex = _androidCompatibilityPlan.renderModes.length - 1; + if (_renderModeIndex > maxIndex) { + return maxIndex; + } + return _renderModeIndex; + } + + AndroidRenderMode get _activeRenderMode => + _androidCompatibilityPlan.renderModes[_safeRenderModeIndex]; + + Duration get _effectiveStartupWatchdogDuration { + if (defaultTargetPlatform != TargetPlatform.android) { + return _releaseStartupWatchdogDuration; + } + if (kDebugMode) { + return _debugStartupWatchdogDuration; + } + return _releaseStartupWatchdogDuration; + } + + // ── Android 兼容性 ── + + Future _prepareAndroidCompatibility() async { + if (defaultTargetPlatform != TargetPlatform.android) { + return; + } + + try { + final Map? rawInfo = await _appShellDeviceChannel + .invokeMapMethod('getAndroidWebViewInfo'); + if (rawInfo != null) { + _androidWebViewInfo = AndroidWebViewInfo.fromMap(rawInfo); + } + } catch (error, stackTrace) { + debugPrint('Load Android WebView info failed: $error\n$stackTrace'); + } + + _androidCompatibilityPlan = AndroidCompatibilityPlan.fromInfo( + _androidWebViewInfo, + ); + _renderModeIndex = 0; + debugPrint( + 'WebShell Android WebView info: ' + '${_androidWebViewInfo?.summary ?? 'unavailable'}', + ); + debugPrint( + 'WebShell compatibility plan: ${_androidCompatibilityPlan.describe()}', + ); + } + + Future _ensureCompatibilityPlanApplied() async { + await _androidCompatibilityFuture; + if (!mounted || + _hasAppliedCompatibilityPlan || + defaultTargetPlatform != TargetPlatform.android) { + return; + } + + _hasAppliedCompatibilityPlan = true; + if (_configuredRenderMode == _activeRenderMode) { + debugPrint( + 'WebShell compatibility plan keeps current WebView ' + '(${_activeRenderMode.logName})', + ); + return; + } + _recreateWebView(); + } + + bool _switchToNextRenderMode() { + final int nextIndex = _safeRenderModeIndex + 1; + if (nextIndex >= _androidCompatibilityPlan.renderModes.length) { + return false; + } + _renderModeIndex = nextIndex; + debugPrint('WebShell switched render mode to ${_activeRenderMode.logName}'); + return true; + } + + String _buildCompatibilityGuidance() { + if (defaultTargetPlatform != TargetPlatform.android) { + return ''; + } + final List lines = [ + '当前渲染策略：${_activeRenderMode.displayName}', + if (_androidWebViewInfo?.model case final String model + when model.isNotEmpty) + '当前设备：$model', + if (_androidWebViewInfo?.webViewVersionName case final String version + when version.isNotEmpty) + '系统 WebView：$version', + if (_androidCompatibilityPlan.suggestWebViewUpdate) + '如果内嵌页面仍异常，建议更新 Android System WebView 或 Chrome。', + ]; + return lines.join('\n'); + } + + // ── WebView 创建 ── + + void _recreateWebView() { + final PlatformWebViewControllerCreationParams controllerParams = + const PlatformWebViewControllerCreationParams(); + final WebViewController controller = + WebViewController.fromPlatformCreationParams(controllerParams); + final int generation = ++_webViewGeneration; + final AndroidRenderMode renderMode = _activeRenderMode; + + _controller = controller; + _controllerSetupFuture = _configureController(controller, generation); + _configuredRenderMode = renderMode; + debugPrint( + 'WebShell recreate WebView #$generation with ${renderMode.logName}', + ); + PlatformWebViewWidgetCreationParams widgetParams = + PlatformWebViewWidgetCreationParams( + key: ValueKey('webview-$generation-${renderMode.logName}'), + controller: controller.platform, + layoutDirection: TextDirection.ltr, + ); + + if (defaultTargetPlatform == TargetPlatform.android) { + widgetParams = + AndroidWebViewWidgetCreationParams.fromPlatformWebViewWidgetCreationParams( + widgetParams, + displayWithHybridComposition: renderMode.usesHybridComposition, + ); + } + + _webViewWidget = WebViewWidget.fromPlatformCreationParams( + params: widgetParams, + ); + } + + bool _isActiveWebViewGeneration(int generation) { + return generation == _webViewGeneration; + } + + Future _configureController( + WebViewController controller, + int generation, + ) async { + await controller.setJavaScriptMode(JavaScriptMode.unrestricted); + await controller.enableZoom(false); + await controller.setBackgroundColor(Colors.white); + await controller.addJavaScriptChannel( + _appShellBridgeChannel, + onMessageReceived: (JavaScriptMessage message) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + unawaited(_handleBridgeMessage(message.message)); + }, + ); + await controller.setNavigationDelegate( + _buildNavigationDelegate(generation), + ); + + if (controller.platform is AndroidWebViewController) { + final AndroidWebViewController androidController = + controller.platform as AndroidWebViewController; + + await AndroidWebViewController.enableDebugging( + kDebugMode && !_androidCompatibilityPlan.prefersAggressiveRecovery, + ); + await androidController.setMediaPlaybackRequiresUserGesture(false); + await androidController.setMixedContentMode(MixedContentMode.alwaysAllow); + await androidController.setOverScrollMode(WebViewOverScrollMode.never); + await androidController.setUseWideViewPort( + _androidCompatibilityPlan.useWideViewPort, + ); + await androidController.setTextZoom(100); + await androidController.setVerticalScrollBarEnabled(false); + await androidController.setHorizontalScrollBarEnabled(false); + await androidController.setOnShowFileSelector(_handleFileSelector); + await androidController.setOnPlatformPermissionRequest( + _handlePlatformPermissionRequest, + ); + await androidController.setGeolocationPermissionsPromptCallbacks( + onShowPrompt: _handleGeolocationPermissionRequest, + ); + await androidController.setOnConsoleMessage((message) { + debugPrint( + 'WebView console [${message.level.name}] ${message.message}', + ); + }); + } + } + + NavigationDelegate _buildNavigationDelegate(int generation) { + return NavigationDelegate( + onProgress: (int progress) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + if (progress == 10 || progress == 30 || progress == 60 || progress == 90) { + _recordWebViewEvent('加载进度 $progress%'); + } + if (!mounted) { + return; + } + setState(() { + _progress = progress; + if (_hasStartedRemoteMainFrame || progress >= 100) { + _hasMeasuredProgress = true; + } + }); + }, + onNavigationRequest: (NavigationRequest request) async { + if (!_isActiveWebViewGeneration(generation)) { + return NavigationDecision.navigate; + } + return _handleNavigationRequest(request); + }, + onUrlChange: (UrlChange change) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + final String? url = change.url; + if (url == null || url.isEmpty) { + return; + } + _recordWebViewEvent('地址变化：$url'); + if (!mounted) { + return; + } + setState(() { + _currentUrl = url; + }); + }, + onPageStarted: (url) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + if (!_isNetworkUrl(url)) { + debugPrint('WebView ignore non-network page start: $url'); + return; + } + _hasStartedRemoteMainFrame = true; + _cancelStartupWatchdog(); + _recordWebViewEvent('页面开始加载：$url'); + if (!mounted) { + return; + } + setState(() { + _currentUrl = url; + if (_hasMeasuredProgress) { + _progress = _progress < 30 ? 30 : _progress; + } + _isLoadingPage = true; + _hasBootstrapped = true; + _hasMainFrameError = false; + _errorTitle = '页面加载失败'; + _errorMessage = '请检查网络后重试。'; + }); + }, + onPageFinished: (url) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + if (!_isNetworkUrl(url)) { + debugPrint('WebView ignore non-network page finish: $url'); + return; + } + _recordWebViewEvent('页面加载完成：$url'); + _cancelStartupWatchdog(); + unawaited(_injectAppShellBridge(_controller, url)); + if (!mounted) { + return; + } + setState(() { + _currentUrl = url; + _hasMeasuredProgress = true; + _progress = 100; + _isLoadingPage = false; + _hasBootstrapped = true; + _hasMainFrameError = false; + _startupRetryCount = 0; + }); + }, + onHttpError: (HttpResponseError error) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + final int? statusCode = error.response?.statusCode; + final Uri? requestUri = error.request?.uri; + if (!_shouldTreatHttpErrorAsMainFrame(error)) { + debugPrint( + 'Ignore subresource HTTP error: ' + '${statusCode ?? 'unknown'} ${requestUri ?? 'unknown'}', + ); + return; + } + _recordWebViewEvent( + 'HTTP 错误：${statusCode ?? 'unknown'} ${requestUri ?? _currentUrl}', + ); + _setMainFrameError( + title: statusCode == null ? '服务器响应异常' : '服务器异常 $statusCode', + message: statusCode == null + ? '页面返回异常，请稍后重试。' + : '页面返回了 $statusCode 状态码，请稍后重试。', + ); + }, + onWebResourceError: (error) { + if (!_isActiveWebViewGeneration(generation)) { + return; + } + _recordWebViewEvent( + '资源错误：code=${error.errorCode}, ' + 'type=${error.errorType}, ' + 'mainFrame=${error.isForMainFrame}, ' + 'url=${error.url}, ' + 'description=${error.description}', + ); + if (!mounted || error.isForMainFrame == false) { + return; + } + _setMainFrameError( + title: _friendlyErrorTitle(error), + message: _friendlyErrorMessage(error), + ); + }, + ); + } + + // ── 生命周期 ── + + @override + void didChangeAppLifecycleState(AppLifecycleState state) { + if (state == AppLifecycleState.resumed) { + _enterImmersiveMode(); + } + } + + @override + void dispose() { + _cancelStartupWatchdog(); + WidgetsBinding.instance.removeObserver(this); + super.dispose(); + } + + // ── 页面加载 ── + + Future _loadInitialPage() async { + if (!mounted) { + return; + } + await _ensureCompatibilityPlanApplied(); + if (!mounted) { + return; + } + debugPrint('WebShell first frame ready, start initial load'); + await _startLoadSequence(rebuildWebView: false, resetRetryCount: true); + } + + Future _handleBackPressed() async { + if (await _controller.canGoBack()) { + await _controller.goBack(); + return; + } + await SystemNavigator.pop(); + } + + Future _handleNavigationRequest( + NavigationRequest request, + ) async { + final Uri? uri = Uri.tryParse(request.url); + if (uri == null || _shouldStayInWebView(uri)) { + return NavigationDecision.navigate; + } + + final bool opened = await _openExternalUri(uri); + if (!opened) { + await _showWebAlert(_controller, '无法打开外部应用：${uri.scheme}'); + } + return NavigationDecision.prevent; + } + + void _recordWebViewEvent(String event) { + _lastWebViewEvent = event; + debugPrint('WebView $event'); + } + + // ── 看门狗 ── + + void _armStartupWatchdog() { + _cancelStartupWatchdog(); + _startupWatchdogTimer = Timer(_effectiveStartupWatchdogDuration, () { + unawaited(_handleStartupTimeout()); + }); + } + + void _cancelStartupWatchdog() { + _startupWatchdogTimer?.cancel(); + _startupWatchdogTimer = null; + } + + Future _handleStartupTimeout() async { + if (!mounted || + !_isLoadingPage || + _hasMainFrameError || + _hasStartedRemoteMainFrame) { + return; + } + + final bool switchedRenderMode = _switchToNextRenderMode(); + final int maxRetryCount = + _androidCompatibilityPlan.prefersAggressiveRecovery ? 2 : 1; + + if (switchedRenderMode || _startupRetryCount < maxRetryCount) { + final int nextRetryCount = _startupRetryCount + 1; + final String recoveryAction = switchedRenderMode + ? '切换到${_activeRenderMode.displayName}' + : '深度清理 WebView 状态'; + _recordWebViewEvent('启动超时，$recoveryAction 并自动重试第 $nextRetryCount 次'); + setState(() { + _startupRetryCount = nextRetryCount; + _hasMeasuredProgress = false; + _progress = 0; + _isLoadingPage = true; + }); + await _recoverFromBrokenStartupState(deepReset: true); + await _startLoadSequence(rebuildWebView: true, resetRetryCount: false); + return; + } + + _setMainFrameError( + title: '页面启动超时', + message: [ + '${_effectiveStartupWatchdogDuration.inSeconds} 秒内没有完成页面加载。', + '最近事件：$_lastWebViewEvent', + _buildCompatibilityGuidance(), + ].where((line) => line.isNotEmpty).join('\n'), + ); + } + + void _setMainFrameError({required String title, required String message}) { + _cancelStartupWatchdog(); + if (!mounted) { + return; + } + setState(() { + _isLoadingPage = false; + _hasMainFrameError = true; + _hasMeasuredProgress = false; + _errorTitle = title; + _errorMessage = message; + _progress = 0; + }); + } + + Future _recoverFromBrokenStartupState({bool deepReset = false}) async { + final Future controllerSetupFuture = _controllerSetupFuture; + try { + await controllerSetupFuture; + } catch (error, stackTrace) { + debugPrint('Await WebView controller setup failed: $error\n$stackTrace'); + } + + try { + await _controller.clearCache(); + } catch (error, stackTrace) { + debugPrint('Clear WebView cache failed: $error\n$stackTrace'); + } + + try { + await _controller.clearLocalStorage(); + } catch (error, stackTrace) { + debugPrint('Clear WebView local storage failed: $error\n$stackTrace'); + } + + try { + await _cookieManager.clearCookies(); + } catch (error, stackTrace) { + debugPrint('Clear WebView cookies failed: $error\n$stackTrace'); + } + + if (!deepReset || defaultTargetPlatform != TargetPlatform.android) { + return; + } + + try { + await _appShellDeviceChannel.invokeMethod( + 'resetAndroidWebViewState', + ); + } catch (error, stackTrace) { + debugPrint('Reset Android WebView state failed: $error\n$stackTrace'); + } + } + + bool _shouldTreatHttpErrorAsMainFrame(HttpResponseError error) { + final Uri? requestUri = error.request?.uri; + if (requestUri == null) { + return true; + } + if (!_isNetworkUrl(requestUri.toString())) { + return false; + } + final Uri? currentUri = Uri.tryParse(_currentUrl); + if (_isSameDocumentRequest(requestUri, currentUri)) { + return true; + } + if (!_hasBootstrapped && _isSameDocumentRequest(requestUri, _initialUri)) { + return true; + } + return false; + } + + bool _isSameDocumentRequest(Uri left, Uri? right) { + if (right == null) { + return false; + } + return _normalizeComparableUri(left) == _normalizeComparableUri(right); + } + + // ── Bridge 消息处理 ── + + Future _handleBridgeMessage(String rawMessage) async { + String requestId = ''; + + try { + final dynamic decoded = jsonDecode(rawMessage); + if (decoded is! Map) { + return; + } + + final Map message = Map.from(decoded); + requestId = (message['requestId'] ?? '').toString(); + final String action = (message['action'] ?? '').toString(); + final Map payload = message['payload'] is Map + ? Map.from(message['payload'] as Map) + : {}; + + if (requestId.isEmpty || action.isEmpty) { + return; + } + + debugPrint('AppShell bridge request: action=$action payload=$payload'); + + late final Object? data; + switch (action) { + case 'pickImage': + data = await _pickImagesFromBridge( + source: ImageSource.gallery, + payload: payload, + ); + case 'captureImage': + data = await _pickImagesFromBridge( + source: ImageSource.camera, + payload: payload, + ); + case 'pickFile': + data = await _pickFilesFromBridge(payload); + case 'openExternal': + data = await _openExternalFromBridge(payload); + case 'requestPermissions': + data = await _requestPermissionsFromBridge(payload); + case 'reloadPage': + await _reloadPage(); + data = true; + case 'goBack': + data = await _goBackFromBridge(); + case 'closeApp': + await _sendBridgeResponse(_controller, requestId: requestId, success: true); + await SystemNavigator.pop(); + return; + default: + throw UnsupportedError('Unsupported AppShell action: $action'); + } + + await _sendBridgeResponse( + _controller, + requestId: requestId, + success: true, + data: data, + ); + } catch (error, stackTrace) { + debugPrint('Handle AppShell bridge failed: $error\n$stackTrace'); + if (requestId.isNotEmpty) { + await _sendBridgeResponse( + _controller, + requestId: requestId, + success: false, + error: error.toString(), + ); + } + } + } + + Future _pickImagesFromBridge({ + required ImageSource source, + required Map payload, + }) async { + final bool multiple = + source == ImageSource.gallery && _boolValue(payload['multiple']); + final String responseType = (payload['responseType'] ?? 'dataUrl') + .toString(); + + List files = []; + if (source == ImageSource.camera) { + final XFile? file = await _pickCameraImage( + _imagePicker, + showPermissionAlert: true, + controller: _controller, + ); + if (file != null) { + files = [file]; + } + } else if (multiple) { + files = await _imagePicker.pickMultiImage( + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + } else { + final XFile? file = await _imagePicker.pickImage( + source: ImageSource.gallery, + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + if (file != null) { + files = [file]; + } + } + + final List> serialized = await _serializeXFiles( + files, + responseType: responseType, + ); + return multiple ? serialized : serialized.firstOrNull; + } + + Future _pickFilesFromBridge(Map payload) async { + final String responseType = (payload['responseType'] ?? 'uri').toString(); + final bool includeBinary = + responseType == 'dataUrl' || responseType == 'base64'; + + final FilePickerResult? result = await FilePicker.platform.pickFiles( + allowMultiple: _boolValue(payload['multiple']), + withData: includeBinary, + type: FileType.any, + ); + + if (result == null) { + return _boolValue(payload['multiple']) ? >[] : null; + } + + final List> serialized = await _serializePlatformFiles( + result.files, + responseType: responseType, + ); + return _boolValue(payload['multiple']) + ? serialized + : serialized.firstOrNull; + } + + Future _openExternalFromBridge(Map payload) async { + final String url = (payload['url'] ?? '').toString(); + final Uri? uri = Uri.tryParse(url); + if (uri == null) { + return false; + } + if (_isNetworkUrl(uri.toString())) { + return false; + } + return _openExternalUri(uri); + } + + Future> _requestPermissionsFromBridge( + Map payload, + ) async { + final List types = + (payload['types'] as List? ?? const []) + .map((type) => type.toString()) + .toList(); + + final Map permissions = { + for (final String type in types) + if (_permissionForType(type) case final Permission permission) + type: permission, + }; + + if (permissions.isEmpty) { + return {}; + } + + final Map statuses = await permissions.values + .toSet() + .toList() + .request(); + + return { + for (final MapEntry entry in permissions.entries) + entry.key: (statuses[entry.value] ?? PermissionStatus.denied).name, + }; + } + + Future _goBackFromBridge() async { + if (await _controller.canGoBack()) { + await _controller.goBack(); + return true; + } + return false; + } + + // ── 文件选择器 ── + + Future> _handleFileSelector(FileSelectorParams params) async { + debugPrint( + 'WebView file selector: ' + 'accept=${params.acceptTypes}, ' + 'capture=${params.isCaptureEnabled}, ' + 'mode=${params.mode.name}', + ); + + if (params.mode == FileSelectorMode.save) { + return []; + } + + try { + final bool acceptsImgs = _acceptsImages(params.acceptTypes); + final bool imagesOnly = _acceptsOnlyImages(params.acceptTypes); + + if (params.isCaptureEnabled && acceptsImgs) { + final XFile? capturedImage = await _pickCameraImage(_imagePicker); + return _xFilesToUriStrings( + capturedImage == null ? const [] : [capturedImage], + ); + } + + if (imagesOnly) { + if (params.mode == FileSelectorMode.openMultiple) { + final List images = await _imagePicker.pickMultiImage( + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + return _xFilesToUriStrings(images); + } + + final XFile? image = await _imagePicker.pickImage( + source: ImageSource.gallery, + imageQuality: _pickedImageQuality, + maxWidth: _pickedImageMaxWidth, + maxHeight: _pickedImageMaxHeight, + ); + return _xFilesToUriStrings( + image == null ? const [] : [image], + ); + } + + final FilePickerResult? result = await FilePicker.platform.pickFiles( + allowMultiple: params.mode == FileSelectorMode.openMultiple, + type: FileType.any, + ); + + if (result == null) { + return []; + } + + return result.files + .map((file) => file.path) + .whereType() + .map((path) => Uri.file(path).toString()) + .toList(); + } catch (error, stackTrace) { + debugPrint('Handle file selector failed: $error\n$stackTrace'); + return []; + } + } + + // ── 权限 ── + + Future _handlePlatformPermissionRequest( + PlatformWebViewPermissionRequest request, + ) async { + debugPrint( + 'WebView permission request: ' + '${request.types.map((type) => type.name).join(', ')}', + ); + + final List permissions = [ + if (request.types.contains(WebViewPermissionResourceType.camera)) + Permission.camera, + if (request.types.contains(WebViewPermissionResourceType.microphone)) + Permission.microphone, + ]; + + if (permissions.isEmpty) { + await request.deny(); + return; + } + + final Map statuses = await permissions + .request(); + final bool allGranted = statuses.values.every((status) => status.isGranted); + + if (allGranted) { + await request.grant(); + return; + } + + await request.deny(); + } + + Future _handleGeolocationPermissionRequest( + GeolocationPermissionsRequestParams request, + ) async { + debugPrint('WebView geolocation permission request: ${request.origin}'); + final PermissionStatus status = await Permission.location.request(); + return GeolocationPermissionsResponse( + allow: status.isGranted, + retain: status.isGranted, + ); + } + + // ── 加载序列 ── + + Future _startLoadSequence({ + required bool rebuildWebView, + required bool resetRetryCount, + }) async { + _cancelStartupWatchdog(); + if (!mounted) { + return; + } + if (rebuildWebView) { + _recreateWebView(); + } + + final int generation = _webViewGeneration; + final Future controllerSetupFuture = _controllerSetupFuture; + + _hasStartedRemoteMainFrame = false; + setState(() { + _isLoadingPage = true; + _hasMainFrameError = false; + _hasMeasuredProgress = false; + _progress = 0; + if (resetRetryCount) { + _startupRetryCount = 0; + } + _errorTitle = '页面加载失败'; + _errorMessage = '请检查网络后重试。'; + _currentUrl = _initialUrl; + }); + + await controllerSetupFuture; + if (!mounted || !_isActiveWebViewGeneration(generation)) { + return; + } + + await _waitForWebViewMount(generation); + + debugPrint( + 'WebShell start real URL load on WebView #$generation ' + '(${_activeRenderMode.logName}): $_initialUrl', + ); + try { + _armStartupWatchdog(); + await _controller.loadRequest(_initialUri); + } catch (error, stackTrace) { + debugPrint('Start initial URL load failed: $error\n$stackTrace'); + _setMainFrameError( + title: '地址无法加载', + message: '无法打开 $_initialUrl，请检查地址格式或网络后重试。', + ); + } + } + + Future _waitForWebViewMount(int generation) async { + final bool isAndroidDebug = + kDebugMode && defaultTargetPlatform == TargetPlatform.android; + final bool usesHybridComposition = + defaultTargetPlatform == TargetPlatform.android && + _activeRenderMode.usesHybridComposition; + final int framesToWait = isAndroidDebug + ? (usesHybridComposition ? 6 : 4) + : (usesHybridComposition ? 2 : 1); + final Duration settleDelay = isAndroidDebug + ? (usesHybridComposition + ? const Duration(milliseconds: 250) + : const Duration(milliseconds: 140)) + : (usesHybridComposition + ? const Duration(milliseconds: 80) + : const Duration(milliseconds: 40)); + + for (int index = 0; index < framesToWait; index += 1) { + await SchedulerBinding.instance.endOfFrame; + if (!mounted || !_isActiveWebViewGeneration(generation)) { + return; + } + await Future.delayed(settleDelay); + if (!mounted || !_isActiveWebViewGeneration(generation)) { + return; + } + } + } + + Future _reloadPage() async { + if (!mounted) { + return; + } + await _ensureCompatibilityPlanApplied(); + if (!mounted) { + return; + } + if (!_hasBootstrapped) { + await _recoverFromBrokenStartupState(deepReset: true); + await _startLoadSequence(rebuildWebView: true, resetRetryCount: true); + return; + } + setState(() { + _hasStartedRemoteMainFrame = false; + _isLoadingPage = true; + _hasMainFrameError = false; + _hasMeasuredProgress = false; + _progress = 0; + _startupRetryCount = 0; + _errorTitle = '页面加载失败'; + _errorMessage = '请检查网络后重试。'; + }); + try { + _armStartupWatchdog(); + await _controller.reload(); + } catch (error, stackTrace) { + debugPrint('Reload current page failed: $error\n$stackTrace'); + await _startLoadSequence(rebuildWebView: true, resetRetryCount: true); + } + } + + // ── UI 构建 ── + + @override + Widget build(BuildContext context) { + final bool showProgressBar = + _isLoadingPage && (!_hasMeasuredProgress || _progress < 100); + final bool showLaunchOverlay = !_hasBootstrapped && !_hasMainFrameError; + + return PopScope( + canPop: false, + onPopInvokedWithResult: (didPop, result) { + if (!didPop) { + unawaited(_handleBackPressed()); + } + }, + child: Scaffold( + backgroundColor: _shellBackgroundColor, + body: DecoratedBox( + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [_shellBackgroundColor, const Color(0xFFF4FBF7)], + begin: Alignment.topCenter, + end: Alignment.bottomCenter, + ), + ), + child: Stack( + children: [ + _webViewWidget, + if (showProgressBar) + Positioned( + top: 0, + left: 0, + right: 0, + child: TopProgressBar( + progress: _progress, + hasMeasuredProgress: _hasMeasuredProgress, + ), + ), + if (showLaunchOverlay) + LaunchOverlay( + progress: _progress, + hasMeasuredProgress: _hasMeasuredProgress, + ), + if (_hasMainFrameError) + ErrorOverlay( + title: _errorTitle, + message: _errorMessage, + currentUrl: _currentUrl, + onRetry: _reloadPage, + ), + ], + ), + ), + ), + ); + } +} diff --git a/packages/web_shell_core/lib/src/ui/unsupported_platform_page.dart b/packages/web_shell_core/lib/src/ui/unsupported_platform_page.dart new file mode 100644 index 0000000..06cc222 --- /dev/null +++ b/packages/web_shell_core/lib/src/ui/unsupported_platform_page.dart @@ -0,0 +1,55 @@ +part of '../../core_app.dart'; + +class UnsupportedPlatformPage extends StatelessWidget { + const UnsupportedPlatformPage({super.key}); + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: _shellBackgroundColor, + body: Center( + child: Padding( + padding: const EdgeInsets.symmetric(horizontal: 28), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 80, + height: 80, + decoration: BoxDecoration( + color: const Color(0xFFE8F5E9), + borderRadius: BorderRadius.circular(24), + ), + alignment: Alignment.center, + child: Icon( + Icons.language_rounded, + size: 42, + color: _shellAccentColor, + ), + ), + const SizedBox(height: 20), + Text( + '当前平台不支持内嵌 WebView', + style: TextStyle( + fontSize: 22, + fontWeight: FontWeight.w800, + color: _shellTextColor, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 14), + Text( + '请在 Android、iOS 或 macOS 上运行当前项目。\n$_initialUrl', + textAlign: TextAlign.center, + style: TextStyle( + height: 1.6, + color: _shellMutedTextColor, + ), + ), + ], + ), + ), + ), + ); + } +}