- Documentation
- Locus
- Contrôle de source
Contrôle de source
Locus fonctionne sans contrôle de source. Lorsqu’Unreal dispose d’un fournisseur actif, Locus applique des règles adaptées au fournisseur selon la propriété de chaque type de contenu.
La propriété détermine le comportement du fournisseur
Section intitulée « La propriété détermine le comportement du fournisseur »| Contenu | Comportement du fournisseur |
|---|---|
| Notes partagées | Marquer pour ajout à la création ; extraction explicite, état et suppression sûre lorsqu’elles sont contrôlées |
| Notes privées | Aucune requête ni opération de fournisseur |
| Repères partagés | Marquer pour ajout à la création ; extraction explicite, état et suppression sûre lorsqu’ils sont contrôlés |
| Repères privés | Aucune requête ni opération de fournisseur |
| Documents | Appartenant au projet ; créés Non suivi, puis Marquer pour ajout explicitement ; extraction, état et suppression sûre lorsqu’ils sont contrôlés |
Privé signifie local dans la limite de stockage Saved du projet. Locus maintient un comportement strict sans interaction avec le fournisseur pour les Notes et Repères privés.
Mode local
Section intitulée « Mode local »Sans fournisseur configuré, Locus passe en mode local. Les fichiers locaux et non suivis restent modifiables sans avertissements du fournisseur ni appels en arrière-plan ; Les Note, repère et Document n’affichent aucun statut de fournisseur, aucun indicateur, aucune info-bulle, aucune orientation, aucune possibilité Marquer pour ajout ou Extraire. Le contenu partagé reste dans les racines du projet.
Un fournisseur configuré mais indisponible est distinct et protège le contenu contrôlé connu. Lorsqu’elle est disponible, la barre d’état utilise l’icône de contrôle de révision standard de Unreal. Afficher le statut du Contrôle de source contrôle uniquement les indicateurs de rangée compacts ; les lignes suivies propres restent silencieuses là où elles sont documentées.
Extraction et états en lecture seule
Section intitulée « Extraction et états en lecture seule »La sélection, l’ouverture ou la lecture d’un contenu contrôlé et propre ne le vérifie pas. Un Note partagé nécessite un Extraire explicite. Une mutation prise en charge d’un repère partagé contrôlé demande automatiquement l’extraction et ne se poursuit que lorsqu’elle est autorisée ; l’échec le laisse protégé.
Les Documents contrôlés restent lisibles, mais leurs actions Markdown faisant autorité Modifier et Enregistrer restent indisponibles jusqu’à la réussite de l’extraction. La même protection s’applique lorsqu’un fichier contrôlé est extrait par un autre utilisateur ou client, pas à jour, déconnecté de son fournisseur requis ou dans un état que Locus ne peut pas vérifier. Exporter une copie reste disponible pour les Documents lorsque cela s’applique.
Après la reconnexion du fournisseur, actualisez le Contrôle de source ou Locus si nécessaire. L’état contrôlé revient, mais un fichier propre reste en lecture seule jusqu’à son extraction explicite.
Locus ne fournit pas de contournement non sûr pour rendre inscriptible un fichier contrôlé en lecture seule.
Nouveaux fichiers et Marquer pour ajout
Section intitulée « Nouveaux fichiers et Marquer pour ajout »Les nouveaux Note partagés conservent leur demande Marquer pour ajout post-création ; l’échec laisse le fichier valide pour une nouvelle tentative. Les nouveaux repère partagés restent Untracked jusqu’à ce qu’ils soient explicitement ajoutés, y compris la multisélection éligible. Un instantané repère partagé est une image distincte avec son propre état d’ajout ou d’extraction.
Les nouveaux Documents restent intentionnellement Non suivi. Créez, organisez, renommez, déplacez et modifiez d’abord le Document, puis utilisez Marquer pour ajout lorsque son chemin final est stable. Un Document Non suivi peut être renommé ou déplacé lorsque cela reste sûr. Un Document marqué pour ajout ou déjà contrôlé ne peut pas être renommé ou déplacé par Locus, car Locus ne peut pas garantir un déplacement transactionnel neutre vis-à-vis du fournisseur. Il n’utilise pas de contournement Rendre inscriptible et ne vous demande pas de désactiver le contrôle de source. Un fichier local n’est partagé avec l’équipe qu’après son ajout et sa soumission selon le workflow normal du projet. Une fois soumis, le fichier est contrôlé et utilise Extraire pour les modifications ultérieures ; il n’est pas marqué à nouveau pour ajout.
Supprimer
Section intitulée « Supprimer »La suppression demande confirmation. Pour les fichiers contrôlés, Locus vérifie l’état signalé et fait passer la suppression par le fournisseur avant le nettoyage local. Il bloque la suppression lorsqu’un autre utilisateur possède l’extraction, que le fichier n’est pas à jour ou que la sécurité ne peut pas être établie.
Conseils Perforce
Section intitulée « Conseils Perforce »Perforce est le fournisseur pour lequel le projet dispose actuellement d’éléments de validation. Un choix courant de typemap pour les Notes et Repères collaboratifs est :
text+l //....uenotetext+l //....locuspinCela traite les fichiers fondés sur JSON comme du texte avec verrouillage exclusif. Les Documents Markdown sont des fichiers texte normaux ; choisissez la politique .md adaptée au dépôt. Locus ne modifie jamais la typemap Perforce à votre place.
Les autres fournisseurs Unreal de contrôle de source sont pris en charge au mieux et non validés pour la version 1.0. Validez leur comportement dans un projet jetable avant de vous y fier.
Perforce est le fournisseur certifié en direct pour la version 1.1. Les autres fournisseurs de contrôle de source Unreal font de leur mieux et ne sont pas validés ; testez-les dans un projet jetable.
Récupération et conflits externes
Section intitulée « Récupération et conflits externes »Les instantanés de récupération protègent le travail local non enregistré et ne remplacent pas le contrôle de source. Un conflit externe se produit lorsque le contenu du disque change alors qu’un éditeur local a des modifications en attente ; Locus bloque le remplacement silencieux et propose des actions de résolution sûres. L’état désynchronisé du contrôle de source et les conflits de l’éditeur sont liés, mais restent distincts.
Voir les sections de récupération dans Notes, Repères et Documents, ou utiliser Résolution des problèmes.