ファイルリリースガイド

SourceForge.JPのファイルリリース機能を利用すると、プロジェクトで作成したソフトウェアを配布できます。

ファイルリリースに関する用語

SourceForge.JPのファイルリリースシステムは以下のような階層構造で管理しています。まずはこれらの用語について説明します。

パッケージ
  |
  +-リリース
  |  :
  |  :
  +-リリース
       |
       +-ファイル
       |  :
       |  :
       +-ファイル

パッケージ

ファイルリリースの最も大きな単位で、ソフトウェアの名前などを付けます。ソフトウェア名とプロジェクト名が同一のプロジェクトが多いので、各プロジェクトにはデフォルトでプロジェクトUNIX名のパッケージを配置しています(名称はもちろん変更可能です)。

パッケージは、プロジェクトごとに複数もつことができます。例えばhelloというプロジェクトが「foo」というソフトウェアだけでなく「bar」というソフトウェアも開発している場合は「foo」と「bar」というパッケージを作成して管理するとわかりやすいでしょう。

リリース

各パッケージはリリースを複数もつことができます。

リリースは以下のものを含みます。

  • ファイル(複数可)
  • リリースノート(複数言語記述できます)
  • 更新履歴(複数言語で記述できます)

つまり、実際に配布する一連のファイルをまとめたものがリリースです。

例えば foo というプログラムの version 0.1 をリリースすることになったとします。その場合は パッケージ 「foo」 以下に リリース「0.1」を作成します。そして 実際の プログラム foo version 0.1 のファイルをそこにアップロードします。また、 そのリリースがどういうものなのか(例えば、「最初のリリースです」とか「まだアルファ版です」といったこと)を リリースノートに、前回のリリースからの変更点を変更履歴に記述します。

作成されたリリースは一覧に掲載されますので 一般のユーザはそこからダウンロード可能になります。

リリース方法

ファイルリリースができるのは、プロジェクト管理者とリリース管理者の権限を持っているユーザーです。

ファイルリリースは、次の順番で行うことになります。

  1. パッケージの作成
  2. リリースの作成(ファイルアップロード)

順番に見ていきましょう。

1 パッケージの作成

プロジェクトが登録された時点で、プロジェクトのUNIX名と同名のパッケージは自動で作成されます。この名前で問題ない場合は、パッケージを新たに作成する必要はありませんので、次に進んでください。

パッケージを作成するには、プロジェクトのリリース一覧もしくはダウンロードの管理ページから「パッケージの追加」をクリックします。パッケージ名を入力し、公開範囲を選択します通常「公開」でいいはずです(公開範囲の詳細に関しては後述します)

2 リリースの作成

パッケージを作成すると、そのパッケージに対してリリースを追加することができるようになります。同じくリリース一覧もしくは ダウンロードの管理ページ上に表示されているリリースを作成したいパッケージ上の「リリースを追加」ボタンをクリックしてください。

リリースには以下の情報が設定できます。

  • リリース名
  • 公開範囲
  • リリースノート
  • 変更履歴
  • リリースに含まれるファイル

リリースノートおよび変更履歴は複数の言語で記述しておくことができます。

リリースには複数ファイルを追加することができます。また、それぞれのファイルに対して公開範囲を設定することができます。

(複数ファイルのアップロードに対応している)ブラウザからはファイルを複数同時にアップロードすることもできます。

また、ファイルのアップロードにFTPを利用することもできます。FTPでのアップロードを利用する場合は、 リリースの編集画面にあるFTPアップロードを利用するスイッチをonにしてください。FTP でのアップロードに 関する情報が表示されます。

なお、ファイルリリースでアップロードできる1ファイルのサイズの上限は2GBまでとなっています。

公開範囲に関して

パッケージ/リリース/ファイル にはそれぞれ「公開範囲」を設定することができます。公開範囲の設定は以下のような 意味を持ちます

  • 公開: 誰でもアクセスできる状態です(通常はこれを設定します)
  • 限定公開: (プロジェクト管理者/ファイルリリース管理者以外が閲覧した場合) リストに表示されなくなります。ただし、アクセスするURLを知っている場合は誰でも直接アクセスすることが可能です。例えば、一般公開前にプロジェクトメンバーにURLを連絡してなにかミスがないか事前に確認してもらってから公開するといった用途に使うことを想定しています
  • 非公開: プロジェクト管理者/ファイルリリース管理者以外は閲覧ができない状態です(URLを知っていてもアクセスできません)

パッケージ/リリース/ファイルそれぞれに個別に公開範囲を設定できますが、それぞれの実際の公開範囲はより上位のもの (リリースであれば パッケージ、ファイルであればそのファイルを含んでいるリリースとパッケージ)の影響を受けます。

例えば、リリースを公開に設定していても そのリリースを含んでいるパッケージが限定公開だった場合 そのリリースは一覧にはリストされません。

優先ダウンロード

ファイルリリース一覧やプロジェクトトップページなどに表示される優先ダウンロードを設定することができます。 例えば、その時点での安定版のファイルを指定しておくことでそれが目立つ形で表示されるためそのファイルをユーザに 優先的にダウンロードさせることができるようになります。

優先ダウンロードはファイルの種類ごとに1つずつ指定できます。

システム要件

リリースしたプログラムなどの動作条件を記述できるシステム要件を設定できます。 システム要件はプロジェクト全体で1つ (複数の言語で)記述できます。