GitHub Packages 快速入门

简介

在本指南中，您将创建一个 GitHub Actions 工作流来测试您的代码，然后将其发布到 GitHub Packages。

发布您的软件包

在 GitHub 上创建一个新的存储库，并添加用于 Node 的 .gitignore。有关更多信息，请参阅“创建新的存储库”。

将存储库克隆到您的本地计算机。

git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git
cd YOUR-REPOSITORY

创建一个 index.js 文件，并添加一个基本的警报以显示“Hello world！”。
JavaScript
```
console.log("Hello, World!");
```
```
console.log("Hello, World!");
```
使用 npm init 初始化 npm 软件包。在软件包初始化向导中，输入您的软件包名称：@YOUR-USERNAME/YOUR-REPOSITORY，并将测试脚本设置为 exit 0。这将生成一个 package.json 文件，其中包含有关您的软件包的信息。
```
$ npm init
  ...
  package name: @YOUR-USERNAME/YOUR-REPOSITORY
  ...
  test command: exit 0
  ...
```

运行 npm install 生成 package-lock.json 文件，然后提交并将更改推送到 GitHub。

npm install
git add index.js package.json package-lock.json
git commit -m "initialize npm package"
git push

创建一个 .github/workflows 目录。在该目录中，创建一个名为 release-package.yml 的文件。

将以下 YAML 内容复制到 release-package.yml 文件中。

YAML

name: Node.js Package

on:
  release:
    types: [created]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 16
      - run: npm ci
      - run: npm test

  publish-gpr:
    needs: build
    runs-on: ubuntu-latest
    permissions:
      packages: write
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 16
          registry-url: https://npm.pkg.github.com/
      - run: npm ci
      - run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}

name: Node.js Package

on:
  release:
    types: [created]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 16
      - run: npm ci
      - run: npm test

  publish-gpr:
    needs: build
    runs-on: ubuntu-latest
    permissions:
      packages: write
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 16
          registry-url: https://npm.pkg.github.com/
      - run: npm ci
      - run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}

使用以下方法之一告诉 npm 将软件包发布到哪个作用域和注册表
- 通过在根目录中创建一个包含以下内容的 .npmrc 文件，为存储库添加一个 npm 配置文件
```
@YOUR-USERNAME:registry=https://npm.pkg.github.com
```
- 编辑 package.json 文件并指定 publishConfig 密钥
```
"publishConfig": {
  "@YOUR-USERNAME:registry": "https://npm.pkg.github.com"
}
```

提交并将更改推送到 GitHub。

$ git add .github/workflows/release-package.yml
# Also add the file you created or edited in the previous step.
$ git add .npmrc or package.json
$ git commit -m "workflow to publish package"
$ git push