发表于 @carto/kepler.gl,被"云原"应用程序所使用.
发展进程
调取请求
-
每项开发均应在自己的特色部门进行
-
牵引请求应该与 main 分支
-
除了代码更改外,PR还应在"未放出"一栏中加入一个条目 CHANGELOG.md 带有链接到自身(如果部分不在场,则在文件顶端重新创建). 这有利于发布进程,使更改日志随时更新 main。 。 。 .
实例:
## Not released
- Support for count aggregation [141](https://github.com/CartoDB/carto-kepler/pull/141)
-
审查后,合并到 main 通过打压树枝 承诺,保持一个干净的历史.
与云土著一起发展
当本地开发时, 您可以使用同名链接连接本地的 CARTO Kepler :
- 在卡通-克普勒中:
yarn link
- 在云内:
yarn link @carto/kepler.gl
- 在卡通-克普勒中:
yarn build:watch
- 在云内:
yarn start
Dev 预放
要能在远程环境(如:QA专用环境)上从云端测试出一德维版本的carto-kepler,需要发布一款α版本的carto-kepler.
-
切换到您想要发布的分支 。 你可以使用任何未合并的 dev 分支, 但要确保它是基于最新的 main 以避免分支范围之外的行为变化.
-
手动更改版本 package.json。使用此模式: <next-version>-alpha.<feature>。 。 。 .
实例: 0.0.47-alpha.custom-markers
-
以 yarn build,并确保没有出错.
-
将软件包作为α发布给国家预防机制。 你需要在国家预防机制组织中拥有适当的权利.
npm publish --tag alpha
-
如果软件包已经正确发布, 那么在 cloud-native 将新版本安装为 yarn add @carto/kepler.gl@<alpha-version-number>打开公关.
如果你需要修改一些 稍后代码,你需要重写。 通过简单地在版本编号中添加后缀来重复这一过程.
实例: 0.0.47-alpha.custom-markers.2
稳定释放进程
-
创建分支 release-<next-version> 从最新变化起 main。 。 。 .
-
修改 CHANGELOG.md 文件,通过创建新区域 <next-version> 并将内容从"未放出"移动到它。 将空出"不放出"部分保留在文件上方.
-
增加版本在 package.json 改为 <next-version>
-
以 yarn build,并确保没有出错.
-
提交更改( N)git commit -am "release <next-version>"),推出,打开公关,要求复核并合并.
-
最后改为: main 向国家预防机制公布
npm publish --access public
关于 @carto/kepler.gl 的常见问题
@carto/kepler.gl 是什么？
kepler.gl是一个基于webgl的应用程序,用于可视化浏览器中的大尺度位置数据
如何安装 @carto/kepler.gl？
在项目目录运行 npm install @carto/kepler.gl，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（>=16.3）、react-dom（>=16.3）、@deck.gl/core（^9.1.2）、@luma.gl/core（^9.1.2）、@deck.gl/carto（^9.1.2）、@deck.gl/react（^9.1.2）、@luma.gl/webgl（^9.1.2）、@deck.gl/layers（^9.1.2）、@loaders.gl/csv（^4.2.5）、@loaders.gl/core（^4.2.5）、@loaders.gl/gltf（^4.2.5）、@loaders.gl/json（^4.2.5）、styled-components（^4.x || ^5.x）、@luma.gl/constants（^9.1.2）、@deck.gl/extensions（^9.1.2）、@deck.gl/geo-layers（^9.1.2）、@deck.gl/mesh-layers（^9.1.2）、@loaders.gl/loader-utils（^4.2.5）、@deck.gl/aggregation-layers（^9.1.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@carto/kepler.gl 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@carto/kepler.gl 支持 ESM 还是 CommonJS？
以 CommonJS 形式发布，可以直接 require()；在 ES Module 项目中也可以用 import 引入（Node.js 会把 module.exports 作为默认导出）。
@carto/kepler.gl 可以商用吗？
@carto/kepler.gl 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@carto/kepler.gl 的下载量有多少？
根据 npm 官方下载统计，@carto/kepler.gl 在 2026/10/09 – 2026/11/07 这 30 天内被下载 7,877 次，日均约 263 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@carto/kepler.gl 还在维护吗？
最新版本 0.0.89 发布于 2026/10/27（12 天前）；至今共发布 233 个版本，其中过去 12 个月发布了 2 个；首次发布于 2021/09/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。