Skip to content

fix: make package WASM-compatible by implementing web connectivity via package:web #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AmisKwok merged 6 commits into from
Sep 15, 2026
Merged

fix: make package WASM-compatible by implementing web connectivity via package:web #3

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
c6e4581
fix: make package WASM-compatible by implementing web connectivity vi…
AmisKwok Sep 15, 2026
128a78e
test: 移除示例的集成测试与组件测试
AmisKwok Sep 15, 2026
ebdb512
chore(example): 更新依赖版本至 1.0.3
AmisKwok Sep 15, 2026
d3a0c78
style: auto-format with dart format
github-actions[bot] Sep 15, 2026
2ae17a0
test: 调整组件测试视口以完整渲染诊断面板
AmisKwok Sep 15, 2026
4b5c601
Merge branch 'fix/wasm-compat-connectivity' of https://github.com/zer…
AmisKwok Sep 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,20 @@
# Changelog

## 1.0.3

### Fixed / 修复

- **WASM compatibility** — the web connectivity implementation no longer imports
`connectivity_plus` (whose non-web default branch pulls in the Linux-only `nm`
package). It now talks to the browser directly through `package:web`
(`navigator.onLine` plus the `online` / `offline` events), so the package scores
full marks (20/20) on pub.dev's platform-support check and compiles with
`flutter build web --wasm`. `connectivity_plus` is still used on native platforms.
- **WASM 兼容性**——Web 端连通性实现不再导入 `connectivity_plus`（其非 Web 默认分支会引入仅限
Linux 的 `nm` 包），改为通过 `package:web`（`navigator.onLine` 与 `online` / `offline`
事件）直接与浏览器交互。包在 pub.dev 平台支持项中得满分（20/20），且可用
`flutter build web --wasm` 编译。`connectivity_plus` 在原生平台仍继续使用。

## 1.0.2

