sdk-webview
XuqmGroup Android SDK WebView 模块。提供嵌入式 WebView 组件和独立页面，内置 JSBridge、文件选择、下载拦截。
依赖
implementation("com.xuqm:sdk-webview:VERSION")
implementation("com.xuqm:sdk-core:VERSION") // 必须
使用
嵌入式组件
import com.xuqm.sdk.webview.XWebViewView
import com.xuqm.sdk.webview.XWebViewConfig
XWebViewView(
config = XWebViewConfig(
url = "https://example.com",
title = "嵌入式网页",
),
)
独立页面
import com.xuqm.sdk.webview.openXWebView
import com.xuqm.sdk.webview.XWebViewConfig
openXWebView(XWebViewConfig(url = "https://example.com", title = "独立页面"))
// navigate("xwebview") 后使用 XWebViewScreen()
XWebViewConfig 参数
| 参数 |
类型 |
默认值 |
说明 |
url |
String |
"" |
初始加载地址 |
title |
String |
"" |
页面标题 |
hideToolbar |
Boolean |
false |
隐藏顶栏 |
hideStatusBar |
Boolean |
false |
隐藏状态栏 |
userAgent |
String? |
null |
自定义 User-Agent |
injectedJavaScript |
String? |
null |
注入的 JS |
jsBridgeName |
String |
"XWebViewBridge" |
JS 桥接对象名 |
debugEnabled |
Boolean |
false |
开启远程调试 |
downloadDestination |
FileDownloadDestination |
Sandbox |
下载存储目标 |
downloadNotificationTitle |
String? |
null |
通知栏下载进度 |
onMessage |
(String) -> Unit? |
null |
H5 消息回调 |
JSBridge 通信
// H5 → Native
window.XWebViewBridge.postMessage(JSON.stringify({ type: 'login', token: '...' }))
// 监听下载进度
window.addEventListener('__xwvDownloadProgress', (e) => { ... })
window.addEventListener('__xwvDownloadDone', (e) => { ... })
文件选择与拍照
<input type="file"> + accept="image/*" + capture → 系统相机<input type="file"> + .docx/.xlsx → 文件选择器getUserMedia() WebRTC → 自动请求 CAMERA 权限
d8ac97255d
