バージョン管理

IMPORTANT
Substance 3D Designerバージョン 14.0.0 は、Perforceサポートを Python 3 にアップグレードします。
必要に応じて、他のスクリプトやバージョンコントロール環境を調整してください。

Designerでは、Perforce (P4)のバージョンコントロールシステムをPythonで統合できます。

この統合により、エクスプローラーのパッケージのコンテキストメニューにカスタムの’バージョン管理’サブメニューが追加され、P4のパッケージの状態に一致するカスタムアイコンが追加されます。

P4を準備中

P4Vで、以下のようにワークスペース名とパスをメモします。

P4Vワークスペース情報 {modal="regular"}

任意のテキストエディターまたは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の環境設定で利用できます。

プロジェクト設定のバージョン管理タブ {modal="regular"}

  1. 編集/環境設定に移動

  2. 「プロジェクト」に移動し、ターゲットプロジェクトファイルを選択して、「バージョン管理」タブに移動します

  3. 「バージョン管理が有効になっています」を確認します。

  4. 「ワークスペース」セクションに次の情報を入力します。

    • 名前: P4Vから以前に取得した’ワークスペース名’を入力してください
    • パス: P4Vから以前に取得した’ワークスペースパス’を入力してください

Designerでの P4の設定:ワークスペース {modal="regular"}

アクションの設定

これらのアクションは、エクスプローラーのパッケージのコンテキストメニューで使用できます。 ほとんどのバージョン管理ツールの概念に一致する定義済みのアクションがあります。

  • 必要に応じて、すべてのアクションラベルを変更できます。
  • すべてのアクションを有効にするには、スクリプトが必要です。

次のものを使用できます。

  • アクションにつき​スクリプト1つ
  • すべての​アクションに対する1つのスクリプト

すべてのアクションのスタータースクリプトは、Designerのインストール’tools/version_control/perforce.py’で利用できます。

IMPORTANT
利用できるようにするには、パッケージを'ワークスペースパス'の下('f:/Dev/perforce'の下)に保存する必要があります
  1. アクショングループで、追加アクションの[…]ボタンをクリックします
  2. Designerのインストールで、次のスクリプトを選択します: ‘tools/version_control/perforce.py’
  3. スクリプトは、他のすべてのアクション用に自動的に設定されます。

Designerでの P4の設定: actions {modal="regular"}

カスタムアクションの設定

すべてのバージョン管理ツールは異なり、多くの機能が含まれているため、ユーザーはカスタムアクションを追加することができます。

  1. 「項目を追加」をクリック
  2. 新しいアクションのラベルを入力し、スクリプトパスを設定します

スクリプトインタプリタの設定

  1. 「Interpreters」セクションで、「Add item」をクリックします。
  2. スクリプトファイルの拡張子または接尾辞と、インタプリタの実行可能ファイルへのパスを設定します
  3. perforce.pyスクリプトを編集して、「p4」バイナリの場所を更新します

Designerでの P4の設定:インタープリター {modal="regular"}

バージョン管理の使用方法

  1. 新しいパッケージを作成

  2. 「ワークスペースのパス」ディレクトリにパッケージを保存します。

  3. パッケージで「RMB」をクリックします。「バージョン管理」サブメニューにアクセスできるようになりました。

  4. ワークスペースのパッケージファイルのステータスに応じて、いくつかのアクションを使用できます。

    • 追加:ファイルを’追加’としてマークします
    • 送信:選択したパッケージを送信します。 このアクションにより、変更メッセージを指定するためのダイアログが表示されます(以下を参照)
    • 元に戻す:変更を元に戻します。 このアクションにより、元に戻すファイルを選択するためのダイアログが表示されます(以下を参照)
    • チェックアウト:デポからファイルをチェックアウトします
    • 最新バージョンの取得:デポから最新バージョンを取得します
    • 状態の更新:パッケージファイルの状態を更新します
    table 0-row-2 0-border-0 1-border-0 2-border-0 html-authored no-header
    '送信'ダイアログ {modal="regular"} '元に戻す'ダイアログ {modal="regular"}
NOTE
すべてのアクションで複数選択がサポートされています
P4およびその他のバージョン管理ツールで、読み取り専用のファイル権限を使用して変更を制限する場合は、変更を行う前にパッケージをチェックアウトする必要があります。
読み取り専用のパッケージファイルはSDで変更できません。

パッケージには、ステータスに応じて次のアイコンが表示されます。

パッケージアイコン:最新

最新

パッケージアイコン:チェックアウト済み

チェックアウトしました

パッケージアイコン:追加

追加用にマーク

パッケージアイコン:デポにありません

車庫にない

最新でないパッケージには、警告記号が付いています。

アクションスクリプト

各アクションで実行されるコマンドは、以下のように構築されます。

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:成功
    • その他:エラー
recommendation-more-help
substance-3d-designer-help-guide