Synchronisation GitHub
Connectez GitHub avec un code d'appareil ou un jeton, publiez un projet comme dépôt nouveau ou existant, poussez et tirez entre machines, et découvrez comment votre jeton est protégé.
La synchronisation GitHub est une sauvegarde facultative hors de la machine et un relais entre plusieurs ordinateurs, bâtie sur le vrai dépôt Git qu’est déjà chaque projet. Les commits locaux fonctionnent sans GitHub. Quand vous vous connectez, il n’y a toujours aucun compte Oleafly dans l’image : seulement votre GitHub.
Connecter votre compte
Section intitulée « Connecter votre compte »Paramètres, Intégrations, GitHub, puis l’une ou l’autre voie :
- Connecter GitHub (recommandé) : un flux à code d’appareil. Oleafly affiche un code court, votre navigateur ouvre
github.com/login/device(avec un bouton Copier pour le code), vous approuvez, et l’application le détecte en quelques secondes. La connexion ne demande que les portéesrepoetread:user. - Jeton d’accès personnel : dépliez « Avancé : utiliser un jeton d’accès personnel » et collez un PAT si vous préférez créer vos propres identifiants.
Une fois connecté, votre avatar et votre nom d’utilisateur apparaissent dans Paramètres et dans le menu GitHub de la barre d’outils supérieure. Déconnecter oublie le jeton.
Comment votre jeton est protégé
Section intitulée « Comment votre jeton est protégé »Le jeton est stocké dans un fichier local chiffré AES-256-GCM, restreint à son propriétaire, et n’est jamais transmis à la couche d’interface de l’application ; l’interface ne connaît jamais que « connecté en tant que @vous ». Quand Git doit s’authentifier, le jeton est injecté par un assistant d’identification en mémoire, donc il n’apparaît jamais dans une ligne de commande, dans .git/config ni dans l’historique de votre shell. Les anciennes versions qui incorporaient des jetons dans les URL distantes sont nettoyées automatiquement au démarrage.
Publier un projet
Section intitulée « Publier un projet »Dans le panneau Contrôle de version, cliquez sur Publier sur GitHub :
- Créer un dépôt : choisissez un nom (prérempli depuis le projet), gardez Privé (recommandé) coché ou non, puis Créer et pousser. Oleafly crée le dépôt, valide les fichiers du projet, configure
originet pousse. - Lier un dépôt existant : choisissez dans une liste filtrable de vos dépôts (les privés affichent un cadenas), puis Lier et pousser.
Après la publication, le menu GitHub de la barre d’outils propose Ouvrir dans GitHub et Copier le lien du dépôt.
Les fichiers qui ressemblent à des secrets restent locaux
Section intitulée « Les fichiers qui ressemblent à des secrets restent locaux »La publication ne valide jamais les fichiers qui contiennent habituellement des clés ou des mots de passe, comme .env, *.pem, les clés privées SSH ou credentials.json. Ils restent dans le dossier du projet, non indexés, et la boîte de dialogue les nomme. Pour en publier un quand même, indexez-le et validez-le vous-même dans le Contrôle de version. Les modèles comme .env.example, les clés publiques et les fichiers Keynote .key sont publiés comme d’habitude.
Un push téléverse tout l’historique. Si un fichier portant l’un de ces noms a déjà été validé, Oleafly le liste et attend Annuler ou Publier quand même avant de créer quoi que ce soit sur GitHub.
Synchronisation au quotidien
Section intitulée « Synchronisation au quotidien »Les boutons Pousser et Tirer du panneau Contrôle de version font ce qu’ils annoncent, vers origin sur votre branche actuelle. Récupérer et Synchroniser sont dans le menu Plus d’actions de contrôle de version, et Valider et pousser et Valider et synchroniser sont dans le menu à côté de Valider. L’indicateur d’avance/retard (↑ ↓) à côté de la pastille de branche vous dit quand il y a quelque chose à pousser ou tirer.
Deux ordinateurs
Section intitulée « Deux ordinateurs »- Sur la machine A : publiez le projet, travaillez, Pousser.
- Sur la machine B : connectez le même compte GitHub, puis choisissez Importer un projet → GitHub et sélectionnez le dépôt. Voir le guide d’importation. Dès lors, Tirer, travaillez, Pousser.
- De retour sur A : Tirer avant de commencer. L’indicateur vous le rappelle.
La couleur de couverture, le choix du document principal et l’historique voyagent tous, parce qu’ils vivent dans le dossier du projet lui-même.
Changer d’avis
Section intitulée « Changer d’avis »Une fois un distant configuré, le menu Plus d’actions de contrôle de version contient deux éléments de plus :
- Changer de dépôt rouvre la boîte de dialogue de publication pour pointer
originailleurs. - Délier retire le distant ; le projet local et son historique restent intacts.
Conflits et branches
Section intitulée « Conflits et branches »Si un tirage rencontre un conflit de fusion, le Contrôle de version liste les fichiers en conflit. Choisissez Garder la version actuelle ou Prendre la version entrante pour chacun, ou modifiez le fichier et choisissez Marquer comme résolu, puis Terminer la fusion. Abandonner la fusion remet les fichiers comme ils étaient. Pousser et Tirer agissent sur la branche extraite, et le menu de branche en haut du panneau change ou crée des branches. Voir Git et le contrôle de version.
Limites, dites franchement
Section intitulée « Limites, dites franchement »Oleafly authentifie les distants HTTPS. La publication en configure un correctement pour vous.
Si quelque chose échoue
Section intitulée « Si quelque chose échoue »- « Pas de distant ‘origin’ » : publiez d’abord ; Pousser et Tirer ont besoin d’un distant.
- Push rejeté parce que le distant a des commits : tirez d’abord, puis poussez.
- « Aucun jeton GitHub défini » : connectez-vous dans Paramètres, Intégrations, GitHub.
Plus dans la FAQ.