Importation d’un projet Gradle
En raison de changements dans le projet, il est nécessaire de mettre à jour les fichiers de compilation pour un projet Gradle des années précédentes. Il est également nécessaire d’importer à nouveau les librairies de fournisseurs, puisque les librairies de fournisseurs de l’année dernière doivent être mises à jour pour être compatibles avec les projets de l’année en cours.
Importation automatique
To make it easy for teams to import previous years gradle projects into the current year’s framework, WPILib includes a wizard for importing previous years projects into VS Code. This will generate the necessary gradle components and load the project into VS Code. In place upgrades are not supported.
Important
Le processus d’importation copie les fichiers source de votre projet du répertoire actuel vers un nouveau répertoire et régénère complètement les fichiers gradle. De plus, il met à jour le code des modifications apportées au package en 2022. Si vous avez effectué des mises à jour non standard du build.gradle, vous devrez effectuer à nouveau ces modifications. Pour cette raison, les mises à niveau sur place ne sont pas prises en charge. Il est également nécessaire d’importer à nouveau les librairies de fournisseurs, car celles de l’année dernière doivent être mises à jour pour être compatibles avec les projets de cette année.
Lancement de l’Assistant d’Importation
Lorsque vous ouvrez un projet de l’année précédente, vous serez invité à importer ce projet. Cliquez sur yes.
Alternately, you can chose to import it from the menu. Press Ctrl+Shift+P and type « WPILib » or click the WPILib icon to locate the WPILib commands. Begin typing « Import a WPILib 2020/2021/2022 Gradle project » and select it from the dropdown as shown below.
Il vous sera présenté la fenêtre WPILib Project Importer. Cette opération est similaire au processus de création d’un nouveau projet et la fenêtre ainsi que les étapes sont affichées ci-dessous. Cette fenêtre contient les éléments suivants :
Gradle Project: Sélectionne le projet à importer. Les utilisateurs doivent sélectionner le fichier build.gradle dans le répertoire racine du projet gradle.
Project Location: Ce paramètre définit le dossier dans lequel le projet de robot sera situé.
Project Name: Ce paramètre définit le nom du projet de robot. Il spécifie également le nom que le dossier de projet recevra si la zone « Create New Folder » est cochée. Il doit s’agir d’un répertoire différent de l’emplacement d’origine.
Create a New Folder: Si cette case est cochée, un nouveau dossier sera créé pour contenir le projet dans le dossier précédemment spécifié. Si elle n’est pas cochée, le projet sera situé directement dans le dossier précédemment spécifié. Une erreur sera générée si le dossier n’est pas vide et que cela n’est pas vérifié.
Team Number: Ce paramètre définit le numéro d’équipe du projet, qui sera utilisé pour les noms de packages dans le projet et pour localiser le robot lors du déploiement du code.
Enable Desktop Support: si cette case est cochée, la prise en charge de la simulation et des tests unitaires est activée. Cependant, dans certains cas, cela entraînera des choses inattendues. De plus, toutes les librairies des fournisseurs ont besoin d’une prise en charge de bureau, contrairement à certaines librairies qui n’en n’ont pas besoin..
Import Romi Project: If this is checked, the project is imported using the Romi gradle template. This should only be checked for Romi projects.
Cliquez sur Import Project pour commencer la mise à niveau.
Le projet gradle sera mis à niveau et copié dans le nouveau répertoire du projet. Vous pouvez alors soit ouvrir le nouveau projet immédiatement à l’aide de la fenêtre contextuelle ci-dessous, soit l’ouvrir plus tard à l’aide du raccourci Ctrl+O (ou Command+O pour macOS).
Cliquez sur Yes I trust the authors. (Oui, je fais confiance aux auteurs.)
Configurations C++ (C++ uniquement)
Pour les projets C++, il existe une étape supplémentaire pour configurer IntelliSense. Chaque fois que vous ouvrez un projet, vous devriez obtenir une fenêtre contextuelle dans le coin inférieur droit vous demandant d’actualiser les configurations C++. Cliquez sur Yes pour configurer IntelliSense.
Bibliothèques des tierces parties
Il est nécessaire de mettre à jour et de ré-importer les bibliothèques tierces. Voir Librairies tierces pour plus de détails.