ソースコントロール

Locus はソースコントロールなしでも動作します。Unreal にアクティブなプロバイダーがある場合、Locus はコンテンツ種別ごとの所有権に応じてプロバイダーを考慮したルールを適用します。

所有権がプロバイダーの動作を決める

コンテンツ	プロバイダーの動作
共有ノート	新規作成時に追加用にマーク。管理対象になった後は明示的なチェックアウト、状態確認、安全な削除
プライベートノート	プロバイダーへの照会や操作なし
共有ピン	新規作成時に追加用にマーク。管理対象になった後は明示的なチェックアウト、状態確認、安全な削除
プライベートピン	プロバイダーへの照会や操作なし
ドキュメント	プロジェクト所有。未追跡で作成し、その後に明示的に追加用にマーク。管理対象になった後はチェックアウト、状態確認、安全な削除

プライベートとは、コンテンツがプロジェクトの Saved 領域にローカル保存されることを意味します。Locus はプライベートなノートとピンについて、プロバイダーを照会したり変更したりすることはありません。

ローカルモード

プロバイダーが構成されていない場合、Locus はローカルモードに入ります。ローカルファイルと追跡されていないファイルは、プロバイダーの警告やバックグラウンド呼び出しなしで編集可能なままです。ノート、ピン、およびドキュメントには、プロバイダーのステータス、インジケーター、ツールヒント、ガイダンス、追加用にマーク、または チェックアウト アフォーダンスが表示されません。共有コンテンツはプロジェクト所有のルートに残ります。

設定されているが利用できないプロバイダーは明確であり、既知の制御されたコンテンツを保護したままにします。利用可能な場合、ステータスバーは Unreal の標準のリビジョン管理アイコンを使用します。 ソースコントロールのステータスを表示 はコンパクト行インジケーターのみを制御します。文書化されている場合、クリーンに追跡された行は静かなままです。

チェックアウトと読み取り専用の状態

クリーンな管理されたコンテンツを選択したり、開いたり、読んだりしても、そのコンテンツはチェックアウトされません。共有ノートには明示的な チェックアウト が必要です。制御された共有ピンのサポートされている変更は、チェックアウトを自動的に要求し、許可された場合にのみ続行します。失敗すると保護されたままになります。

管理対象ドキュメントは読み取り可能ですが、権威のある Markdown の編集と保存はチェックアウトに成功するまで利用できません。別のユーザーまたはクライアントがチェックアウトしている、古い、必要なプロバイダーから切断されている、または Locus が確認できない状態の場合も同じ保護が適用されます。該当するドキュメントでは コピーをエクスポートを利用できます。

プロバイダーに再接続した後、必要に応じてソースコントロールまたは Locus を更新します。管理対象の状態は戻りますが、クリーンなファイルは明示的にチェックアウトするまで読み取り専用のままです。

Locus は読み取り専用の管理対象ファイルに対する 書き込み可能にする回避策を提供しません。

新しいファイルと追加用にマーク

新しい共有ノートは、作成後の 追加用にマーク リクエストを保持します。失敗すると、再試行できる有効なファイルが残ります。新しい共有ピンは、適格な複数選択を含め、明示的に追加されるまで Untracked のままです。共有ピンスナップショットは、独自の追加またはチェックアウト状態を持つ個別のイメージです。

新しいドキュメントは意図的に 未追跡のままです。まずドキュメントを作成、整理、名前変更、移動、編集し、最終パスが安定したら 追加用にマークを使います。未追跡のドキュメントは、安全であれば名前変更または移動できます。追加用にマーク済み、またはすでに管理対象のドキュメントは、プロバイダーに依存しないトランザクション形式の移動を保証できないため、Locus から名前変更や移動を行えません。この境界を回避するために、書き込み可能にする回避策を使ったり、ソースコントロールを無効にしたりすることもありません。

ローカルファイルは、プロジェクトの通常のワークフローで追加して送信するまでチームメイトと共有されません。送信後、ファイルは管理対象となり、以後の編集には チェックアウトを使います。再び追加用にマークすることはありません。

削除

削除には確認が必要です。管理対象ファイルの場合、Locus は報告された状態を確認し、ローカルのクリーンアップ前にプロバイダーを通じて削除します。別のユーザーがチェックアウトを所有している、ファイルが古い、安全性を確立できない場合は削除をブロックします。

Perforce のガイダンス

Perforce は、現在プロジェクトで検証された根拠があるプロバイダーです。共同で使うノートとピンの一般的なプロジェクト typemap の選択肢は次のとおりです。

text+l //....uenote
text+l //....locuspin

これは JSON ベースのファイルを排他的ロック付きのテキストとして扱います。Markdown ドキュメントは通常のテキストファイルです。リポジトリに適した .md ポリシーを選んでください。Locus が Perforce typemap を編集することはありません。

その他の Unreal Source Control プロバイダーは 1.0 では保証なしの対応であり、検証されていません。利用する前に、データを失っても問題のないテストプロジェクトでプロバイダーの動作を検証してください。

Perforce は、1.1 のライブ認定プロバイダーです。他の Unreal ソース管理プロバイダーはベストエフォートであり、検証されていません。使い捨てプロジェクトでテストしてください。

復旧と外部競合

復旧スナップショットは保存されていないローカル作業を保護するもので、ソースコントロールに置き換わるものではありません。外部競合は、ローカルエディタに保留中の変更がある間にディスクの内容が変更されると発生します。Locus は無言の上書きを防ぎ、安全な解決アクションを提示します。ソースコントロールの古い状態とエディタの競合は関連しますが、別の条件です。

ノート、ピン、ドキュメントの復旧セクション、またはトラブルシューティングを参照してください。