Pour mettre en place son environnement de développement sur son PC personnel, il a quelques étapes à suivre.
Il est possible de créer votre environnement à l'aide de docker, bien que cela ne soit pas obligatoire. Dans tous les cas, vous devez avoir un serveur MySQL que vous pouvez installer à partir de Docker.
- Cloner la branch develop du repository
- Démarrer le serveur MySQL (soit votre propre serveur, soit à partir d'une image Docker dont la mise en place est expliquée sur le wiki de gitlab : https://git.unistra.fr/acrobatt-equipe-6/acrobatt/-/wikis/Base-de-donn%C3%A9es)
- Rendez-vous dans le fichier
src/resources/application.properties - Modifier les informations de connexion pour correspondre à votre serveur MySQL
- Enregistrer et fermer le fichier
Ensuite, vous pourrez lancer l'API. L'API peut se lancer avec ou sans docker.
Installation et lancement de l'API à partir de Docker
- Ouvrir un terminal de commande
- Rendez-vous dans le dossier de l'API
- Lancer la commande :
mvnw.cmd spring-boot:build-image(rajouter ./ avant la commande sur Windows) - Attendre la fin de la création de l'image docker.
- Lancer l'interface utilisateur de Docker
- Lancer la commande
docker-machine ip, noter l'ip affiché - Déplacez-vous dans le dossier .git/ de l'API
- Utiliser la commande
docker-compose up - Aller sur votre navigateur pour vérifier que l'API fonctionne en vous mettant comme URL l'IP que vou avez récupéré précédemment et en rajoutant :8080.
Installation et lancement de l'API sans Docker
- Ouvrir un terminal de commande
- Rendez-vous dans le dossier de l'API
- Taper la commande :
mvnw.cmd spring-boot:run - Les fichiers de l'API vont être compilés, puis le serveur se connectera à
Le démarrage de l'application web en mode développement est très simple.
Pensez régulièrement à effectuer la commande npm install dès que vous récupérez sur le repo gitlab des changements.
Rendez-vous dans le dossier de l'application et taper la commande npm run start, ce qui va lancer le serveur de développement de react.
Téléchargez le client command expo-cli avec la commande npm install -g expo-cli.
Enregistrez vous compte expo puis faite la commande expo login
L'application mobile utilise yarn comme gestionnaire de paquet. Rendez-vous dans la racine de l'application mobile.
Comme pour l'application mobile, utiliser la commande yarn install pour installer les éventuels nouveaux plugins.
Ensuite, pour lancer le serveur de développement react-native, utiliser la commande expo start ou yarn start.
Pour mettre en place l'environnement de production il faudra d'abord avoir à disposition un serveur linux 64bits avec un compte administrateur.
Pour déployer l'api vous devez installer au préalabe un serveur de base de données MariaDB.
- Installer java sur votre serveur, avec cette commande par exemple :
apt install openjdk-11-jdk maven - Cloner la branch master du repository
- Démarrer le serveur MySQL
- Rendez-vous dans le fichier
src/resources/application.properties - Modifier les informations de connexion pour correspondre à votre serveur MySQL
- Enregistrer et fermer le fichier
- Vous pouvez ensuite build le jar de l'application avec la commande
mvn package -DskipTests
Ensuite, vous pourrez lancer l'API grâce à la commande java -jar acrobatt.api-<version>.jar.
Pour mettre en production l'application web vous aurrez besoin d'un serveur web comme par exemple nginx. apt install nginx
Pensez à effectuer pendant chaque mise à jour la commande npm install dès que vous récupérez sur le repo gitlab des changements.
npm run build va créer les fichiers optimisés qui seront à déposer sur votre serveur web (sur /var/www/html dans le cas d'nginx).
Pour créer l'apk de l'application, il faut d'abord vérifier que tous les modules sont installés avec yarn install.
Puis avec le client expo exécuter la commande expo build:android -t apk, l'apk de l'application sera exécuté sur les serveurs d'expo, il faudra récupérer le résultat sur leur site.