qsh-webview-sdk 2.4.6 → 2.4.8

package/README.md

@@ -47,7 +47,6 @@ import qsh from 'qsh-webview-sdk';
 
 // 等待 SDK 就绪后再调用 API（内部也有自动等待机制）
 qsh.ready().then(() => {
-  qsh.navigateTo({ url: '/pages/test/test' });
 });
 ```
 
@@ -79,7 +78,7 @@ await qsh.ready();
 
 - 浏览器环境下，SDK 会在 DOM 就绪后自动初始化，并触发 `UniAppJSBridgeReady` 事件。
 - SSR/Node 环境不会执行自动初始化；在客户端 Hydration 后会按上述规则自动初始化。
-- 所有对外 API（如 `navigateTo`、`postMessage`、`getEnv` 等）内置自动等待机制：即使在未就绪时调用，也会在就绪后自动执行，无需手动监听事件。
+- 所有对外 API（如 `postMessage`、`getEnv` 等）内置自动等待机制：即使在未就绪时调用，也会在就绪后自动执行，无需手动监听事件。
 - 仍可使用 `qsh.ready()` 等待准备完成；如需“控制初始化时机”，可手动调用 `qsh.init()`。该方法是幂等的，多次调用仅首次生效。
 
 > 注：当检测到运行于微信内且为小程序 web-view 场景时，SDK 将自动按需注入 `jweixin-1.6.2.js`（若页面已引入则不会重复注入）。若你需要自定义版本或自行控制加载时机，可在页面提前引入 jweixin，SDK 将跳过自动注入。
@@ -88,7 +87,7 @@ await qsh.ready();
 
 ```javascript
 // 直接调用，无需等待（内部会自动等待就绪）
