@coast/qrcode-svg

中文文档
1.0.9发布于 2026/07/29ISCTypeScriptCommonJS近 30 天下载 8653

在 SVG 中生成一个 QRCode,底部有一个集成的海岸标志.

中文使用文档
文档目录15 节
  1. 生成查询 PDF
  2. 预期 CSV 格式
  3. 生成命令
  4. 解决问题
  5. 使用量
  6. 道具 :
  7. 出版
  8. 发展
  9. 测试
  10. 赫鲁库
  11. Dyno 大小
  12. 应用程序配置
  13. 监视应用程序日志
  14. 清除应用程序缓存
  15. 重新启动应用程序

创建 QRCde

在 SVG 中生成一个 QRCode,底部有一个集成的海岸标志.

生成查询 PDF

附录 /upload 用于上传 CSV 文件.

由于上传限制(bandwidth和30个第二次请求超时),该app只一次处理350行.

预期 CSV 格式

CSV MUST包括以下一栏:

  • 资产细节 URL
  • 服务请求 URL

CSV可选择包括以下一栏:

  • 制造商
  • 型号
  • 序列号
  • 海岸身份证
  • 获得年份

所有其他列将被忽略 .

生成命令

运行 yarn generate:pdfs path/to/data.csv。 。 。 .

PDF 将在顶层输出 pdfs 文件夹,作为编号文件。 说明: 当脚本运行时,此文件夹中的任何已存文件都将被删除.

解决问题

如果CSV格式不正确,应用程序会说它处理了文件,但不会显示出错,也不会生成/播放包含PDF的zip文件的链接. 您需要遵循区域中的指令, 进一步跟踪 Heroku 日志, 查看任何错误消息 .

使用量

import { createQRCode } from '@coast/qrcode-svg';

const url = 'https://shared.coastapp.com/r/d634c3d2-4708-42f3-8dbe-a987696a8bb3';
const width = 400;
const showBorder = true;
const svg = createQRCode({ url, width, showBorder });

道具 :

  • url: 字符串
  • 宽度 ? : 数字 - 如果省略, SVG 将是大小不可知/ 响应
  • 显示边界 ?: 布尔 - 默认为虚假
  • 显示Logo? : 布尔 - 默认为真

出版

  • 运行 yarn build && git add dist && git commit -m "Update distribution"
  • 弹出版本通过 npm version (这将创建一个 vXXX 标签)
  • 将您的更改合并到 main 分支
  • 通过推高新版本标签 git push --tags
  • 更新软件包中使用此库指向新版本标签的引用

发展

该项目包括用于修改创建的QRCode SVG生成器输出的dev环境. 用一个 斯维尔特基特 在浏览器中显示已渲染的 SVG 的服务器.

运行应用程序

yarn
yarn dev

然后打开http://localhost:5173

测试

测试 测试。 。 。 .

yarn test

注意: SVG 固定装置在测试运行开始时作为文件被读取,所以任何对固定装置的修改都需要重新开始测试. (在监视模式下按下R键)

赫鲁库

访问时间 https://dashboard.heroku.com/apps/qrcode-svg 页面存档备份,存于互联网档案馆

安装 赫罗库CLI 通过运行签名 heroku login

Dyno 大小

目前主要应用制约是记忆. 目前我们仅限于使用带有1GB内存的2x干道大小. 月票至少30元后,可以使用较大的有较多内存的堤坝尺寸.

https://dashboard.heroku.com/apps/qrcode-svg/resources 页面存档备份,存于互联网档案馆

应用程序配置

曲线

PUPPETEER_EXECUTABLE_PATH: /app/.chrome-for-testing/chrome-linux64/chrome
NODE_ENV: production

构建软件包

添加 heroku-community/色素测试

监视应用程序日志

heroku logs -a qrcode-svg --tail

清除应用程序缓存

heroku builds:cache:purge -a qrcode-svg

重新启动应用程序

heroku ps:restart -a qrcode-svg

版本与发布记录

@coast/qrcode-svg 共发布 3 个版本,首次发布于 2024/12/13;过去 12 个月发布了 2 个版本。

版本发布日期距今
1.0.9latest2026/07/293 个月前
1.0.82026/07/293 个月前
1.0.72024/12/131.9 年前

关于 @coast/qrcode-svg 的常见问题

@coast/qrcode-svg 是什么?

在 SVG 中生成一个 QRCode,底部有一个集成的海岸标志.

如何安装 @coast/qrcode-svg?

在项目目录运行 npm install @coast/qrcode-svg,或使用 pnpm add / yarn add / bun add。

@coast/qrcode-svg 支持 TypeScript 吗?

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

@coast/qrcode-svg 支持 ESM 还是 CommonJS?

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

@coast/qrcode-svg 可以商用吗?

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

@coast/qrcode-svg 的下载量有多少?

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

@coast/qrcode-svg 还在维护吗?

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