Files
AudiOhm/BUILD_INSTRUCTIONS.md
T
root 85dad89d5b feat: Modernisation UI/UX et configuration Flutter multi-plateforme
Phase 1 - Corrections Critiques:
- Fixed memory leaks dans music_provider.dart (stream subscriptions)
- Fixed race conditions dans search_provider.dart (stale results)
- Fixed token refresh errors dans api_service.dart
- Improved error handling avec messages utilisateur
- Changed API URL to HTTPS by default

Phase 2 - Améliorations UX Desktop:
- Ajouté cursor pointers sur tous les éléments cliquables
- Implémenté hover states avec effets néon glow (200ms transitions)
- Créé skeleton loading states avec shimmer animation
- Ajouté widgets: ClickableWrapper, ErrorDisplay, SkeletonLoading
- Enhanced visual feedback pour desktop users

Phase 3 - Configuration Flutter:
- Configuré Android (Gradle 8.1.0, Kotlin 1.9.0, minSdk 21, targetSdk 34)
- Créé launcher icons cyberpunk néon (5 densités)
- Configuré Windows desktop (structure complète)
- Activé Linux desktop support
- Ajouté package équatable pour entités de domaine
- Corrigé imports (colors.dart, auth_provider.dart)
- Fixed Dio API compatibility (RequestOptions)

Documentation:
- STYLE_GUIDE.md: Guide complet (100+ pages)
- DESIGN_IMPLEMENTATION_GUIDE.md: Implémentation Flutter
- BUILD_STATUS.md: Status builds + troubleshooting
- QUICKSTART_BUILDS.md: Guide rapide
- BUILD_INDEX.md: Index documentation
- PHASE_1_CORRECTIONS.md: Corrections Phase 1
- PHASE_2_UX_IMPROVEMENTS.md: Améliorations Phase 2
- PR_REVIEW_SUMMARY.md: Revue code complète
- CODE_ANALYSIS_AND_PRIORITIES.md: Analyse code

Scripts & Builds:
- BUILD_ALL.sh: Script automatisé builds multi-plateforme
- builds/: Structure avec README par plateforme
- design-system/: Système de design complet

Backend:
- Ajouté streaming HTTP Range pour audio progressif
- Enhanced YouTube service avec métadonnées complètes
- Improved error handling et validation

Generated with [Claude Code](https://claude.com/claude-code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-01-19 07:44:40 +00:00

3.2 KiB

🎵 AudiOhm - Instructions de Build

📱 Build Android APK

Prérequis

  • Flutter SDK installé
  • Android SDK configuré
  • JDK 8 ou supérieur

Build APK Release

cd /opt/audiOhm/frontend
flutter build apk --release

Output: build/app/outputs/flutter-apk/app-release.apk

Build App Bundle (pour Google Play)

flutter build appbundle --release

Output: build/app/outputs/bundle/release/app-release.aab

Installer sur Android

  1. Transférer l'APK sur l'appareil
  2. Activer "Sources inconnues" dans les paramètres
  3. Ouvrir le fichier APK pour installer

🪟 Build Windows EXE

Prérequis

  • Windows 10 ou supérieur
  • Visual Studio 2022 (avec charges de travail "Développement d'applications de bureau avec .NET")

Build EXE Release

cd /opt/audiOhm/frontend
flutter build windows --release

Output: build/windows/runner/Release/audiOhm.exe

Installer sur Windows

  1. Exécuter audiOhm.exe
  2. Suivre les instructions d'installation

🌐 Build Web

Prérequis

  • Chrome ou un autre navigateur moderne
  • Backend démarré

Build Web Release

cd /opt/audiOhm/frontend
flutter build web --release

Output: build/web/ (fichiers statiques)

Déployer

# Avec un serveur web (ex: nginx)
cp -r build/web/* /var/www/html/

🚀 Script Automatisé

Utilisez le script BUILD.sh pour builder les deux plateformes :

./BUILD.sh

Ce script va :

  1. Installer les dépendances
  2. Builder l'APK Android release
  3. Builder l'EXE Windows release

🧪 Mode Développement

Android

flutter run -d android

Windows

flutter run -d windows

Web

flutter run -d chrome

📝 Notes de Configuration

Android

  • Package Name: com.audiohm.audiOhm
  • App ID: com.audiohm.audiOhm
  • Min SDK: 21 (Android 5.0)
  • Target SDK: 34 (Android 14)

Windows

  • Executable Name: audiOhm.exe
  • Company Name: audiohm
  • Product Name: AudiOhm

Réseau Local

Pour le développement local, overridez l'URL API :

flutter run --dart-define=API_BASE_URL=http://localhost:8000/api/v1

🔧 Configuration Requise

Android - Google Services (Optionnel)

Pour Firebase ou Google Services :

  1. Créer un projet Firebase
  2. Télécharger google-services.json
  3. Placer dans android/app/google-services.json

Windows - Certificat (Release)

Pour signer l'EXE Windows :

  1. Créer un certificat de signature
  2. Configurer dans windows/C/CMakeLists.txt

Pour le développement, le certificat de debug suffit.


Vérification du Build

Android

  • APK se compile sans erreurs
  • L'application se lance sur l'appareil
  • Les connexions API fonctionnent
  • L'audio joue correctement

Windows

  • EXE se compile sans erreurs
  • L'application se lance
  • Les connexions API fonctionnent
  • L'audio joue correctement

📚 Documentation

  • Style Guide: STYLE_GUIDE.md
  • Quick Reference: QUICK_REFERENCE.md
  • Design System: design-system/MASTER.md

Dernière mise à jour: 2026-01-18 Version: 1.0.0