Controle de Código-Fonte

O Locus funciona sem controle de código-fonte. Quando o Unreal tem um provedor ativo, o Locus aplica regras conscientes do provedor de acordo com a propriedade de cada tipo de conteúdo.

A propriedade determina o comportamento do provedor

Conteúdo	Comportamento do provedor
Notas Compartilhadas	Marcar para Adição quando novas; checkout explícito, status e exclusão segura quando controladas
Notas Privadas	Nenhuma consulta ou operação do provedor
Pins Compartilhados	Marcar para Adição quando novos; checkout explícito, status e exclusão segura quando controlados
Pins Privados	Nenhuma consulta ou operação do provedor
Documentos	Pertencentes ao projeto; criados Não rastreados, depois explicitamente Marcados para Adição; checkout, status e exclusão segura quando controlados

Privado significa que o conteúdo é armazenado localmente na área Saved do projeto. O Locus nunca consulta nem modifica o provedor para Notas e Pins Privados.

Modo local

Sem nenhum provedor configurado, Locus entra no modo local. Arquivos locais e não rastreados permanecem editáveis ​​sem avisos do provedor ou chamadas em segundo plano; Notas, Pins e Documentos não mostram status de provedor, indicador, dica de ferramenta, orientação, recursos de Marcar para Adição ou Check Out. O conteúdo compartilhado permanece nas raízes do projeto.

Um provedor configurado, mas indisponível, é distinto e mantém protegido o conteúdo controlado conhecido. Quando disponível, a barra de status usa o ícone de controle de revisão padrão do Unreal. Mostrar Status do Controle de Código-Fonte controla apenas indicadores de linha compactos; linhas rastreadas limpas permanecem silenciosas onde documentadas.

Checkout e estados somente leitura

Selecionar, abrir ou ler conteúdo limpo e controlado não verifica. Um Nota compartilhado requer Check Out explícito. Uma mutação suportada de um Pin compartilhado controlado solicita checkout automaticamente e prossegue somente quando permitido; a falha o deixa protegido.

Documentos controlados permanecem legíveis, mas suas ações Markdown autoritativas Editar e Salvar ficam indisponíveis até o checkout ser bem-sucedido. A mesma proteção se aplica quando um arquivo controlado está em checkout por outro usuário ou cliente, está desatualizado, desconectado do provedor necessário ou em um estado que o Locus não consegue verificar. Exportar Cópia permanece disponível para Documentos quando aplicável.

Depois de reconectar o provedor, atualize o Controle de Código-Fonte ou o Locus se necessário. O estado controlado retorna, mas um arquivo limpo continua somente leitura até receber Check Out explicitamente.

O Locus não oferece um bypass para tornar gravável um arquivo controlado somente leitura.

Novos arquivos e Marcar para Adição

Novos Notas compartilhados mantêm sua solicitação Marcar para Adição pós-criação; a falha deixa o arquivo válido para nova tentativa. Novos Pins compartilhados permanecem Untracked até serem adicionados explicitamente, incluindo seleção múltipla qualificada. Um instantâneo Pin compartilhado é uma imagem separada com seu próprio estado de adição ou checkout.

Novos Documentos permanecem intencionalmente Não rastreados. Crie, organize, renomeie, mova e edite o Documento primeiro; depois use Marcar para Adição quando o caminho final estiver estável. Um Documento Não rastreado pode ser renomeado ou movido quando isso for seguro. Um Documento Marcado para Adição ou já controlado não pode ser renomeado ou movido pelo Locus, pois o Locus não pode garantir uma movimentação transacional neutra em relação ao provedor. Ele não usa um fallback para tornar gravável e não pede para desabilitar o controle de código-fonte. Um arquivo local não é compartilhado com a equipe até ser adicionado e enviado pelo fluxo normal do projeto. Depois do envio, o arquivo é controlado e usa Check Out para edições futuras; não é marcado novamente para adição.

Segurança antes da conveniência

O Locus recusa uma operação que não consegue manter sincronizada com o controle de código-fonte, em vez de deixar silenciosamente um arquivo e o estado do provedor em caminhos diferentes.

Excluir

A exclusão exige confirmação. Para arquivos controlados, o Locus verifica o estado informado e encaminha a exclusão pelo provedor antes da limpeza local. Bloqueia a exclusão quando outro usuário possui o checkout, o arquivo está desatualizado ou não é possível estabelecer segurança.

O Locus não envia

O Locus não envia arquivos, não cria nem administra changelists, não sincroniza o espaço de trabalho nem modifica a configuração do repositório. Revise e envie as alterações usando as ferramentas normais de controle de código-fonte do Unreal ou da equipe.

Orientações para Perforce

Perforce é o provedor com as evidências atuais de validação do projeto. Uma escolha comum de typemap para Notas e Pins colaborativos é:

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

Isso trata os arquivos baseados em JSON como texto com bloqueio exclusivo. Documentos Markdown são arquivos de texto normais; escolha a política .md adequada ao repositório. O Locus nunca edita a typemap do Perforce para você.

Outros provedores de controle de código-fonte do Unreal têm suporte sem garantias e não foram validados para 1.0. Verifique o comportamento do provedor em um projeto de teste no qual a perda de dados não seja um problema.

Perforce é o provedor certificado ao vivo para 1.1. Outros provedores de controle de origem Unreal são de melhor esforço e não validados; teste-os em um projeto descartável.

Recuperação e conflitos externos

Snapshots de recuperação protegem o trabalho local não salvo e não substituem o controle de código-fonte. Um conflito externo acontece quando o conteúdo no disco muda enquanto um editor local tem alterações pendentes; o Locus bloqueia a substituição silenciosa e oferece ações seguras de resolução. O estado desatualizado do controle de código-fonte e os conflitos do editor são relacionados, mas separados.

Consulte as seções de recuperação em Notas, Pins e Documentos ou use Solução de problemas.