发布到 npm
为库设置版本并发布
发布到 npm 是 CoddyKit 上的免费 Angular Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Angular Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。
与全世界共享您的库
库构建为 Angular Package Format 后,就可以发布到注册表(通常是 npm),这样任何项目都能使用 npm install 安装它。本课程将介绍版本管理和发布流程。
发布 dist 输出,而不是源代码
您要发布的是 dist/<lib> 中构建好的包,其中包含生成的 package.json 和编译后的包,而不是原始源项目。正是构建步骤使其能够被使用。
ng build ui-kit --configuration production
cd dist/ui-kit语义化版本
npm 包使用 semver:MAJOR.MINOR.PATCH。修复问题时递增 PATCH,添加向后兼容的功能时递增 MINOR,进行破坏性变更时递增 MAJOR。使用者依靠这一规则安全升级。
0.0.1 -> 0.1.0 # new feature, no breaks (minor)
0.1.0 -> 0.1.1 # bug fix (patch)
0.1.1 -> 1.0.0 # breaking change (major)设置版本
版本来自库自己的 package.json。请在构建前更新它,或使用 npm version 一致地递增版本。
# inside projects/ui-kit (or use the field directly)
npm version minor # bumps and tags the version登录 npm
发布前请先向注册表进行身份验证。npm login 会保存令牌,使发布命令获得授权。
npm login
# enter username, password / token, email发布
在构建后的包目录中运行 npm publish。npm 会上传该包,使其可以通过名称和版本进行安装。
cd dist/ui-kit
npm publish带作用域的包
组织包使用类似 @myorg/ui-kit 的作用域。在 npm 上,带作用域的包默认是私有的;请传入 --access public 才能将其公开发布。
npm publish --access public安装已发布的库
使用者随后可以像添加任何依赖一样添加它,并从其公共 API 导入内容。Angular 会通过生成的 package.json 找到 FESM 包和类型。
npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';预发布版本和标签
请将不稳定版本发布到类似 next 的 dist-tag 下,使其不会成为默认的 latest 版本。使用者可以明确选择使用它。
npm publish --tag next
npm install ui-kit@next私有注册表
对于仅供内部使用的库,请通过配置 .npmrc 将其发布到私有注册表(npm 私有包、GitHub Packages 或 Verdaccio)。发布流程相同,只有注册表 URL 和身份验证方式不同。
在 CI 中自动化
成熟的团队会在带标签的发布版本上通过 CI 发布:该流程构建库、运行测试,并使用已保存的令牌运行 npm publish。这样可以避免手动错误,并使版本能够追溯到提交。
快速检查
您要将什么发布到 npm?
回顾
发布使用 semver 进行版本管理的构建输出 dist/<lib>。递增版本,运行 npm login,然后运行 npm publish(带作用域的包请添加 --access public,预发布版本请添加 --tag next)。使用者运行 npm install,并从公共 API 导入内容。在 CI 中自动化发布,以提高可靠性。
常见问题解答
「发布到 npm」课时是免费的吗?
是的 — 「发布到 npm」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Angular Academy 课程的其余内容,请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。
「发布到 npm」这节课中我会学到什么?
为库设置版本并发布 你通过在浏览器中直接运行的动手代码来练习 Angular Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Angular Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「发布到 npm」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Angular Academy 课中编写并运行代码吗?
能。每节 Angular Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。