バージョン管理
Designerでは、Perforce (P4)のバージョンコントロールシステムをPythonで統合できます。
この統合により、エクスプローラーのパッケージのコンテキストメニューにカスタムの’バージョン管理’サブメニューが追加され、P4のパッケージの状態に一致するカスタムアイコンが追加されます。
P4を準備中
P4Vで、以下のようにワークスペース名とパスをメモします。
任意のテキストエディターまたはIDEで、Designerのインストールにある次のスクリプトを開きます: ‘tools/version_control/perforce.py’。
19行目で、システム上の 'p4’実行可能ファイル の場所へのパスを編集します。
次の例では、このパスは’c:/Program Files/Perforce/p4.exe’です。
## Editable variables
cPerforceP4AbsPath = os.path.abspath("c:/Program Files/Perforce/p4.exe")
cVerbose = False
Designerでの設定
バージョン管理がプロジェクト設定で構成されており、Designerの環境設定で利用できます。
-
編集/環境設定に移動
-
「プロジェクト」に移動し、ターゲットプロジェクトファイルを選択して、「バージョン管理」タブに移動します
-
「バージョン管理が有効になっています」を確認します。
-
「ワークスペース」セクションに次の情報を入力します。
- 名前: P4Vから以前に取得した’ワークスペース名’を入力してください
- パス: P4Vから以前に取得した’ワークスペースパス’を入力してください
Designerでの
アクションの設定
これらのアクションは、エクスプローラーのパッケージのコンテキストメニューで使用できます。 ほとんどのバージョン管理ツールの概念に一致する定義済みのアクションがあります。
- 必要に応じて、すべてのアクションラベルを変更できます。
- すべてのアクションを有効にするには、スクリプトが必要です。
次のものを使用できます。
- アクションにつきスクリプト1つ
- すべてのアクションに対する1つのスクリプト
すべてのアクションのスタータースクリプトは、Designerのインストール’tools/version_control/perforce.py’で利用できます。
- アクショングループで、追加アクションの[…]ボタンをクリックします
- Designerのインストールで、次のスクリプトを選択します: ‘tools/version_control/perforce.py’
- スクリプトは、他のすべてのアクション用に自動的に設定されます。
Designerでの
カスタムアクションの設定
すべてのバージョン管理ツールは異なり、多くの機能が含まれているため、ユーザーはカスタムアクションを追加することができます。
- 「項目を追加」をクリック
- 新しいアクションのラベルを入力し、スクリプトパスを設定します
スクリプトインタプリタの設定
- 「Interpreters」セクションで、「Add item」をクリックします。
- スクリプトファイルの拡張子または接尾辞と、インタプリタの実行可能ファイルへのパスを設定します
- perforce.pyスクリプトを編集して、「p4」バイナリの場所を更新します
Designerでの
バージョン管理の使用方法
-
新しいパッケージを作成
-
「ワークスペースのパス」ディレクトリにパッケージを保存します。
-
パッケージで「RMB」をクリックします。「バージョン管理」サブメニューにアクセスできるようになりました。
-
ワークスペースのパッケージファイルのステータスに応じて、いくつかのアクションを使用できます。
- 追加:ファイルを’追加’としてマークします
- 送信:選択したパッケージを送信します。 このアクションにより、変更メッセージを指定するためのダイアログが表示されます(以下を参照)
- 元に戻す:変更を元に戻します。 このアクションにより、元に戻すファイルを選択するためのダイアログが表示されます(以下を参照)
- チェックアウト:デポからファイルをチェックアウトします
- 最新バージョンの取得:デポから最新バージョンを取得します
- 状態の更新:パッケージファイルの状態を更新します
table 0-row-2 0-border-0 1-border-0 2-border-0 html-authored no-header {modal="regular"}
{modal="regular"}
パッケージには、ステータスに応じて次のアイコンが表示されます。
最新でないパッケージには、警告記号が付いています。
アクションスクリプト
各アクションで実行されるコマンドは、以下のように構築されます。
my_script ワークスペース名WorkspacePath ActionName[アクション引数]
ワークスペース名:ワークスペースの名前
WorkspacePath:ワークスペースのルートディレクトリのパス
アクション名:アクションの名前:
- 「追加」アクションの追加:
- 「チェックアウト」アクションのチェックアウト:
- 「送信」アクションの送信:
- 「元に戻す」操作の復帰:
- [最新バージョンの取得]アクションのget_last_version:
- 「ステータスを取得」アクションのget_status:
ラベルは、プロジェクト設定で「 」文字を「_」に置き換えて設定します – 例: “My Action” => “My_Action”
アクションの ActionArgs: 引数:
- -desc: '送信’操作で使用される説明文字列
- -files:ファイルの一覧
- -files_list:行ごとのファイルのリストを含むテキストファイル
get_status:指定したファイルの状態に応じて値を返します:
-
0:未定義のステータス
-
1:保管庫に保管されていません
-
2:以前のバージョン(最新ではありません)
-
3:最新バージョン(最新)
-
4:チェックアウト済み
-
5:追加用にマーク済み
-
その他のアクション:
- 0:成功
- その他:エラー