DocumentaçãoSubstance 3DSubstance 3D Designer

Controle de versão

Última atualização: 11 de setembro de 2026
IMPORTANT
A versão 14.0.0 do Substance 3D Designer atualiza o suporte a Perforce para Python 3.
Verifique se os outros scripts e o ambiente de controle de versão estão ajustados de acordo.

O Designer oferece uma integração Python para o sistema de controle de versão Perforce (P4).

A integração adiciona um submenu personalizado ‘Controle de Versão’ ao menu contextual de pacotes no Explorer, bem como ícones personalizados para corresponder ao status de um pacote no P4.

Preparando P4

No P4V, anote o nome e o caminho do espaço de trabalho, conforme mostrado abaixo:

Informações do espaço de trabalho P4V {modal="regular"}

Em qualquer editor de texto ou IDE, abra este script localizado na instalação do Designer: ‘tools/version_control/perforce.py’.

Na linha 19, edite o caminho para o local do executável ‘p4’ em seu sistema.
No exemplo abaixo, esse caminho é ‘c:/Program Files/Perforce/p4.exe’.

## Editable variables

cPerforceP4AbsPath = os.path.abspath("c:/Program Files/Perforce/p4.exe")

cVerbose = False

Configuração no Designer

O controle de versão está configurado nas Configurações do projeto, disponíveis nas Preferências do Designer.

Guia 'Controle de versão' nas configurações do projeto {modal="regular"}

  1. Acesse “Editar > Preferências”

  2. Vá para ‘Projetos’, selecione o arquivo de projeto de destino e vá para a guia ‘Controle de Versão’

  3. Verificar ‘Controle de Versão Habilitado’

  4. Preencha estas informações na seção ‘Espaço de trabalho’:

    • Nome: insira o ‘Nome do Espaço de Trabalho’ recuperado anteriormente do P4V
    • Caminho: insira o ‘Caminho de Espaço de Trabalho’ recuperado anteriormente do P4V

Configuração P4 no Designer: espaço de trabalho {modal="regular"}

Configurar ações

As ações estarão disponíveis no menu contextual de um pacote no Explorer. Existem ações predefinidas que correspondem à maioria dos conceitos de ferramentas do Controle de versão:

  • Todos os rótulos de ação podem ser alterados conforme necessário.
  • Todas as ações precisam de um script para serem válidas.

Você pode usar:

  • um script por ação
  • um script para todas ações

Um script inicial para todas as ações está disponível na instalação do Designer: ‘tools/version_control/perforce.py’.

IMPORTANT
Para estar disponível, o pacote precisa ser salvo no 'Caminho do espaço de trabalho' (por exemplo, em 'f:/Dev/perforce')
  1. No grupo Ações, clique no botão ‘…’ da ação Adicionar
  2. Selecione o seguinte script na instalação do Designer: ‘tools/version_control/perforce.py’
  3. O script deve ser configurado automaticamente para todas as outras ações.

Configuração P4 no Designer: ações {modal="regular"}

Configurar ações personalizadas

Como todas as ferramentas de controle de versão são diferentes e incluem muitos recursos, permitimos que o usuário adicione ações personalizadas.

  1. Clique em ‘Adicionar item’
  2. Preencha o rótulo da nova ação e defina o caminho do script

Configurar o interpretador de scripts

  1. Na seção “Intérpretes”, clique em “Adicionar item”
  2. Definir uma extensão ou sufixo de arquivo de script e o caminho para o executável do intérprete
  3. Edite o script perforce.py para atualizar o local do binário ‘p4’

Configuração P4 no Designer: intérprete {modal="regular"}

Como usar o controle de versão

  1. Criar um novo pacote

  2. Salve o pacote no diretório “Caminho do espaço de trabalho”

  3. Clique no RMB no pacote: agora você tem acesso ao submenu “Controle de versão”

  4. Várias ações estão disponíveis, dependendo do status do arquivo de pacote no espaço de trabalho:

    • Adicionar: Marque os arquivos como ‘ToAdd’
    • Enviar: envie os pacotes selecionados. Esta ação exibe uma caixa de diálogo para especificar uma mensagem de alteração (veja abaixo)
    • Reverter: reverta as modificações. Esta ação exibe uma caixa de diálogo para selecionar os arquivos a serem revertidos (veja abaixo)
    • Check-out: faça o check-out do arquivo do depósito
    • Obter última versão: recupere a versão mais recente do depósito
    • Status da atualização: Atualize o status do arquivo do pacote
    table 0-row-2 0-border-0 1-border-0 2-border-0 html-authored no-header
    Caixa de diálogo 'Enviar' {modal="regular"} 'Reverter' caixa de diálogo {modal="regular"}
NOTE
Todas as ações são compatíveis com várias seleções
Para o P4 e outras ferramentas de controle de versão que usam a permissão de arquivo somente leitura para restringir modificações, o usuário precisará primeiro fazer check-out do pacote antes de modificá-lo.
Arquivos de pacote somente leitura não podem ser modificados no SD.

Dependendo do status do pacote, ele terá os seguintes ícones:

Ícone de pacote: atualizado

Atualizado

Ícone de pacote: Check-out

Check-out feito

Ícone de pacote: adicionado

Marcado para adição

Ícone de pacote: não está no depósito

Fora do depósito

Observe que um pacote que não está atualizado é marcado com um sinal de aviso.

Scripts de ação

O comando executado por cada ação é compilado desta forma:

meu_script NomeEspaçoTrabalhoCaminhoEspaçoTrabalhoNomeAção[ArgosdeAção]

WorkspaceName: o nome do espaço de trabalho

WorkspacePath: o caminho do diretório raiz do espaço de trabalho

ActionName: o nome da ação:

  • adicionar: para a ação “Adicionar”
  • check-out: para a ação “Check-out”
  • enviar: para a ação “Enviar”
  • reverter: para a ação “Reverter”
  • get_last_version: para a ação “Obter Última Versão”
  • get_status: para a ação “Obter Status”

O rótulo é configurado nas configurações do projeto, com o caractere ’ ’ substituído por ‘_’. Por exemplo: “Minha ação” => “Minha ação_ação”.

ActionArgs: argumentos da ação:

  • -desc: uma cadeia de caracteres de descrição usada pela ação ‘Enviar’
  • -arquivos: Uma lista de arquivos
  • -files_list: Um arquivo de texto que contém uma lista de arquivos por linha

get_status: retorna um valor que depende do status do arquivo especificado:

  • 0: status indefinido

  • 1: não está no depósito

  • 2: versão anterior (não atualizada)

  • 3: versão mais recente (atualizada)

  • 4: retirada

  • 5: marcado para adição

  • outras ações:

    • 0: sucesso
    • outro: erro
recommendation-more-help
substance-3d-designer-help-guide