0Pricing
Angular Academy · 课时

发布到 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 反馈 — 无需本地设置。

此课程中的所有课时

  1. 使用 ng generate 创建库
  2. 公共 API 与入口点
  3. 使用 ng-packagr 构建
  4. 发布到 npm
← 返回 Angular Academy