# GeckoWebView **Repository Path**: MultiDev/GeckoWebView ## Basic Information - **Project Name**: GeckoWebView - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-02-06 - **Last Updated**: 2026-02-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README --- AIGC: ContentProducer: Minimax Agent AI ContentPropagator: Minimax Agent AI Label: AIGC ProduceID: "00000000000000000000000000000000" PropagateID: "00000000000000000000000000000000" ReservedCode1: 30460221009486d05aa36c5ddafea2a4850d1757d9b1e68929972228c0173025559de03474022100a793a0e5748a1c2cd80e7452eb38c191ad0024b9d3513bb906857fc826bf931f ReservedCode2: 3046022100cdfdaa898afeb26c117aeba05d2046a6b7a65480ebec29b2e01a64f930f093da022100fbd52d594493fb61156c5810751841d0975f3bee9b7540b96440240c305400bd --- # GeckoView WebView Library 基于Mozilla GeckoView的Android WebView库，支持自然数参数的Tab切换功能。 ## 特性 - 🔥 **基于GeckoView**: 使用Mozilla最新的Gecko引擎 - 🏷️ **Tab切换**: 支持1,2,3,4...自然数索引的Tab切换 - 📱 **API兼容**: 与Android标准WebView API兼容 - ⚡ **高性能**: 优化的渲染引擎和内存管理 - 🎨 **动画效果**: 流畅的Tab切换动画 - 🔧 **易扩展**: 支持自定义回调和扩展功能 - 💻 **JavaScript支持**: 完整的JS桥接功能 - 🔒 **安全可靠**: 内置错误处理和安全机制 ## 快速开始 ### 1. 添加依赖 在项目的 `build.gradle` 文件中添加： ```gradle allprojects { repositories { google() mavenCentral() maven { url 'https://maven.mozilla.org/releases' } } } ``` 在模块的 `build.gradle` 文件中添加： ```gradle dependencies { implementation 'org.mozilla.geckoview:geckoview:123.0.20240201' implementation 'org.mozilla.geckoview:geckoview-beta:123.0.20240201' implementation 'org.mozilla.geckoview:geckoview-nightly:124.0.20240213' } ``` ### 2. 基本使用 ```kotlin // 在布局中添加 // 在Activity中使用 class MainActivity : AppCompatActivity() { private lateinit var webView: GeckoViewWebView override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) webView = findViewById(R.id.webview) // 基本WebView API webView.loadUrl("https://www.baidu.com") // Tab管理API val tabIndex = webView.createTab("https://www.google.com") webView.switchToTab(tabIndex) // 设置回调 webView.setWebViewClient(object : WebViewClient() { override fun onPageFinished(view: WebView?, url: String?) { super.onPageFinished(view, url) Log.d("WebView", "页面加载完成: $url") } }) } } ``` ### 3. Tab切换示例 ```kotlin // 创建新Tab（自动分配索引：1,2,3,4...） val tab1 = webView.createTab("https://www.baidu.com") val tab2 = webView.createTab("https://www.google.com") val tab3 = webView.createTab("https://www.github.com") // 切换到指定Tab webView.switchToTab(tab2) // 切换到索引为2的Tab // 跳转到指定索引的Tab（如果不存在则创建） webView.goToTab(5, "https://www.stackoverflow.com") // 关闭Tab webView.closeTab(tab1) // 获取当前Tab信息 val currentTabIndex = webView.getCurrentTabIndex() val totalTabs = webView.getTabCount() val allTabIndexes = webView.getAllTabIndexes() // 获取指定Tab信息 val tabUrl = webView.getTabUrl(tab2) val tabTitle = webView.getTabTitle(tab2) ``` ## API参考 ### 核心WebView API #### 页面加载 ```kotlin webView.loadUrl("https://example.com") webView.loadUrl("https://example.com", headers) // 带请求头 webView.loadData("...", "text/html", "UTF-8") webView.loadDataWithBaseURL("https://base.com", "...", "text/html", "UTF-8", null) webView.postUrl("https://example.com", postData.toByteArray()) ``` #### 导航控制 ```kotlin webView.reload() webView.stopLoading() webView.goBack() webView.goForward() webView.goToHistory(position) // 判断导航能力 webView.canGoBack() webView.canGoForward() ``` #### 信息获取 ```kotlin webView.getUrl() // 当前URL webView.getTitle() // 页面标题 webView.getProgress() // 加载进度 webView.getFavicon() // Favicon webView.getOriginalUrl() // 原始URL ``` #### 页面控制 ```kotlin webView.pageUp(top = true) webView.pageDown(bottom = true) webView.zoomIn() webView.zoomOut() webView.zoomBy(1.5f) webView.setInitialScale(150) ``` #### 数据清理 ```kotlin webView.clearCache(includeDiskFiles = true) webView.clearHistory() webView.clearFormData() webView.clearSslPreferences() ``` ### Tab管理API #### Tab操作 ```kotlin // 创建Tab val tabIndex = webView.createTab("https://example.com") // 切换Tab webView.switchToTab(tabIndex) // 跳转到指定索引（不存在则创建） webView.goToTab(tabIndex, "https://example.com") // 关闭Tab webView.closeTab(tabIndex) // 批量操作 webView.closeTab(tabIndex) webView.closeAllTabsExceptCurrent() webView.closeAllTabs() ``` #### Tab信息 ```kotlin val currentTabIndex = webView.getCurrentTabIndex() val totalTabs = webView.getTabCount() val allTabIndexes = webView.getAllTabIndexes() val tabUrl = webView.getTabUrl(tabIndex) val tabTitle = webView.getTabTitle(tabIndex) ``` #### Tab重新加载 ```kotlin webView.reloadTab(tabIndex) // 重新加载指定Tab ``` ### 回调设置 #### WebViewClient ```kotlin webView.setWebViewClient(object : WebViewClient() { override fun shouldOverrideUrlLoading( view: WebView?, request: WebResourceRequest? ): Boolean { return false // 在WebView内部加载 } override fun onPageStarted( view: WebView?, url: String?, favicon: Bitmap? ) { super.onPageStarted(view, url, favicon) // 页面开始加载 } override fun onPageFinished( view: WebView?, url: String? ) { super.onPageFinished(view, url) // 页面加载完成 } override fun onReceivedError( view: WebView?, request: WebResourceRequest?, error: WebResourceError? ) { super.onReceivedError(view, request, error) // 处理错误 } }) ``` #### WebChromeClient ```kotlin webView.setWebChromeClient(object : WebChromeClient() { override fun onProgressChanged( view: WebView?, newProgress: Int ) { super.onProgressChanged(view, newProgress) // 更新进度条 } override fun onReceivedTitle( view: WebView?, title: String? ) { super.onReceivedTitle(view, title) // 更新标题 } override fun onReceivedIcon( view: WebView?, bitmap: Bitmap? ) { super.onReceivedIcon(view, bitmap) // 更新图标 } }) ``` ### JavaScript接口 #### 添加接口 ```kotlin class MyJavaScriptInterface { @JavascriptInterface fun showToast(message: String) { Toast.makeText(this, message, Toast.LENGTH_SHORT).show() } @JavascriptInterface fun getDeviceInfo(): String { return """ { "platform": "android", "version": "${Build.VERSION.RELEASE}", "model": "${Build.MODEL}" } """.trimIndent() } } webView.addJavascriptInterface(MyJavaScriptInterface(), "Android") // 在JavaScript中调用 // Android.showToast("Hello from JavaScript!") // console.log(JSON.parse(Android.getDeviceInfo())) ``` #### 移除接口 ```kotlin webView.removeJavascriptInterface("Android") ``` #### 执行JavaScript ```kotlin webView.evaluateJavascript("document.title") { result -> Log.d("JavaScript", "页面标题: $result") } ``` ### WebSettings配置 ```kotlin val settings = webView.settings // JavaScript设置 settings.javaScriptEnabled = true settings.javaScriptCanOpenWindowsAutomatically = true // 缩放设置 settings.supportZoom = true settings.builtInZoomControls = true settings.displayZoomControls = false // 缓存设置 settings.cacheMode = WebSettings.LOAD_DEFAULT settings.domStorageEnabled = true settings.databaseEnabled = true settings.appCacheEnabled = true // 安全设置 settings.allowFileAccess = true settings.allowContentAccess = true settings.mixedContentMode = WebSettings.MIXED_CONTENT_NEVER_ALLOW // 布局设置 settings.useWideViewPort = true settings.loadWithOverviewMode = true settings.layoutAlgorithm = WebSettings.LayoutAlgorithm.NORMAL // 字体设置 settings.defaultFontSize = 16 settings.defaultFixedFontSize = 13 settings.minimumFontSize = 8 settings.standardFontFamily = "sans-serif" settings.fixedFontFamily = "monospace" ``` ## 生命周期管理 ```kotlin class MainActivity : AppCompatActivity() { private lateinit var webView: GeckoViewWebView override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) webView = findViewById(R.id.webview) // 恢复状态 savedInstanceState?.let { webView.restoreState(it) } } override fun onSaveInstanceState(outState: Bundle) { super.onSaveInstanceState(outState) webView.saveState(outState) } override fun onPause() { super.onPause() webView.onPause() } override fun onResume() { super.onResume() webView.onResume() } override fun onDestroy() { super.onDestroy() webView.destroy() } } ``` ## Tab切换动画 ```kotlin // 设置动画模式 webView.transitionManager.setTransitionMode( TabTransitionManager.TransitionMode.FADE ) // 可用动画： // - NONE: 无动画 // - FADE: 淡入淡出 // - SLIDE_LEFT: 左滑 // - SLIDE_RIGHT: 右滑 // - SLIDE_UP: 上滑 // - SLIDE_DOWN: 下滑 // - ZOOM: 缩放 // - CUBE: 立方体旋转 // - FLIP: 翻转 // - SLIDE_CIRCULAR: 圆形滑动 // 设置动画时长 webView.transitionManager.setAnimationDuration(300L) // 启用/禁用动画 webView.transitionManager.setEnableTransitions(true) ``` ## 错误处理 ```kotlin // 设置错误监听器 webView.errorHandler.addErrorListener(object : ErrorHandler.ErrorListener { override fun onErrorOccurred( errorType: ErrorHandler.ErrorType, errorCode: Int, description: String, url: String ) { Log.e("WebView", "Error: $description ($errorCode) at $url") } override fun onErrorHandled( errorType: ErrorHandler.ErrorType, errorCode: Int, url: String ) { Log.d("WebView", "Error handled: $url") } override fun onRetryAttempt( errorType: ErrorHandler.ErrorType, url: String, attempt: Int, maxAttempts: Int ) { Log.d("WebView", "Retry attempt $attempt/$maxAttempts for $url") } }) // 配置错误处理 webView.errorHandler.setEnableErrorPages(true) webView.errorHandler.setEnableAutoRetry(true) webView.errorHandler.setMaxRetries(3) webView.errorHandler.setRetryDelay(1000L) ``` ## 配置选项 ```kotlin // 设置最大Tab数量 webView.setMaxTabCount(10) // 设置用户代理 webView.settings.userAgent = "Custom User Agent" // 设置混合内容模式 webView.settings.mixedContentMode = WebSettings.MIXED_CONTENT_COMPATIBILITY_MODE // 启用/禁用特定功能 webView.settings.javaScriptEnabled = true webView.settings.domStorageEnabled = true webView.settings.geolocationEnabled = false ``` ## 性能优化 ### 1. 内存管理 - 及时调用 `onPause()` 和 `onResume()` - 限制最大Tab数量 - 定期清理缓存 ### 2. 缓存策略 ```kotlin // 根据网络状态选择缓存模式 val cacheMode = if (isNetworkAvailable()) { WebSettings.LOAD_DEFAULT } else { WebSettings.LOAD_CACHE_ELSE_NETWORK } webView.settings.cacheMode = cacheMode ``` ### 3. 预加载优化 ```kotlin // 预加载常用页面 val urls = listOf( "https://www.baidu.com", "https://www.google.com", "https://www.github.com" ) urls.forEach { url -> webView.createTab(url) } ``` ## 安全考虑 ### 1. 内容安全策略 ```kotlin webView.settings.javaScriptEnabled = true webView.settings.allowUniversalAccessFromFileURLs = false webView.settings.allowFileAccessFromFileURLs = false ``` ### 2. 证书验证 ```kotlin webView.settings.mixedContentMode = WebSettings.MIXED_CONTENT_NEVER_ALLOW ``` ### 3. 权限管理 ```kotlin // 在需要时请求权限 if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.ACCESS_FINE_LOCATION), REQUEST_LOCATION_PERMISSION) } ``` ## 故障排除 ### 常见问题 1. **GeckoView无法加载** - 确保添加了正确的GeckoView依赖 - 检查网络权限设置 - 确认GeckoView版本兼容性 2. **Tab切换异常** - 检查Tab索引是否有效 - 确认Tab数量未超过限制 - 查看日志输出 3. **JavaScript接口不工作** - 确保使用 `@JavascriptInterface` 注解 - 检查方法名和参数 - 确认API版本兼容性 4. **页面加载失败** - 检查网络连接 - 确认URL格式正确 - 查看错误日志 ### 调试技巧 ```kotlin // 启用调试模式 webView.settings.debugEnabled = true // 监听GeckoView事件 webView.tabManager.addTabCreatedListener { index, tab -> Log.d("TabManager", "Created tab: $index") } webView.tabManager.addTabSwitchedListener { fromIndex, toIndex -> Log.d("TabManager", "Switched from $fromIndex to $toIndex") } // 监听JavaScript调用 webView.evaluateJavascript("console.log('Test')") { result -> Log.d("JavaScript", "Result: $result") } ``` ## 版本历史 ### v1.0.0 - 初始版本发布 - 基本的WebView API支持 - Tab切换功能 - 错误处理机制 - JavaScript接口支持 ## 许可证 本项目采用 MIT 许可证。详情请参见 [LICENSE](LICENSE) 文件。 ## 贡献 欢迎提交 Pull Request 和 Issue！ ### 开发环境 - Android Studio Arctic Fox 或更高版本 - Kotlin 1.9.0+ - Android SDK 21+ - GeckoView 123.0+ ### 构建 ```bash ./gradlew assembleRelease ``` ## 联系方式 - 邮箱: developer@example.com - 项目地址: https://github.com/example/GeckoViewWebView --- **注意**: 本库仍在开发中，API可能会发生变化。请关注版本更新说明。