S2M Jump App

S2M Jump App est un outil pédagogique qui permet d'explorer l'effet de paramètres biomécaniques sur la performance d'un saut aérien. L'application présente les phases du saut et met à jour les résultats de translation et de rotation lorsque les paramètres sont modifiés.

Fonctionnalités

• visualisation des phases de propulsion, de vol et d'atterrissage;
• comparaison des paramètres de translation et de rotation;
• calcul de la vitesse de décollage, de la hauteur maximale, du temps de vol et de la rotation;
• ajustement des paramètres par curseurs ou par saisie numérique.

Modifier Une Valeur

Les valeurs visibles et les valeurs utilisées par les calculs ont la même précision :

• les temps affichés en ms sont calculés au milliseconde près;
• les valeurs affichées avec deux décimales sont calculées avec ces deux décimales;
• Fmax est exprimée en poids corporel (BW) en fonction de la masse du sujet.

Pour entrer une valeur précise, appuyer sur le libellé d'un paramètre, par exemple T : 300 ms ou omega0 : 1.50 rev/s. Une fenêtre permet de saisir une valeur comprise dans l'intervalle autorisé. Le séparateur décimal , ou . est accepté.

Maintenir l'appui sur un paramètre éditable pour afficher son explication.

Prérequis

• Flutter 3.44.0 ou une version compatible récente;
• Dart ^3.10.0 (inclus avec Flutter);
• pour iOS/macOS : Xcode et CocoaPods;
• pour Android : un SDK Android compatible avec la version Flutter installée.

Développement

Installer les dépendances :

flutter pub get

Lancer l'application :

flutter run

Vérifier le code et exécuter les tests :

flutter analyze
flutter test

Les tests couvrent notamment :

• l'arrondi et les bornes des valeurs affichées;
• la cohérence des unités utilisées pour les calculs biomécaniques;
• l'entrée numérique, y compris la virgule décimale et les valeurs hors plage.

Publication

Android

Pour générer un Android App Bundle :

flutter build appbundle

La signature nécessite un fichier android/key.properties contenant :

storeFile=...
storePassword=...
keyAlias=s2mjumpapp
keyPassword=...

Le fichier référencé par storeFile doit être obtenu auprès d'un membre de l'équipe.

Binaires desktop (GitHub Release)

Un workflow GitHub Actions génère automatiquement les binaires desktop lors de la publication d'une release GitHub, puis les ajoute comme assets de la release :

• Linux : archive .tar.gz du bundle;
• Windows : archive .zip du dossier Release;
• macOS : archive .zip du fichier .app.

Le workflow est défini dans .github/workflows/release-desktop-binaries.yml.

iOS

Pour préparer un fichier IPA :

flutter build ipa

Il est possible que la commande s'arrête à la fin si l'environnement local ne peut pas terminer la distribution automatiquement. Dans ce cas, suivre le lien affiché dans la console pour ouvrir Xcode.

Dans Xcode :

1. cliquer sur Distribute App;
2. sélectionner Custom;
3. sélectionner App Store Connect;
4. sélectionner Export;
5. vérifier que seule l'option TestFlight internal testing only n'est pas cochée;
6. sélectionner Manually manage signing;
7. choisir le certificat de distribution et le profil de provisionnement Apple;
8. cliquer sur Export et choisir un dossier de sortie.

Le certificat de distribution et le profil de provisionnement doivent être valides pour l'application. Si vous ne les avez pas, les demander à un membre de l'équipe ou les générer dans le portail Apple Developer / App Store Connect, section Certificates, Identifiers & Profiles.

Une fois le fichier exporté, utiliser l'application Transporter pour envoyer le build vers App Store Connect.

Apple envoie généralement un courriel environ 5 à 10 minutes après le téléversement. Ce courriel indique si le build a été accepté ou refusé. En cas d'échec, le build n'apparaît pas dans App Store Connect : corriger les erreurs, recompiler et recommencer. En cas de succès, le build apparaît dans la liste des builds et peut être sélectionné pour soumission à la revue.

Contact

Pour communiquer avec l'équipe : s2mlab@gmail.com.