root
85dad89d5b
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>
195 lines
3.2 KiB
Markdown
195 lines
3.2 KiB
Markdown
# 🎵 AudiOhm - Instructions de Build
|
|
|
|
## 📱 Build Android APK
|
|
|
|
### Prérequis
|
|
|
|
- Flutter SDK installé
|
|
- Android SDK configuré
|
|
- JDK 8 ou supérieur
|
|
|
|
### Build APK Release
|
|
|
|
```bash
|
|
cd /opt/audiOhm/frontend
|
|
flutter build apk --release
|
|
```
|
|
|
|
**Output:** `build/app/outputs/flutter-apk/app-release.apk`
|
|
|
|
### Build App Bundle (pour Google Play)
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
cd /opt/audiOhm/frontend
|
|
flutter build web --release
|
|
```
|
|
|
|
**Output:** `build/web/` (fichiers statiques)
|
|
|
|
### Déployer
|
|
|
|
```bash
|
|
# 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 :
|
|
|
|
```bash
|
|
./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
|
|
|
|
```bash
|
|
flutter run -d android
|
|
```
|
|
|
|
### Windows
|
|
|
|
```bash
|
|
flutter run -d windows
|
|
```
|
|
|
|
### Web
|
|
|
|
```bash
|
|
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 :
|
|
|
|
```bash
|
|
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
|