-qsh.navigateTo({ url: '/pages/detail/detail?id=1' });
+qsh.postMessage({ data: {} });
 
 // 如需在 UI 上显示“就绪状态”，可以使用 ready()
 qsh.ready().then(() => {
@@ -96,35 +95,6 @@ qsh.ready().then(() => {
 });
 ```
 
-### 导航功能
-
-```javascript
-// 跳转到新页面
-qsh.navigateTo({
-  url: '/pages/detail/detail?id=1'
-});
-
-// 返回上一页
-qsh.navigateBack({
-  delta: 1
-});
-
-// 切换 Tab
-qsh.switchTab({
-  url: '/pages/home/home'
-});
-
-// 重启应用
-qsh.reLaunch({
-  url: '/pages/index/index'
-});
-
-// 重定向
-qsh.redirectTo({
-  url: '/pages/login/login'
-});
-```
-
 ### 消息通信
 
 ```javascript
@@ -151,25 +121,16 @@ qsh.getEnv(function(result) {
 // 获取当前环境信息
 const env = qsh.environment;
 
-console.log('环境类型:', env.type); // 'weixin' | 'webview' | 'offline'
+console.log('环境类型:', env.type); // 'weixin' | 'offline' | 'uvue' | 'webview'
 console.log('是否微信小程序:', env.isWeixinMiniProgram);
-console.log('是否在 App 基座中:', env.isUniApp);
+console.log('是否App:', env.isUniApp);
+console.log('是否鸿蒙:', env.isUvue);
 ```
 
 <!-- 加密能力（SM2/SM3/SM4）已在 v2.1.0 起移除，如需相关能力请在业务侧引入专用加密库。 -->
 
 ## API 文档
 
-### 导航 API
-
-| 方法 | 说明 | 参数 |
-|------|------|------|
-| `navigateTo` | 保留当前页面，跳转到应用内的某个页面 | `{ url: string }` |
-| `navigateBack` | 关闭当前页面，返回上一页面或多级页面 | `{ delta?: number }` |
-| `switchTab` | 跳转到 tabBar 页面 | `{ url: string }` |
-| `reLaunch` | 关闭所有页面，打开到应用内的某个页面 | `{ url: string }` |
-| `redirectTo` | 关闭当前页面，跳转到应用内的某个页面 | `{ url: string }` |
-
 ### 消息 API
 
 | 方法 | 说明 | 参数 |
@@ -349,7 +310,6 @@ src/
 │   ├── image.js            # 图片 API
 │   ├── scan.js             # 扫码 API
 │   ├── location.js         # 位置 API
-│   ├── navigation.js       # 导航 API
 │   └── message.js          # 消息 API
 ├── index.js                # 主入口
 └── index.d.ts              # 类型定义
@@ -372,30 +332,29 @@ references/                 # 开发参考（如原版 uni.webview.1.5.6.js）
 
 ### 小程序（web-view）
 
-- [x] 扫码 ✅
-- [x] 获取位置 ✅
-- [x] 查看位置 ✅
-- [x] 照片选择 ✅
-- [ ] 相机
-- [ ] 打开地图选择位置
-- [ ] 人脸核身
+- [] 扫码 ✅
+- [] 获取位置 ✅
+- [] 查看位置 ✅
+- [] 微信分享 ✅
+- [] 照片选择 ✅
+- [] 打开地图选择位置 ✅
+- [] 人脸核身 ✅
 
 ### APP（UniApp/Plus/NVUE/UVUE）
 
-- [x] 扫码 ✅
-- [x] 获取位置 ✅
-- [x] 查看位置 ✅
-- [x] 照片选择 ✅
-- [x] 持续定位 ✅
-- [ ] 相机
-- [ ] 蓝牙
-- [ ] WiFi
-- [ ] 微信分享
-- [x] 照片选择 ✅
-- [ ] 文件选择
-- [ ] 打开地图选择位置
-- [ ] 人脸核身
-- [ ] 打印服务
+- [] 扫码 ✅
+- [] 获取位置 ✅
+- [] 查看位置 ✅
+- [] 照片选择 ✅
+- [] 持续定位 ✅
+- [x] 相机
+- [x] 蓝牙
+- [] 微信分享 ✅
+- [] 照片选择 ✅
+- [x] 文件选择
+- [] 打开地图选择位置 ✅
+- [] 人脸核身 ✅
+- [] 打印服务 ✅
 
 ### 扫码功能
 
@@ -602,8 +561,9 @@ qsh.createBLEConnection({
 ```javascript
 // 打开地图选择位置（APP）
 qsh.chooseLocation({
-  latitude: 39.908823, // 初始纬度
-  longitude: 116.397470, // 初始经度
+  // 初始经纬度 不传默认取当前定位
+  latitude: 39.908823,
+  longitude: 116.397470,
   success: (res) => {
     console.log(res.location);
     console.log(res.formatted_address);
@@ -639,6 +599,7 @@ qsh.printPdf({
 ```javascript
 qsh.filePreview({
   url: 'https://example.com/files/demo.pdf', // 文件地址
+  fileType: 'pdf', // 文件类型
   showMenu: true, // 是否显示右上角菜单，默认 false
   success: (res) => console.log('文件预览请求成功', res),
   fail: (err) => console.error('文件预览失败:', err)
@@ -647,11 +608,12 @@ qsh.filePreview({
 // Promise 用法
 await qsh.filePreviewAsync({
   url: 'https://example.com/files/demo.pdf',
+  fileType: 'pdf',
   showMenu: false
 });
 ```
 
-> 仅支持以下文件格式：`doc`、`xls`、`ppt`、`pdf`、`docx`、`xlsx`、`pptx`。
+> `fileType` 仅支持以下取值：`doc`、`xls`、`ppt`、`pdf`、`docx`、`xlsx`、`pptx`。
 > 微信小程序 `web-view` 下，SDK 会通过 `wx.miniProgram.postMessage` 把预览请求投递给宿主，再调用 `wx.miniProgram.navigateBack` 返回基座；APP 端通过 `callApiInWebView` 调用基座能力。
 
 ### 跳转其他微信小程序
@@ -660,8 +622,7 @@ await qsh.filePreviewAsync({
 qsh.navigateToMiniProgram({
   appid: '',
   path: '',
-  // release/trial/develop
-  env: 'release',
+  env: 'release', // release/trial/develop
   success: (res) => console.log('跳转成功', res),
   fail: (err) => console.error('跳转失败:', err),
 });
@@ -736,8 +697,6 @@ onMounted(async () => {
   qsh.ready().catch((err) => {
     console.error('qsh ready failed', err)
   })
-
-  qsh.navigateTo({ url: '/pages/demo/index' });
 });
 </script>
 ```

package/dist/index.d.ts

@@ -54,9 +54,13 @@ declare namespace UniWebView {
     [key: string]: any;
   }
 
+  type FilePreviewType = "doc" | "xls" | "ppt" | "pdf" | "docx" | "xlsx" | "pptx";
+
   interface FilePreviewOptions {
     /** file url */
     url: string;
+    /** file type */
+    fileType: FilePreviewType;
     /** whether to show the top-right menu */
     showMenu?: boolean;
     /** success callback */