qsh-webview-sdk 2.3.8 → 2.4.0

package/README.md

@@ -58,7 +58,7 @@ import qsh from 'qsh-webview-sdk';
 
 if(qsh.environment.isWeixinMiniProgram) {
   qsh.config({
-    clientId: 'your-client-id',
+    clientId: 'your-client-id',  // 注意区分生产和测试的clientId
     isProd: false
   })
 }
@@ -478,7 +478,7 @@ qsh.getLocation({
 // Promise 版本
 try {
   const location = await qsh.getLocationAsync({
-    type: 'gcj02',
+    type: 'wgs84',
     altitude: true
   });
   console.log('位置:', location.latitude, location.longitude);
@@ -511,7 +511,7 @@ await qsh.openLocationAsync({
 ```
 
 #### 坐标类型
-
+目前定位相关接口仅支持wgs84
 | 类型 | 说明 | 常量 |
 |------|------|------|
 | `wgs84` | GPS 坐标 | `qsh.CoordinateTypes.WGS84` |
@@ -588,37 +588,6 @@ qsh.createBLEConnection({
 });
 ```
 
-
-### 微信分享（仅 APP）
-
-```javascript
-// 分享到微信
-qsh.shareToWeixin({
-  type: 'webpage', // 分享类型：text, image, webpage, music, video
-  title: '分享标题',
-  description: '分享描述',
-  webpageUrl: 'https://example.com',
-  imageUrl: 'https://example.com/image.jpg',
-  success: () => console.log('分享成功'),
-  fail: (err) => console.error('分享失败:', err)
-});
-```
-
-### 文件选择（仅 APP）
-
-```javascript
-// 选择文件
-qsh.chooseFile({
-  type: 'all', // 文件类型：all, image, video, audio, file
-  count: 1,
-  success: (res) => {
-    console.log('文件路径:', res.tempFilePaths);
-    console.log('文件信息:', res.tempFiles);
-  },
-  fail: (err) => console.error(err)
-});
-```
-
 ### 地图选择位置（仅 APP）
 
 ```javascript
@@ -665,6 +634,40 @@ qsh.printPdf({
 - NVUE 页面
 - UVUE 页面 (UniApp X)
 
+### 跳转其他微信小程序
+
+```javascript
+qsh.navigateToMiniProgram({
+  appid: ',
+  path: ',
+  // release/trial/develop
+  env: 'release',
+  success: (res) => console.log('跳转成功', res),
+  fail: (err) => console.error('跳转失败:', err),
+});
+```
+
+> `appid` 在微信小程序环境下传目标小程序 `AppID`，在 App-plus 环境下传微信小程序原始 ID。
+> `env` 为可选参数，取值 `release` / `trial` / `develop`，不传时由基座按默认逻辑处理。
+> 微信小程序 `web-view` 下，SDK 会先通过 `wx.miniProgram.postMessage` 把跳转请求投递给宿主，再调用 `wx.miniProgram.navigateBack` 触发宿主处理，因此当前 H5 页面会退出，且只能拿到“请求已投递”的结果，不能拿到宿主侧实时回调。
+
+### 在小程序中通过弹出层分享(仅小程序)
+
+```javascript
+qsh.manualShare({
+  title: '分享标题',
+  h5Url: 'https://example.com/activity?id=123', // 要通过分享打开的h5页面地址
+  clientId: 'your-client-id', // 注意区分生产和测试的clientId
+  isPublic: false, // 默认false 分享打开的h5页面如果不需要登录权限可直接打开则传true
+  imageUrl: 'https://example.com/share.png',
+  description: '分享描述',
+  success: (res) => console.log('分享成功', res),
+  fail: (err) => console.error('分享失败:', err)
+});
+```
+对于isPublic:true时 用户点击分享的内容后会直接从基座首页跳转到h5Url, 对于isPublic:false时,基座完成登录流程后会携带参数h5Url=${encodeURIComponent(h5Url)}跳转到业务配置的h5首页, 在h5首页获取code和h5Url后根据需要自行处理登录逻辑和跳转
+此方法会销毁当前H5页面并返回小程序基座
+
 ## License
 
 MIT
@@ -695,7 +698,7 @@ onMounted(async () => {
   // 小程序环境下要先进行签名
   if (qsh.environment.isWeixinMiniProgram) {
     qsh.config({
-      clientId: '',
+      clientId: '', // 注意区分生产和测试的clientId
       isProd: import.meta.env.MODE === 'production'
     })
   }

package/dist/index.d.ts

@@ -301,6 +301,8 @@ declare namespace UniWebView {
     kind: "web" | "text" | "image";
     scene?: 0 | 1 | ShareUniversalScene;
     payload: ShareUniversalPayload;
+    /** 原样透传给宿主 message 的自定义字段，不参与 SDK 默认分享参数组装 */
+    rowCustom?: any;
     success?: (res: ShareResult) => void;
     fail?: (error: any) => void;
     complete?: () => void;
@@ -328,11 +330,29 @@ declare namespace UniWebView {
 
   interface ShareMiniProgramCardOptions {
     payload: ShareMiniProgramCardPayload;
+    /** 原样透传给宿主 message 的自定义字段，不参与 SDK 默认分享参数组装 */
+    rowCustom?: any;
     success?: (res: ShareResult) => void;
     fail?: (error: any) => void;
     complete?: () => void;
   }
 
+  interface ManualSharePayload {
+    title: string;
+    /** 分享后打开的 H5 地址，基座会自动包装为小程序 webview 页面 */
+    h5Url: string;
+    clientId: string;
+    isPublic?: boolean;
+    imageUrl?: string;
+    description?: string;
+  }
+
+  interface ManualShareOptions extends ManualSharePayload {
+    success?: (res: ShareResult) => void;
+    fail?: (error: any) => void;
+    complete?: (res?: ShareResult | any) => void;
+  }
+
   interface BluetoothOptions {
     success?: (res: any) => void;
     fail?: (error: any) => void;
@@ -498,6 +518,12 @@ declare namespace UniWebView {
       options: Omit<ShareDirectedOptions, "success" | "fail" | "complete">,
     ): Promise<ShareResult>;
 
+     /** 手动分享预览：仅微信小程序 web-view，触发宿主分享弹窗 */
+    manualShare(options: ManualShareOptions): Promise<ShareResult> | void;
+    manualShareAsync(
+      options: Omit<ManualShareOptions, "success" | "fail" | "complete">,
+    ): Promise<ShareResult>;
+
     /** 蓝牙 API */
     openBluetoothAdapter(options?: BluetoothOptions): Promise<any> | void;
     openBluetoothAdapterAsync(options?: BluetoothOptions): Promise<any>;