ワーキングコピーを取得するには、リポジトリからチェックアウトを実行する必要があります。
ワーキングコピーを配置したいディレクトリをWindowsエクスプローラーで選択します。右クリックしてコンテキストメニューを表示し、 → コマンドを選択すると、次のダイアログボックスが表示されます。
まだ存在しないフォルダー名を入力すると、その名前のディレクトリが作成されます。
デフォルト設定では、チェックアウトメニュー項目はTortoiseSVNサブメニュー内ではなく、エクスプローラーのトップメニューに表示されます。サブメニューにないTortoiseSVNコマンドには、SVN
が前に付いています:
プロジェクトに、同時にチェックアウトしたくない外部プロジェクトへの参照が含まれている場合は、外部参照を無視チェックボックスを使用します。
外部参照を無視がチェックされている場合、またはdepth値を大きくしたい場合は、 → を → の代わりに使用して、ワーキングコピーをアップデートする必要があります。標準のアップデートは、すべての外部参照を含み、既存のdepthを維持します。
ディレクトリツリーのtrunk
部分以下のみをチェックアウトすることをお勧めします。URLでディレクトリツリーの親パスを指定すると、プロジェクトのすべてのブランチとタグを含むリポジトリツリー全体のコピーを取得するため、ハードディスクがいっぱいになる可能性があります!
たとえば、ソースのzip圧縮tarballを作成するために、.svn
ディレクトリなしでローカルコピーを作成したい場合があります。「Subversionワーキングコピーのエクスポート」のセクションを読んで、その方法を確認してください。
チェックアウトしたいdepthを選択できます。これにより、子フォルダーへの再帰の深さを指定できます。大きなツリーのいくつかのセクションのみが必要な場合は、トップレベルフォルダーのみをチェックアウトし、選択したフォルダーを再帰的にアップデートできます。
すべての子フォルダーとサブフォルダーを含む、ツリー全体をチェックアウトします。
指定されたディレクトリを、すべてのファイルと子フォルダーを含めてチェックアウトしますが、子フォルダーの内容は展開しません。
指定されたディレクトリを、すべてのファイルを含めてチェックアウトしますが、子フォルダーはチェックアウトしません。
ディレクトリのみをチェックアウトします。ファイルや子フォルダーで展開しません。
ワーキングコピーで指定されたdepthを保持します。このオプションはチェックアウトダイアログでは使用されませんが、depth設定を持つ他のすべてのダイアログではデフォルトです。
フォルダーがすでに展開された後に、ワーキングコピーのdepthを減らすために使用されます。このオプションは、特定リビジョンへアップデートダイアログでのみ使用できます。
チェックアウトに必要な項目のみを簡単に選択し、結果として得られるワーキングコピーにそれらの項目のみを保持させるには、sparse checkout
として知られています。このようなワーキングコピーのアップデートは、不足しているファイルやフォルダーをフェッチせず、ワーキングコピーにすでに存在するものをアップデートするだけです。
sparseワーキングコピーをチェックアウトした場合(つまり、チェックアウトdepthに完全再帰
以外のものを選択した場合)、次のいずれかの方法を使用して、後でサブフォルダーを簡単に追加または削除できます。
チェックアウトしたフォルダーを右クリックし、 → を選択し、 をクリックします。これにより、最初のチェックアウトで使用可能だったのと同じダイアログが開き、チェックアウトに含める項目を選択または選択解除できます。この方法は非常に柔軟ですが、フォルダー内のすべての項目が個別にアップデートされるため、遅くなる可能性があります。
チェックアウトしたフォルダーを右クリックし、 → を使用してリポジトリブラウザを起動します。ワーキングコピーに追加したいサブフォルダーを見つけ、 → を使用します。
変更の確認ダイアログで、最初にShiftキーを押しながら ボタンをクリックします。ダイアログには、リポジトリに存在するが、リモートで追加
としてチェックアウトしていないすべてのファイルとフォルダーが表示されます。ワーキングコピーに追加したいフォルダーを右クリックし、 → を使用します。
この機能は、大きなツリーの一部のみをチェックアウトしたいが、単一のワーキングコピーをアップデートする利便性を求めている場合に非常に役立ちます。たとえば、Project01
からProject99
までのサブフォルダーを持つ大きなツリーがあり、Project03
、Project25
、およびProject76/SubProj
のみをチェックアウトしたいとします。次の手順を使用してください
depth “この項目のみ”で親フォルダーをチェックアウトします。これで、空のトップレベルフォルダーができました。
新しいフォルダーを選択し、
→ を使用してリポジトリの内容を表示します。Project03
を右クリックし、 → 。デフォルト設定を保持し、 をクリックします。これで、そのフォルダーが完全に展開されました。
Project25
についても同じプロセスを繰り返します。
Project76/SubProj
に移動して、同じ操作を行います。今回は、Project76
フォルダーにはSubProj
以外のコンテンツがなく、SubProj
自体は完全に展開されていることに注意してください。Subversionは、中間フォルダーを展開せずに作成しました。
ワーキングコピーを特定のdepthにチェックアウトした後、depthを固定チェックボックスを必ずチェックしてください。
→ を使用して、後でそのdepthを変更してコンテンツを増減できます。そのダイアログで、1.5より前のサーバーは、ワーキングコピーのdepthリクエストを理解していないため、常に効率的にリクエストを処理できるとは限りません。コマンドは引き続き機能しますが、古いサーバーはすべてのデータを送信し、クライアントは不要なものをフィルタリングする必要があるため、多くのネットワークトラフィックが発生する可能性があります。可能であれば、サーバーを少なくとも1.5にアップグレードする必要があります。
ワーキングコピーにオリジナルコピーを保存チェックボックスは、デフォルトでチェックされています。このオプションを有効にすると、Subversionは各ファイルのBASE
リビジョン(オリジナル
)をワーキングコピー内にキャッシュします。これにより、差分やリバートなどの操作がオフラインで動作し、コミットはファイル全体ではなく、ファイルの変更された部分のみをリポジトリサーバーに送信できます。この設計は、リポジトリへのネットワーク接続がボトルネックになる可能性があり、ローカルストレージが安価であるという前提で、これらの操作の速度と可用性を最適化します。バージョン1.15より前では、これがSubversionの唯一の動作方法でした。
Subversion 1.15以降では、各ファイルのコピーをワーキングコピーに保存することを避けることができます。Subversionは、必要なときだけ("オンデマンド
")オリジナルコピーをダウンロードします。これは、非常に大きなファイルを扱う場合や、めったに変更されないバイナリファイルが多数ある場合に役立ちます。
すべてのファイルのオリジナルコピーを保存しないようにするには、ワーキングコピーにオリジナルコピーを保存チェックボックスをオフにします。
ワーキングコピーにオリジナルコピーを保存がオフになっている場合、結果として得られるワーキングコピーは、1.15より前のSubversionクライアントでは使用できません。