70 行
2.0 KiB
Markdown
70 行
2.0 KiB
Markdown
|
# sdk-webview
|
||
|
|
|
||
|
|
XuqmGroup Android SDK WebView 模块。提供嵌入式 WebView 组件和独立页面，内置 JSBridge、文件选择、下载拦截。
|
||
|
|
|
||
|
|
## 依赖
|
||
|
|
|
||
|
|
```kotlin
|
||
|
|
implementation("com.xuqm:sdk-webview:VERSION")
|
||
|
|
implementation("com.xuqm:sdk-core:VERSION") // 必须
|
||
|
|
```
|
||
|
|
|
||
|
|
## 使用
|
||
|
|
|
||
|
|
### 嵌入式组件
|
||
|
|
|
||
|
|
```kotlin
|
||
|
|
import com.xuqm.sdk.webview.XWebViewView
|
||
|
|
import com.xuqm.sdk.webview.XWebViewConfig
|
||
|
|
|
||
|
|
XWebViewView(
|
||
|
|
config = XWebViewConfig(
|
||
|
|
url = "https://example.com",
|
||
|
|
title = "嵌入式网页",
|
||
|
|
),
|
||
|
|
)
|
||
|
|
```
|
||
|
|
|
||
|
|
### 独立页面
|
||
|
|
|
||
|
|
```kotlin
|
||
|
|
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 通信
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
// 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 权限
|
