Configuration de GitHub pour la collaboration

Avant de commencer à travailler avec d'autres utilisateurs sur des projets Vuforia Studio dans GitHub, quelques étapes de base doivent être complétées.

Si vous disposez déjà d'un projet sur lequel vous souhaitez collaborer, vous pouvez ignorer cette étape.

1. Ouvrez Vuforia Studio.

2. Dans la page Mes projets, cliquez sur l'icône Plus verte pour créer un nouveau projet.

3. Sélectionnez le modèle que vous souhaitez utiliser, saisissez un nom de projet et une URL Experience Service.

4. Cliquez sur Créer.

1. Ouvrez GitHub Desktop et sélectionnez File > New repository....

2. Entrez les informations appropriées dans la fenêtre Create a new repository.

◦ Name : nous recommandons d'utiliser la valeur exacte de l'entrée fileName du fichier appConfig.json comme nouveau nom de référentiel. Pour localiser la valeur de fileName, accédez à Documents > VuforiaStudio > Projects > <nom_projet>. Ouvrez ensuite le fichier appConfig.json, puis localisez la valeur de fileName.

◦ Description : fournit des informations supplémentaires concernant le projet ou le référentiel.

◦ Local path : cliquez sur Choose... et accédez au dossier Projects dans le répertoire VuforiaStudio. Par exemple, C:\Users\<nom_utilisateur>\Documents\VuforiaStudio\Projects.

3. Cliquez sur Create repository.

Une fois le référentiel créé, vous seul pouvez le voir, car il n'existe que sur votre ordinateur. Pour que ce référentiel soit utilisable par d'autres personnes, vous devez le publier sur GitHub afin de le rendre accessible.

1. Cliquez sur Publish repository.

2. Dans la fenêtre Publish repository, assurez-vous que les options Name et Description sont correctes. Par défaut, la case Keep this code private est cochée. Cette option vous permet de choisir si votre code sera visible par d'autres utilisateurs de GitHub. Lorsque cette case est cochée, votre code n'est pas accessible publiquement.

3. Cliquez sur Publish repository. Une fois la publication terminée, le référentiel est disponible sur GitHub.com.

Vous pouvez accéder à votre référentiel à partir de GitHub Desktop en sélectionnant Repository > View on GitHub ou en utilisant le raccourci clavier Ctrl+Maj+G.

Si le code dans le référentiel est privé, vous devrez inviter d'autres utilisateurs pour collaborer.

1. Cliquez sur Settings.

2. Dans l'onglet Settings, cliquez sur Collaborators. Cette page vous permet de gérer l'accès des utilisateurs au référentiel. Vous devez ajouter tous les utilisateurs qui agiront en tant que collaborateurs pour ce projet. Pour plus d'informations sur la gestion des accès, consultez la rubrique Gestion des équipes et des personnes ayant accès à votre dépôt dans GitHub Docs.

Une fois que vous avez accès à un référentiel, vous devez cloner le nouveau référentiel sur votre ordinateur local avant de pouvoir commencer à travailler.

1. Accédez à github.com et connectez-vous à votre compte.

2. Sous Top Repositories, recherchez le référentiel dans lequel vous avez été invité.

3. Dans l'onglet Code du référentiel, cliquez sur le menu déroulant Code.

4. Cliquez sur l'icône de copie en regard de l'URL.

5. Ouvrez GitHub Desktop, puis sélectionnez File > Clone repository....

6. Sélectionnez URL dans les onglets en haut de la fenêtre.

◦ Repository URL or GitHub username and repository : collez l'URL du référentiel que vous avez copiée à l'étape 4.

Une fois que vous avez sélectionné le dossier Projects, le chemin d'accès se met à jour en fonction du nom du référentiel. Par exemple, C:\Users\<nom_utilisateur>\Documents\VuforiaStudio\Projects devient automatiquement C:\Users\<nom_utilisateur>\Documents\VuforiaStudio\Projects\Machine_2_Maintenance.

7. Cliquez sur Clone. Une fois le clonage terminé, le référentiel apparaît dans GitHub Desktop.

Pour découvrir un bref exemple de processus de collaboration sur des projets Vuforia Studio à l'aide de GitHub, consultez la rubrique Exemple de processus de collaboration.