Ce guide détaille le processus complet pour créer un nouveau projet dans l'IDE Cangjie et le soumettre à un dépôt GitCode, incluant toutes les commandes Git nécessaires.
I. Prérequis
- Créer et se connecter à un compte GitCode : https://gitcode.com/
- Sur l'interface web de GitCode, créer un dépôt vide. Notez l'URL du dépôt (par exemple :
https://gitcode.com/votre_nom_utilisateur/nom_du_depot.git).
II. Processus dans l'IDE Cangjie
Étape 1 : Création du projet Cangjie
- Ouvrez « CodeArts IDE for Cangjie ».
- Cliquez sur « Nouveau Projet » → Sélectionnez « Projet Cangjie ».
- Saisissez le nom du projet (ex:
mon_projet_test) et choisissez le chemin de sauvegarde local → Cliquez sur « Créer ». - Attendez l'initialisation du projet, les fichiers principaux comme
src/main.cjetcjpm.tomlseront générés automatiquement.
Étape 2 : Ouvrir le terminal et naviguer vers le répertoire du projet
-
Cliquez sur le bouton « Terminal » en bas de l'IDE pour ouvrir une fenêtre de ligne de commande.
-
Exécutez la commande pour accéder au répertoire racine du projet (remplacez par votre chemin réel) : ```bash
cd D:/chemin/vers/votre/projet/mon_projet_test
Étape 3 : Initialisation du dépôt Git
Exécutez la commande pour initialiser la gestion de version Git :
git init
Explication : Ceci crée un répertoire caché .git qui marque le dossier actuel comme un dépôt Git.
Étape 4 : Ajout des fichiers à la zone de staging
Exécutez la commande pour ajouter tous les fichiers du projet à la zone de staging :
git add .
Explications :
- Le point (
.) indique d'ajouter tous les fichiers du répertoire courant. Vous pouvez aussi spécifier un fichier unique (ex:git add src/main.cj).- Si vous voyez un avertissement de type
LF will be replaced by CRLF, il s'agit d'une alerte concernant le format des fins de ligne sous Windows, qui n'affecte pas l'opération et peut être ignorée.
Étape 5 : Commiter dans le dépôt local
Exécutez la commande pour sauvegarder les modifications dans votre dépôt Git local :
git commit -m "Initialisation du projet Cangjie mon_projet_test"
Explication : L'option
-mest suivie d'un message obligatoire décrivant les modifications (ex: "Ajout de la fonctionnalité de connexion", "Correction du bug de démarrage").
Étape 6 : Lier le dépôt distant GitCode
Exécutez la commande pour lier votre dépôt local au dépôt GitCode (remplacez par l'URL de votre dépôt GitCode) :
git remote add origin https://gitcode.com/votre_nom_utilisateur/mon_projet_test.git
Pour vérifier que la liaison a réussi, exécutez :
git remote -v
Si l'URL de votre dépôt GitCode apparaît dans les lignes fetch et push, la liaison est confirmée.
Étape 7 : Pousser le code vers GitCode
Choisissez la commande appropriée selon le nom de votre branche locale :
Cas 1 : Utilisation de la branche par défaut master (par défaut dans l'IDE Cangjie)
git push -u origin master
Cas 2 : Utilisation de la branche main (pratique courante)
Renommez d'abord la branche locale, puis poussez :
# Renommer la branche locale master en main
git branch -m master main
# Pousser la branche main vers GitCode
git push -u origin main
Gestion des problèmes courants :
-
Erreur
non-fast-forward: Le dépôt distant contient déjà des modifications. Il faut d'abord fusionner l'historique avant de pousser. ```bashgit pull origin master --allow-unrelated-histories git push -u origin master
-
Si vous êtes certain que votre code local est le plus récent et souhaitez écraser le contanu distant : ```bash
git push -f origin master
**Attention :** Le push forcé écrase tout le code distant. À n'utiliser que pour des projets personnels et si vous êtes sûr de ne pas perdre de données importantes.
Étape 8 : Vérification du résultat du push
- Ouvrez votre navigateur et accédez à l'URL de votre dépôt GitCode (ex:
https://gitcode.com/votre_nom_utilisateur/mon_projet_test). - Connectez-vous à votre compte. Vous devriez voir les fichiers du projet (
main.cj,cjpm.toml) et l'historique des commits, confirmant que la synchronisation du code a réussi.
III. Flux de mise à jour de code pour le développement quoitdien
# 1. Récupérer les dernières modifications de GitCode (pour éviter les conflits)
git pull origin master
# 2. Modifier/ajouter du code dans l'IDE Cangjie
# 3. Ajouter les fichiers modifiés à la zone de staging
git add .
# 4. Commiter dans le dépôt local
git commit -m "Description des modifications : ex: Ajout de la fonctionnalité X"
# 5. Pousser vers GitCode (après le premier push, la commande peut être simplifiée)
git push
IV. Tableau de référence rapide des commandes clés
| Commande | Action |
|---|---|
git init |
Initialiser un dépôt Git. |
git add . |
Ajouter tous les fichiers au staging. |
git commit -m "Commentaire" |
Valider les changements dans le dépôt local. |
git remote add origin URL_depot |
Lier un dépôt distant (nommé 'origin'). |
git remote -v |
Afficher les dépôts distants configurés. |
git push -u origin nom_branche |
Premier envoi du code vers GitCode. |
git pull origin nom_branche |
Récupérer les dernières modifications de GitCode. |
git push |
Envoyer les mises à jour de code ultérieures. |
V. Points d'attantion
- Nommage des branches : Par défaut, l'IDE Cangjie utilise la branche
master. Vous pouvez la renommer enmainselon vos préférences. Le nom de la branche doit être cohérent entre votre dépôt local et distant lors du push. - Convention de commit : Rédigez des messages de commit clairs et concis pour faciliter le suivi des modifications du code.
- Sécurité : Évitez de sauvegarder vos identifiants Git sur des appareils publics. Privilégiez l'authentification OAuth ou SSH.