web-dev-qa-db-ja.com

GitHubのリリースとは何ですか？

  • 正確には何ですか？
  • それは何のために使われますか？
  • 使用量はどのくらいですか？
  • 通常はどのように使用されますか？
gitgithubreleasegithub-api
19
Ernst Ernst

公式GitHubから ：

リリースは、ソフトウェアをパッケージ化してユーザーに提供するGitHubの方法です。これは、ダウンロードを使用してソフトウェアを提供することに代わるものと考えることができます。

Releasesを使用すると、バイナリファイルへのリンクと、変更を説明するリリースノートを提供できます。

コアでは、Releasesは Gitタグ に基づいています。タグは、プロジェクトの履歴の特定のポイントをマークするため、リリースを示すのに最適な方法です。 Releasesは、次のようにタグの日付順に並べられます。

  • 注釈付きタグ の場合、タグオブジェクトの日付が使用されます。
  • 軽量タグ の場合、コミットオブジェクトの日付が使用されます。

既存のタグの表示の詳細については、「 タグの操作 」を参照してください。

17
Ernst Ernst

すでにそれを使用している人々からの公式な説明をバックアップして、どのように機能するかを確認したいと思います。

定義

「 リリースについて 」で述べたように

リリースは、ソフトウェアをパッケージ化してユーザーに提供するGitHubの方法です。これは、ダウンロードを使用してソフトウェアを提供することに代わるものと考えることができます。

リリースは、git注釈付きタグに関連付けられた1つ以上のアセットのコンテナです（ git Push --follow-tags注釈付きタグのみをプッシュ ）

2013年7月以降、古い「GitHubダウンロード」システムに置き換わる これは 悪用され始め （人々は何でもすべてを保存していた）、2012年12月に削除された。
インダイレクションを強制することで（タグ=>リリース=>アセット）、GitHubはその機能をより管理しやすくしました。

使用法

GitHubリリースが使用されます。

  • gitのようなsource制御システムにプロジェクトからビルドされた大きなgeneratedバイナリを保存しないようにします。
  • リポジトリのユーザーが「最終結果」、つまり、gitを持たない場合でもgitリポジトリコンテンツから既に構築されている「配信」をダウンロードする。

例

リリースを使用するプロジェクトの例は、 Windowsリリースのgit です。
git for Windows の場合、最初にgitをインストールしたい場合があり、コンパイルするための適切なツールセットがない可能性があることを考慮すると便利です。ソース。

APIに関する考慮事項

GitHub V3リリースAPI が示すように、リリースはnotタグです。
リリースを作成 の場合、タグの名前が必要になりますが、emptyリリース（それに関連付けられた鬼ごっこ）

リリースから、 1つ以上のアセットをアップロード できます。

資産データは、生のバイナリ形式であることが期待されています。

POST https://<upload_url>/repos/:owner/:repo/releases/:id/assets?name=foo.Zip

注：GitLabは「リリース」もサポートしています GitLab 8.2（2015年11月）以降 。

11
VonC