Controllo del codice sorgente

Locus funziona senza controllo del codice sorgente. Quando Unreal ha un provider attivo, Locus applica regole consapevoli del provider in base alla proprietà di ogni tipo di contenuto.

La proprietà determina il comportamento del provider

Contenuto	Comportamento del provider
Nota Condivise	Contrassegna per l’aggiunta quando nuove; checkout esplicito, stato ed eliminazione sicura quando controllate
Nota Private	Nessuna query o operazione del provider
Pin Condivisi	Contrassegna per l’aggiunta quando nuovi; checkout esplicito, stato ed eliminazione sicura quando controllati
Pin Privati	Nessuna query o operazione del provider
Documenti	Di proprietà del progetto; creati Non tracciati, poi Contrassegna per l’aggiunta esplicitamente; checkout, stato ed eliminazione sicura quando controllati

Privato significa che il contenuto viene archiviato localmente nell’area Saved del progetto. Locus non interroga né modifica mai il provider per Nota e Pin Privati.

Modalità locale

Senza alcun provider configurato, Locus entra in modalità locale. I file locali e non tracciati rimangono modificabili senza avvisi del provider o chiamate in background; Gli Nota, Pin e Documento non mostrano lo stato del fornitore, l’indicatore, la descrizione comando, la guida, l’affordance Contrassegna per l’aggiunta o Checkout. Il contenuto condiviso rimane nelle radici di proprietà del progetto.

Un provider configurato ma non disponibile è distinto e mantiene protetti i contenuti controllati noti. Se disponibile, la barra di stato utilizza l’icona di controllo di revisione standard di Unreal. Mostra Stato Controllo del codice sorgente controlla solo gli indicatori di fila compatti; le righe tracciate pulite rimangono silenziose dove documentate.

Checkout e stati di sola lettura

La selezione, l’apertura o la lettura di contenuti puliti e controllati non ne compromettono il check-out. Uno Nota condiviso richiede Checkout esplicito. Una mutazione supportata di uno Pin condiviso controllato richiede il checkout automaticamente e procede solo quando consentito; il fallimento lo lascia protetto.

I Documenti controllati restano leggibili, ma le azioni Modifica e Salva, che cambiano il file Markdown di riferimento, restano non disponibili finché il checkout non riesce. La stessa protezione vale quando un file controllato è in checkout da altro utente o client, non aggiornato, disconnesso dal provider richiesto o in uno stato che Locus non può verificare. Esporta copia resta disponibile per i Documenti quando applicabile.

Dopo aver riconnesso il provider, aggiorna Controllo del codice sorgente o Locus se necessario. Lo stato controllato ritorna, ma un file pulito resta di sola lettura finché non viene sottoposto esplicitamente a checkout.

Locus non offre un bypass non sicuro per rendere scrivibile un file controllato di sola lettura.

Nuovi file e Contrassegna per l’aggiunta

I nuovi Nota condivisi mantengono la richiesta Contrassegna per l’aggiunta post-creazione; l’errore lascia il file valido per un nuovo tentativo. I nuovi Pin condivisi rimangono Untracked finché non vengono aggiunti esplicitamente, inclusa la selezione multipla idonea. Un’istantanea Pin condivisa è un’immagine separata con il proprio stato di aggiunta o estrazione.

I nuovi Documenti restano intenzionalmente Non tracciati. Crea, organizza, rinomina, sposta e modifica prima il Documento, poi usa Contrassegna per l’aggiunta quando il percorso finale è stabile. Un Documento Non tracciato può essere rinominato o spostato quando altrimenti è sicuro. Un Documento contrassegnato per l’aggiunta o già controllato non può essere rinominato o spostato da Locus, perché Locus non può garantire uno spostamento transazionale indipendente dal provider. Non usa Rendi scrivibile come soluzione alternativa e non chiede di disabilitare il controllo del codice sorgente. Un file locale non è condiviso con il team finché non viene aggiunto e inviato tramite il normale flusso del progetto. Dopo l’invio, il file è controllato e usa Checkout per le modifiche successive; non viene contrassegnato di nuovo per l’aggiunta.

Sicurezza prima della comodità

Locus rifiuta un’operazione che non può mantenere sincronizzata con il controllo del codice sorgente, invece di lasciare silenziosamente file e stato del provider a percorsi diversi.

Elimina

L’eliminazione richiede conferma. Per i file controllati, Locus verifica lo stato segnalato e instrada l’eliminazione tramite il provider prima della pulizia locale. Blocca l’eliminazione quando un altro utente possiede il checkout, il file non è aggiornato o non è possibile stabilire la sicurezza.

Locus non invia

Locus non invia file, non crea né amministra changelist, non sincronizza l’area di lavoro e non modifica la configurazione del repository. Esamina e invia le modifiche con gli strumenti normali del controllo del codice sorgente di Unreal o del team.

Indicazioni per Perforce

Perforce è il provider con le attuali evidenze di validazione del progetto. Una scelta comune di typemap per Nota e Pin collaborativi è:

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

Tratta i file basati su JSON come testo con blocco esclusivo. I Documenti Markdown sono normali file di testo; scegli la policy .md adatta al repository. Locus non modifica la typemap Perforce per te.

Gli altri provider Unreal del controllo del codice sorgente sono supportati senza garanzie e non sono stati convalidati per la versione 1.0. Verifica il comportamento del provider in un progetto di test in cui la perdita di dati non sia un problema prima di utilizzarlo.

Perforce è il fornitore certificato live per 1.1. Altri fornitori di controllo del codice sorgente Unreal offrono il massimo impegno e non sono convalidati; testarli in un progetto usa e getta.

Recupero e conflitti esterni

Le copie di recupero proteggono il lavoro locale non salvato e non sostituiscono il controllo del codice sorgente. Un conflitto esterno si verifica quando il contenuto sul disco cambia mentre l’editor locale ha modifiche in sospeso; Locus blocca la sovrascrittura silenziosa e offre azioni di risoluzione sicure. Lo stato non aggiornato del controllo del codice sorgente e i conflitti dell’editor sono correlati ma distinti.

Vedi le sezioni sul recupero in Nota, Pin e Documenti, oppure usa Risoluzione dei problemi.