qsh-webview-sdk 2.4.2 → 2.4.4

package/README.md

@@ -56,14 +56,20 @@ qsh.ready().then(() => {
 ```javascript
 import qsh from 'qsh-webview-sdk';
 
+// 如果路由使用了hash模式,则只需在App.vue中config一次,url可以不传
+// 如果是非hash模式, 则需要在每次路由变化时重新config, 且要传入完整的url
 if(qsh.environment.isWeixinMiniProgram) {
   qsh.config({
     clientId: 'your-client-id',  // 注意区分生产和测试的clientId
-    isProd: false
+    isProd: false,
+    debug: false, // isProd 为 true 时会强制关闭
+    url: '' // 可选：传入后用于微信签名，默认使用当前页面 URL
   })
 }
 
 // isProd 默认为 false: 根据环境传入
+// debug 默认为 false: 仅在 isProd 为 false 时可开启
+// url 默认为空: 有值时会替代当前页面 URL 参与微信签名
 // 依赖微信 JS-SDK 的能力前，建议先注入 clientId
 // 已调用 qsh.config() 时，qsh.ready() 会在微信小程序 web-view 中额外等待 wx.config 完成
 await qsh.ready();
@@ -492,8 +498,8 @@ try {
 ```javascript
 // 打开地图查看指定位置
 qsh.openLocation({
-  latitude: 39.908823,
-  longitude: 116.397470,
+  latitude: 39.908823, // 需传入wgs84坐标
+  longitude: 116.397470, // 需传入wgs84坐标
   name: '天安门',
   address: '北京市东城区东长安街',
   scale: 15,  // 缩放级别 1-28
@@ -504,8 +510,8 @@ qsh.openLocation({
 
 // Promise 版本
 await qsh.openLocationAsync({
-  latitude: 39.908823,
-  longitude: 116.397470,
+  latitude: 39.908823, // 需传入wgs84坐标
+  longitude: 116.397470, // 需传入wgs84坐标
   name: '天安门'
 });
 ```
@@ -596,10 +602,9 @@ qsh.chooseLocation({
   latitude: 39.908823, // 初始纬度
   longitude: 116.397470, // 初始经度
   success: (res) => {
-    console.log('选择位置:', res.name);
-    console.log('地址:', res.address);
-    console.log('纬度:', res.latitude);
-    console.log('经度:', res.longitude);
+    console.log(res.location);
+    console.log(res.formatted_address);
+    console.log(res.addressComponent);
   },
   fail: (err) => console.error(err)
 });
@@ -626,20 +631,12 @@ qsh.printPdf({
 });
 ```
 
-## 兼容性
-
-- 微信小程序 WebView
-- UniApp APP 端 (Android/iOS)
-- H5+ 环境
-- NVUE 页面
-- UVUE 页面 (UniApp X)
-
 ### 跳转其他微信小程序
 
 ```javascript
 qsh.navigateToMiniProgram({
-  appid: ',
-  path: ',
+  appid: '',
+  path: '',
   // release/trial/develop
   env: 'release',
   success: (res) => console.log('跳转成功', res),
@@ -668,6 +665,14 @@ qsh.manualShare({
 对于isPublic:true时 用户点击分享的内容后会直接从基座首页跳转到h5Url, 对于isPublic:false时,基座完成登录流程后会携带参数h5Url=${encodeURIComponent(h5Url)}跳转到业务配置的h5首页, 在h5首页获取code和h5Url后根据需要自行处理登录逻辑和跳转
 此方法会销毁当前H5页面并返回小程序基座
 
+## 兼容性
+
+- 微信小程序 WebView
+- UniApp APP 端 (Android/iOS)
+- H5+ 环境
+- NVUE 页面
+- UVUE 页面 (UniApp X)
+
 ## License
 
 MIT
@@ -699,7 +704,9 @@ onMounted(async () => {
   if (qsh.environment.isWeixinMiniProgram) {
     qsh.config({
       clientId: '', // 注意区分生产和测试的clientId
-      isProd: import.meta.env.MODE === 'production'
+      isProd: import.meta.env.MODE === 'production',
+      debug: false,
+      url: ''
     })
   }