mobile-web-bridge 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,14 +2,15 @@
2
2
 
3
3
  MWB 为 iOS 和 Android 的 Web 容器提供统一 JS API。原生通信由 DSBridge 3.x 完成。
4
4
 
5
- 当前源码版本为 `0.1.2`,与本轮 iOS/Android 源码配套;尚未发布 npm,下方安装命令仍指向已发布的 Beta。
5
+ 当前版本为 `0.1.4`,与同一 Git Tag 下的 iOS/Android 源码配套。下方安装命令固定为 `0.1.4`;分发状态见 [版本说明](https://github.com/gaoxiao228/MobileWebBridge/blob/main/docs/versioning.md),需要本地构建时可按 [源码构建与安装](https://github.com/gaoxiao228/MobileWebBridge#从源码构建-js-sdk) 使用。
6
6
 
7
- 已公开发布 `0.1.1-beta.1`,当前仍处于 Beta 阶段。正式仓库:[gaoxiao228/MobileWebBridge](https://github.com/gaoxiao228/MobileWebBridge)。npm 的 `latest`/`next` 目前均为 Beta,建议固定精确版本;原生接入与支持范围见 [项目 README](https://github.com/gaoxiao228/MobileWebBridge#readme)。
7
+ 正式仓库:[gaoxiao228/MobileWebBridge](https://github.com/gaoxiao228/MobileWebBridge)。建议固定精确版本;Git Tag 与 npm 分发标签独立,原生接入与支持范围见 [项目 README](https://github.com/gaoxiao228/MobileWebBridge#readme)。
8
8
 
9
9
  ## 安装和使用
10
10
 
11
11
  ```bash
12
- npm install mobile-web-bridge@0.1.1-beta.1
12
+ # 固定项目版本;原生端也使用配套版本。
13
+ npm install mobile-web-bridge@0.1.4
13
14
  ```
14
15
 
15
16
  ```ts
@@ -41,7 +42,7 @@ await mwb.setNavigationBarTheme({
41
42
 
42
43
  当前源码新增 `await mwb.basic.notifyPageReady()`(也可用根入口 `mwb.notifyPageReady()`),用于 H5 主动通知当前原生容器首屏准备完成。无需注册业务插件,重复调用幂等。成功表示原生接受通知,不代表宿主已完成展示。
43
44
 
44
- 已发布的 JS `0.1.1-beta.1` 不包含此能力,H5 须使用当前 JS 源码,并搭配 Android Maven `0.1.1` 或当前 iOS 源码;旧原生 `0.1.0` 不支持此能力。此方法走文档身份网关,等待上限 30000ms;旧原生和普通浏览器明确失败。调用时机、原生回调和重载规则见 [接入说明](https://github.com/gaoxiao228/MobileWebBridge/blob/main/docs/page-lifecycle.md)。
45
+ 此能力请配套使用 JS、iOS 和 Android `0.1.4`。此方法走文档身份网关,等待上限 30000ms;旧原生和普通浏览器明确失败。调用时机、原生回调和重载规则见 [接入说明](https://github.com/gaoxiao228/MobileWebBridge/blob/main/docs/page-lifecycle.md)。
45
46
 
46
47
  ## 同步与异步调用
47
48
 
@@ -92,7 +93,9 @@ async function copyMessage() {
92
93
  }
93
94
  ```
94
95
 
95
- Promise 完成仅表示该方法约定的操作完成:`navigateTo` 成功不等于新页面首屏完成,`toast` 成功不等于提示已消失。具体结果仍以各方法契约为准。
96
+ Promise 完成仅表示该方法约定的操作完成:`navigateTo` 默认在发起导航时成功,`toast` 成功不等于提示已消失。具体结果仍以各方法契约为准。
97
+
98
+ 当前 iOS 源码可传 `await mwb.navigateTo({ url: childURL, waitForReady: true })`,由 SDK 自动等待主文档加载及 WebKit 绘制准备后再发起原系统转场;无需 H5 报告 ready。参数默认 `false`,Android 应省略此参数。总等待 3000 ms,加载/绘制失败或超时拒绝为 `-1002`,源页离开或后台取消为 `-1005`,同源已有准备请求为 `-1004`,非布尔值为 `-1001`。源文档失效后旧回复丢弃。成功不表示动画结束或异步业务数据完成,详见 [iOS 接入说明](../MWB-iOS/README.md)。
96
99
 
97
100
  除新增 `notifyPageReady()` 外,既有 basic 异步调用没有统一超时及文档失效兜底;原生未回调时可能持续等待。业务添加等待超时只会停止自己的等待,不代表原生操作已取消;支付等操作尤其不能据超时推断业务失败或直接重试。
98
101
 
package/dist/index.js CHANGED
@@ -222,7 +222,7 @@ var require_dsbridge = __commonJS({
222
222
  var import_dsbridge = __toESM(require_dsbridge(), 1);
223
223
 
224
224
  // src/types.ts
225
- var version = "0.1.2";
225
+ var version = "0.1.4";
226
226
 
227
227
  // src/eventHub.ts
228
228
  var hubs = /* @__PURE__ */ new WeakMap();
package/dist/mwb.iife.js CHANGED
@@ -224,7 +224,7 @@ SOFTWARE.
224
224
  var import_dsbridge = __toESM(require_dsbridge(), 1);
225
225
 
226
226
  // src/types.ts
227
- var version = "0.1.2";
227
+ var version = "0.1.4";
228
228
 
229
229
  // src/eventHub.ts
230
230
  var hubs = /* @__PURE__ */ new WeakMap();
package/dist/types.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export declare const version = "0.1.2";
1
+ export declare const version = "0.1.4";
2
2
  type TYPE_VERSION = typeof version;
3
3
  export type GenericAsyncResult<T = any> = {
4
4
  errCode: number;
@@ -32,6 +32,8 @@ export type ParamStorageClear = {
32
32
  groupName?: string;
33
33
  };
34
34
  export type ParamNavigateTo = {
35
+ /** 仅 iOS:SDK 等待主文档加载与绘制准备后转场,默认 false;最长等待 3000ms,不代表业务数据就绪。 */
36
+ waitForReady?: boolean;
35
37
  /**
36
38
  * 跳转地址
37
39
  **/
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mobile-web-bridge",
3
- "version": "0.1.2",
3
+ "version": "0.1.4",
4
4
  "description": "Mobile Web Bridge JavaScript SDK",
5
5
  "author": "gaoxiao228",
6
6
  "repository": {