@facilitronworks/react-native-windows-maps

中文文档
0.1.0-pre.0发布于 2026/08/25MITTypeScriptCommonJS零依赖近 30 天下载 4244

反应-本土-窗口地图的应用-不可知半:Web Mercator投影数学,以及一个在WebView2岛内制作的maplibre-gl页面的构建器. 零运行时间依赖关系.

中文使用文档
文档目录7 节
  1. 这不是什么
  2. 使用量
  3. 桥梁协议
  4. 标记在页面上渲染,而不是在页面上
  5. maplibre-gl 被版本和SRI所粘住
  6. 平台
  7. 许可证

@facilitronworks/ react-native-windows-maps (英语)

应用不可知半个 反应-内生-窗口 映射地平面: Web Mercator 投影数学, 以及用于映射- gl HTML 页面的构建器 在WebView2岛上.

零运行时间依赖关系. 这两个模块都是纯TypeScript,没有导入.

这不是什么

这个包是故意的 没有 船舶a <MapView> 组件或任何基图样式分辨率.

样式解析为 EXPO_PUBLIC_* 环境变量,以及 babel-preset-expo 仅内含 用于文件的文件 外部 node_modules。生活在这一包中的解决方案者将默默读取 '' 在每块建筑中: 地图会倒回原始的 OSM 瓦片, 深模切换会注入 字节相同的样式,无所事事,没有出错,也没有失败的测试. 主机应用程序拥有样式和 将解析的样式移入.

使用量

import {
  buildMapPage,
  projectToViewport,
  regionToZoom,
  viewportToRegion,
  type LatLng,
  type Region,
} from '@facilitronworks/react-native-windows-maps';

buildMapPage(options) 返回完整的 HTML 文档。 在注入的网络视频中渲染 window.ReactNativeWebView.postMessage 在此之前 内容负载.

桥梁协议

页=主机,通过 window.ReactNativeWebView.postMessage数字 :

消息含义
{type:'ready'}已构建地图, 第一个样式已装入
{type:'viewport', center, zoom, css}移动和调整大小
{type:'press', coordinate}在地图表面单击
{type:'markerPress', id}点击了页内标记元素
{type:'error', message}脚本 / 样式 / 瓦片失败

主机 – 页面,通过 injectJavaScript 反对 window.__worksMap数字 :

调用含义
setRegion({center, zoom}, durationMs)相机移动( e)0 = 跳动)
setStyle(styleJsonOrUrl)外观变化
setMarkers(list)替换页内标记层

标记在页面上渲染,而不是在页面上

上面的WebView2岛复合材料 全部 反应内含物 界限,不论兄弟间命令或 zIndex (对照三个独立层进行核查) (战略) 因此,无法看到RN重叠。 主机仍然计算集群和拥有 每个处理器; 页面只画出它通过 setMarkers 和报道 回来 每个条目都是简单的数据—— {id, latitude, longitude, kind:'cluster'|'pin', label, bg, fg, border, size} ——由主办方主讲.

maplibre-gl 被版本和SRI所粘住

页面从 unpkg 上装入 maplibre- gl 的版本 财务报告和审定财务报表 以 sha384 分资源完整性. MAPLIBRE_JS_SRI 编号 : MAPLIBRE_CSS_SRI 确切的艺术品的花序 [email protected]。 。 。 . 被篡改或被替换的文件失败检查, 脚本不执行, 页面报告 {type:'error'} 这样宿主就可以倒地了.

maplibre-gl 被宣布为 可选同伴依赖 所以一个不同版本的主机得到一个 安装时间信号。 如果碰到它,两个SRI常数必须在同一个变化中再生成,或者 地图上什么也没有.

平台

仅在 windows 平台,其中地铁重定向 react-native 改为 react-native-windows。 。 。 .

许可证

麻省理工学院

版本与发布记录

@facilitronworks/react-native-windows-maps 共发布 1 个版本,首次发布于 2026/08/25;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.1.0-pre.0latest2026/08/252 个月前

关于 @facilitronworks/react-native-windows-maps 的常见问题

@facilitronworks/react-native-windows-maps 是什么?

反应-本土-窗口地图的应用-不可知半:Web Mercator投影数学,以及一个在WebView2岛内制作的maplibre-gl页面的构建器. 零运行时间依赖关系.

如何安装 @facilitronworks/react-native-windows-maps?

在项目目录运行 npm install @facilitronworks/react-native-windows-maps,或使用 pnpm add / yarn add / bun add。

@facilitronworks/react-native-windows-maps 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@facilitronworks/react-native-windows-maps 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@facilitronworks/react-native-windows-maps 可以商用吗?

@facilitronworks/react-native-windows-maps 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@facilitronworks/react-native-windows-maps 的下载量有多少?

根据 npm 官方下载统计,@facilitronworks/react-native-windows-maps 在 2026/10/14 – 2026/11/12 这 30 天内被下载 4,244 次,日均约 141 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@facilitronworks/react-native-windows-maps 还在维护吗?

最新版本 0.1.0-pre.0 发布于 2026/08/25(2 个月前);至今共发布 1 个版本,其中过去 12 个月发布了 1 个;首次发布于 2026/08/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。