### Added / 新增
Expand Down
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ micro-benchmarks — for Android, iOS, macOS, Windows, Linux and Web (partial).
[![Dart](https://img.shields.io/badge/Dart-✓-0175C2?logo=dart)](https://dart.dev)
[![Style: effective dart](https://img.shields.io/badge/style-effective_dart-40c4ff.svg)](https://pub.dev/packages/effective_dart)

> **🔔 Upgrade recommended:** `1.0.2` adds Swift Package Manager support for iOS and macOS, so the plugin also works in projects that have migrated away from CocoaPods. Upgrade to `^1.0.2`.
> **🔔 Upgrade recommended:** `1.0.3` makes the package WASM-compatible — the web build no longer pulls in `connectivity_plus`'s Linux-only `nm` dependency, so `flutter build web --wasm` and pub.dev's platform score (20/20) both pass. Upgrade to `^1.0.3`.

🌐 **[Official Website](https://www.zerolabsco.com/)**  ·  📦 **[View on pub.dev](https://pub.dev/packages/zero_network_kit)**  ·  🔗 **[View on GitHub](https://github.com/zero-labsco/zero_network_kit)**

Expand Down Expand Up @@ -74,7 +74,7 @@ Design goals:

```yaml
dependencies:
zero_network_kit: ^1.0.2
zero_network_kit: ^1.0.3
```

### Android permissions
Expand Down
4 changes: 2 additions & 2 deletions README_zh.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
[![Dart](https://img.shields.io/badge/Dart-✓-0175C2?logo=dart)](https://dart.dev)
[![Style: effective dart](https://img.shields.io/badge/style-effective_dart-40c4ff.svg)](https://pub.dev/packages/effective_dart)

> **🔔 推荐升级：** `1.0.2` 为 iOS 与 macOS 新增 Swift Package Manager 支持，插件因此同样适用于已从 CocoaPods 迁移走的工程。建议升级到 `^1.0.2`。
> **🔔 推荐升级：** `1.0.3` 让包具备 WASM 兼容性——Web 构建不再引入 `connectivity_plus` 仅限 Linux 的 `nm` 依赖，因此 `flutter build web --wasm` 与 pub.dev 的平台评分（20/20）均可通过。建议升级到 `^1.0.3`。

🌐 **[官方网站](https://www.zerolabsco.com/)**  ·  📦 **[在 pub.dev 查看](https://pub.dev/packages/zero_network_kit)**  ·  🔗 **[查看 GitHub 仓库](https://github.com/zero-labsco/zero_network_kit)**

Expand Down Expand Up @@ -72,7 +72,7 @@

```yaml
dependencies:
zero_network_kit: ^1.0.2
zero_network_kit: ^1.0.3
```

### Android 权限
Expand Down
2 changes: 1 addition & 1 deletion docs/404.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1 +1 @@
<!DOCTYPE html><html><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width"/><title>404: This page could not be found</title><meta name="next-head-count" content="3"/><link rel="preload" href="/zero_network_kit/_next/static/css/df9fc72061aac7da.css" as="style"/><link rel="stylesheet" href="/zero_network_kit/_next/static/css/df9fc72061aac7da.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" nomodule="" src="/zero_network_kit/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/zero_network_kit/_next/static/chunks/webpack-ecae8a7b821d04b9.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/framework-64ad27b21261a9ce.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/main-f01190a0229cfea1.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/pages/_app-8d9090723aec7545.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/pages/_error-7a92967bea80186d.js" defer=""></script><script src="/zero_network_kit/_next/static/j1hO4dyly2im2OvPwfgSC/_buildManifest.js" defer=""></script><script src="/zero_network_kit/_next/static/j1hO4dyly2im2OvPwfgSC/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"j1hO4dyly2im2OvPwfgSC","assetPrefix":"/zero_network_kit","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>
<!DOCTYPE html><html><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width"/><title>404: This page could not be found</title><meta name="next-head-count" content="3"/><link rel="preload" href="/zero_network_kit/_next/static/css/df9fc72061aac7da.css" as="style"/><link rel="stylesheet" href="/zero_network_kit/_next/static/css/df9fc72061aac7da.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" nomodule="" src="/zero_network_kit/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/zero_network_kit/_next/static/chunks/webpack-ecae8a7b821d04b9.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/framework-64ad27b21261a9ce.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/main-f01190a0229cfea1.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/pages/_app-8d9090723aec7545.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/pages/_error-7a92967bea80186d.js" defer=""></script><script src="/zero_network_kit/_next/static/kJERBdhNlGdQ3aEAKNeb_/_buildManifest.js" defer=""></script><script src="/zero_network_kit/_next/static/kJERBdhNlGdQ3aEAKNeb_/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"kJERBdhNlGdQ3aEAKNeb_","assetPrefix":"/zero_network_kit","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>
2 changes: 1 addition & 1 deletion docs/404/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1 +1 @@
<!DOCTYPE html><html><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width"/><title>404: This page could not be found</title><meta name="next-head-count" content="3"/><link rel="preload" href="/zero_network_kit/_next/static/css/df9fc72061aac7da.css" as="style"/><link rel="stylesheet" href="/zero_network_kit/_next/static/css/df9fc72061aac7da.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" nomodule="" src="/zero_network_kit/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/zero_network_kit/_next/static/chunks/webpack-ecae8a7b821d04b9.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/framework-64ad27b21261a9ce.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/main-f01190a0229cfea1.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/pages/_app-8d9090723aec7545.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/pages/_error-7a92967bea80186d.js" defer=""></script><script src="/zero_network_kit/_next/static/j1hO4dyly2im2OvPwfgSC/_buildManifest.js" defer=""></script><script src="/zero_network_kit/_next/static/j1hO4dyly2im2OvPwfgSC/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"j1hO4dyly2im2OvPwfgSC","assetPrefix":"/zero_network_kit","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>
<!DOCTYPE html><html><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width"/><title>404: This page could not be found</title><meta name="next-head-count" content="3"/><link rel="preload" href="/zero_network_kit/_next/static/css/df9fc72061aac7da.css" as="style"/><link rel="stylesheet" href="/zero_network_kit/_next/static/css/df9fc72061aac7da.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" nomodule="" src="/zero_network_kit/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/zero_network_kit/_next/static/chunks/webpack-ecae8a7b821d04b9.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/framework-64ad27b21261a9ce.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/main-f01190a0229cfea1.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/pages/_app-8d9090723aec7545.js" defer=""></script><script src="/zero_network_kit/_next/static/chunks/pages/_error-7a92967bea80186d.js" defer=""></script><script src="/zero_network_kit/_next/static/kJERBdhNlGdQ3aEAKNeb_/_buildManifest.js" defer=""></script><script src="/zero_network_kit/_next/static/kJERBdhNlGdQ3aEAKNeb_/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"kJERBdhNlGdQ3aEAKNeb_","assetPrefix":"/zero_network_kit","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>
4 changes: 2 additions & 2 deletions docs/API-Reference/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Benchmark/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Connectivity/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/DNS/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/FAQ/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Full-Report/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Getting-Started/index.html
View file
Open in desktop

Large diffs are not rendered by default.

8 changes: 4 additions & 4 deletions docs/Installation/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Ping/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Platform-Support/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Ports/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Quality/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Speed-Test/index.html
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/Usage/index.html
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/_next/static/chunks/nextra-data-en-US.json
View file
Open in desktop

Large diffs are not rendered by default.

Loading
Loading